Technische Übersicht, für Zebra DataWedge auf Elo Android I-Series 5. Kompatibilität, Unterstützung von Funktionen und Konfiguration (Phase 1)
Schnellzugriffe
Versionen
| Komponente | Version |
|---|---|
| Komponente | Version |
| DataWedge | 20.0.36.139 |
| Scanner Framework | 43.63.56.0 |
| Minimale Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Übersicht
Mit der Veröffentlichung des Android 14 MR-9 Betriebssystems werden Elo I-Series 5 Geräte mit Zebra DataWedge ausgeliefert, dem gleichen Zero-Code-Datenaufnahme-Service, der auch auf Zebras Unternehmens-Android-Geräten verwendet wird.
DataWedge erfasst Daten von einem verbundenen Barcode-Scanner oder einer Kamera und liefert sie an die App im Vordergrund - entweder als Tastenanschläge, als ob sie auf einer Tastatur eingegeben wurden, oder als einen Android-Intent, den die App programmgesteuert erhält. Apps müssen keinen scannerspezifischen Code oder ein Elo-spezifisches SDK enthalten, um Scan-Daten zu empfangen.
Dies ist die erste Softwareplattform-Integration, die gemeinsam von Elo und Zebra bereitgestellt wird. DataWedge wird von Zebra erstellt und von Elo in das Elo Android OS-Image integriert, sodass es nach dem MR-9-Update sofort verfügbar ist - kein separates Herunterladen oder Sideloading ist erforderlich.
Warum es wichtig ist
- Wiederverwendung vorhandener Logik in Apps. Anwendungen, die bereits auf DataWedge-Profile und -Intents auf Zebra-Geräten zugreifen, sind so konzipiert, dass sie auf Elo I-Series 5 ohne Umprogrammierung ihrer Scan-Integration laufen.
- Kein Scanner-SDK erforderlich. Scan-Daten kommen als Tastenanschläge oder Intents, sodass neue Apps Scannen unterstützen können, ohne ein gerätespezifisches SDK zu integrieren.
- Pro-App-Verhalten, automatisch. Profile sind an Apps gebunden; DataWedge wechselt die Profile, während Apps in den Vordergrund kommen, ohne dass der Benutzer eingreifen muss.
- Wiederholbare Flottenkonfiguration. Eine Konfiguration, die auf einem Gerät erstellt wurde, kann auf andere exportiert und importiert werden.
2. Hardware- und Plattformkompatibilität
Unterstützte Geräte und OS
| Gerät | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" und 22" | Qualcomm QCS6490 | Android 14 |
Minimales OS: Elo Android 14 MR-9, Version 7.000.009.0046+gen5p oder neuer.
Verfügbarkeit: Dropdown OTA im EloView-Portal am 28. Oktober 2026; Standard OTA auf EloView und OEMConfig ab dem 4. November 2026.
Unterstützte Eingabek Quellen
| Eingabequelle | Verbindung | Hinweise |
|---|---|---|
| Elo Edge Connect Barcode-Scanner | USB | Zebra Scan-Engine-Scanner werden nativ von DataWedge unterstützt. |
| Integrierte Frontkamera | In DataWedge als Frontkamera aufgeführt. Wählen Sie es im Auswahlmenü für Barcode-Eingabescanner unter Neuem Scanner hinzufügen aus. Verfügbar auf I-Series 5 10", 15" und 22". |
Zebra TechDocs Referenz:
Barcode-Eingabe: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Funktionen
Phase 1 liefert das Kern-Feature-Set von DataWedge für die Barcode-Erfassung, Profiverwaltung, Datenausgabe und Konfiguration. Die Funktionsbeschreibungen folgen der Dokumentation von Zebras DataWedge; siehe Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) für eine vollständige Parameterreferenz.
3.1 Datenerfassung
| Funktion | Beschreibung |
|---|---|
| Barcode-Eingabe | Erfassung von Barcode-Daten von angeschlossenen USB-Scannern oder einer Kamera. |
| Kamera-Scan | Scannen Sie Barcodes mit einer Kamera durch den DataWedge-Sucher. |
| Scanner Input-Plugin | Steuern Sie die Scanner-Hardware, Dekodierungsparameter und Lesegeräteparameter. |
| Scanner-Auswahl | Standardmäßig automatisch. Um einen speziellen externen Scanner oder die Frontkamera zu verwenden, öffnen Sie die Auswahl für Barcode-Eingabescanner, öffnen Sie das Menü und wählen Sie Neuen Scanner hinzufügen; Automatisch verwenden kehrt zur automatischen Auswahl zurück. |
| Dekodierer (Symbologie) Konfiguration | Aktivieren oder deaktivieren Sie einzelne Symbologien und setzen Sie Dekodierungsparameter pro Profil. |
| Data Capture Plus (Bildschirm-Scan-Auslöser) | Bezeichnet einen Teil des Bildschirms als virtuellen Scan-Auslöser: Drücken und Halten startet einen Scan mit dem ausgewählten Scanner oder der Kamera des Profils, genau wie ein Hardware-Auslöser. Wird als schwebende Taste in Apps angezeigt, deren Profil dies aktiviert hat: es ist standardmäßig in neuen Profilen eingeschaltet, und für Apps ohne Profil erscheint es, sobald Profile0 aktiviert ist (Einstieg, Schritt 2). |
Zebra TechDocs Referenz:
Barcode-Eingabe: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Datenausgabe und -formatierung
| Funktion | Beschreibung |
|---|---|
| Tastenanschlag-Ausgabe | Liefern Sie die Scan-Daten als Tastenereignisse in das fokussierte Feld der Vordergrund-App, einschließlich Aktions-Tastenzeichen, Inter-Zeichen-Verzögerung und Tastenevent-Verzögerung. |
| Intent-Ausgabe | Liefern Sie Scan-Daten an eine App als Android-Intent (Broadcast, Aktivität starten oder Dienst starten) mit konfigurierbarer Aktion und Kategorie. Daten kommen in Standard-DataWedge-Extras wie com.symbol.datawedge.data_string und com.symbol.datawedge.label_type. |
| Basale Datenformatierung (BDF) | Fügen Sie ein Präfix, Suffix oder die Enter-/Tabulatortaste zu den Scan-Daten hinzu. |
| Erweiterte Datenformatierung (ADF) | Regelbasierte Formatierung, die an Symbologie, Länge oder Inhalt gebunden ist. |
| GS1 / GS1 Digital Link Parsing | Parsen und Anordnen von GS1-Anwendungs-Identifikatoren in der Ausgabe. |
Zebra TechDocs Referenz:
Tastenanschlag-Ausgabe: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Intent-Ausgabe: 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 Profiverwaltung
| Funktion | Beschreibung |
|---|---|
| Mehrere Profile | Erstellen und verwalten Sie separate Konfigurationen für verschiedene Apps oder Anwendungsfälle. |
| Standardprofil (Profil0) | Basisprofil, das auf jede App angewendet wird, die kein eigenes Profil hat. |
| App- und Aktivitätszuordnung | Verknüpfen Sie ein Profil mit einer oder mehreren Apps (und Aktivitäten), damit es aktiviert wird, wenn diese App im Vordergrund ist. |
| Automatisches Profilwechseln | DataWedge wechselt zum verknüpften Profil, wenn eine App in den Vordergrund kommt. |
| Erstellen / Bearbeiten / Löschen von Profilen | Verwalten Sie Profile in der DataWedge-Konfigurations-App. |
| Profil deaktivieren | Ein Profil ausschalten, ohne es zu löschen. |
| Profil klonen | Ein Profil duplizieren (ohne seine App-Zuordnung). |
Zebra TechDocs Referenz:
DataWedge-Profile: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 DataWedge-Einstellungen und Bereitstellung
| Funktion | Beschreibung |
|---|---|
| DataWedge aktivieren / deaktivieren | Den DataWedge-Dienst ein- oder ausschalten. |
| Liste der deaktivierten Apps | Deaktivieren Sie DataWedge für ausgewählte Apps oder Aktivitäten, während sie im Vordergrund sind. |
| Profile exportieren / importieren | Ein einzelnes Profil in eine Datei exportieren und auf einem anderen Gerät importieren. |
| Komplette Konfiguration exportieren / importieren | Die vollständige DataWedge-Konfiguration exportieren und auf anderen Geräten importieren. |
| Standardeinstellungen wiederherstellen | DataWedge auf die Standardkonfiguration zurücksetzen. |
| Automatisches Importieren | DataWedge wendet automatisch Konfigurationsdateien an, die im Auto-Import-Ordner abgelegt sind (siehe Abschnitt 4). |
| Konfigurationspersistenz | Die Konfiguration bleibt beim Neustart erhalten. |
| Benutzeroberfläche zur Konfiguration | DataWedge-App auf dem Gerät für manuelle Konfiguration. |
Zebra TechDocs Referenz:
DataWedge-Einstellungen: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Programmatische Steuerung und Tools
| Funktion | Beschreibung |
|---|---|
| DataWedge Intent API | Steuern Sie DataWedge von einer App aus mit Android-Intents - zum Beispiel Profile wechseln, einen Soft-Scan auslösen, die Liste der deaktivierten Apps festlegen, den Scannerstatus abfragen und Konfigurationen erstellen oder aktualisieren. |
| DWDemo-App | Testen Sie das Scannen und die Datenausgabe. |
Zebra TechDocs Referenz:
DataWedge APIs: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Einstieg
Schritt 1 - Aktualisieren Sie das OS
- Aktualisieren Sie das Gerät auf Elo Android 14 MR-9 (7.000.009.0046+gen5p) oder neuer über das EloView-Portal oder das EloView-Control-Panel auf dem Gerät. Andere MDM-Nutzer können die Funktionen für automatische und manuelle Updates von Elo OEMConfig verwenden.
- Wenn Sie einen Edge Connect Barcode-Scanner verwenden, verbinden Sie ihn mit dem Gerät.
- Öffnen Sie die DataWedge-App aus dem App-Launcher.
Schritt 2 - Aktivieren Sie Profil0 und überprüfen Sie es
- Profil0 ist das Fallback-Profil, das auf jede App angewendet wird, die kein eigenes Profil hat. In der Release-Version ist es standardmäßig deaktiviert, sodass Apps ohne ihr eigenes Profil keine schwebende Scan-Taste erhalten und DataWedge die Kamera nicht aktiviert, bis Sie es einschalten.
- Um es zu aktivieren, öffnen Sie Android-Einstellungen Elo-Einstellungen und schalten Sie DataWedge-Scanning (Profil0) ein. Öffnen Sie dann DWDemo, scannen Sie einen Barcode mit dem angeschlossenen Scanner (oder drücken und halten Sie die gelbe Scan-Taste auf dem Bildschirm: bei Scanner-Auswahl auf Automatisch verwendet er den angeschlossenen USB-Scanner, und ohne verbundenen USB-Scanner scannen Sie mit der Frontkamera) und bestätigen Sie, dass die Daten angezeigt werden.
- Während die Elo-Einstellungen verwendet werden, ist der Profil0-Eintrag in der DataWedge-App ausgegraut ("von Administrator deaktiviert"); ändern Sie Profil0 in den Elo-Einstellungen.
- Um das Scannen ohne Berühren jedes Geräts zu ermöglichen, geben Sie Ihrer App ihr eigenes Profil anstelle der Abhängigkeit von Profil0. Ein Profil wird immer dann angewendet, wenn seine App im Vordergrund ist, unabhängig von der Einstellung von Profil0. Erstellen Sie es auf einem Referenzgerät und übertragen Sie es mit Auto Import (Schritt 5) auf die Flotte oder lassen Sie die App es beim ersten Start mit der DataWedge SET_CONFIG Intent API erstellen (siehe Für Entwickler).
Schritt 3 - Erstellen Sie ein Profil für Ihre App
- Öffnen Sie in DataWedge das Menü und wählen Sie Neues Profil; geben Sie einen Namen ein.
- Öffnen Sie Verknüpfte Apps und fügen Sie das Paket Ihrer App hinzu (und optional spezifische Aktivitäten).
- Über Barcode-Eingabe stellen Sie sicher, dass die Eingabe aktiviert ist und wählen Sie das Gerät unter Scanner-Auswahl aus (Standardmäßig automatisch; um einen bestimmten externen Scanner oder die Frontkamera auszuwählen, öffnen Sie das Menü und wählen Sie Neuen Scanner beibehalten). Hinweis: Der Scanner, der unter Auswahl für Barcode-Eingabescanner ausgewählt wurde, ist derjenige, den das Profil verwendet; Scanner-Einstellungen konfigurieren setzt nur die Parameter dieses Scanners fest.
- Unter Dekodierer aktivieren Sie nur die Symbologien, die Ihr Workflow benötigt.
- Wählen Sie eine Ausgabe: Tastenanschlag-Ausgabe für Apps, die Textfelder lesen, oder Intent-Ausgabe für Apps, die Scan-Daten programmgesteuert empfangen (setzen Sie die Intent-Aktion, Kategorie und das Übergabeverfahren so, dass sie zu Ihrem App-Empfänger passen). Deaktivieren Sie die Ausgabe, die Sie nicht verwenden.
- Fügen Sie optional Präfixe, Suffixe oder Regeln unter Basis oder Erweiterte Datenformatierung hinzu.
- Bringen Sie Ihre App in den Vordergrund - DataWedge wechselt automatisch zum neuen Profil.
Schritt 4 - Steuern Sie Profil0 und die schwebende Scan-Taste
- Profil0 ist standardmäßig deaktiviert, sodass Apps ohne eigenes Profil keine schwebende Scan-Taste anzeigen. Schalten Sie es ein oder aus über Android-Einstellungen > Elo-Einstellungen > DataWedge-Scanning (Profil0).
- Data Capture Plus ist standardmäßig in jedem neuen Profil aktiviert, sodass die schwebende Scan-Taste auch in Apps erscheint, die ihr eigenes Profil haben. Um sie für eine App auszublenden, öffnen Sie das Profil dieser App und deaktivieren Sie Data Capture Plus > Aktiviert.
- Apps, die die Kamera nicht teilen oder Scan-Daten empfangen dürfen - zum Beispiel Tap-to-Pay / SoftPOS-Zahlungs-Apps, die die Kameranutzung erkennen - sollten zu Einstellungen > Liste der deaktivierten Apps in DataWedge hinzugefügt werden, oder Profil0 sollte deaktiviert bleiben.
Schritt 5 - Bereitstellung der Konfiguration für Ihre Flotte
- Öffnen Sie auf einem konfigurierten Referenzgerät DataWedge-Einstellungen Exportieren und exportieren Sie die vollständige Konfiguration (datawedge.db) oder ein einzelnes Profil (dwprofile\_<name>.db).
- Verwenden Sie Ihr MDM, um die Datei in den Auto-Import-Ordner von DataWedge auf den Zielgeräten zu übertragen:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge importiert die Datei automatisch und wendet sie ohne Neustart an. Ändern oder bearbeiten Sie exportierte .db-Dateien nicht.
Für Entwickler
- Verwenden Sie die DataWedge Intent API, um Profile zu wechseln, Scans auszulösen und Profile aus Ihrer App zu erstellen oder zu aktualisieren: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Profil- und Plugin-Referenz: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Apps, die bereits mit DataWedge auf Zebra Android-Geräten integriert sind, sind so konzipiert, dass sie keine Änderungen am Scan-Code für das Feature-Set von Phase 1 benötigen.
5. Ressourcen und Unterstützung
- Zebra DataWedge Dokumentation: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Elo-Unterstützung: https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article