スタートガイド

インストール

AIアシストによるセットアップでプラグインをインストールできます。以下のコマンドを使用して、お使いのAIツールに Capgo のスキルを追加してください：

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

次に、以下のプロンプトを使用します：

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 の形状の互換性以外は利用できません。

Getting Startedの続きを進める

使用している場合 スタートガイド ネイティブプラグインの作業を計画するには、次と連携してください： @capgo/capacitor-zebra-datawedge の使用方法 @capgo/capacitor-zebra-datawedge を使用してネイティブ機能を利用する場合、 Capgo プラグインディレクトリ Capgo プラグインディレクトリのプロダクトワークフローについては、 Capgo による Capacitor プラグイン Capgo による Capacitor プラグインの実装詳細については、 プラグインの追加または更新 プラグインの追加または更新における実装詳細については、および Ionic Enterprise プラグインの代替案 Ionic Enterprise プラグインの代替案におけるプロダクトワークフローについては。