技术概述，Elo Android I-Series 5 上的 Zebra DataWedge。兼容性、功能支持和配置（第 1 阶段）

版本

1. 概述

自 Android 14 MR-9 操作系统发布以来，Elo I-Series 5 设备随附Zebra DataWedge，这是一个在 Zebra 企业 Android 设备上使用的零编码数据捕获服务。

DataWedge 从连接的条形码扫描器或相机捕获数据，并将其传递给处于前台的应用程序——无论是作为键击，如同在键盘上输入，还是作为应用程序以编程方式接收的 Android 意图。应用程序无需包含针对扫描器特定代码或 Elo 特定 SDK 以接收扫描数据。

这是 Elo 与 Zebra 共同交付的第一个软件平台集成。DataWedge 由 Zebra 构建，并由 Elo 集成到 Elo Android 操作系统镜像中，因此在 MR-9 更新后开箱即用——无需单独下载或侧载。

为什么重要

• 重用现有应用逻辑。 已经针对 Zebra 设备上的 DataWedge 配置文件和意图编写的应用程序设计为在 Elo I-Series 5 上运行，而无需重写其扫描集成。
• 无需扫描器 SDK。 扫描数据作为键击或意图到达，因此新应用可以在不集成特定设备 SDK 的情况下支持扫描。
• 每个应用自动行为。 配置文件与应用绑定；当应用处于前台时，DataWedge 自动切换配置文件，无需用户操作。
• 可重复的车队配置。 在一台设备上构建的配置可以导出并导入到其他设备。

2. 硬件和平台兼容性

支持的设备和操作系统

最低操作系统： Elo Android 14 MR-9，版本7.000.009.0046+gen5p或更高。
可用性： 2026年10月28日，EloView门户上的下拉OTA；2026年11月4日起，EloView 和 OEMConfig上的默认OTA。

支持的输入源

Zebra TechDocs 参考:

条形码输入: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/

3. 功能

第 1 阶段提供了条形码捕获、配置文件管理、数据交付和配置的核心 DataWedge 功能集。功能描述遵循 Zebra 的 DataWedge 文档；请参阅 Zebra TechDocs（https://techdocs.zebra.com/datawedge/latest/guide/about/）以获取完整参数参考。

3.1 数据捕获

Zebra TechDocs 参考:

条形码输入: https://techdocs.zebra.com/datawedge/latest/guide/input/barcode/
数据捕获增强: https://techdocs.zebra.com/datawedge/latest/guide/input/dcp/

3.2 数据交付和格式化

Zebra TechDocs 参考:

键击输出: https://techdocs.zebra.com/datawedge/latest/guide/output/keystroke/
意图输出: https://techdocs.zebra.com/datawedge/latest/guide/output/intent/
BDF: https://techdocs.zebra.com/datawedge/latest/guide/process/bdf/
ADF: https://techdocs.zebra.com/datawedge/latest/guide/process/adf/

3.3 配置文件管理

Zebra TechDocs 参考:

DataWedge 配置文件: https://techdocs.zebra.com/datawedge/latest/guide/profiles/

3.4 DataWedge 设置和部署

Zebra TechDocs 参考:

DataWedge 设置: https://techdocs.zebra.com/datawedge/latest/guide/settings/

3.5 程序控制和工具

Zebra TechDocs 参考:

DataWedge APIs: https://techdocs.zebra.com/datawedge/latest/guide/api/
DWDemo: https://techdocs.zebra.com/datawedge/latest/guide/samples/dwdemo/

4. 开始使用

步骤 1 - 更新操作系统

1. 通过 EloView 门户或设备上的 EloView 控制面板将设备更新为 Elo Android 14 MR-9 (7.000.009.0046+gen5p) 或更高。其他 MDM 用户可以使用 Elo OEMConfig 的自动和手动更新功能。
2. 如果使用 Edge Connect 条形码扫描器，请将其连接到设备。
3. 从应用启动器打开 DataWedge 应用。

步骤 2 - 启用 Profile0 并进行验证

