如何在 EloView WebApps 和 WebViewController 中使用本地配置？

本文解释了如何使用本地配置与EloView® WebApps和WebViewController (WVC)直接在Elo Android设备上应用高级浏览器和自助终端配置设置。

本地配置允许WebViewController (WVC)在启动WVC时使用存储在Elo Android设备上的本地配置设置。这些设置可以提供超出EloView门户提供的配置选项。

⚠ 重要

在EloView中启用本地配置会告知WebViewController查找本地配置文件。它不会在设备上创建、下载或复制配置文件。客户或管理员必须创建配置文件并将其放置在物理Elo Android设备上的受支持位置。

概述

WebViewController可以通过两种方式接收配置信息：

本地配置文件 – WVC读取存储在设备根目录/sdcard/中的受支持配置文件。
Android Intent – 自定义Android应用程序可以启动WVC并以编程方式提供配置信息。

readLocalConfig布尔Intent附加项决定WebViewController是否尝试使用本地配置文件而不是launchContentSetting意图设置。

readLocalConfig	行为
`true`	请求WVC使用受支持的本地配置文件并忽略`launchContentSetting`。
`false`	WVC可以通过`launchContentSetting`接收其启动配置。

开始前

ℹ 开始前

在创建配置文件之前，确定您的部署所需的WebViewController设置。

Elo建议仅包括您有意需要更改的设置。将其他设置保持在现有或默认行为。

在EloView中启用本地配置

在EloView中配置WebApp内容时，启用内容属性中的本地配置：

在EloView门户中，打开相关的WebApp内容项。
导航到内容详情 > 内容属性。
在浏览器设置下，找到本地配置。
将本地配置设置为启用（活动）。
保存或应用配置。

⚠ 重要

启用此设置并不意味着创建或部署配置文件。配置文件仍必须创建并复制到目标设备的受支持位置。

创建并放置本地配置文件

WebViewController支持Java属性和JSON配置文件。使用以下受支持的文件名之一，将配置文件直接放置在根目录/sdcard/中。

优先级	支持的文件路径	格式
1 – 最高	`/sdcard/wvc_config.properties`	Java属性
2	`/sdcard/wvc_config.prop`	Java属性
3 – 最低	`/sdcard/wvc_config.json`	JSON

ℹ 文件优先级

如果设备上存在多个受支持的配置文件，WebViewController将使用最高优先级的文件。例如，wvc_config.properties优先于wvc_config.prop和wvc_config.json。

⚠ 存储路径要求

文件必须直接放置在/sdcard/下。存储在子文件夹如/sdcard/Download/中的文件属于不同路径，并不在本地配置文档所支持的位置之列。

WebViewController配置设置

本地配置支持一系列WebViewController设置。布尔值使用true或false。字符串值在JSON中使用引号，并在Java属性文件中作为文本值输入。

浏览器和会话设置

设置	类型	描述
`viewMode`	字符串	使用`Full View`表示全屏。其他值使用表单视图。
`layerType`	字符串	`HW`启用硬件加速。其他值使用`SW`。在开发者文档中推荐在视频播放时使用硬件加速。
`pinchZoom`	布尔值	启用捏合缩放。
`homePageTimeout`	字符串	返回到主页之前的空闲分钟数。`0`, `never`或省略的值表示没有超时。
`clearUserDataOnTimeout`	布尔值	当主页超时发生时清除用户数据。
`clearCookiesOnTimeout`	布尔值	当主页超时发生时清除cookie。
`ssl`	布尔值	启用SSL。
`userAgent`	字符串	设置User-Agent字符串。
`virtualKeyboard`	布尔值	设置为`false`以禁用虚拟键盘。
`disableDownload`	布尔值	设置为`true`以禁用下载。这也会禁用PDF。
`showLoadingBar`	布尔值	在屏幕顶部显示加载条。

导航栏设置

设置	类型	描述
`showNavBar`	布尔值	在屏幕底部显示主页、后退和前进导航栏。
`navBarBackgroundColor`	字符串	导航栏颜色，使用`#RRGGBB`或`#AARRGGBB`格式。
`navBarAccentColor`	字符串	导航栏强调色。

操作栏设置

