快速入门

安装

你可以使用我们的 AI 辅助设置来安装插件。使用以下命令将 Capgo skills 添加到你的 AI 工具中：

bunx skills add https://github.com/Cap-go/capgo-skills --skill capacitor-plugins

然后使用以下 prompt：

Use the `capacitor-plugins` skill from `Cap-go/capgo-skills` to install the `@capgo/capacitor-zebra-datawedge` plugin in my project.

如果你更想手动设置，请运行以下命令安装插件，并按照下方各平台的说明操作：

1. 安装插件

   bun add @capgo/capacitor-zebra-datawedge

2. 同步原生平台

   bunx cap sync android

3. 在设备上配置 DataWedge

   • 创建或选择一个与您的应用包名关联的 Zebra DataWedge 配置方案。
   • 启用 Intent Output.
   • 设置 Intent delivery 改为 Broadcast Intent.
   • 选择如下操作： app.capgo.zebra.SCAN.

4. 检查 Android 行为

   • 阅读 Android 注意事项 并在生产环境中启用软触发器之前。

快速入门

import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';

await ZebraDataWedge.cloneProfile({
  destProfileName: 'dest-profile',
  sourceProfileName: 'source-profile',
});

示例：createProfile

import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';

await ZebraDataWedge.createProfile({ profileName: 'profile' });

示例：deleteProfile

import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';

await ZebraDataWedge.deleteProfile({ profileNames: ['profile'] });

常见坑点

• 监听器: 在页面卸载时移除句柄。
• 原生同步：运行 bunx cap sync 在插件升级后。
• 唯一可信来源：信任 src/definitions.ts 在 GitHub 仓库中。

基础设置

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);

主要运行时分组

• ZebraConfiguration 管理配置文件和已禁用应用的设置。
• ZebraNotification 注册 DataWedge 通知广播，例如扫描器状态和配置文件切换。
• ZebraQuery 读取当前配置文件、关联应用、扫描器状态、扫描器列表及版本信息。
• ZebraRuntime 启用或禁用 DataWedge、切换扫描器并触发扫描。

平台范围

• Android：在已安装 DataWedge 的 Zebra 设备上完全支持。
• iOS：不可用，因为 DataWedge 是 Zebra Android 专属的。
• Web：除 API 形态一致外，不可用。

从入门指南继续

如果你正在使用 快速入门 要规划原生插件工作，请将其与 使用 @capgo/capacitor-zebra-datawedge 用于“使用 @capgo/capacitor-zebra-datawedge”中的原生能力， Capgo 插件目录 查看 Capgo 插件目录中的产品工作流， Capgo 提供的 Capacitor 插件 查看由 Capgo 提供的 Capacitor 插件中的实现细节， 添加或更新插件 关于“添加或更新插件”中的实现细节，以及 Ionic Enterprise 插件替代方案 关于“Ionic Enterprise 插件替代方案”中的产品工作流。