Przegląd techniczny, dla Zebra DataWedge na Elo Android I-Series 5. Zgodność, wsparcie dla funkcji i konfiguracja (Faza 1)
Szybkie linki
Wersje
| Komponent | Wersja |
|---|---|
| Komponent | Wersja |
| DataWedge | 20.0.36.139 |
| Framework skanera | 43.63.56.0 |
| Minimalne Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Przegląd
Od wydania systemu Android 14 MR-9, urządzenia Elo I-Series 5 są dostarczane zZebra DataWedge, tym samym bezkodowym serwisem przechwytywania danych, który jest używany w urządzeniach przedsiębiorstw Zebra.
DataWedge przechwytuje dane z podłączonego skanera kodów kreskowych lub kamery i dostarcza je do aplikacji, która jest aktywna na pierwszym planie - jako wprowadzenie z klawiatury, jakby były wpisywane na klawiaturze, lub jako zamiar Android, który aplikacja odbiera programowo. Aplikacje nie muszą zawierać kodu specyficznego dla skanera ani specyficznego dla Elo SDK, aby odbierać dane skanowania.
To jest pierwsza integracja platformy oprogramowania dostarczona wspólnie przez Elo i Zebra. DataWedge jest budowane przez Zebra i zintegrowane przez Elo w obrazie systemu operacyjnego Elo Android, więc jest dostępne od razu po aktualizacji MR-9 - nie jest wymagane osobne pobieranie ani instalacja.
Dlaczego to ma znaczenie
- Wykorzystanie istniejącej logiki aplikacji. Aplikacje już napisane zgodnie z profilami i zamiarami DataWedge na urządzeniach Zebra są zaprojektowane do działania na Elo I-Series 5 bez potrzeby przepisania integracji skanowania.
- Nie wymaga SDK skanera. Dane skanowania przychodzą jako wprowadzenie z klawiatury lub zamiary, więc nowe aplikacje mogą wspierać skanowanie bez integrowania specyficznego dla urządzenia SDK.
- Zachowanie przypisane do aplikacji, automatycznie. Profile są związane z aplikacjami; DataWedge przełącza profile, gdy aplikacje stają się aktywne, bez interakcji użytkownika.
- Powtarzalna konfiguracja floty. Konfiguracja stworzona na jednym urządzeniu może być eksportowana i importowana na innych.
2. Zgodność sprzętowa i platformy
Wspierane urządzenia i systemy operacyjne
| Urządzenie | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" i 22" | Qualcomm QCS6490 | Android 14 |
Minimalny OS: Elo Android 14 MR-9, wersja 7.000.009.0046+gen5p lub nowsza.
Dostępność: aktualizacja OTA na portalu EloView 28 października 2026 r.; domyślna aktualizacja OTA na EloView i OEMConfig od 4 listopada 2026 r.
Wspierane źródła wejścia
| Źródło wejścia | Połączenie | Uwagi |
|---|---|---|
| Skanery kodów kreskowych Elo Edge Connect | USB | Skanery z silnikiem skanującym Zebra są obsługiwane natywnie przez DataWedge. |
| Zintegrowana kamera frontalna | Wbudowana | Zidentyfikowana w DataWedge jako Kamera frontalna. Wybierz ją w menu wyboru Skanera wejściowego Kodów kreskowych, aby dodać nowy skaner. Dostępna w I-Series 5 10", 15" i 22". |
Dokumentacja techniczna Zebra:
Wejście kodu kreskowego: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Funkcje
Faza 1 dostarcza podstawowy zestaw funkcji DataWedge do przechwytywania kodów kreskowych, zarządzania profilami, dostarczania danych i konfiguracji. Opisy funkcji są zgodne z dokumentacją DataWedge firmy Zebra; zobacz Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) w celu pełnej referencji parametrów.
3.1 Przechwytywanie danych
| Funkcja | Opis |
|---|---|
| Wejście kodu kreskowego | Pozyskuj dane kodów kreskowych z podłączonych skanerów USB lub kamery. |
| Skanowanie kamerą | Skanuj kody kreskowe za pomocą kamery przez wizjer DataWedge. |
| Wtyczka wejścia skanera | Kontroluj sprzęt skanera, parametry dekodera i parametry czytnika. |
| Wybór skanera | Domyślnie automatyczny. Aby użyć konkretnego zewnętrznego skanera lub kamery frontalnej, otwórz wybór Skanera wejściowego Kodów kreskowych, otwórz menu i wybierz Dodaj nowy skaner; Użyj automatycznie przywraca do automatycznego wyboru. |
| Konfiguracja dekodera (symbologia) | Włącz lub wyłącz poszczególne symbologie oraz ustaw parametry dekodera dla każdego profilu. |
| Data Capture Plus (wyzwalacz skanowania na ekranie) | Wskazuje część ekranu jako wirtualny wyzwalacz skanowania: naciśnięcie i przytrzymanie go rozpoczyna skanowanie wybranym skanerem lub kamerą, tak jakby to były wyzwalacze sprzętowe. Pokazuje jako unoszący się przycisk w aplikacjach, których profil ma to włączone: jest włączone domyślnie w nowych profilach, a dla aplikacji bez profilu pojawia się, gdy Profil0 jest włączony (Wprowadzenie, krok 2). |
Dokumentacja techniczna Zebra:
Wejście kodu kreskowego: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Dostarczanie i formatowanie danych
| Funkcja | Opis |
|---|---|
| Wyjście z klawiatury | Dostarczanie danych skanowania jako zdarzenia klawiszowe do pola skupienia na aktywnej aplikacji, w tym znaki akcji, opóźnienia między znakami i opóźnienia zdarzeń klawiszowych. |
| Wyjście intencji | Dostarczanie danych skanowania do aplikacji jako zamiar Android (broadcast, start activity lub start service) z konfigurowalną akcją i kategorią. Dane przychodzą w standardowych dodatkowych parametrach DataWedge, takich jak com.symbol.datawedge.data_string i com.symbol.datawedge.label_type. |
| Podstawowe formatowanie danych (BDF) | Dodaj prefiks, sufiks lub klawisz Enter/Tab do danych skanowania. |
| Zaawansowane formatowanie danych (ADF) | Formatowanie oparte na regułach uzależnionych od symbologii, długości lub treści. |
| Analiza GS1 / GS1 Digital Link | Analizuj i porządkuj identyfikatory aplikacji GS1 w wyjściu. |
Dokumentacja techniczna Zebra:
Wyjście z klawiatury: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Wyjście intencji: https://techdocs.zebra.com/datawedge/latest/guide/output/intent/
BDF: https://techdocs.zebra.com/datawedge/latest/guide/process/bdf/
ADF: https://techdocs.zebra.com/datawedge/latest/guide/process/adf/
3.3 Zarządzanie profilami
| Funkcja | Opis |
|---|---|
| Wiele profili | Twórz i zarządzaj osobnymi konfiguracjami dla różnych aplikacji lub przypadków użycia. |
| Domyślny profil (Profil0) | Podstawowy profil stosowany do każdej aplikacji bez własnego profilu. |
| Powiązanie aplikacji i aktywności | Połącz profil z jedną lub więcej aplikacjami (i aktywnościami), aby aktywować go, gdy ta aplikacja jest na pierwszym planie. |
| Automatyczne przełączanie profili | DataWedge przełącza się na powiązany profil, gdy aplikacja staje się aktywna. |
| Tworzenie / edytowanie / usuwanie profilu | Zarządzaj profilami w aplikacji konfiguracyjnej DataWedge. |
| Dezaktywuj profil | Wyłącz profil bez jego usuwania. |
| Klona profil | Duplikuj profil (bez powiązań z aplikacjami). |
Dokumentacja techniczna Zebra:
Profile DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Ustawienia DataWedge i wdrażanie
| Funkcja | Opis |
|---|---|
| Włącz / wyłącz DataWedge | Włącz lub wyłącz usługę DataWedge. |
| Lista aplikacji wyłączonych | Zawieszenie DataWedge dla wybranych aplikacji lub aktywności podczas ich działania. |
| Eksport / import profili | Eksportuj pojedynczy profil do pliku i importuj go na inne urządzenie. |
| Eksport / import pełnej konfiguracji | Eksportuj pełną konfigurację DataWedge i zaimportuj ją na innych urządzeniach. |
| Przywróć ustawienia domyślne | Przywróć DataWedge do domyślnej konfiguracji. |
| Automatyczny import | DataWedge automatycznie stosuje pliki konfiguracyjne umieszczone w jego folderze automatycznego importu (patrz sekcja 4). |
| Utrzymywanie konfiguracji | Konfiguracja jest zachowywana po ponownych uruchomieniach. |
| Interfejs użytkownika konfiguracji | Aplikacja DataWedge na urządzeniu do ręcznej konfiguracji. |
Dokumentacja techniczna Zebra:
Ustawienia DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Programowe sterowanie i narzędzia
| Funkcja | Opis |
|---|---|
| API intencji DataWedge | Kontroluj DataWedge z aplikacji za pomocą zamiarów Android - na przykład przełączaj profile, wyzwalaj skanowanie, ustawiaj listę wyłączonych aplikacji, pytaj o status skanera, i twórz lub aktualizuj konfigurację. |
| Aplikacja DWDemo | Testuj skanowanie i wyjście danych. |
Dokumentacja techniczna Zebra:
Interfejsy API DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Wprowadzenie
Krok 1 - Zaktualizuj system operacyjny
- Zaktualizuj urządzenie do Elo Android 14 MR-9 (7.000.009.0046+gen5p) lub nowszej wersji z portalu EloView lub panelu sterowania EloView na urządzeniu. Inni użytkownicy MDM mogą skorzystać z funkcji Aktualizacji automatycznej i ręcznej Elo OEMConfig.
- Jeśli używasz skanera kodów kreskowych Edge Connect, podłącz go do urządzenia.
- Otwórz aplikację DataWedge z uruchamiacza aplikacji.
Krok 2 - Włącz Profil0 i zweryfikuj
- Profil0 jest profilem zapasowym, który stosuje się do każdej aplikacji bez własnego profilu. W wersji wydania jest domyślnie wyłączony, więc aplikacje bez własnego profilu nie mają unoszącego się przycisku skanowania, a DataWedge nie trzyma kamery, dopóki jej nie włączysz.
- Aby go włączyć, otwórz Ustawienia Androida Ustawienia Elo i włącz Skanowanie DataWedge (Profil0). Następnie otwórz DWDemo, zeskanuj kod kreskowy przy użyciu podłączonego skanera (lub naciśnij i przytrzymaj żółty przycisk skanowania na ekranie: z Wyborem skanera ustawionym na Auto używa podłączonego skanera USB, a bez podłączonego skanera USB skanuje kamerą frontalną) i potwierdź, że dane się pojawiają.
- Podczas korzystania z kontroli Ustawień Elo, wpis Profil0 w aplikacji DataWedge jest wyszarzony ("wyłączony przez administratora"); zmień Profil0 w Ustawieniach Elo.
- Aby włączyć skanowanie bez dotykania każdego urządzenia, nadaj swojej aplikacji własny profil zamiast polegać na Profil0. Profil obowiązuje, gdy jego aplikacja jest z przodu, niezależnie od ustawienia Profil0. Stwórz go na urządzeniu referencyjnym i przekaż go flocie za pomocą Automatycznego importu (Krok 5), lub pozwól, aby aplikacja utworzyła go przy pierwszym uruchomieniu za pomocą interfejsu API SET_CONFIG Intent DataWedge (patrz Dla deweloperów).
Krok 3 - Stwórz profil dla swojej aplikacji
- W DataWedge otwórz menu i wybierz Nowy profil; wprowadź nazwę.
- Otwórz Powiązane aplikacje i dodaj pakiet swojej aplikacji (i, opcjonalnie, konkretne aktywności).
- Pod Wejściem kodu kreskowego upewnij się, że wejście jest włączone i wybierz urządzenie w Wybieraniu skanera (Auto domyślnie; aby wybrać konkretny zewnętrzny skaner lub kamerę frontalną, otwórz menu i wybierz Zachowaj nowy skaner). Uwaga: skaner wybrany w menu wyboru Skanera wejściowego Kodów kreskowych to ten, którego używa ten profil; Konfiguracja ustawień skanera ustawia tylko parametry tego skanera.
- Pod Dekoderami włącz tylko te symbologie, które są potrzebne w twoim przepływie pracy.
- Wybierz wyjście: Wyjście z klawiatury dla aplikacji, które odczytują pola tekstowe, lub Wyjście intencji dla aplikacji, które odbierają dane skanowania programowo (ustaw akcję zamiaru, kategorię i metodę dostarczania, aby odpowiadały odbiorcy twojej aplikacji). Wyłącz wyjście, którego nie używasz.
- Opcjonalnie dodaj prefiksy, sufiksy lub reguły w Podstawowym lub Zaawansowanym formatowaniu danych.
- Przynieś swoją aplikację na pierwszy plan - DataWedge automatycznie przełącza się na nowy profil.
Krok 4 - Kontroluj Profil0 i przycisk skanowania na ekranie
- Profil0 jest domyślnie wyłączony, więc aplikacje bez własnego profilu nie wyświetlają unoszącego się przycisku skanowania. Włącz lub wyłącz go w Ustawieniach Androida > Ustawienia Elo > Skanowanie DataWedge (Profil0).
- Data Capture Plus jest domyślnie włączona w każdym nowym profilu, więc unoszący się przycisk skanowania również pojawia się w aplikacjach, które mają swój własny profil. Aby ukryć go dla aplikacji, otwórz profil tej aplikacji i odznacz Data Capture Plus > Włączona.
- Aplikacje, które nie powinny dzielić się kamerą ani otrzymywać danych skanowania - na przykład aplikacje tap-to-pay / SoftPOS, które wykrywają użycie kamery - powinny zostać dodane do Ustawienia > Lista wyłączonych aplikacji w DataWedge, albo Profil0 powinien pozostać wyłączony.
Krok 5 - Wdróż konfigurację do swojej floty
- Na skonfigurowanym urządzeniu referencyjnym otwórz Eksport ustawień DataWedge i wyeksportuj pełną konfigurację (datawedge.db) lub pojedynczy profil (dwprofile\_<nazwa>.db).
- Użyj swojego MDM, aby przesłać plik do folderu automatycznego importu DataWedge na docelowych urządzeniach:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge automatycznie importuje plik i stosuje go bez ponownego uruchamiania. Nie zmieniaj ani nie edytuj wyeksportowanych plików .db.
Dla deweloperów
- Użyj API intencji DataWedge do przełączania profili, wyzwalania skanowania i tworzenia lub aktualizacji profili z twojej aplikacji: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Dokumentacja profili i wtyczek: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Aplikacje już zintegrowane z DataWedge na urządzeniach Zebra Android zostały zaprojektowane tak, aby nie wymagały zmian w kodzie skanowania dla zestawu funkcji fazy 1.
5. Zasoby i wsparcie
- Dokumentacja Zebra DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Wsparcie Elo: https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article