Questo articolo spiega come utilizzare la Configurazione Locale con EloView® WebApps e WebViewController (WVC) per applicare impostazioni avanzate di configurazione del browser e del chiosco direttamente su un dispositivo Elo Android.
La Configurazione Locale consente a WebViewController (WVC) di utilizzare le impostazioni di configurazione memorizzate localmente su un dispositivo Elo Android quando WVC viene avviato. Queste impostazioni possono fornire ulteriori opzioni di configurazione oltre a quelle disponibili attraverso il portale EloView.
⚠ Importante
Attivare Configurazione Locale in EloView informa WebViewController di cercare un file di configurazione locale. Non crea, scarica o copia il file di configurazione sul dispositivo. Il cliente o l'amministratore deve creare il file di configurazione e posizionarlo in una posizione supportata sul dispositivo Elo Android fisico.
Panoramica
WebViewController può ricevere informazioni di configurazione in due modi:
-
File di configurazione locale – WVC legge un file di configurazione supportato memorizzato nella directory radice
/sdcard/sul dispositivo. - Intents Android – Un'applicazione Android personalizzata può avviare WVC e fornire informazioni di configurazione programmaticamente.
Il valore booleano readLocalConfig extra dell'Intent determina se WebViewController tenta di utilizzare un file di configurazione locale invece delle impostazioni dell'Intent launchContentSetting.
| readLocalConfig | Comportamento |
|---|---|
true |
Richiede a WVC di utilizzare un file di configurazione locale supportato e ignorare launchContentSetting. |
false |
WVC può ricevere la sua configurazione di avvio tramite launchContentSetting. |
Prima di Iniziare
ℹ Prima di Iniziare
Determinare quali impostazioni di WebViewController sono necessarie per il tuo progetto prima di creare il file di configurazione.
Elo consiglia di includere solo le impostazioni che intendi modificare. Lascia le altre impostazioni nel loro comportamento attuale o predefinito.
Attivare la Configurazione Locale in EloView
Quando configuri il contenuto dell'app Web in EloView, attiva la Configurazione Locale dalle proprietà del contenuto:
- Nel portale EloView, apri l'elemento di contenuto WebApp applicabile.
- Naviga a Dettagli Contenuto > Proprietà Contenuto.
- Sotto Impostazioni Browser, trova Configurazione Locale.
- Imposta Configurazione Locale su Abilitato (Attivo).
- Salva o applica la configurazione.
⚠ Importante
Attivare questa impostazione non crea o distribuisce il file di configurazione. Il file di configurazione deve comunque essere creato e copiato nella posizione supportata sul dispositivo di destinazione.
Creare e Posizionare il File di Configurazione Locale
WebViewController supporta file di configurazione in formato Java properties e JSON. Posiziona il file di configurazione direttamente nella directory radice /sdcard/ utilizzando uno dei nomi di file supportati di seguito.
| Precedenza | Percorso del File Supportato | Formato |
|---|---|---|
| 1 – Maggiore | /sdcard/wvc_config.properties |
Java Properties |
| 2 | /sdcard/wvc_config.prop |
Java Properties |
| 3 – Inferiore | /sdcard/wvc_config.json |
JSON |
ℹ Precedenza dei File
Se esistono più file di configurazione supportati sul dispositivo, WebViewController utilizza il file con la priorità più alta. Ad esempio, wvc_config.properties ha la precedenza su wvc_config.prop e wvc_config.json.
⚠ Requisito del Percorso di Archiviazione
Il file deve essere posizionato direttamente sotto /sdcard/. Un file memorizzato in una sottocartella come /sdcard/Download/ è un percorso diverso e non è uno dei percorsi supportati documentati per la Configurazione Locale.
Impostazioni di Configurazione di WebViewController
La Configurazione Locale supporta una gamma di impostazioni di WebViewController. I valori booleani utilizzano true o false. I valori stringa sono racchiusi tra virgolette in JSON e inseriti come valori di testo in un file di proprietà Java.
Impostazioni del Browser e della Sessione
| Impostazione | Tipo | Descrizione |
|---|---|---|
viewMode |
String | Usa Full View per schermo intero. Altri valori utilizzano la Vista Form. |
layerType |
String |
HW abilita l'accelerazione hardware. Altri valori utilizzano SW. L'accelerazione hardware è consigliata nella documentazione per sviluppatori per la riproduzione video. |
pinchZoom |
Boolean | Abilita il pinch-to-zoom. |
homePageTimeout |
String | Numero di minuti di inattività prima di tornare alla home page. 0, mai o un valore omesso significa senza timeout. |
clearUserDataOnTimeout |
Boolean | Cancella i dati utente quando si verifica il timeout della home page. |
clearCookiesOnTimeout |
Boolean | Cancella i cookie quando si verifica il timeout della home page. |
ssl |
Boolean | Abilita SSL. |
userAgent |
String | Imposta la stringa User-Agent. |
virtualKeyboard |
Boolean | Imposta su false per disabilitare la tastiera virtuale. |
disableDownload |
Boolean | Imposta su true per disabilitare i download. Questo disabilita anche PDF. |
showLoadingBar |
Boolean | Mostra la barra di caricamento in alto dello schermo. |
Impostazioni della Barra di Navigazione
| Impostazione | Tipo | Descrizione |
|---|---|---|
showNavBar |
Boolean | Mostra la barra di navigazione Home, Indietro e Avanti in fondo allo schermo. |
navBarBackgroundColor |
String | Colore della barra di navigazione utilizzando formato #RRGGBB o #AARRGGBB. |
navBarAccentColor |
String | Colore d'accento della barra di navigazione. |
Impostazioni della Barra delle Azioni
| Impostazione | Tipo | Descrizione |
|---|---|---|
showActionBar |
Boolean | Mostra la Barra delle Azioni in alto nello schermo. |
actionBarBackgroundColor |
String | Colore di sfondo della Barra delle Azioni. |
actionBarBackgroundUrl |
String | URL di un'immagine utilizzata come sfondo della Barra delle Azioni. |
actionBarAccentColor |
String | Colore d'accento della Barra delle Azioni. |
showActionBarLogo |
Boolean | Mostra il logo sul lato sinistro della Barra delle Azioni. |
actionBarLogoIconUrl |
String* | URL di un'immagine utilizzata come icona della Barra delle Azioni. |
showActionBarTitle |
Boolean | Mostra il titolo della pagina web nella Barra delle Azioni. |
showActionBarSubtitle |
Boolean | Mostra il sottotitolo della pagina web nella Barra delle Azioni. |
showActionBarPrintBtn |
Boolean | Mostra il pulsante Stampa. |
showActionBarShareBtn |
Boolean | Mostra il pulsante Condividi. |
showActionBarInfoBtn |
Boolean | Mostra il pulsante Informazioni. |
ℹ Nota sulla Documentazione
La documentazione degli sviluppatori descrive actionBarLogoIconUrl come un URL anche se nella sua tabella di origine il tasto è etichettato come Boolean. Poiché l'impostazione rappresenta un URL, viene mostrata come String in questo articolo. Verifica il comportamento con il pacchetto WebViewController utilizzato sul dispositivo di destinazione.
Impostazioni PDF
| Impostazione | Tipo | Descrizione |
|---|---|---|
pdfSupport |
Boolean | Abilita la visualizzazione dei PDF. |
pdfHyperlinkSupport |
Boolean | Abilita i collegamenti ipertestuali all'interno dei PDF. |
pdfSwipeHorizontal |
Boolean | Abilita lo scorrimento orizzontale dei PDF quando impostato su true. |
pdfShowScrollHandle |
Boolean | Mostra una maniglia di scorrimento durante lo scorrimento dei PDF. |
pdfFitToHeight |
Boolean | Adatta il PDF all'altezza dello schermo invece che alla larghezza. |
Esempio di Configurazione JSON
Il seguente esempio abbreviato dimostra la struttura di un file wvc_config.json. Seleziona solo le impostazioni e i valori appropriati per il tuo progetto.
{
"contentpath": "https://example.com",
"viewMode": "Full View",
"layerType": "HW",
"pinchZoom": true,
"homePageTimeout": "0",
"showNavBar": true,
"pdfSupport": true
}Salva il file utilizzando uno dei nomi di file supportati direttamente sotto /sdcard/. Quando utilizzi un file di configurazione locale, avvia WebViewController con readLocalConfig impostato su true.
Configurare WebViewController Utilizzando gli Intents Android
WebViewController può essere avviato e configurato anche programmaticamente tramite gli Intents Android. Questo fornisce un'alternativa all'uso di un file di configurazione memorizzato sul dispositivo.
Ad esempio, dopo l'installazione di WebViewController, un'applicazione agente del dispositivo personalizzata può inviare gli Intents appropriati per controllare WVC come parte del flusso di lavoro del dispositivo.
| Intent Extra | Tipo | Scopo |
|---|---|---|
contentPath |
String | URL della home page che inizia con http://, https:// o file://. |
readLocalConfig |
Boolean | Quando è true, richiede a WVC di ignorare launchContentSetting e utilizzare un file di configurazione locale supportato. |
launchContentSetting |
String | Oggetto JSON contenente opzioni di avvio come modalità di visualizzazione, barre di navigazione, comportamento di timeout, comportamento PDF e altre impostazioni supportate. |
⚠ Importante – Nomi dei Parametri Intent
La documentazione per gli sviluppatori identifica l'extra Intent come contentPath, mentre il suo comando di esempio utilizza contentpath in minuscolo.
Gli integratori dovrebbero verificare i nomi esatti degli extras Intent e la codifica dei valori contro la versione installata di WebViewController e i file di esempio forniti con il pacchetto per sviluppatori applicabile.
Risoluzione dei Problemi
| Problema | Cosa Controllare |
|---|---|
| La configurazione locale non viene applicata | Verifica che la Configurazione Locale sia attivata e che il file di configurazione utilizzi un nome di file e una posizione supportati. |
| La configurazione JSON sembra essere ignorata | Controlla per wvc_config.properties o wvc_config.prop. Entrambi hanno una precedenza maggiore rispetto a wvc_config.json. |
| Il file di configurazione non viene rilevato | Conferma che il file sia direttamente sotto /sdcard/. I file in posizioni come /sdcard/Download/ non sono uno dei percorsi documentati per la Configurazione Locale. |
Le impostazioni launchContentSetting non vengono utilizzate |
Controlla readLocalConfig. Quando impostato su true, WVC prova a utilizzare il file di configurazione locale invece. |
| I download o i PDF non sono disponibili | Controlla se disableDownload è impostato su true. Il comportamento documentato afferma che attivare questa opzione disabilita anche i PDF. |
Elenco di Controllo per la Configurazione Locale
- Identifica solo le impostazioni di WebViewController necessarie per il progetto.
- Crea un file di configurazione JSON o Java properties valido utilizzando i nomi e i tipi di valore documentati.
- Salva il file utilizzando uno dei nomi di file supportati.
- Copia il file direttamente nella radice
/sdcard/sul dispositivo Elo Android fisico. - Attiva Configurazione Locale per l'app Web applicabile in EloView.
- Quando avvii WVC utilizzando un file di configurazione locale, imposta
readLocalConfigsutrue. - Per il controllo programmatico, installa prima WebViewController e poi fai inviare all'applicazione agente del dispositivo gli Intents Android appropriati.
- Testa la configurazione sul dispositivo di destinazione e conferma che WebViewController si comporti come previsto.
💡 Suggerimento
Il comportamento di WebViewController e le impostazioni disponibili possono variare in base alla versione di WVC. Quando sviluppi una distribuzione automatizzata, verifica la configurazione con il pacchetto WebViewController e i file di configurazione di esempio installati sul dispositivo di destinazione.
Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article