Visão técnica, para Zebra DataWedge na Elo Android I-Series 5. Compatibilidade, suporte a recursos e configuração (Fase 1)
Links Rápidos
Versões
| Componente | Versão |
|---|---|
| Componente | Versão |
| DataWedge | 20.0.36.139 |
| Framework de Scanner | 43.63.56.0 |
| Mínimo Elo OS | Elo Android 14 MR-9, 7.000.009.0046+gen5p |
1. Visão Geral
A partir do lançamento do sistema operacional Android 14 MR-9, os dispositivos Elo I-Series 5 são fornecidos com Zebra DataWedge, o mesmo serviço de captura de dados sem código utilizado em todos os dispositivos Android empresariais da Zebra.
DataWedge captura dados de um scanner de código de barras ou câmera conectada e entrega esses dados para o aplicativo que está em primeiro plano - seja como toques de teclas, como se digitado em um teclado, ou como um intent do Android que o aplicativo recebe programaticamente. Os aplicativos não precisam incluir código específico para scanners ou um SDK específico da Elo para receber dados de digitalização.
Esta é a primeira integração de plataforma de software entregue em conjunto pela Elo e Zebra. DataWedge é desenvolvido pela Zebra e integrado pela Elo na imagem do sistema operacional Android da Elo, portanto, está presente assim que a atualização MR-9 é feita - nenhum download ou sideload separado é necessário.
Por que é importante
- Reutilizar a lógica existente do aplicativo. Aplicações já escritas para perfis e intents do DataWedge em dispositivos Zebra foram projetadas para funcionar no Elo I-Series 5 sem reescrever sua integração de digitalização.
- Nenhum SDK de scanner necessário. Os dados de digitalização chegam como toques de teclas ou intents, portanto, novos aplicativos podem suportar digitalização sem integrar um SDK específico para o dispositivo.
- Comportamento por aplicativo, automaticamente. Perfis estão vinculados a aplicativos; o DataWedge troca de perfis conforme os aplicativos entram em primeiro plano, sem ação do usuário.
- Configuração de frota repetível. Uma configuração criada em um dispositivo pode ser exportada e importada em outros.
2. Compatibilidade de Hardware e Plataforma
Dispositivos e OS suportados
| Dispositivo | Chipset | OS |
|---|---|---|
| Elo I-Series 5 10", 15" e 22" | Qualcomm QCS6490 | Android 14 |
Mínimo OS: Elo Android 14 MR-9, versão 7.000.009.0046+gen5p ou posterior.
Disponibilidade: atualização por OTA no portal EloView em 28 de outubro de 2026; OTA padrão no EloView e OEMConfig a partir de 4 de novembro de 2026.
Fontes de entrada suportadas
| Fonte de entrada | Conexão | Anotações |
|---|---|---|
| Scanners de código de barras Elo Edge Connect | USB | Scanners de motores de leitura Zebra são acionados nativamente pelo DataWedge. |
| Câmera frontal integrada | Integrado | Listada no DataWedge como Câmera Frontal. Selecione-a no menu de seleção de Scanner de Entrada de Código de Barras Adicionar novo scanner. Disponível no I-Series 5 10", 15" e 22". |
Referência Zebra TechDocs:
Entrada de Código de Barras: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
3. Recursos
A Fase 1 entrega o conjunto central de recursos do DataWedge para captura de códigos de barras, gerenciamento de perfis, entrega de dados e configuração. As descrições dos recursos seguem a documentação do DataWedge da Zebra; consulte Zebra TechDocs (https://techdocs.zebra.com/datawedge/latest/guide/about/) para referência completa de parâmetros.
3.1 Captura de dados
| Recurso | Descrição |
|---|---|
| Entrada de Código de Barras | Adquirir dados de código de barras de scanners USB conectados ou de uma câmera. |
| Digitalização por Câmera | Digitalizar códigos de barras com uma câmera através do visor do DataWedge. |
| Plug-in de Entrada de Scanner | Controlar o hardware do scanner, parâmetros do decodificador e parâmetros do leitor. |
| Seleção de Scanner | Automático por padrão. Para usar um scanner externo específico ou a câmera frontal, abra a seleção de Scanner de Entrada de Código de Barras, abra o menu e selecione Adicionar novo scanner; Usar automático retorna à seleção automática. |
| Configuração do Decodificador (simbologia) | Ativar ou desativar simbologias individuais e definir parâmetros do decodificador por perfil. |
| Data Capture Plus (gatilho de digitalização na tela) | Designa parte da tela como um gatilho virtual de digitalização: pressioná-la e segurá-la inicia uma digitalização com o scanner ou a câmera selecionada do perfil, assim como um gatilho físico faria. Mostrado como um botão flutuante em aplicativos cujo perfil o tem habilitado: está ativado por padrão em novos perfis, e para aplicativos que não possuem um perfil, aparece uma vez que o Profile0 é ativado (Começando, Passo 2). |
Referência 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 e formatação de dados
| Recurso | Descrição |
|---|---|
| Saída de Toques de Teclado | Entregar dados de digitalização como eventos de tecla no campo focado do aplicativo em primeiro plano, incluindo caracteres de tecla de ação, atraso entre caracteres e atraso de eventos de tecla. |
| Saída de Intent | Entregar dados de digitalização para um aplicativo como um intent do Android (broadcast, iniciar atividade ou iniciar serviço) com ação e categoria configuráveis. Os dados chegam em extras padrão do DataWedge, como com.symbol.datawedge.data_string e com.symbol.datawedge.label_type. |
| Formatação Básica de Dados (BDF) | Adicionar um prefixo, sufixo, ou tecla Enter/Tab aos dados de digitalização. |
| Formatação Avançada de Dados (ADF) | Formatação baseada em regras condicionada a simbologia, comprimento, ou conteúdo. |
| Análise de GS1 / GS1 Digital Link | Analisar e ordenar Identificadores de Aplicação GS1 na saída. |
Referência Zebra TechDocs:
Saída de Toques de Teclado: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
Saída 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 Gerenciamento de Perfis
| Recurso | Descrição |
|---|---|
| Múltiplos perfis | Criar e gerenciar configurações separadas para diferentes aplicativos ou casos de uso. |
| Perfil padrão (Profile0) | Perfil base aplicado a qualquer aplicativo sem seu próprio perfil. |
| Associação de aplicativo e atividade | Vincular um perfil a um ou mais aplicativos (e atividades) para que ele ative quando esse aplicativo estiver em primeiro plano. |
| Troca automática de perfil | O DataWedge troca para o perfil associado quando um aplicativo entra em primeiro plano. |
| Criar / editar / excluir perfil | Gerenciar perfis no aplicativo de configuração do DataWedge. |
| Desabilitar perfil | Desligar um perfil sem excluí-lo. |
| Clone perfil | Duplicar um perfil (sem sua associação de aplicativo). |
Referência Zebra TechDocs:
Perfis do DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
3.4 Configurações e implantação do DataWedge
| Recurso | Descrição |
|---|---|
| Ativar / desativar DataWedge | Ativar ou desativar o serviço DataWedge. |
| Lista de aplicativos desabilitados | Suspender o DataWedge para aplicativos ou atividades selecionadas enquanto estão em primeiro plano. |
| Exportar / importar perfis | Exportar um único perfil para um arquivo e importá-lo em outro dispositivo. |
| Exportar / importar configuração completa | Exportar a configuração completa do DataWedge e importá-la em outros dispositivos. |
| Restaurar padrões | Retornar o DataWedge para sua configuração padrão. |
| Importação Automática | O DataWedge aplica automaticamente arquivos de configuração colocados em sua pasta de importação automática (veja a seção 4). |
| Persistência da configuração | A configuração é mantida entre reinicializações. |
| Interface do usuário de configuração | Aplicativo DataWedge no dispositivo para configuração manual. |
Referência Zebra TechDocs:
Configurações do DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/settings/
3.5 Controle programático e ferramentas
| Recurso | Descrição |
|---|---|
| API Intent do DataWedge | Controlar o DataWedge a partir de um aplicativo com intents do Android - por exemplo, trocar perfis, disparar uma digitalização, configurar a lista de aplicativos desabilitados, consultar o status do scanner e criar ou atualizar a configuração. |
| Aplicativo DWDemo | Testar digitalização e saída de dados. |
Referência Zebra TechDocs:
APIs do DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/
4. Começando
Passo 1 - Atualizar o OS
- Atualize o dispositivo para Elo Android 14 MR-9 (7.000.009.0046+gen5p) ou posterior através do portal EloView ou do Painel de Controle EloView no dispositivo. Outros usuários de MDM podem usar os recursos de Atualização Automática e Manual do Elo OEMConfig.
- Se você usar um scanner de código de barras Edge Connect, conecte-o ao dispositivo.
- Abra o aplicativo DataWedge a partir do iniciador de aplicativos.
Passo 2 - Ativar o Profile0 e verificar
- Profile0 é o perfil padrão que se aplica a todos os aplicativos sem seu próprio perfil. Na versão de release, ele está desativado por padrão, então os aplicativos sem seu próprio perfil não recebem o botão de digitalização flutuante e o DataWedge não mantém a câmera até que você o ative.
- Para ativá-lo, abra Configurações do Android > Configurações Elo e ative Digitalização DataWedge (Profile0). Em seguida, abra DWDemo, digitalize um código de barras com o scanner conectado (ou pressione e mantenha o botão de digitalização amarelo na tela: com Seleção de Scanner em Automático ele usa o scanner USB conectado, e sem scanner USB conectado, digitaliza com a câmera frontal) e confirme que os dados aparecem.
- Enquanto o controle de Configurações Elo estiver em uso, a entrada Profile0 dentro do aplicativo DataWedge estará desativada ("desabilitada pelo admin"); altere o Profile0 a partir das Configurações Elo.
- Para ativar a digitalização sem tocar em cada dispositivo, forneça ao seu aplicativo seu próprio perfil em vez de depender do Profile0. Um perfil se aplica sempre que seu aplicativo está à frente, independentemente da configuração do Profile0. Crie-o em um dispositivo de referência e envie-o para a frota com Importação Automática (Passo 5), ou faça com que o aplicativo o crie no primeiro lançamento com o API Intent SET_CONFIG do DataWedge (veja Para desenvolvedores).
Passo 3 - Criar um perfil para seu aplicativo
- No DataWedge, abra o menu e selecione Novo perfil; insira um nome.
- Abra Aplicativos associados e adicione o pacote do seu aplicativo (e, opcionalmente, atividades específicas).
- Sob Entrada de Código de Barras, certifique-se de que a entrada esteja habilitada e escolha o dispositivo sob Seleção de Scanner (Automático por padrão; para escolher um scanner externo específico ou a câmera frontal, abra o menu e selecione Manter novo scanner). Nota: o scanner escolhido na seleção de Scanner de Entrada de Código de Barras é aquele que o perfil usa; Configurar Configurações do Scanner apenas define os parâmetros daquele scanner.
- Sob Decodificadores, habilite apenas as simbologias necessárias para seu fluxo de trabalho.
- Escolha uma saída: Saída de Toques de Teclado para aplicativos que leem campos de texto, ou Saída de Intent para aplicativos que recebem dados de digitalização programaticamente (defina a ação do intent, categoria e método de entrega para corresponder ao receptor do seu aplicativo). Desative a saída que você não está usando.
- Opcionalmente, adicione prefixos, sufixos ou regras sob Formatação Básica ou Formatação Avançada de Dados.
- Traga seu aplicativo para o primeiro plano - o DataWedge troca para o novo perfil automaticamente.
Passo 4 - Controlar o Profile0 e o botão de digitalização na tela
- O Profile0 está desativado por padrão, então aplicativos sem seu próprio perfil não exibem botão de digitalização flutuante. Ative-o ou desative-o em Configurações do Android > Configurações Elo > Digitalização DataWedge (Profile0).
- O Data Capture Plus está ativado por padrão em cada novo perfil, então o botão de digitalização flutuante também aparece em aplicativos que têm seu próprio perfil. Para ocultá-lo para um aplicativo, abra o perfil desse aplicativo e desmarque Data Capture Plus > Ativado.
- Aplicativos que não devem compartilhar a câmera ou receber dados de digitalização - por exemplo, aplicativos de pagamento tap-to-pay / SoftPOS que detectam o uso da câmera - devem ser adicionados à Configurações > Lista de aplicativos desabilitados no DataWedge, ou o Profile0 deve ser deixado desativado.
Passo 5 - Implantar a configuração para sua frota
- Em um dispositivo de referência configurado, abra Exportar Configurações do DataWedge e exporte a configuração completa (datawedge.db) ou um único perfil (dwprofile\_<name>.db).
- Use seu MDM para enviar o arquivo para a pasta de importação automática do DataWedge nos dispositivos de destino:
/storage/emulated/0/Android/data/com.symbol.datawedge/files/autoimport
- O DataWedge importa o arquivo automaticamente e o aplica sem reinicialização. Não renomeie ou edite arquivos .db exportados.
Para desenvolvedores
- Use a API Intent do DataWedge para alternar perfis, disparar digitalizações e criar ou atualizar perfis a partir de seu aplicativo: https://techdocs.zebra.com/datawedge/latest/guide/api/
- Referência de perfil e plug-in: https://techdocs.zebra.com/datawedge/latest/guide/profiles/
- Aplicativos já integrados com o DataWedge em dispositivos Zebra Android são projetados para não necessitar de alterações no código de digitalização para o conjunto de recursos da Fase 1.
5. Recursos e Suporte
- Documentação do Zebra DataWedge: https://techdocs.zebra.com/datawedge/latest/guide/about/
- Suporte 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