开始使用
复制一个包含安装步骤和本插件完整 Markdown 指南的配置提示。
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-zebra-datawedge`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/zebra-datawedge/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
-
安装插件
终端窗口 bun add @capgo/capacitor-zebra-datawedge -
同步本机平台
终端窗口 bunx cap sync android -
在设备上配置 DataWedge
- 创建或选择与您的应用程序包相关的 Zebra DataWedge 配置文件。
- 启用
Intent Output. - 设置
Intent delivery为Broadcast Intent. - 选择一个操作,如
app.capgo.zebra.SCAN.
-
查看 Android 行为
- 阅读 Android 笔记 在生产环境中启用软触发器之前。
基本设置
复制到剪贴板import { DataWedgeConfigMode, DataWedgePlugin, ZebraConfiguration, ZebraDataWedge, ZebraRuntime,} from '@capgo/capacitor-zebra-datawedge';
const intentAction = 'app.capgo.zebra.SCAN';
await ZebraConfiguration.setConfig({ profileName: 'CapgoZebraProfile', profileEnabled: true, configMode: DataWedgeConfigMode.CREATE_IF_NOT_EXIST, appList: [ { packageName: 'com.example.app', activityList: ['*'], }, ], pluginConfigs: [ { pluginName: DataWedgePlugin.BARCODE, resetConfig: true, paramList: { scanner_selection: 'auto', scanner_input_enabled: 'true', }, }, { pluginName: DataWedgePlugin.INTENT, resetConfig: true, paramList: { intent_output_enabled: 'true', intent_action: intentAction, intent_delivery: 2, }, }, ],});
await ZebraDataWedge.addListener('scan', (result) => { console.log('Scanned', result.data, result.labelType);});
const result = await ZebraRuntime.softScanTrigger(intentAction);console.log(result.data);管理配置文件和禁用应用设置。
注册数据韦奇数据传输广播,例如扫描器状态和配置文件切换。ZebraConfigurationSection titled “Basic setup”ZebraNotificationSection titled “Main runtime groups”ZebraQuery读取活跃的配置文件、关联的应用、扫描器状态、扫描器列表和版本信息。ZebraRuntime启用或禁用 DataWedge、切换扫描器并触发扫描。
平台范围
标题为“平台范围”- Android:在安装了 DataWedge 的 Zebra 设备上完全支持。
- iOS:不可用,因为 DataWedge 是 Zebra Android 专有的。
- Web:不支持超出 API 形状平衡。