Regra de arquitetura
Use o wedge para fluxos de trabalho controlados de entrada de formulários onde o comportamento do foco é aceitável. Use intenções quando a entrega de digitalização estruturada estiver disponível e a configuração do scanner puder permanecer externa. Use o SDK quando o aplicativo precisar possuir sessões de gatilho, simbologias, modo de saída ou estado detalhado do scanner. Valide o dispositivo e firmware exatos.
Teclado: baixo código, estado oculto
O modo Wedge injeta caracteres no controle em foco e pode funcionar com aplicativos da web ou legados. É portátil no nível de entrada, mas depende do foco, layout do teclado, IME, prefixo, sufixo e tempo.
Evite que as varreduras entrem em campos de pesquisa, notas ou autenticação. Defina se Enter ou Tab será anexado e teste códigos longos, varreduras rápidas e digitação manual.
- Estado explícito do campo pronto para digitalização
- Prefixo e sufixo documentados
- IME e layout de teclado corrigidos
- Proteção contra envio duplicado
Intenção de transmissão: entrega estruturada com regras de ciclo de vida Android
A saída da intenção separa os dados digitalizados do foco do texto. O receptor pode inspecionar a ação e extras, validar a duração e encaminhar o evento para o fluxo de trabalho ativo.
Os nomes das ações, extras e requisitos do receptor variam de acordo com o fornecedor e a versão do SDK. Registre e cancele o registro com o ciclo de vida apropriado, restrinja a exposição sempre que possível e rejeite cargas inesperadas.
- Ação exata e teclas extras
- Exportação do receptor e revisão de permissão
- Comportamento em primeiro e segundo plano
- Bytes brutos versus string decodificada
Fornecedor SDK: controle explícito e acoplamento explícito
Um SDK pode abrir e fechar o scanner, selecionar o modo de saída, configurar simbologias e iniciar ou parar sessões de decodificação. Isto é apropriado quando o comportamento de varredura faz parte da máquina de estado do aplicativo.
Envolva chamadas de fornecedores por trás de uma interface de aplicativo, registre valores de retorno e torne a limpeza idempotente. Mantenha uma matriz de compatibilidade de dispositivos porque a disponibilidade de API não garante comportamento idêntico de mecanismo ou firmware.
- Adaptador fornecido pelo fornecedor API
- Abrir, iniciar, parar e fechar propriedade
- Leitura de configuração quando disponível
- Estados de falha e tempo limite visíveis
Valide a integridade e o ciclo de vida dos dados
Teste a inicialização a frio, a retomada, o bloqueio de tela, a alternância de aplicativos, a rotação, se houver suporte, a reinicialização, o modo quiosque MDM e os gatilhos rápidos e repetidos. Confirme se cada verificação física cria um evento de negócios pretendido.
Use sequências de bytes conhecidas para caracteres não-ASCII e de controle. Decida se o aplicativo armazena bytes brutos, texto decodificado, simbologia e carimbo de data/hora. Evite registrar valores digitalizados confidenciais.
- Uma varredura equivale a uma transação
- Nenhuma varredura vai para a tela errada
- Codificação e comprimento verificados
- A recuperação não precisa de reinicialização do dispositivo
Cunha vs intenção vs SDK
Escolha o nível mínimo de integração que ainda fornece o controle necessário.
| Critério | Cunha do teclado | Intenção de transmissão | Fornecedor SDK |
|---|---|---|---|
| Esforço de implementação | Baixo | Médio | Médio a alto |
| Dependência de foco | Alto | Baixo | Baixo |
| Controle do scanner | Principalmente configuração externa | Externo ou limitado | Propriedade do aplicativo |
| Estrutura de dados | Personagens e sufixo | Extras nomeados | API evento ou transmissão |
| Portabilidade | Portabilidade em nível de entrada | Mapeamento de ações do fornecedor | Adaptador do fornecedor API necessário |
Lista de verificação de validação de integração
Registre os resultados por dispositivo, sistema operacional, firmware, SDK e construção de aplicativo.
- 01
Somente o modo de saída pretendido está ativo
- 02
Comportamento de foco e sufixo testado para cunha
- 03
Ação intencional e extras validados
- 04
Ciclo de vida e exposição do receptor revisados
- 05
SDK valores de retorno de abertura e fechamento manipulados
- 06
Eventos de disparo rápido e duplicados testados
- 07
Suspensão, retomada, reinicialização e troca de aplicativos testadas
- 08
Codificação e cargas longas verificadas
- 09
Dados restritos excluídos dos registros
- 10
Reversão e redefinição de configuração documentadas
Perguntas frequentes
A cunha do teclado é confiável o suficiente para produção?
Pode ser quando o fluxo de trabalho controla rigidamente o foco, a configuração do teclado, o sufixo e o envio duplicado. Valide todas as telas que podem receber entrada.
As intenções do scanner Android são padronizadas?
Não. Os nomes das ações de transmissão, extras, configurações e permissões podem variar de acordo com o fornecedor do dispositivo e a versão do SDK.
Um aplicativo deve sempre usar o fornecedor SDK?
Não. Use-o quando o aplicativo precisar de controle do scanner ou estado que o wedge e as intenções configuradas não podem fornecer. O SDK adiciona ciclo de vida e trabalho de compatibilidade.
Evidências e limitações
Orientação de arquitetura de engenharia/comportamento exato requer validação do dispositivo
Os princípios da plataforma Android são combinados com evidências de UROVO SDK ; nenhuma equivalência entre fornecedores API é reivindicada.
Revisado: 2026-08-10
- Documentação do desenvolvedor Android : eventos de entrada e receptores de transmissão
- RuggedLayer aprovou UROVO Android SDK referência v4.1.0326 API referência
