Wie verwende ich die lokale Konfiguration mit EloView WebApps und WebViewController?

Dieser Artikel erklärt, wie man Local Config mit EloView® WebApps und WebViewController (WVC) verwendet, um erweiterte Browser- und Kiosk-Konfigurationseinstellungen direkt auf einem Elo Android-Gerät anzuwenden.

Local Config ermöglicht es WebViewController (WVC), Konfigurationseinstellungen zu verwenden, die lokal auf einem Elo Android-Gerät gespeichert sind, wenn WVC gestartet wird. Diese Einstellungen können zusätzliche Konfigurationsoptionen bieten, die über die im EloView-Portal verfügbaren hinausgehen.

⚠ Wichtig

Die Aktivierung von Local Config in EloView weist WebViewController an, nach einer lokalen Konfigurationsdatei zu suchen. Es erstellt nicht die Konfigurationsdatei, lädt sie herunter oder kopiert sie auf das Gerät. Der Kunde oder Administrator muss die Konfigurationsdatei erstellen und sie an einem unterstützten Speicherort auf dem physischen Elo Android-Gerät ablegen.

Übersicht

WebViewController kann Konfigurationsinformationen auf zwei Arten erhalten:

Lokale Konfigurationsdatei – WVC liest eine unterstützte Konfigurationsdatei, die im Stammverzeichnis /sdcard/ auf dem Gerät gespeichert ist.
Android Intents – Eine benutzerdefinierte Android-Anwendung kann WVC starten und programmgesteuert Konfigurationsinformationen bereitstellen.

Das readLocalConfig Boolean Intent Extra bestimmt, ob WebViewController versucht, eine lokale Konfigurationsdatei anstelle der launchContentSetting Intent-Einstellungen zu verwenden.

readLocalConfig	Verhalten
`true`	Fordert WVC auf, eine unterstützte lokale Konfigurationsdatei zu verwenden und `launchContentSetting` zu ignorieren.
`false`	WVC kann seine Startkonfiguration über `launchContentSetting` erhalten.

Bevor Sie Beginnen

ℹ Bevor Sie Beginnen

Bestimmen Sie, welche WebViewController-Einstellungen für Ihre Bereitstellung erforderlich sind, bevor Sie die Konfigurationsdatei erstellen.

Elo empfiehlt, nur die Einstellungen einzuschließen, die Sie absichtlich ändern müssen. Lassen Sie andere Einstellungen im vorhandenen oder Standardverhalten.

Aktivieren Sie Local Config in EloView

Beim Konfigurieren von WebApp-Inhalten in EloView aktivieren Sie Local Config in den Inhaltseigenschaften:

Öffnen Sie im EloView-Portal den entsprechenden WebApp-Inhalt.
Navigieren Sie zu Inhaltsdetails > Inhalteigenschaften.
Unter Browsereinstellungen finden Sie Local Config.
Setzen Sie Local Config auf Aktiviert (Aktiv).
Speichern oder übernehmen Sie die Konfiguration.

⚠ Wichtig

Das Aktivieren dieser Einstellung erstellt oder implementiert die Konfigurationsdatei nicht. Die Konfigurationsdatei muss weiterhin erstellt und an den unterstützten Speicherort auf dem Zielgerät kopiert werden.

Erstellen und Platzieren der lokalen Konfigurationsdatei

WebViewController unterstützt Java-Properties und JSON-Konfigurationsdateien. Platzieren Sie die Konfigurationsdatei direkt im Stammverzeichnis /sdcard/ mit einem der unterstützten Dateinamen unten.

Priorität	Unterstützter Dateipfad	Format
1 – Höchste	`/sdcard/wvc_config.properties`	Java Properties
2	`/sdcard/wvc_config.prop`	Java Properties
3 – Niedrigste	`/sdcard/wvc_config.json`	JSON

ℹ Dateivorrang

Wenn mehr als eine unterstützte Konfigurationsdatei auf dem Gerät vorhanden ist, verwendet WebViewController die Datei mit der höchsten Priorität. Zum Beispiel hat wvc_config.properties Vorrang vor wvc_config.prop und wvc_config.json.

⚠ Anforderungen an den Speicherort

Die Datei muss direkt unter /sdcard/ abgelegt werden. Eine in einem Unterordner wie /sdcard/Download/ gespeicherte Datei stellt einen anderen Pfad dar und ist nicht einer der unterstützten Speicherorte, die für Local Config dokumentiert sind.

WebViewController-Konfigurationseinstellungen

Local Config unterstützt eine Reihe von WebViewController-Einstellungen. Boolesche Werte verwenden true oder false. String-Werte werden in JSON in Anführungszeichen gesetzt und als Textwerte in einer Java-Properties-Datei eingegeben.

