Regola dell'architettura
Utilizza Wedge per flussi di lavoro di immissione moduli controllati in cui il comportamento di messa a fuoco è accettabile. Utilizza gli intenti quando è disponibile la consegna della scansione strutturata e la configurazione dello scanner può rimanere esterna. Utilizza SDK quando l'app deve possedere sessioni di trigger, simbologie, modalità di output o stato dettagliato dello scanner. Convalidare il dispositivo e il firmware esatti.
Cuneo della tastiera: codice basso, stato nascosto
La modalità Wedge inserisce i caratteri nel controllo focalizzato e può funzionare con app Web o legacy. È portabile a livello di input ma dipende dal focus, dal layout della tastiera, dall'IME, dal prefisso, dal suffisso e dai tempi.
Impedisci alle scansioni di inserire campi di ricerca, note o autenticazione. Definisci se aggiungere Invio o Tab e prova codici lunghi, scansioni rapide e digitazione manuale.
- Stato esplicito del campo pronto per la scansione
- Prefisso e suffisso documentati
- IME e layout della tastiera corretti
- Protezione dall'invio duplicato
Intento di trasmissione: consegna strutturata con regole del ciclo di vita Android.
L'output dell'intento separa i dati di scansione dal focus del testo. Il destinatario può ispezionare l'azione e gli extra, convalidare la durata e indirizzare l'evento al flusso di lavoro attivo.
I nomi delle azioni, gli extra e i requisiti del destinatario variano in base al fornitore e alla versione di SDK. Registrarsi e annullare la registrazione con il ciclo di vita appropriato, limitare l'esposizione ove possibile e rifiutare payload imprevisti.
- Azione esatta e tasti extra
- Esportazione del destinatario e revisione delle autorizzazioni
- Comportamento in primo piano e in secondo piano
- Byte grezzi e stringa decodificata
Fornitore SDK: controllo esplicito e accoppiamento esplicito
Un SDK può aprire e chiudere lo scanner, selezionare la modalità di output, configurare simbologie e avviare o interrompere le sessioni di decodifica. Ciò è appropriato quando il comportamento di scansione fa parte della macchina a stati dell'applicazione.
Racchiude le chiamate dei fornitori in un'interfaccia applicativa, registra i valori restituiti e rende la pulizia idempotente. Conserva una matrice di compatibilità del dispositivo perché la disponibilità di API non garantisce il comportamento identico del motore o del firmware.
- Adattatore attorno al fornitore API
- Apri, avvia, ferma e chiudi la proprietà
- Rilettura della configurazione ove disponibile
- Stati di errore e timeout visibili
Convalidare l'integrità e il ciclo di vita dei dati
Testa l'avvio a freddo, la ripresa, il blocco dello schermo, il cambio di app, la rotazione se supportata, il riavvio, la modalità kiosk MDM e i trigger ripetuti rapidi. Conferma che ogni scansione fisica crea un evento aziendale previsto.
Utilizza sequenze di byte note per caratteri non ASCII e di controllo. Decidi se l'applicazione memorizza byte grezzi, testo decodificato, simbologia e timestamp. Evitare di registrare valori scansionati sensibili.
- Una scansione equivale a una transazione
- Nessuna scansione va alla schermata sbagliata
- Codifica e lunghezza verificate
- Il ripristino non richiede il riavvio del dispositivo
Cuneo, intenzione e SDK
Scegli il livello di integrazione minimo che offra comunque il controllo richiesto.
| Criterio | Cuneo della tastiera | Intento di trasmissione | Venditore SDK |
|---|---|---|---|
| Sforzo di implementazione | Basso | Medio | Da medio ad alto |
| Dipendenza dal focus | Alto | Basso | Basso |
| Controllo dello scanner | Per lo più configurazione esterna | Esterno o limitato | Di proprietà dell'applicazione |
| Struttura dei dati | Caratteri e suffisso | Extra nominati | API evento o trasmissione |
| Portabilità | Portabilità a livello di input | Mappatura delle azioni del fornitore | È richiesto l'adattatore del fornitore API. |
Elenco di controllo per la convalida dell'integrazione
Registra i risultati per dispositivo, sistema operativo, firmware, SDK e build dell'applicazione.
- 01
È attiva solo la modalità di output prevista
- 02
Comportamento del focus e del suffisso testato per wedge
- 03
Azione di intenti ed extra convalidati
- 04
Revisione del ciclo di vita e dell'esposizione del ricevitore
- 05
SDK valori restituiti di apertura e chiusura gestiti
- 06
Trigger rapido ed eventi duplicati testati
- 07
Testato per modalità di sospensione, ripresa, riavvio e cambio app
- 08
Codifica e payload lunghi verificati
- 09
Dati riservati esclusi dai log
- 10
Rollback e ripristino della configurazione documentati
Domande frequenti
Il Keyboard Wedge è sufficientemente affidabile per la produzione?
Può accadere quando il flusso di lavoro controlla strettamente il focus, la configurazione della tastiera, il suffisso e l'invio duplicato. Convalidare ogni schermata che può ricevere input.
Gli intenti dello scanner Android sono standardizzati?
No. I nomi delle azioni di trasmissione, gli extra, la configurazione e le autorizzazioni possono variare in base al fornitore del dispositivo e alla versione di SDK.
Un'app dovrebbe utilizzare sempre il fornitore SDK?
No. Usalo quando l'applicazione necessita del controllo dello scanner o dello stato che gli intenti wedge e configurati non possono fornire. SDK aggiunge lavoro sul ciclo di vita e sulla compatibilità.
Prove e limiti
Le indicazioni sull'architettura ingegneristica/il comportamento esatto richiedono la convalida del dispositivo
I principi della piattaforma Android sono combinati con le prove UROVO SDK ; non viene rivendicata alcuna equivalenza tra fornitori API.
Recensito: 2026-08-10
- Android documentazione per sviluppatori: eventi di input e ricevitori di trasmissione
- RuggedLayer ha approvato UROVO Android SDK v4.1.0326 API riferimento
