Como faço para utilizar a Configuração Local com EloView WebApps e WebViewController?

Este artigo explica como usar a Configuração Local com EloView® WebApps e WebViewController (WVC) para aplicar configurações avançadas de navegador e quiosque diretamente em um dispositivo Elo Android.

A Configuração Local permite que WebViewController (WVC) use configurações de configuração armazenadas localmente em um dispositivo Elo Android quando o WVC é iniciado. Essas configurações podem fornecer opções de configuração adicionais além daquelas disponíveis através do portal EloView.

⚠ Importante

Ativar Configuração Local no EloView informa ao WebViewController para procurar um arquivo de configuração local. Isso não cria, baixa ou copia o arquivo de configuração para o dispositivo. O cliente ou administrador deve criar o arquivo de configuração e colocá-lo em um local suportado no dispositivo Elo Android físico.

Visão Geral

O WebViewController pode receber informações de configuração de duas maneiras:

Arquivo de configuração local – O WVC lê um arquivo de configuração suportado armazenado no diretório raiz /sdcard/ no dispositivo.
Intenções Android – Um aplicativo Android personalizado pode iniciar o WVC e fornecer informações de configuração programaticamente.

O extra Boolean do Intent readLocalConfig determina se o WebViewController tenta usar um arquivo de configuração local em vez das configurações do Intent launchContentSetting.

readLocalConfig	Comportamento
`true`	Solicita que o WVC use um arquivo de configuração local suportado e ignore `launchContentSetting`.
`false`	O WVC pode receber sua configuração de inicialização através de `launchContentSetting`.

Antes de Começar

ℹ Antes de Começar

Determine quais configurações do WebViewController são necessárias para sua implantação antes de criar o arquivo de configuração.

A Elo recomenda incluir apenas as configurações que você realmente precisa mudar. Deixe outras configurações em seu comportamento existente ou padrão.

Ativar Configuração Local no EloView

Ao configurar o conteúdo do WebApp no EloView, ative a Configuração Local nas propriedades do conteúdo:

No portal EloView, abra o item de conteúdo do WebApp aplicável.
Navegue até Detalhes do Conteúdo > Propriedades do Conteúdo.
Sob Configurações do Navegador, localize Configuração Local.
Defina Configuração Local como Ativado (Ativo).
Salve ou aplique a configuração.

⚠ Importante

Ativar esta configuração não cria ou implanta o arquivo de configuração. O arquivo de configuração ainda deve ser criado e copiado para o local suportado no dispositivo de destino.

Criar e Colocar o Arquivo de Configuração Local

O WebViewController suporta arquivos de propriedades Java e arquivos de configuração JSON. Coloque o arquivo de configuração diretamente no diretório raiz /sdcard/ usando um dos nomes de arquivo suportados abaixo.

Precedência	Caminho de Arquivo Suportado	Formato
1 – Mais Alto	`/sdcard/wvc_config.properties`	Propriedades Java
2	`/sdcard/wvc_config.prop`	Propriedades Java
3 – Mais Baixo	`/sdcard/wvc_config.json`	JSON

ℹ Precedência de Arquivo

Se mais de um arquivo de configuração suportado existir no dispositivo, o WebViewController usa o arquivo de maior prioridade. Por exemplo, wvc_config.properties tem prioridade sobre wvc_config.prop e wvc_config.json.

⚠ Requisito de Caminho de Armazenamento

O arquivo deve ser colocado diretamente em /sdcard/. Um arquivo armazenado em uma subpasta, como /sdcard/Download/, é um caminho diferente e não é um dos locais suportados documentados para a Configuração Local.

Configurações de Configuração do WebViewController

A Configuração Local suporta uma variedade de configurações do WebViewController. Os valores Booleanos usam true ou false. Os valores de string são citados em JSON e inseridos como valores de texto em um arquivo de propriedades Java.

Configurações de Navegador e Sessão

Configuração	Tipo	Descrição
`viewMode`	String	Use `Full View` para tela cheia. Outros valores usam Form View.
`layerType`	String	`HW` habilita a aceleração de hardware. Outros valores usam `SW`. A aceleração de hardware é recomendada na documentação do desenvolvedor para reprodução de vídeo.
`pinchZoom`	Boolean	Habilita o zoom por pinça.
`homePageTimeout`	String	Número de minutos inativos antes de retornar à página inicial. `0`, `never`, ou um valor omitido significa nenhum tempo limite.
`clearUserDataOnTimeout`	Boolean	Limpa os dados do usuário quando o tempo limite da página inicial ocorre.
`clearCookiesOnTimeout`	Boolean	Limpa os cookies quando o tempo limite da página inicial ocorre.
`ssl`	Boolean	Ativa o SSL.
`userAgent`	String	Define a string do User-Agent.
`virtualKeyboard`	Boolean	Defina como `false` para desabilitar o teclado virtual.
`disableDownload`	Boolean	Defina como `true` para desabilitar downloads. Isso também desabilita PDF.
`showLoadingBar`	Boolean	Mostra a barra de carregamento na parte superior da tela.

Configurações da Barra de Navegação

Configuração	Tipo	Descrição
`showNavBar`	Boolean	Mostra a barra de navegação de Início, Voltar e Avançar na parte inferior da tela.
`navBarBackgroundColor`	String	Cor da barra de navegação usando `#RRGGBB` ou `#AARRGGBB`.
`navBarAccentColor`	String	Cor de destaque da barra de navegação.

Configurações da Barra de Ação

