Descripción técnica, para Zebra DataWedge en Elo Android I-Series 5. Compatibilidad, soporte de características y configuración (Fase 1)
Enlaces Rápidos
Versiones
| Componente | Versión |
|---|---|
| Componente | Versión |
| DataWedge | 20.0.36.139 |
| Scanner Framework | 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 vienen con Zebra DataWedge, el mismo servicio de captura de datos sin código utilizado en los dispositivos Android empresariales de Zebra.
DataWedge captura datos de un escáner de códigos de barras o cámara conectada y los entrega a la aplicación que está en primer plano - ya sea como pulsaciones de teclas, como si se hubieran escrito en un teclado, o como una intención de Android que la aplicación recibe programáticamente. Las aplicaciones no necesitan incluir código específico para el escáner o 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 es desarrollado por Zebra e integrado por Elo en la imagen del sistema operativo Android de Elo, por lo que está presente listo para usar después de la actualización MR-9; no se requiere ninguna descarga o instalación adicional.
Por qué es importante
- Reutiliza la lógica de la aplicación existente. Las aplicaciones que ya se escribieron contra los perfiles e intenciones 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 de escáner. Los datos de escaneado llegan como pulsaciones de teclas o intenciones, 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 ligados a aplicaciones; DataWedge cambia de perfil a medida que las aplicaciones pasan al primer plano, sin necesidad de acción por parte del usuario.
- Configuración repetible de flota. Una configuración construida en un dispositivo puede ser exportada e importada en otros.
2. Compatibilidad de Hardware y Plataforma
Dispositivos y sistemas operativos soportados
| Dispositivo | Chipset | Sistema Operativo |
|---|---|---|
| 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 posterior.
Disponibilidad: actualización OTA en el portal EloView el 28 de octubre de 2026; OTA predeterminada en EloView y OEMConfig a partir del 4 de noviembre de 2026.
Fuentes de entrada soportadas
| Fuente de entrada | Conexión | Notas |
|---|---|---|
| Escáneres de código de barras Elo Edge Connect | USB | Los escáneres de motor de escaneo Zebra son controlados de forma nativa por DataWedge. |
| Cámara frontal integrada | Integrada | Listada en DataWedge como Cámara Frontal. Selecciónela en el menú de selección de escáner de entrada de código de barras Agregar nuevo escáner. Disponible en I-Series 5 10", 15" y 22". |
Referencia Zebra TechDocs:
Entrada de código de barras: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Características
La Fase 1 entrega el conjunto básico de características de DataWedge para captura de códigos de barras, gestión de perfiles, entrega de datos y configuración. Las descripciones de características siguen la documentación de DataWedge de Zebra; consulte Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) para la referencia completa de parámetros.
3.1 Captura de datos
| Característica | Descripción |
|---|---|
| Entrada de código de barras | Adquirir datos de códigos de barras de escáneres USB conectados o 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ódigo de barras, abra el menú y seleccione Agregar nuevo escáner; Usar automático vuelve a la selección automática. |
| Configuración de decodor (simbología) | Habilitar o deshabilitar simbologías individuales y establecer parámetros de decodificación por perfil. |
| Data Capture Plus (disparador de escaneo en pantalla) | Designa parte de la pantalla como un disparador de escaneo virtual: presionar y mantenerlo inicia un escaneo con el escáner o cámara seleccionada del perfil, tal como lo haría un disparador de hardware. Se muestra como un botón flotante en las aplicaciones cuyo perfil tiene habilitado: está activado por defecto en nuevos perfiles, y para aplicaciones sin un perfil aparece una vez que se habilita el Perfil0 (Empezando, Paso 2). |
Referencia Zebra TechDocs:
Entrada de código 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
| Característica | Descripción |
|---|---|
| Salida de pulsaciones de teclas | Entregar los datos de escaneo como eventos de tecla en el campo enfocado de la aplicación en primer plano, incluidos caracteres de tecla de acción, retraso entre caracteres y retraso en eventos de tecla. |
| Salida de intención | Entregar datos de escaneo a una aplicación como una intención de Android (broadcast, 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 básico de datos (BDF) | Agregar un prefijo, sufijo o clave de Enter/Tab a los datos de escaneo. |
| Formateo avanzado de datos (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 Teclas: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Salida de Intención: 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
| Característica | Descripción |
|---|---|
| Múltiples perfiles | Crear y gestionar configuraciones separadas para diferentes aplicaciones o casos de uso. |
| Perfil predeterminado (Perfil0) | 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 pasa al primer plano. |
| Crear / editar / eliminar perfil | Gestionar perfiles en la aplicación de configuración DataWedge. |
| Deshabilitar perfil | Apagar 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 Configuraciones y despliegue de DataWedge
| Característica | 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 archivos de configuración colocados en su carpeta de auto-importación (ver sección 4). |
| Permanencia de configuración | La configuración se mantiene a través de 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
| Característica | Descripción |
|---|---|
| API de Intención de DataWedge | Controlar DataWedge desde una aplicación con intenciones 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 la configuración. |
| Aplicación DWDemo | Probar escaneos 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. Empezando
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 usar las funciones de Actualización Automática y Manual de Elo OEMConfig.
- Si utiliza un escáner de código 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 compilació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 sostiene la cámara hasta que la activa.
- Para habilitarlo, abra Ajustes de Android Ajustes de 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 amarillo en pantalla: 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 Ajustes de Elo esté en uso, la entrada de Profile0 dentro de la aplicación DataWedge está atenuada ("deshabilitada por admin"); cambie Profile0 desde Ajustes de Elo.
- Para habilitar el escaneo sin tocar cada dispositivo, otorgue a su aplicación su propio perfil en lugar de depender de Profile0. Un perfil se aplica siempre que su aplicación esté al frente, independientemente de la configuración de Profile0. Créelo en un dispositivo de referencia y empújelo a la flota con Importación Automática (Paso 5), o haga que la aplicación lo cree en el primer lanzamiento con el DataWedge SET_CONFIG Intent API (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ódigo de barras, asegúrese de que la entrada esté habilitada y elija el dispositivo bajo 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ódigo de Barras es el que utiliza el perfil; Configurar Ajustes de Escáner solo establece los parámetros de ese escáner.
- Bajo Decodificadores, habilite solo las simbologías que necesita su flujo de trabajo.
- Elija una salida: Salida de pulsaciones de teclas para aplicaciones que leen campos de texto, o Salida de intención para aplicaciones que reciben datos de escaneo programáticamente (establezca la acción de intención, categoría y método de entrega para coincidir con el receptor de su aplicación). Desactive la salida que no está utilizando.
- Opcionalmente agregue prefijos, sufijos o reglas bajo Formateo Básico o Formateo Avanzado de Datos.
- Traiga su aplicación al primer plano: DataWedge cambiará 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. Actívelo o desactívelo desde Ajustes de Android > Ajustes de 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 desmarque Data Capture Plus > Habilitado.
- Las aplicaciones que no deben compartir la cámara o recibir datos de escaneo - por ejemplo, tap-to-pay / aplicaciones de pago SoftPOS que detectan uso de la cámara - deben ser agregadas a Ajustes > Lista de aplicaciones deshabilitadas en DataWedge, o dejar Profile0 desactivado.
Paso 5 - Desplegar la configuración a su flota
- En un dispositivo de referencia configurado, abra Exportar Configuraciones de DataWedge y exporte la configuración completa (datawedge.db) o un perfil único (dwprofile\_<nombre>.db).
- Utilice su MDM para enviar el archivo a la carpeta de auto-importación 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 reiniciar. No renombre ni edite los archivos .db exportados.
Para desarrolladores
- Utilice el API de Intención 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 de 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 de 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