Démarrage

1. Installer le plugin

   bun add @capgo/capacitor-zebra-datawedge

2. Synchroniser les plateformes natives

   bunx cap sync android

3. Configurer DataWedge sur le dispositif

   • Créer ou choisir un profil DataWedge Zebra associé à votre package d'application.
   • Activer Intent Output.
   • Définir Intent delivery à Broadcast Intent.
   • Choisissez une action comme app.capgo.zebra.SCAN.

4. Révisez le comportement d'Android

   • Lisez les Notes d'Android avant d'activer les déclencheurs souples en production.

Configuration de base

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

Groupes de runtime principaux

• ZebraConfiguration gestionne les profils et les paramètres d'applications désactivées.
• ZebraNotification s'inscrit aux diffusions de notification DataWedge telles que l'état du scanner et les changements de profil.
• ZebraQuery lit les profils actifs, les applications associées, l'état du scanner, les listes de scanners et les informations de version.
• ZebraRuntime active ou désactive DataWedge, bascule les scanners et déclenche les balayages.

Portée du plateau

• Android : pleinement pris en charge sur les appareils Zebra avec DataWedge installé.
• iOS : non disponible car DataWedge est spécifique à Android Zebra.
• Web : non disponible au-delà de la conformité de forme API.