Browser- und Sitzungseinstellungen

Einstellung	Typ	Beschreibung
`viewMode`	String	Verwenden Sie `Full View` für den Vollbildmodus. Andere Werte verwenden den Formularansicht.
`layerType`	String	`HW` aktiviert die Hardwarebeschleunigung. Andere Werte verwenden `SW`. Hardwarebeschleunigung wird in der Entwickl Dokumentation für die Videowiedergabe empfohlen.
`pinchZoom`	Boolean	Aktiviert das Ziehen zum Vergrößern.
`homePageTimeout`	String	Anzahl der Leerlaufminuten, bevor zur Startseite zurückgekehrt wird. `0`, `nie` oder ein ausgelassener Wert bedeutet keinen Timeout.
`clearUserDataOnTimeout`	Boolean	Löscht Benutzerdaten, wenn der Timeout der Startseite eintritt.
`clearCookiesOnTimeout`	Boolean	Löscht Cookies, wenn der Timeout der Startseite eintritt.
`ssl`	Boolean	Aktiviert SSL.
`userAgent`	String	Setzt den User-Agent-String.
`virtualKeyboard`	Boolean	Auf `false` setzen, um die virtuelle Tastatur zu deaktivieren.
`disableDownload`	Boolean	Auf `true` setzen, um Downloads zu deaktivieren. Dies deaktiviert auch PDF.
`showLoadingBar`	Boolean	Zeigt die Ladeleiste oben auf dem Bildschirm an.

Navigation Bar Einstellungen

Einstellung	Typ	Beschreibung
`showNavBar`	Boolean	Zeigt die Navigation Leiste für Home, Zurück und Weiter am unteren Bildschirmrand an.
`navBarBackgroundColor`	String	Farbe der Navigationsleiste im Format `#RRGGBB` oder `#AARRGGBB`.
`navBarAccentColor`	String	Akzentfarbe der Navigationsleiste.

Aktion Bar Einstellungen

Einstellung	Typ	Beschreibung
`showActionBar`	Boolean	Zeigt die Aktionsleiste oben auf dem Bildschirm an.
`actionBarBackgroundColor`	String	Hintergrundfarbe der Aktionsleiste.
`actionBarBackgroundUrl`	String	URL eines Bildes, das als Hintergrund der Aktionsleiste verwendet wird.
`actionBarAccentColor`	String	Akzentfarbe der Aktionsleiste.
`showActionBarLogo`	Boolean	Zeigt das Logo auf der linken Seite der Aktionsleiste an.
`actionBarLogoIconUrl`	String*	URL eines Bildes, das als Aktionsleisten-Icon verwendet wird.
`showActionBarTitle`	Boolean	Zeigt den Titel der Webseite in der Aktionsleiste an.
`showActionBarSubtitle`	Boolean	Zeigt den Untertitel der Webseite in der Aktionsleiste an.
`showActionBarPrintBtn`	Boolean	Zeigt die Druckschaltfläche an.
`showActionBarShareBtn`	Boolean	Zeigt die Teilen-Schaltfläche an.
`showActionBarInfoBtn`	Boolean	Zeigt die Schaltfläche Informationen an.

ℹ Hinweis zur Dokumentation

Die Entwicklerdokumentation beschreibt actionBarLogoIconUrl als URL, obwohl die Quelltabelle das Schlüsselwort Berichten zufolge als Boolean kennzeichnet. Da die Einstellung eine URL darstellt, wird sie in diesem Artikel als String angezeigt. Verifizieren Sie das Verhalten gegen das verwendete WebViewController-Paket auf dem Zielgerät.

PDF-Einstellungen

Einstellung	Typ	Beschreibung
`pdfSupport`	Boolean	Aktiviert die PDF-Anzeige.
`pdfHyperlinkSupport`	Boolean	Aktiviert Hyperlinks innerhalb von PDFs.
`pdfSwipeHorizontal`	Boolean	Aktiviert horizontales Scrollen durch PDFs, wenn auf `true` gesetzt.
`pdfShowScrollHandle`	Boolean	Zeigt einen Scrollgriff an, während durch PDFs gescrollt wird.
`pdfFitToHeight`	Boolean	Passt das PDF an die Bildschirmhöhe an, anstatt an die Breite.

Beispiel für eine JSON-Konfiguration

Das folgende verkürzte Beispiel zeigt die Struktur einer wvc_config.json Datei. Wählen Sie nur die Einstellungen und Werte, die für Ihre Bereitstellung geeignet sind.