Configuração	Tipo	Descrição
`showActionBar`	Boolean	Mostra a Barra de Ação na parte superior da tela.
`actionBarBackgroundColor`	String	Cor de fundo da Barra de Ação.
`actionBarBackgroundUrl`	String	URL de uma imagem usada como fundo da Barra de Ação.
`actionBarAccentColor`	String	Cor de destaque da Barra de Ação.
`showActionBarLogo`	Boolean	Mostra o logotipo no lado esquerdo da Barra de Ação.
`actionBarLogoIconUrl`	String*	URL de uma imagem usada como ícone da Barra de Ação.
`showActionBarTitle`	Boolean	Mostra o título da página web na Barra de Ação.
`showActionBarSubtitle`	Boolean	Mostra o subtítulo da página web na Barra de Ação.
`showActionBarPrintBtn`	Boolean	Mostra o botão de Impressão.
`showActionBarShareBtn`	Boolean	Mostra o botão Compartilhar.
`showActionBarInfoBtn`	Boolean	Mostra o botão de Informação.

ℹ Nota de Documentação

A documentação do desenvolvedor indica actionBarLogoIconUrl como uma URL, embora sua tabela de origem o rotule como Boolean. Como a configuração representa uma URL, ela é mostrada como uma String neste artigo. Verifique o comportamento em relação ao pacote do WebViewController usado no dispositivo de destino.

Configurações de PDF

Configuração	Tipo	Descrição
`pdfSupport`	Boolean	Habilita a visualização de PDFs.
`pdfHyperlinkSupport`	Boolean	Habilita hyperlinks dentro dos PDFs.
`pdfSwipeHorizontal`	Boolean	Habilita a rolagem horizontal de PDF quando definido como `true`.
`pdfShowScrollHandle`	Boolean	Mostra um controle de rolagem ao percorrer PDFs.
`pdfFitToHeight`	Boolean	Ajusta o PDF para a altura da tela em vez da largura.

Exemplo de Configuração JSON

O seguinte exemplo abreviado demonstra a estrutura de um arquivo wvc_config.json. Selecione apenas as configurações e valores apropriados para sua implantação.

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

Salve o arquivo usando um dos nomes de arquivo suportados diretamente sob /sdcard/. Ao usar um arquivo de configuração local, inicie o WebViewController com readLocalConfig definido como true.

Configurar WebViewController Usando Intenções Android

O WebViewController também pode ser iniciado e configurado programaticamente através de Intenções Android. Isso fornece uma alternativa ao uso de um arquivo de configuração armazenado no dispositivo.

Por exemplo, depois que o WebViewController foi instalado, um aplicativo agente do dispositivo personalizado pode enviar as Intenções apropriadas para controlar o WVC como parte do fluxo de trabalho do dispositivo.

Intent Extra	Tipo	Propósito
`contentPath`	String	URL da página inicial começando com `http://`, `https://`, ou `file://`.
`readLocalConfig`	Boolean	Quando `true`, solicita que o WVC ignore `launchContentSetting` e use um arquivo de configuração local suportado.
`launchContentSetting`	String	Objeto JSON contendo opções de inicialização, como modo de visualização, barras de navegação, comportamento de tempo limite, comportamento de PDF e outras configurações suportadas.

⚠ Importante – Nomes de Parâmetros de Intent

A documentação do desenvolvedor identifica o extra do Intent como contentPath, enquanto seu comando de exemplo usa contentpath em letras minúsculas.

Os integradores devem verificar os nomes exatos dos extras do Intent e a codificação de valores em relação à versão do WebViewController instalada e aos arquivos de exemplo fornecidos com o pacote de desenvolvedor aplicável.

Solução de Problemas

Problema	O que Verificar
A configuração local não está aplicada	Verifique se a Configuração Local está ativada e se o arquivo de configuração usa um nome de arquivo e local suportados.
A configuração JSON parece estar sendo ignorada	Verifique se há `wvc_config.properties` ou `wvc_config.prop`. Ambos têm precedência maior do que `wvc_config.json`.
Arquivo de configuração não detectado	Confirme que o arquivo está diretamente sob `/sdcard/`. Arquivos em locais como `/sdcard/Download/` não são um dos caminhos documentados da Configuração Local.
`launchContentSetting` as configurações não estão sendo usadas	Verifique `readLocalConfig`. Quando definido como `true`, o WVC tenta usar o arquivo de configuração local em vez disso.
Downloads ou PDFs estão indisponíveis	Verifique se `disableDownload` está definido como `true`. O comportamento documentado afirma que habilitar esta opção também desabilita PDF.

Checklist de Configuração da Configuração Local

Identifique apenas as configurações do WebViewController necessárias para a implantação.
Crie um arquivo de configuração JSON ou de propriedades Java válido usando os nomes e tipos de valores das configurações documentadas.
Salve o arquivo usando um dos nomes de arquivo suportados.
Copie o arquivo diretamente para o diretório raiz /sdcard/ no dispositivo Elo Android físico.
Ative Configuração Local para o WebApp aplicável no EloView.
Ao iniciar o WVC usando um arquivo de configuração local, defina readLocalConfig como true.
Para controle programático, instale primeiro o WebViewController e, em seguida, faça o aplicativo agente do dispositivo enviar as Intenções Android apropriadas.
Teste a configuração no dispositivo de destino e confirme que o WebViewController se comporta como esperado.

💡 Dica

O comportamento do WebViewController e as configurações disponíveis podem variar por versão do WVC. Ao desenvolver uma implantação automatizada, verifique a configuração em relação ao pacote do WebViewController e arquivos de configuração de exemplo instalados no dispositivo de destino.

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

Pesquisa

Bem-vindo ao Suporte Elo