Per iniziare

Installazione

Puoi usare il nostro setup assistito dall'IA per installare il plugin. Aggiungi le skill Capgo al tuo strumento di IA usando il seguente comando:

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

Poi usa il seguente prompt:

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

Se preferisci la configurazione manuale, installa il plugin eseguendo questi comandi e segui le istruzioni specifiche per piattaforma qui sotto:

1. Installa il plugin

   bun add @capgo/capacitor-zebra-datawedge

2. Sincronizza le piattaforme native

   bunx cap sync android

3. Configura DataWedge sul dispositivo

   • Crea o seleziona un profilo Zebra DataWedge associato al package della tua app.
   • Abilita Intent Output.
   • Imposta Intent delivery a Broadcast Intent.
   • Scegli un'azione come app.capgo.zebra.SCAN.

4. Verifica il comportamento di Android

   • Leggi la Note per Android prima di abilitare i soft trigger in produzione.

Avvio rapido

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

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

Esempio: createProfile

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

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

Esempio: deleteProfile

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

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

Errori comuni

• Listener: rimuovi gli handle quando gli schermi vengono smontati.
• Sync nativo: esegui bunx cap sync dopo gli aggiornamenti dei plugin.
• Fonte di verità: fidati src/definitions.ts nel repo GitHub.

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

Gruppi di runtime principali

• ZebraConfiguration gestisce i profili e le impostazioni delle app disabilitate.
• ZebraNotification registra i broadcast di notifica di DataWedge, come lo stato dello scanner e il cambio di profilo.
• ZebraQuery legge i profili attivi, le app associate, lo stato dello scanner, l'elenco degli scanner e le info sulla versione.
• ZebraRuntime abilita o disabilita DataWedge, cambia scanner e avvia le scansioni.

Ambito della piattaforma

• Android: supporto completo su dispositivi Zebra con DataWedge installato.
• iOS: non disponibile poiché DataWedge è specifico per Android di Zebra.
• Web: non disponibile oltre la parità di API.

Continua da Getting Started

Se stai usando Per iniziare per pianificare il lavoro sui plugin nativi, collegalo a Utilizzo di @capgo/capacitor-zebra-datawedge per la funzionalità nativa in Utilizzo di @capgo/capacitor-zebra-datawedge, Directory dei plugin di Capgo per il workflow del prodotto nella Capgo Plugin Directory, Plugin Capacitor di Capgo per i dettagli di implementazione in Capacitor Plugins di Capgo, Aggiunta o aggiornamento dei plugin per i dettagli su come aggiungere o aggiornare i plugin, e Alternative ai plugin Ionic Enterprise per il workflow del prodotto in Alternative ai plugin Ionic Enterprise.