EloView WebApps ve WebViewController ile Yerel Yapılandırmayı nasıl kullanabilirim?

Bu makale, EloView® WebApps ve WebViewController (WVC) ile Yerel Yapılandırma'nın nasıl kullanılacağını, gelişmiş tarayıcı ve kiosk yapılandırma ayarlarını doğrudan bir Elo Android cihazında nasıl uygulayacağınızı açıklar.

Yerel Yapılandırma, WebViewController (WVC)’nin WVC başlatıldığında Elo Android cihazında yerel olarak saklanan yapılandırma ayarlarını kullanmasına olanak tanır. Bu ayarlar, EloView portalı üzerinden sağlanan seçeneklerin ötesinde ek yapılandırma seçenekleri sunabilir.

⚠ Önemli

EloView'da Yerel Yapılandırma'yı etkinleştirmek, WebViewController'a yerel bir yapılandırma dosyası aramasını söyler. Bu, yapılandırma dosyasını cihazda yaratmaz, indirmez veya kopyalamaz. Müşteri veya yönetici, yapılandırma dosyasını oluşturmak ve fiziksel Elo Android cihazında desteklenen bir konuma yerleştirmek zorundadır.

Genel Bakış

WebViewController yapılandırma bilgilerini iki şekilde alabilir:

Yerel yapılandırma dosyası – WVC, cihazdaki kök /sdcard/ dizininde saklanan desteklenen bir yapılandırma dosyasını okur.
Android İstekleri – Özel bir Android uygulaması, WVC'yi başlatabilir ve programatik olarak yapılandırma bilgileri sağlayabilir.

readLocalConfig Boolean Intent extra, WebViewController'ın launchContentSetting Intent ayarları yerine yerel bir yapılandırma dosyasını kullanıp kullanmamayı belirler.

readLocalConfig	Davranış
`true`	WVC'nin desteklenen bir yerel yapılandırma dosyasını kullanmasını talep eder ve `launchContentSetting`'i göz ardı eder.
`false`	WVC, başlatma yapılandırmasını `launchContentSetting` aracılığıyla alabilir.

Başlamadan Önce

ℹ Başlamadan Önce

Yapılandırma dosyasını oluşturduğunuzdan önce, dağıtımınız için gereken WebViewController ayarlarını belirleyin.

Elo, yalnızca kasıtlı olarak değiştirmeniz gereken ayarları dahil etmenizi önerir. Diğer ayarları mevcut veya varsayılan davranışlarıyla bırakın.

EloView'da Yerel Yapılandırmayı Etkinleştir

EloView'da WebApp içeriğini yapılandırırken, içerik özelliklerinden Yerel Yapılandırmayı etkinleştirin:

EloView portalında, ilgili WebApp içerik öğesini açın.
İçerik Ayrıntıları > İçerik Özellikleri’ne gidin.
Tarayıcı Ayarları altında Yerel Yapılandırma'yı bulun.
Yerel Yapılandırma'yı Etkin (Aktif) olarak ayarlayın.
Yapılandırmayı kaydedin veya uygulayın.

⚠ Önemli

Bu ayarı etkinleştirmek yapılandırma dosyasını oluşturmaz veya dağıtmaz. Yapılandırma dosyası hâlâ oluşturulmalı ve hedef cihazdaki desteklenen bir konuma kopyalanmalıdır.

Yerel Yapılandırma Dosyasını Oluşturma ve Yerleştirme

WebViewController, Java özellikleri ve JSON yapılandırma dosyalarını destekler. Yapılandırma dosyasını doğrudan aşağıdaki desteklenen dosya adlarından birini kullanarak kök /sdcard/ dizinine yerleştirin.

Öncelik	Desteklenen Dosya Yolu	Format
1 – En Yüksek	`/sdcard/wvc_config.properties`	Java Özellikleri
2	`/sdcard/wvc_config.prop`	Java Özellikleri
3 – En Düşük	`/sdcard/wvc_config.json`	JSON

ℹ Dosya Önceliği

Cihazda birden fazla desteklenen yapılandırma dosyası varsa, WebViewController en yüksek öncelikli dosyayı kullanır. Örneğin, wvc_config.properties, wvc_config.prop ve wvc_config.json'dan daha önceliklidir.

⚠ Depolama Yolu Gereksinimi

Dosya doğrudan /sdcard/ altında yerleştirilmelidir. /sdcard/Download/ gibi bir alt klasöre kaydedilen bir dosya farklı bir yoldur ve Yerel Yapılandırma için belgelenen desteklenen konumlardan biri değildir.

WebViewController Yapılandırma Ayarları

