Règle d'architecture
Utilisez Wedge pour les flux de travail de saisie de formulaire contrôlés où le comportement de focus est acceptable. Utilisez des intentions lorsque la livraison d’analyse structurée est disponible et que la configuration du scanner peut rester externe. Utilisez le SDK lorsque l'application doit posséder des sessions de déclenchement, des symbologies, un mode de sortie ou un état détaillé du scanner. Validez l’appareil et le micrologiciel exacts.
Coin clavier : low code, état caché
Le mode Wedge injecte des caractères dans le contrôle ciblé et peut fonctionner avec des applications Web ou héritées. Il est portable au niveau de l'entrée mais dépend de la mise au point, de la disposition du clavier, de l'IME, du préfixe, du suffixe et du timing.
Empêchez les analyses d'entrer dans les champs de recherche, de notes ou d'authentification. Définissez si Entrée ou Tab est ajouté et testez les codes longs, les analyses rapides et la saisie manuelle.
- État du champ prêt à l'analyse explicite
- Préfixe et suffixe documentés
- IME et disposition du clavier corrigés
- Protection contre les soumissions en double
Intention de diffusion : diffusion structurée avec Android règles de cycle de vie
La sortie d’intention sépare les données numérisées du focus texte. Le destinataire peut inspecter l'action et les extras, valider la durée et acheminer l'événement vers le flux de travail actif.
Les noms d'action, les extras et les exigences du récepteur varient selon le fournisseur et la version de SDK. Enregistrez-vous et désinscrivez-vous avec le cycle de vie approprié, limitez l'exposition lorsque cela est possible et rejetez les charges utiles inattendues.
- Action exacte et touches supplémentaires
- Exportation du récepteur et examen des autorisations
- Comportement au premier plan et en arrière-plan
- Octets bruts par rapport à la chaîne décodée
Fournisseur SDK : contrôle explicite et couplage explicite
Un SDK peut ouvrir et fermer le scanner, sélectionner le mode de sortie, configurer les symbologies et démarrer ou arrêter les sessions de décodage. Ceci est approprié lorsque le comportement d’analyse fait partie de la machine à états de l’application.
Enveloppez les appels du fournisseur derrière une interface d’application, enregistrez les valeurs de retour et rendez le nettoyage idempotent. Conservez une matrice de compatibilité des appareils, car la disponibilité de API ne garantit pas un comportement identique du moteur ou du micrologiciel.
- Adaptateur autour du fournisseur API
- Ouvrir, démarrer, arrêter et fermer la propriété
- Relecture de la configuration si disponible
- États d’échec et d’expiration visibles
Valider l’intégrité et le cycle de vie des données
Testez le démarrage à froid, la reprise, le verrouillage de l'écran, le changement d'application, la rotation si pris en charge, le redémarrage, le mode kiosque MDM et les déclenchements répétés rapides. Confirmez que chaque analyse physique crée un événement commercial prévu.
Utilisez des séquences d'octets connues pour les caractères non-ASCII et de contrôle. Décidez si l'application stocke les octets bruts, le texte décodé, la symbologie et l'horodatage. Évitez de consigner les valeurs numérisées sensibles.
- Un scan équivaut à une transaction
- Aucune analyse ne renvoie vers le mauvais écran
- Encodage et longueur vérifiés
- La récupération ne nécessite aucun redémarrage de l'appareil
Coin, intention et SDK
Choisissez le niveau d'intégration minimum qui offre toujours le contrôle requis.
| Critère | Cale de clavier | Intention de diffusion | Fournisseur SDK |
|---|---|---|---|
| Effort de mise en œuvre | Faible | Moyen | Moyen à élevé |
| Dépendance au focus | Élevé | Faible | Faible |
| Contrôle du scanner | Configuration principalement externe | Externe ou limité | Propriété de l'application |
| Structure des données | Caractères et suffixe | Extras nommés | API événement ou diffusion |
| Portabilité | Portabilité au niveau de l'entrée | Cartographie des actions des fournisseurs | Adaptateur du fournisseur API requis |
Liste de contrôle de validation de l'intégration
Enregistrez les résultats par appareil, système d'exploitation, micrologiciel, SDK et version de l'application.
- 01
Seul le mode de sortie prévu est actif
- 02
Comportement du focus et du suffixe testé pour le coin
- 03
Intention d'action et extras validés
- 04
Cycle de vie et exposition du récepteur examinés
- 05
SDK valeurs de retour d'ouverture et de fermeture gérées
- 06
Déclenchement rapide et événements en double testés
- 07
Mise en veille, reprise, redémarrage et changement d'application testés
- 08
Encodage et charges utiles longues vérifiées
- 09
Données restreintes exclues des journaux
- 10
Rollback et réinitialisation de la configuration documentés
Questions fréquemment posées
Le coin clavier est-il suffisamment fiable pour la production ?
Cela peut se produire lorsque le flux de travail contrôle étroitement le focus, la configuration du clavier, le suffixe et la soumission en double. Validez chaque écran pouvant recevoir des entrées.
Les intentions du scanner Android sont-elles standardisées ?
Non. Les noms des actions de diffusion, les extras, la configuration et les autorisations peuvent différer selon le fournisseur de l'appareil et la version de SDK.
Une application doit-elle toujours utiliser le fournisseur SDK ?
Non. Utilisez-le lorsque l'application a besoin du contrôle du scanner ou indique que le coin et les intentions configurées ne peuvent pas fournir. Le SDK ajoute un travail de cycle de vie et de compatibilité.
Preuves et limites
Les conseils sur l'architecture d'ingénierie/le comportement exact nécessitent une validation de l'appareil
Les principes de la plate-forme Android sont combinés avec les preuves de UROVO SDK ; aucune équivalence entre fournisseurs API n'est revendiquée.
Révisé: 2026-08-10
- Documentation du développeur Android : événements d'entrée et récepteurs de diffusion
- RuggedLayer approuvé UROVO Android SDK v4. 1.0326 API référence