{
  "contentpath": "https://example.com",
  "viewMode": "Full View",
  "layerType": "HW",
  "pinchZoom": true,
  "homePageTimeout": "0",
  "showNavBar": true,
  "pdfSupport": true
}

Speichern Sie die Datei mit einem der unterstützten Dateinamen direkt unter /sdcard/. Wenn Sie eine lokale Konfigurationsdatei verwenden, starten Sie WebViewController mit readLocalConfig, das auf true gesetzt ist.

Konfigurieren Sie WebViewController mit Android Intents

WebViewController kann auch programmgesteuert über Android Intents gestartet und konfiguriert werden. Dies bietet eine Alternative zur Verwendung einer auf dem Gerät gespeicherten Konfigurationsdatei.

Zum Beispiel kann nach der Installation von WebViewController eine benutzerdefinierte Geräte-Agent-Anwendung die entsprechenden Intents senden, um WVC als Teil des Geräte-Workflows zu steuern.

Intent Extra	Typ	Zweck
`contentPath`	String	URL der Startseite, die mit `http://`, `https://` oder `file://` beginnt.
`readLocalConfig`	Boolean	Wenn `true` angefordert wird, dass WVC `launchContentSetting` ignoriert und eine unterstützte lokale Konfigurationsdatei verwendet.
`launchContentSetting`	String	JSON-Objekt, das Startoptionen wie Ansichtsmodus, Navigationsleisten, Timeout-Verhalten, PDF-Verhalten und andere unterstützte Einstellungen enthält.

⚠ Wichtig – Intent-Parameternamen

Die Entwickl Dokumentation identifiziert das Intent Extra als contentPath, während ihr Beispielbefehl contentpath in Kleinbuchstaben verwendet.

Integratoren sollten die genauen Namen der Intent-Extras und die Wertekodierung mit der installierten WebViewController-Version und den Beispiel-Dateien, die mit dem entsprechenden Entwicklerpaket geliefert werden, verifizieren.

Fehlerbehebung

Problem	Was zu überprüfen ist
Lokale Konfiguration wird nicht angewendet	Überprüfen Sie, ob Local Config aktiviert ist und ob die Konfigurationsdatei einen unterstützten Dateinamen und Speicherort verwendet.
JSON-Konfiguration scheint ignoriert zu werden	Überprüfen Sie `wvc_config.properties` oder `wvc_config.prop`. Beide haben eine höhere Priorität als `wvc_config.json`.
Konfigurationsdatei wird nicht erkannt	Bestätigen Sie, dass sich die Datei direkt unter `/sdcard/` befindet. Dateien an Speicherorten wie `/sdcard/Download/` gehören nicht zu den dokumentierten Local Config-Pfaden.
`launchContentSetting` Einstellungen werden nicht verwendet	Überprüfen Sie `readLocalConfig`. Wenn auf `true` gesetzt, versucht WVC, stattdessen die lokale Konfigurationsdatei zu verwenden.
Downloads oder PDFs sind nicht verfügbar	Überprüfen Sie, ob `disableDownload` auf `true` gesetzt ist. Das dokumentierte Verhalten besagt, dass die Aktivierung dieser Option auch PDF deaktiviert.

Checkliste zur Einrichtung von Local Config

Identifizieren Sie nur die WebViewController-Einstellungen, die für die Bereitstellung erforderlich sind.
Erstellen Sie eine gültige JSON- oder Java-Properties-Konfigurationsdatei unter Verwendung der dokumentierten Einstellungsnamen und Wertetypen.
Speichern Sie die Datei mit einem der unterstützten Dateinamen.
Kopieren Sie die Datei direkt in das Stammverzeichnis /sdcard/ auf dem physischen Elo Android-Gerät.
Aktivieren Sie Local Config für die entsprechende WebApp in EloView.
Wenn Sie WVC mit einer lokalen Konfigurationsdatei starten, setzen Sie readLocalConfig auf true.
Für die programmgesteuerte Steuerung installieren Sie zuerst WebViewController und lassen Sie dann die Geräte-Agent-Anwendung die entsprechenden Android Intents senden.
Testen Sie die Konfiguration auf dem Zielgerät und bestätigen Sie, dass WebViewController wie erwartet funktioniert.

💡 Tipp

Das Verhalten von WebViewController und die verfügbaren Einstellungen können je nach WVC-Version variieren. Wenn Sie eine automatisierte Bereitstellung entwickeln, überprüfen Sie die Konfiguration anhand des WebViewController-Pakets und der auf dem Zielgerät installierten Beispielkonfigurationsdateien.

Please report any broken links by emailing elo.support@zebra.com and include a link to the knowledge article

Suche

Willkommen beim Elo-Support