Teknik genel bakış, Elo Android I-Series 5 için Zebra DataWedge. Uyumluluk, özellik desteği ve yapılandırma (Aşama 1)
Hızlı Bağlantılar
Sürümler
| Birlikte Gelen Bileşen | Sürüm |
|---|---|
| Bileşen | Sürüm |
| DataWedge | 20.0.36.139 |
| Tarayıcı Çerçevesi | 43.63.56.0 |
| Minimum Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Genel Bakış
Android 14 MR-9 OS sürümü ile birlikte, Elo I-Series 5 cihazları, Zebra'nın kurumsal Android cihazları arasında kullanılan aynı sıfır kodlu veri yakalama servisi olan Zebra DataWedge ile gönderilmektedir.
DataWedge, bağlı bir barkod tarayıcısından veya kameradan veri toplar ve bunu ön planda olan uygulamaya - ya tuş vuruşları olarak, klavyeden yazılmış gibi, ya da uygulamanın programatik olarak aldığı bir Android intent olarak iletir. Uygulamalar, tarayıcıya özgü kod veya bir Elo'ya özel SDK içermeden tarama verilerini almak için gereklidir.
Bu, Elo ve Zebra tarafından ortaklaşa teslim edilen ilk yazılım platformu entegrasyonudur. DataWedge, Zebra tarafından oluşturulmuş ve Elo tarafından Elo Android OS görüntüsüne entegre edilmiştir, bu nedenle MR-9 güncellemesinden sonra kutudan çıktığı gibi mevcuttur - ayrı bir indirme veya yan yükleme gerekmez.
Neden önemli
- Mevcut uygulama mantığını yeniden kullanma. Zebra cihazlarında DataWedge profilleri ve intentleri ile yazılmış olan uygulamalar, tarama entegrasyonlarını yeniden yazmadan Elo I-Series 5’te çalışacak şekilde tasarlanmıştır.
- Tarayıcı SDK'sı gerekmez. Tarama verileri tuş vuruşları veya intentler olarak gelir, bu nedenle yeni uygulamalar, cihaz spesifik bir SDK entegrasyonu olmadan taramayı destekleyebilir.
- Uygulama başına davranış, otomatik olarak. Profiller uygulamalara bağlıdır; DataWedge, uygulamalar ön plana çıktıkça profilleri değiştirir, kullanıcı eylemi olmadan.
- Tekrar edilebilir filo yapılandırması. Bir cihazda oluşturulan bir yapılandırma, diğerlerine aktarılabilir ve içe aktarılabilir.
2. Donanım ve Platform Uyumluluğu
Desteklenen cihazlar ve OS
| Cihaz | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" ve 22" | Qualcomm QCS6490 | Android 14 |
Minimum OS: Elo Android 14 MR-9, sürüm 7.000.009.0046+gen5p veya sonraki.
Mevcut olma durumu: 28 Ekim 2026’da EloView portalında OTA güncellemesi; 4 Kasım 2026’dan itibaren EloView ve OEMConfig'de varsayılan OTA.
Desteklenen giriş kaynakları
| Giriş kaynağı | Bağlantı | Notlar |
|---|---|---|
| Elo Edge Connect barkod tarayıcıları | USB | Zebra tarama motoru tarayıcıları, DataWedge tarafından yerel olarak sürülmektedir. |
| Entegre ön kamera | Dahili | DataWedge'de Ön Kamera olarak listelenmiştir. Barkod Girişi Tarayıcı seçme menüsü altından yeni tarayıcı ekle. I-Series 5 10", 15" ve 22" modellerinde mevcuttur. |
Zebra TechDocs referansı:
Barkod Girişi: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Özellikler
Aşama 1, barkod yakalama, profil yönetimi, veri iletimi ve yapılandırma için temel DataWedge özellik setini sunar. Özellik açıklamaları Zebra'nın DataWedge belgeleriyle uyumludur; tam parametre referansı için Zebra TechDocs'a bakın (https://techdocs.zebra.com/datawedge/latest/guide/about/).
3.1 Veri yakalama
| Özellik | Açıklama |
|---|---|
| Barkod Girişi | Bağlı USB tarayıcılarından veya bir kameradan barkod verisini alır. |
| Kamera ile tarama | DataWedge vizöründen bir kamera ile barkodları tarar. |
| Tarayıcı Girişi eklentisi | Tarayıcı donanımını, çözümleyici parametrelerini ve okuma parametrelerini kontrol eder. |
| Tarayıcı seçimi | Varsayılan olarak otomatik. Belirli bir harici tarayıcıyı veya ön kamerayı kullanmak için, Barkod Girişi Tarayıcı seçimini açın, menüyü açın ve Yeni tarayıcı ekle; Otomatik Kullan seçeneği otomatik seçime geri döner. |
| Çözümleyici (simbololoji) yapılandırması | Bireysel simgeleri etkinleştirip devre dışı bırakabilir ve profil başına çözümleyici parametrelerini ayarlayabilirsiniz. |
| Data Capture Plus (ekranda tarama tetikleyici) | Ekranın bir kısmını sanal bir tarama tetikleyici olarak belirler: basıp tutmak, profilin seçili tarayıcısı veya kamerası ile bir tarama başlatır, donanım tetikleyicisi gibi. Uygulamalarda etkinleştirildiğinde, profil ile birlikte dahil olan yüzey düğmesi olarak görünür: yeni profillerde varsayılan olarak açıktır ve profili olmayan uygulamalarda Profil0 etkinleştirildiğinde görünür (Başlarken, Adım 2). |
Zebra TechDocs referansı:
Barkod Girişi: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Veri iletimi ve biçimlendirilmesi
| Özellik | Açıklama |
|---|---|
| Tuş vuruşu çıktısı | Tarama verilerini ön planda bulunan uygulamanın odaklı alanına tuş olayları olarak iletir, eylem tuşu karakterleri, karakterler arası gecikme ve tuş olayı gecikmesini içerir. |
| Intent çıktısı | Tarama verilerini bir uygulamaya Android intent (yayın, aktivite başlatma veya hizmet başlatma) olarak iletir, eylem ve kategori konfigüre edilebilir. Veriler standart DataWedge extraları olarak gelir, örneğin com.symbol.datawedge.data_string ve com.symbol.datawedge.label_type. |
| Temel Veri Biçimlendirme (BDF) | Tarama verisine bir ön ek, sondan veya Enter/TAB tuşu ekler. |
| Gelişmiş Veri Biçimlendirme (ADF) | Simgeye, uzunluğa veya içeriğe bağlı kural tabanlı biçimlendirme. |
| GS1 / GS1 Dijital Bağlantı ayrıştırma | Veri çıktısında GS1 Uygulama Tanımlayıcılarını ayrıştırır ve sıralar. |
Zebra TechDocs referansı:
Tuş Vuruşu Çıkışı: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Intent Çıkışı: 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 Profil yönetimi
| Özellik | Açıklama |
|---|---|
| Birden fazla profil | Farklı uygulamalar veya kullanım durumları için ayrı yapılandırmalar oluşturun ve yönetin. |
| Varsayılan profil (Profil0) | Kendi profili olmayan her uygulama için geçerli olan temel profil. |
| Uygulama ve aktivite ilişkisi | Bir profili bir veya daha fazla uygulamaya (ve aktivitelerine) bağlayın, böylece profili ön planda olan uygulama aktif olduğunda aktive olur. |
| Otomatik profil değiştirme | DataWedge, bir uygulama ön plana çıktığında ilişkili profili değiştirir. |
| Profil oluştur / düzenle / sil | DataWedge yapılandırma uygulamasında profilleri yönetin. |
| Profili devre dışı bırak | Bir profili silmeden kapatın. |
| Profil klonla | Bir profilin kopyasını çıkarın (uygulama ilişkilendirmesi olmadan). |
Zebra TechDocs referansı:
DataWedge Profilleri: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 DataWedge ayarları ve dağıtımı
| Özellik | Açıklama |
|---|---|
| DataWedge'i etkinleştir / devre dışı bırak | DataWedge servisini açın veya kapatın. |
| Devre dışı kalan uygulama listesi | Ön planda bulundukları süre boyunca seçilen uygulamalar veya aktiviteler için DataWedge'i askıya alın. |
| Profilleri dışa aktar / içe aktar | Bir profili bir dosyaya dışa aktarın ve diğer bir cihazda içe aktarın. |
| Tüm yapılandırmayı dışa aktar / içe aktar | Tam DataWedge yapılandırmasını dışa aktarın ve diğer cihazlarda içe aktarın. |
| Varsayılan ayarlara geri dön | DataWedge'i varsayılan yapılandırmasına döndürün. |
| Otomatik İçe Aktarma | DataWedge, otomatik içe aktarma klasörüne konulan yapılandırma dosyalarını otomatik olarak uygular (bkz. bölüm 4). |
| Yapılandırma kalıcılığı | Yapılandırma, yeniden başlatmalarda korunur. |
| Yapılandırma kullanıcı arayüzü | Manuel yapılandırma için cihaz üzerindeki DataWedge uygulaması. |
Zebra TechDocs referansı:
DataWedge Ayarları: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Programatik kontrol ve araçlar
| Özellik | Açıklama |
|---|---|
| DataWedge Intent API | Uygulama üzerinden DataWedge kontrol edin - örneğin profilleri değiştirin, bir yumuşak taramayı tetikleyin, devre dışı kalan uygulama listesini ayarlayın, tarayıcı durumunu sorgulayın ve yapılandırmayı oluşturun veya güncelleyin. |
| DWDemo uygulaması | Tarama ve veri çıktısını test edin. |
Zebra TechDocs referansı:
DataWedge API'leri: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Başlarken
Adım 1 - OS'yi Güncelleyin
- Cihazı Elo Android 14 MR-9 (7.000.009.0046+gen5p) veya daha yenisiyle EloView portalından veya cihaz üzerindeki EloView Kontrol Panelinden güncelleyin. Diğer MDM kullanıcıları, Elo OEMConfig'un Otomatik ve Manuel Güncelleme özelliklerini kullanabilir.
- Edge Connect barkod tarayıcısını kullanıyorsanız, cihazınıza bağlayın.
- Uygulama başlatıcısından DataWedge uygulamasını açın.
Adım 2 - Profil0'ı etkinleştirin ve doğrulayın
- Profil0 kendi profili olmayan her uygulamaya uygulanan yedek profilidir. Sürüm yapısında varsayılan olarak kapalıdır, bu nedenle kendi profili olmayan uygulamalar herhangi bir yüzey tarama düğmesi almaz ve DataWedge kamerayı tutmaz, ta ki açana kadar.
- Bunu etkinleştirmek için Android Ayarları Elo Ayarları bölümünü açın ve DataWedge taraması (Profil0) seçeneklerini açın. Ardından DWDemo'yu açın, bağlantılı tarayıcı ile bir barkod tarayın (veya ekran üzerindeki sarı tarama düğmesine basarak ve tutun: Tarayıcı seçimi Otomatik durumunda bağlantılı USB tarayıcıyı kullanır ve USB tarayıcı bağlı değilse ön kamerayla tarar) ve verilerin göründüğünü onaylayın.
- Elo Ayarları kontrol edilirken, DataWedge uygulaması içindeki Profil0 girişi gri renkli olacak şekilde işaretlenecektir ("yönetici tarafından devre dışı bırakılmıştır"); Profil0'ı Elo Ayarlarından değiştirin.
- Her cihazı dokunmadan taramayı etkinleştirmek için, uygulamanıza Profil0'a güvenmek yerine kendi profilini verin. Bir profil, uygulamanız ön planda olduğunda etkin olur, Profil0 ayarından bağımsızdır. Bunu bir referans cihazında oluşturun ve Otomatik İçe Aktarma (Adım 5) ile filoya itmeli, veya uygulamanın ilk açılışında DataWedge SET_CONFIG Intent API'si ile oluşturmasını sağlayabilirsiniz (bkz. Geliştiriciler için).
Adım 3 - Uygulamanız için bir profil oluşturun
- DataWedge'de menüyü açın ve Yeni profil seçeneğini belirleyin; bir isim girin.
- Açık İlişkili uygulamalar ve uygulamanızın paketini (ve isteğe bağlı olarak özel aktiviteleri) ekleyin.
- Barkod Girişi altında, girişi etkinleştirildiğinden emin olun ve Tarayıcı seçimi altında cihazı seçin (Otomatik varsayılan olarak; belirli bir harici tarayıcıyı veya ön kamerayı seçmek için menüyü açın ve Yeni tarayıcıyı koru seçeneğini belirleyin). Not: Barkod Girişi Tarayıcı seçiminde seçilen tarayıcı, profilin kullandığıdır; Tarayıcı Ayarlarını Yapılandır seçeneği yalnızca o tarayıcının parametrelerini ayarlar.
- Çözümleyiciler altında, yalnızca iş akışınızda gereken simgeleri etkinleştirin.
- Bir çıktı seçin: Tuş vuruşu çıktısı metin alanlarını okuyan uygulamalar için veya Intent çıktısı tarama verilerini programatik olarak alan uygulamalar için (intent eylem, kategori ve teslim yöntemini uygulamanızın alıcısına uygun hale getirin). Kullanmadığınız çıktıyı devre dışı bırakın.
- İsteğe bağlı olarak Temel veya Gelişmiş Veri Biçimlendirme altında ön ekler, son ekler veya kurallar ekleyin.
- Uygulamanızı ön plana getirin - DataWedge otomatik olarak yeni profili değiştirir.
Adım 4 - Profil0 ve ekran üzerindeki tarama düğmesini kontrol et
- Profil0 varsayılan olarak kapalıdır, bu nedenle kendi profili olmayan uygulamalar yüzey tarama düğmesi göstermez. Açmak veya kapatmak için Android Ayarları > Elo Ayarları > DataWedge taraması (Profil0) bölümünden değiştirin.
- Data Capture Plus her yeni profilde varsayılan olarak açıktır, bu nedenle yüzey tarama düğmesi kendi profillerine sahip uygulamalarda da görünür. Bir uygulama için gizlemek için, o uygulamanın profilini açın ve Data Capture Plus > Enabled seçeneğini temizleyin.
- Kamerayı paylaşmaması veya tarama verisi almaması gereken uygulamalar - örneğin dokunarak ödeme / SoftPOS ödeme uygulamaları, kamera kullanımını tespit eden - Ayarlar > Devre dışı kalan uygulama listesi'ne eklenmelidir veya Profil0 kapalı bırakılmalıdır.
Adım 5 - Yapılandırmayı filonuza dağıtın
- Bir yapılandırılmış referans cihazında, DataWedge Ayarları Dışa Aktar seçeneğini açın ve tam yapılandırmayı (datawedge.db) veya bir profili (dwprofile\_<isim>.db) dışa aktarın.
- MDM'inizi kullanarak dosyayı hedef cihazlardaki DataWedge otomatik içe aktarma klasörüne itmek için:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge, dosyayı otomatik olarak içe aktarır ve yeniden başlatmaya gerek kalmadan uygular. Exported .db dosyalarını yeniden adlandırmayın veya düzenlemeyin.
Geliştiriciler için
- Profil değiştirmek, taramaları tetiklemek ve uygulamanızdan profiller oluşturmak veya güncellemek için DataWedge Intent API'sini kullanın: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Profil ve eklenti referansı: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Zebra Android cihazlarında DataWedge ile entegre edilmiş uygulamalar, Aşama 1 özellik seti için herhangi bir tarama kodu değişikliği gerektirmeyecek şekilde tasarlanmıştır.
5. Kaynaklar ve Destek
- Zebra DataWedge belgeleri: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Elo desteği: https://www.elotouch.com/support
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article