Yerel Yapılandırma, bir dizi WebViewController ayarını destekler. Boolean değerler true veya false olarak kullanılır. String değerler JSON'da tırnak içinde yazılır ve bir Java özellikleri dosyasında metin değerleri olarak enterilir.

Tarayıcı ve Oturum Ayarları

Ayar	Tür	Açıklama
`viewMode`	String	Tam ekran için `Full View` kullanın. Diğer değerler Form Görünümünü kullanır.
`layerType`	String	`HW` donanım hızlandırmasını etkinleştirir. Diğer değerler `SW` kullanır. Donanım hızlandırması, video oynatma için geliştirici belgelerinde önerilmektedir.
`pinchZoom`	Boolean	İki parmakla yakınlaştırmayı etkinleştirir.
`homePageTimeout`	String	Ana sayfaya dönmeden önce bekleme süresi. `0`, `asla` veya atlanan bir değer zaman aşımı olmadığını gösterir.
`clearUserDataOnTimeout`	Boolean	Ana sayfa zaman aşımı gerçekleştiğinde kullanıcı verilerini temizler.
`clearCookiesOnTimeout`	Boolean	Ana sayfa zaman aşımı gerçekleştiğinde çerezleri temizler.
`ssl`	Boolean	SSL'yi etkinleştirir.
`userAgent`	String	Kullanıcı-Agent dizesini ayarlar.
`virtualKeyboard`	Boolean	Sanal klavyayı devre dışı bırakmak için `false` olarak ayarlayın.
`disableDownload`	Boolean	İndirmeleri devre dışı bırakmak için `true` olarak ayarlayın. Bu ayrıca PDF'leri de devre dışı bırakır.
`showLoadingBar`	Boolean	Ekranın üst kısmında yükleme çubuğunu gösterir.

Navigasyon Çubuğu Ayarları

Ayar	Tür	Açıklama
`showNavBar`	Boolean	Ekranın alt kısmında Ana Sayfa, Geri ve İleri navigasyon çubuğunu gösterir.
`navBarBackgroundColor`	String	Navigasyon çubuğu rengi `#RRGGBB` veya `#AARRGGBB` formatında.
`navBarAccentColor`	String	Navigasyon çubuğu vurgulama rengi.

Eylem Çubuğu Ayarları

Ayar	Tür	Açıklama
`showActionBar`	Boolean	Ekranın üst kısmında Eylem Çubuğunu gösterir.
`actionBarBackgroundColor`	String	Eylem Çubuğu arka plan rengi.
`actionBarBackgroundUrl`	String	Eylem Çubuğu arka planı olarak kullanılan bir resmin URL'si.
`actionBarAccentColor`	String	Eylem Çubuğu vurgulama rengi.
`showActionBarLogo`	Boolean	Eylem Çubuğunun sol tarafında logoyu gösterir.
`actionBarLogoIconUrl`	String*	Eylem Çubuğu simgesi olarak kullanılan bir resmin URL'si.
`showActionBarTitle`	Boolean	Eylem Çubuğunda web sayfası başlığını gösterir.
`showActionBarSubtitle`	Boolean	Eylem Çubuğunda web sayfası alt başlığını gösterir.
`showActionBarPrintBtn`	Boolean	Yazdır düğmesini gösterir.
`showActionBarShareBtn`	Boolean	Paylaş düğmesini gösterir.
`showActionBarInfoBtn`	Boolean	Bilgi düğmesini gösterir.

ℹ Belge Notu

Kaynak geliştirici belgeleri actionBarLogoIconUrl'yu bir URL olarak tanımlarken, örnek komut büyük ihtimalle anahtarı Boolean olarak etiketlemektedir. Ayar bir URL'yi temsil ettiğinden, bu makalede String olarak gösterilmiştir. Hedef cihazda kullanılan WebViewController paketi ile davranış doğrulanmalıdır.

PDF Ayarları

Ayar	Tür	Açıklama
`pdfSupport`	Boolean	PDF görüntülemeyi etkinleştirir.
`pdfHyperlinkSupport`	Boolean	PDF'ler içindeki köprüleri etkinleştirir.
`pdfSwipeHorizontal`	Boolean	`true` olarak ayarlandığında yatay PDF kaydırmayı etkinleştirir.
`pdfShowScrollHandle`	Boolean	PDF'leri kaydırırken bir kaydırma tutamağını gösterir.
`pdfFitToHeight`	Boolean	PDF'yi genişlik yerine ekran yüksekliğine uydurur.

Örnek JSON Yapılandırması