• Profile0 是适用于没有自己配置文件的每个应用程序的后备配置文件。在发布版本中，它默认关闭，因此没有自己配置文件的应用程序不会显示浮动扫描按钮，并且 DataWedge 不会保持相机，直到您打开它。
• 要启用它，请打开Android 设置 Elo 设置并打开DataWedge 扫描（Profile0）。然后打开DWDemo，使用连接的扫描器扫描条形码（或按住黄色屏幕扫描按钮：将扫描器选择设置为自动则使用连接的 USB 扫描器，且在未连接 USB 扫描器时使用前置相机扫描），并确认数据出现。
• 在使用 Elo 设置控制时，DataWedge 应用中的 Profile0 条目是灰色的（“管理员禁用”）；请通过 Elo 设置更改 Profile0。
• 要在不接触每个设备的情况下启用扫描，为您的应用程序提供自己的配置文件，而不是依赖于 Profile0。每当其应用程序在前台时，就会应用配置文件，无论 Profile0 的设置如何。在参考设备上创建它，并通过自动导入（第 5 步）将其推送到整个车队，或者让应用程序首次启动时使用 DataWedgeSET_CONFIG Intent API创建它（见开发人员介绍）。

步骤 3 - 为您的应用创建配置文件

4. 在 DataWedge 中，打开菜单并选择新配置文件；输入名称。
5. 打开关联应用并添加您的应用包（可选，具体活动）。
6. 在条形码输入下，确保启用输入并在扫描器选择下选择设备（默认情况下为自动；要选择特定外部扫描器或前置相机，请打开菜单并选择保留新扫描器）。注意：在条形码输入扫描器选择中选择的扫描器是配置文件使用的扫描器；配置扫描器设置仅设置该扫描器的参数。
7. 在解码器下，仅启用您的工作流程所需的符号。
8. 选择输出：对于读取文本字段的应用程序选择键击输出，或对于以编程方式接收扫描数据的应用程序选择意图输出（设置意图动作、类别和交付方式以匹配您的应用程序的接收者）。禁用未使用的输出。
9. 可选地在基本或高级数据格式化下添加前缀、后缀或规则。
10. 将您的应用程序带到前台——DataWedge 会自动切换到新配置文件。

步骤 4 - 控制 Profile0 和屏幕扫描按钮

• Profile0 默认关闭，因此没有自己配置文件的应用程序不会显示浮动扫描按钮。从Android 设置 > Elo 设置 > DataWedge 扫描（Profile0）中打开或关闭它。
• 在每个新配置文件中，数据捕获增强默认开启，因此浮动扫描按钮也会出现在具有自己配置文件的应用程序中。要为应用程序隐藏它，请打开该应用程序的配置文件并清除数据捕获增强 > 启用。
• 必须不共享相机或接收扫描数据的应用程序——例如tap-to-pay / SoftPOS 付款应用程序检测到相机使用——应添加到设置 > 禁用应用列表中，或者 Profile0 应保持关闭。

步骤 5 - 将配置部署到您的车队

11. 在配置好的参考设备上，打开DataWedge 设置导出并导出完整配置（datawedge.db）或单个配置文件（dwprofile\_<name>.db）。
12. 使用 MDM 将文件推送到目标设备上的 DataWedge 自动导入文件夹：

13. DataWedge 自动导入该文件并应用，无需重启。请勿重命名或编辑导出的 .db 文件。

对于开发人员

• 使用 DataWedge 意图 API 切换配置文件、触发扫描，以及从您的应用程序创建或更新配置文件： https://techdocs.zebra.com/datawedge/latest/guide/api/
• 配置文件和插件参考： https://techdocs.zebra.com/datawedge/latest/guide/profiles/
• 已经在 Zebra Android 设备上与 DataWedge 集成的应用程序设计为不需要扫描代码更改以使用第 1 阶段功能集。

5. 资源和支持

• Zebra DataWedge 文档： https://techdocs.zebra.com/datawedge/latest/guide/about/
• Elo 支持： https://www.elotouch.com/support