设置	类型	描述
`showActionBar`	布尔值	在屏幕顶部显示操作栏。
`actionBarBackgroundColor`	字符串	操作栏背景颜色。
`actionBarBackgroundUrl`	字符串	用作操作栏背景的图像的URL。
`actionBarAccentColor`	字符串	操作栏强调色。
`showActionBarLogo`	布尔值	在操作栏左侧显示徽标。
`actionBarLogoIconUrl`	字符串*	用作操作栏图标的图像的URL。
`showActionBarTitle`	布尔值	在操作栏中显示网页标题。
`showActionBarSubtitle`	布尔值	在操作栏中显示网页副标题。
`showActionBarPrintBtn`	布尔值	显示打印按钮。
`showActionBarShareBtn`	布尔值	显示分享按钮。
`showActionBarInfoBtn`	布尔值	显示信息按钮。

ℹ 文档说明

源开发者文档将actionBarLogoIconUrl描述为URL，即使其源表据说将该键标记为布尔值。由于该设置表示一个URL，因此在本文中显示为字符串。请根据目标设备上使用的WebViewController包验证行为。

PDF设置

设置	类型	描述
`pdfSupport`	布尔值	启用PDF查看。
`pdfHyperlinkSupport`	布尔值	启用PDF中的超链接。
`pdfSwipeHorizontal`	布尔值	设置为`true`时启用水平PDF滚动。
`pdfShowScrollHandle`	布尔值	在浏览PDF时显示滚动手柄。
`pdfFitToHeight`	布尔值	将PDF适应显示高度而非宽度。

示例JSON配置

以下简略示例展示了wvc_config.json文件的结构。请选择适合您部署的设置和数值。

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

使用受支持的文件名之一，在/sdcard/下直接保存文件。当使用本地配置文件时，启动WebViewController时将readLocalConfig设置为true。

使用Android Intent配置WebViewController

WebViewController也可以通过Android Intent以编程方式启动和配置。这为使用存储在设备上的配置文件提供了一种替代方法。

例如，在安装WebViewController后，自定义设备代理应用程序可以发送适当的Intent以在设备工作流中控制WVC。

Intent附加项	类型	目的
`contentPath`	字符串	以`http://`、`https://`或`file://`开头的主页URL。
`readLocalConfig`	布尔值	当`true`时，请求WVC忽略`launchContentSetting`并使用受支持的本地配置文件。
`launchContentSetting`	字符串	包含启动选项的JSON对象，例如视图模式、导航栏、超时行为、PDF行为及其他受支持设置。

⚠ 重要 - Intent参数名称

开发者文档将Intent附加项标识为contentPath，而其示例命令使用小写的contentpath。

集成商应核实安装的WebViewController版本与适用开发者包中提供的示例文件的确切Intent附加项名称和数值编码。

故障排除

问题	检查内容
未应用本地配置	确认本地配置已启用，并且配置文件使用受支持的文件名和位置。
JSON配置似乎被忽略	检查`wvc_config.properties`或`wvc_config.prop`。两者的优先级高于`wvc_config.json`。
未检测到配置文件	确认文件直接位于`/sdcard/`下。位于`/sdcard/Download/`等位置的文件不是文档中列出的本地配置路径。
`launchContentSetting`设置未被使用	检查`readLocalConfig`。当设置为`true`时，WVC尝试使用本地配置文件。
下载或PDF不可用	检查`disableDownload`是否设置为`true`。文档说明启用此选项会同时禁用PDF。

本地配置设置清单

仅识别部署所需的WebViewController设置。
使用文档中说明的设置名称和数值类型创建有效的JSON或Java属性配置文件。
使用受支持的文件名之一保存文件。
将文件直接复制到物理Elo Android设备上的/sdcard/根目录。
在EloView中为相关的WebApp启用本地配置。
在使用本地配置文件启动WVC时，将readLocalConfig设置为true。
用于程序控制，首先安装WebViewController，然后让设备代理应用程序发送适当的Android Intent。
在目标设备上测试配置，以确认WebViewController按预期行为。

💡 提示

WebViewController的行为和可用设置可能因WVC版本而异。在开发自动化部署时，请对照目标设备上安装的WebViewController包和示例配置文件验证配置。

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

搜索

欢迎来到 Elo 技术支持中心