Aşağıdaki kısaltılmış örnek, bir wvc_config.json dosyasının yapısını göstermektedir. Sadece dağıtımınıza uygun olan ayarları ve değerleri seçin.

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

Dosyayı desteklenen dosya adlarından birini kullanarak doğrudan /sdcard/ altında kaydedin. Yerel yapılandırma dosyası kullanırken, WebViewController'ı readLocalConfig değeri true olarak ayarlandığında başlatın.

WebViewController'ı Android İstekleri Kullanarak Yapılandırma

WebViewController ayrıca, Android İstekleri aracılığıyla programatik olarak başlatılabilir ve yapılandırılabilir. Bu, cihazda saklanan bir yapılandırma dosyası kullanmanın alternatifini sağlar.

Örneğin, WebViewController yüklendikten sonra, özel bir cihaz-ajansı uygulaması WVC'yi cihaz akışının bir parçası olarak kontrol etmek için uygun İstekleri gönderebilir.

Intent Ekstra	Tür	Amaç
`contentPath`	String	`http://`, `https://` veya `file://` ile başlayan anasayfa URL'si.
`readLocalConfig`	Boolean	`true` olduğunda, WVC'nin `launchContentSetting`'i göz ardı etmesini ve desteklenen bir yerel yapılandırma dosyasını kullanmasını talep eder.
`launchContentSetting`	String	Görünüm modu, navigasyon çubukları, zaman aşımı davranışı, PDF davranışı ve diğer desteklenen ayarlar gibi başlatma seçeneklerini içeren JSON nesnesi.

⚠ Önemli – Intent Parametre İsimleri

Geliştirici belgeleri, Intent ekstra değerini contentPath olarak tanımlarken, örnek komut contentpath'ı küçük harflerle kullanmaktadır.

Entegratörler, yüklü WebViewController sürümü ve ilgili geliştirici paketi ile sağlanan örnek dosyalar karşısında belirli Intent ekstra isimlerini ve değer kodlamalarını doğrulamalıdır.

Sorun Giderme

Sorun	Kontrol Edilecekler
Yerel yapılandırma uygulanmıyor	Yerel Yapılandırma'nın etkin olduğundan ve yapılandırma dosyasının desteklenen bir dosya adı ve konumu kullandığından emin olun.
JSON yapılandırmasının göz ardı ediliyormuş gibi görünmesi	`wvc_config.properties` ya da `wvc_config.prop` olup olmadığını kontrol edin. İkisi de `wvc_config.json`'dan daha yüksek önceliğe sahiptir.
Yapılandırma dosyası tespit edilemedi	Dosyanın doğrudan `/sdcard/` altında olduğunu doğrulayın. `/sdcard/Download/` gibi yerlerde dosyalar, belgelenmiş Yerel Yapılandırma yollarından biri değildir.
`launchContentSetting` ayarları kullanılmıyor	`readLocalConfig`'i kontrol edin. `true` olarak ayarlanmışsa, WVC yerel yapılandırma dosyasını kullanmaya çalışır.
İndirmeler veya PDF'ler kullanılamıyor	`disableDownload`'ın `true` olarak ayarlanıp ayarlanmadığını kontrol edin. Belgelenmiş davranış, bu seçeneği etkinleştirmenin aynı zamanda PDF'leri de devre dışı bıraktığını belirtmektedir.

Yerel Yapılandırma Kurulum Kontrol Listesi

Sadece dağıtım için gereken WebViewController ayarlarını belirleyin.
Belgelenmiş ayar adları ve değer türlerini kullanarak geçerli bir JSON veya Java özellikleri yapılandırma dosyası oluşturun.
Dosyayı desteklenen dosya adlarından biriyle kaydedin.
Dosyayı fiziksel Elo Android cihazındaki /sdcard/ kök dizinine doğrudan kopyalayın.
EloView'da ilgili WebApp için Yerel Yapılandırma'yı etkinleştirin.
Yerel yapılandırma dosyası kullanarak WVC'yi başlatırken readLocalConfig'i true olarak ayarlayın.
Programatik kontrol için önce WebViewController'ı yükleyin ve ardından cihaz ajansı uygulamasının uygun Android İsteklerini göndermesini sağlayın.
Yapılandırmayı hedef cihazda test edin ve WebViewController'ın beklenildiği gibi davrandığından emin olun.

💡 İpucu

WebViewController davranışı ve mevcut ayarlar WVC sürümüne göre değişiklik gösterebilir. Otomatik bir dağıtım geliştirirken, hedef cihazda kurulu olan WebViewController paketi ve örnek yapılandırma dosyaları karşısında yapılandırmayı doğrulayın.

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

Ara

Elo Destek'e Hoş Geldiniz