Resumen técnico, para Zebra DataWedge en Elo Android I-Series 5. Compatibilidad, soporte de funciones y configuración (Fase 1)
Enlaces Rápidos
Versiones
| Componente | Versión |
|---|---|
| Componente | Versión |
| DataWedge | 20.0.36.139 |
| Marco del escáner | 43.63.56.0 |
| Mínimo Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Resumen
A partir del lanzamiento del sistema operativo Android 14 MR-9, los dispositivos Elo I-Series 5 se envían con Zebra DataWedge, el mismo servicio de captura de datos sin código utilizado en todos los dispositivos Android empresariales de Zebra.
DataWedge captura datos de un escáner de códigos de barras o de una cámara conectada y los entrega a la aplicación que está en primer plano, ya sea como pulsaciones de tecla, como si se hubieran escrito en un teclado, o como un intent de Android que la aplicación recibe programáticamente. Las aplicaciones no necesitan incluir código específico del escáner ni un SDK específico de Elo para recibir datos de escaneo.
Esta es la primera integración de plataforma de software entregada conjuntamente por Elo y Zebra. DataWedge está construido por Zebra e integrado por Elo en la imagen del sistema operativo Elo Android, por lo que está presente desde el primer momento después de la actualización MR-9; no se requiere descarga o sideload por separado.
Por qué es importante
- Reutilizar la lógica de la aplicación existente. Las aplicaciones ya escritas contra perfiles e intents de DataWedge en dispositivos Zebra están diseñadas para funcionar en Elo I-Series 5 sin reescribir su integración de escaneo.
- No se requiere SDK del escáner. Los datos de escaneo llegan como pulsaciones de tecla o intents, por lo que las nuevas aplicaciones pueden admitir el escaneo sin integrar un SDK específico del dispositivo.
- Comportamiento por aplicación, automáticamente. Los perfiles están vinculados a aplicaciones; DataWedge cambia de perfiles a medida que las aplicaciones pasan al primer plano, sin necesidad de acción por parte del usuario.
- Configuración repetible de flotas. Una configuración construida en un dispositivo puede exportarse e importarse en otros.
2. Compatibilidad de Hardware y Plataforma
Dispositivos y OS compatibles
| Dispositivo | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" y 22" | Qualcomm QCS6490 | Android 14 |
Sistema operativo mínimo: Elo Android 14 MR-9, versión 7.000.009.0046+gen5p o superior.
Disponibilidad: lanzamiento por OTA en el portal EloView el 28 de octubre de 2026; lanzamiento por OTA predeterminado en EloView y OEMConfig desde el 4 de noviembre de 2026.
Fuentes de entrada compatibles
| Fuente de entrada | Conexión | Notas |
|---|---|---|
| Escáneres de códigos de barras Elo Edge Connect | USB | Los escáneres con motores de escaneo Zebra son controlados nativamente por DataWedge. |
| Cámara frontal integrada | Integrado | Enumerado en DataWedge como Cámara Frontal. Selecciónelo en el menú de selección de Escáner de Entrada de Códigos de Barras Agregar nuevo escáner. Disponible en I-Series 5 10", 15" y 22". |
Referencia Zebra TechDocs:
Entrada de Códigos de Barras: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Funciones
La Fase 1 entrega el conjunto de funciones básicas de DataWedge para captura de códigos de barras, gestión de perfiles, entrega de datos y configuración. Las descripciones de funciones siguen la documentación de DataWedge de Zebra; consulte Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) para una referencia completa de parámetros.
3.1 Captura de datos
| Función | Descripción |
|---|---|
| Entrada de Códigos de Barras | Adquirir datos de códigos de barras de escáneres USB conectados o de una cámara. |
| Escaneo con cámara | Escanear códigos de barras con una cámara a través del visor de DataWedge. |
| Complemento de entrada de escáner | Controlar el hardware del escáner, parámetros del decodificador y parámetros del lector. |
| Selección de escáner | Automático por defecto. Para usar un escáner externo específico o la cámara frontal, abra la selección de Escáner de Entrada de Códigos de Barras, abra el menú y seleccione Agregar nuevo escáner; Usar automático vuelve a selección automática. |
| Configuración del decodificador (simbología) | Habilitar o deshabilitar simbologías individuales y establecer parámetros del decodificador por perfil. |
| Data Capture Plus (disparador de escaneo en pantalla) | Designa parte de la pantalla como un disparador de escaneo virtual: presionar y mantener inicia un escaneo con el escáner o cámara seleccionados por el perfil, justo como lo haría un disparador de hardware. Se muestra como un botón flotante en las aplicaciones cuyo perfil tiene esta opción habilitada: está activado por defecto en nuevos perfiles, y para aplicaciones sin un perfil aparece una vez que se habilita el Profile0 (Comenzando, Paso 2). |
Referencia Zebra TechDocs:
Entrada de Códigos de Barras: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
Data Capture Plus: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/
3.2 Entrega y formateo de datos
| Función | Descripción |
|---|---|
| Salida de pulsaciones de tecla | Entregar datos de escaneo como eventos de tecla en el campo enfocado de la aplicación en primer plano, incluyendo caracteres de tecla de acción, retraso entre caracteres y retraso en eventos de tecla. |
| Salida de intent | Entregar datos de escaneo a una aplicación como un intent de Android (difusión, iniciar actividad o iniciar servicio) con acción y categoría configurables. Los datos llegan en extras estándar de DataWedge como com.symbol.datawedge.data_string y com.symbol.datawedge.label_type. |
| Formateo de Datos Básico (BDF) | Agregar un prefijo, sufijo o key Enter/Tab a los datos de escaneo. |
| Formateo de Datos Avanzado (ADF) | Formateo basado en reglas condicionado por simbología, longitud o contenido. |
| Análisis de GS1 / GS1 Digital Link | Analizar y ordenar identificadores de aplicación GS1 en la salida. |
Referencia Zebra TechDocs:
Salida de Pulsaciones de Tecla: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Salida de Intent: 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 Gestión de perfiles
| Función | Descripción |
|---|---|
| Múltiples perfiles | Crear y gestionar configuraciones separadas para diferentes aplicaciones o casos de uso. |
| Perfil predeterminado (Profile0) | Perfil base aplicado a cualquier aplicación sin su propio perfil. |
| Asociación de aplicación y actividad | Vincular un perfil a una o más aplicaciones (y actividades) para que se active cuando esa aplicación esté en primer plano. |
| Cambio automático de perfil | DataWedge cambia al perfil asociado cuando una aplicación está en primer plano. |
| Crear / editar / eliminar perfil | Gestionar perfiles en la aplicación de configuración de DataWedge. |
| Deshabilitar perfil | Desactivar un perfil sin eliminarlo. |
| Clonar perfil | Duplicar un perfil (sin su asociación de aplicación). |
Referencia Zebra TechDocs:
Perfiles de DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Configuración y despliegue de DataWedge
| Función | Descripción |
|---|---|
| Habilitar / deshabilitar DataWedge | Activar o desactivar el servicio DataWedge. |
| Lista de aplicaciones deshabilitadas | Suspender DataWedge para aplicaciones o actividades seleccionadas mientras están en primer plano. |
| Exportar / importar perfiles | Exportar un perfil único a un archivo e importarlo en otro dispositivo. |
| Exportar / importar configuración completa | Exportar la configuración completa de DataWedge e importarla en otros dispositivos. |
| Restaurar valores predeterminados | Devolver DataWedge a su configuración predeterminada. |
| Importación automática | DataWedge aplica automáticamente los archivos de configuración colocados en su carpeta de importación automática (ver sección 4). |
| Persistencia de configuración | La configuración se mantiene entre reinicios. |
| Interfaz de usuario de configuración | Aplicación DataWedge en el dispositivo para configuración manual. |
Referencia Zebra TechDocs:
Configuraciones de DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Control programático y herramientas
| Función | Descripción |
|---|---|
| API de Intent de DataWedge | Controlar DataWedge desde una aplicación con intents de Android, por ejemplo, cambiar perfiles, activar un escaneo suave, establecer la lista de aplicaciones deshabilitadas, consultar el estado del escáner y crear o actualizar configuraciones. |
| Aplicación DWDemo | Probar escaneo y salida de datos. |
Referencia Zebra TechDocs:
APIs de DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Comenzando
Paso 1 - Actualizar el OS
- Actualice el dispositivo a Elo Android 14 MR-9 (7.000.009.0046+gen5p) o posterior desde el portal EloView o el Panel de Control de EloView en el dispositivo. Otros usuarios de MDM pueden utilizar las funciones de Actualización Automática y Manual de Elo OEMConfig.
- Si utiliza un escáner de códigos de barras Edge Connect, conéctelo al dispositivo.
- Abra la aplicación DataWedge desde el lanzador de aplicaciones.
Paso 2 - Habilitar Profile0 y verificar
- Profile0 es el perfil de respaldo que se aplica a cada aplicación sin su propio perfil. En la versión de lanzamiento está desactivado por defecto, por lo que las aplicaciones sin su propio perfil no tienen botón de escaneo flotante y DataWedge no mantiene la cámara hasta que lo active.
- Para habilitarlo, abra Ajustes de Android Configuración Elo y active Escaneo de DataWedge (Profile0). Luego abra DWDemo, escanee un código de barras con el escáner conectado (o presione y mantenga el botón de escaneo en pantalla amarillo: con Selección de escáner en Automático utiliza el escáner USB conectado, y sin escáner USB conectado escanea con la cámara frontal), y confirme que los datos aparecen.
- Mientras el control de Configuración Elo esté en uso, la entrada Profile0 dentro de la aplicación DataWedge está deshabilitada ("deshabilitada por el administrador"); cambie Profile0 desde Configuración Elo.
- Para habilitar el escaneo sin tocar cada dispositivo, dé a su aplicación su propio perfil en lugar de depender de Profile0. Un perfil se aplica siempre que su aplicación esté enfrente, sea cual sea la configuración de Profile0. Créele en un dispositivo de referencia y envíelo a la flota con Importación Automática (Paso 5), o haga que la aplicación lo cree en el primer lanzamiento con la API de Intent SET_CONFIG de DataWedge (ver Para desarrolladores).
Paso 3 - Crear un perfil para su aplicación
- En DataWedge, abra el menú y seleccione Nuevo perfil; ingrese un nombre.
- Abra Aplicaciones asociadas y agregue el paquete de su aplicación (y, opcionalmente, actividades específicas).
- Bajo Entrada de Códigos de Barras, asegúrese de que la entrada esté habilitada y elija el dispositivo en Selección de escáner (Automático por defecto; para elegir un escáner externo específico o la cámara frontal, abra el menú y seleccione Mantener nuevo escáner). Nota: el escáner elegido en la selección de Escáner de Entrada de Códigos de Barras es el que utiliza el perfil; Configurar Parámetros del Escáner solo establece los parámetros de ese escáner.
- Bajo Decodificadores, habilite solo las simbologías que su flujo de trabajo necesita.
- Elija una salida: Salida de Pulsaciones de Tecla para aplicaciones que leen campos de texto, o Salida de Intent para aplicaciones que reciben datos de escaneo programáticamente (estabelezca la acción del intent, la categoría y el método de entrega para que coincidan con el receptor de su aplicación). Desactive la salida que no esté utilizando.
- Opcionalmente agregue prefijos, sufijos o reglas bajo Formateo de Datos Básico o Formateo de Datos Avanzado.
- Traiga su aplicación al primer plano: DataWedge cambia automáticamente al nuevo perfil.
Paso 4 - Controlar Profile0 y el botón de escaneo en pantalla
- Profile0 está desactivado por defecto, por lo que las aplicaciones sin su propio perfil no muestran botón de escaneo flotante. Enciéndalo o apáguelo desde Ajustes de Android > Configuración Elo > Escaneo de DataWedge (Profile0).
- Data Capture Plus está activado por defecto en cada nuevo perfil, por lo que el botón de escaneo flotante también aparece en aplicaciones que tienen su propio perfil. Para ocultarlo en una aplicación, abra el perfil de esa aplicación y desactive Data Capture Plus > Habilitado.
- Las aplicaciones que no deben compartir la cámara o recibir datos de escaneo - por ejemplo, aplicaciones de pago tap-to-pay / SoftPOS que detectan uso de cámara - deben ser añadidas a Ajustes > Lista de aplicaciones deshabilitadas en DataWedge, o dejar Profile0 apagado.
Paso 5 - Desplegar la configuración a su flota
- En un dispositivo de referencia configurado, abra Exportar configuración de DataWedge y exporte la configuración completa (datawedge.db) o un solo perfil (dwprofile\_<nombre>.db).
- Utilice su MDM para enviar el archivo a la carpeta de importación automática de DataWedge en los dispositivos de destino:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- DataWedge importa el archivo automáticamente y lo aplica sin un reinicio. No renombre ni edite los archivos .db exportados.
Para desarrolladores
- Utilice la API de Intent de DataWedge para cambiar perfiles, activar escaneos y crear o actualizar perfiles desde su aplicación: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Referencia de perfil y complemento: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Las aplicaciones ya integradas con DataWedge en dispositivos Android Zebra están diseñadas para no necesitar cambios en el código de escaneo para el conjunto de características de la Fase 1.
5. Recursos y Soporte
- Documentación de Zebra DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Soporte 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