Erste Schritte

Installation

Du kannst unser KI-gestütztes Setup nutzen, um das Plugin zu installieren. Füge die Capgo Skills mit dem folgenden Befehl deinem KI-Tool hinzu:

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

Nutze dann diesen Prompt:

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

Wenn du ein manuelles Setup bevorzugst, installiere das Plugin mit den folgenden Befehlen und befolge die plattformspezifischen Anweisungen unten:

1. Plugin installieren

   bun add @capgo/capacitor-zebra-datawedge

2. Native Plattformen synchronisieren

   bunx cap sync android

3. DataWedge auf dem Gerät konfigurieren

   • Erstelle oder wähle ein Zebra-DataWedge-Profil, das deinem App-Package zugeordnet ist.
   • Aktivieren Intent Output.
   • Setzen Sie Intent delivery zu Broadcast Intent.
   • Wähle eine Aktion wie zum Beispiel app.capgo.zebra.SCAN.

4. Android-Verhalten prüfen

   • Lies die Android-Hinweise bevor du Soft Triggers in Produktion aktivierst.

Quickstart

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

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

Beispiel: createProfile

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

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

Beispiel: deleteProfile

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

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

Häufige Stolperfallen

• Listener: Handles beim Unmounten von Screens entfernen.
• Nativer Sync: ausführen bunx cap sync nach Plugin-Upgrades.
• Single Source of Truth: Vertrauen src/definitions.ts im GitHub Repo.

Basis-Setup

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

Haupt-Runtime-Gruppen

• ZebraConfiguration verwaltet Profile und Einstellungen für deaktivierte Apps.
• ZebraNotification registriert sich für DataWedge-Benachrichtigungs-Broadcasts, wie z. B. den Scanner-Status oder Profilwechsel.
• ZebraQuery Liest aktive Profile, zugehörige Apps, Scanner-Status, Scanner-Listen und Versionsinfos aus.
• ZebraRuntime Aktiviert oder deaktiviert DataWedge, wechselt Scanner und löst Scans aus.

Plattform-Scope

• Android: vollständig unterstützt auf Zebra-Geräten mit installiertem DataWedge.
• iOS: nicht verfügbar, da DataWedge spezifisch für Zebra-Android ist.
• Web: nicht verfügbar, abgesehen von der Shape-Parität zu API.

Weiter geht's nach Getting Started

Wenn du es nutzt Erste Schritte Um die Arbeit an nativen Plugins zu planen, verbinde sie mit @capgo/capacitor-zebra-datawedge verwenden für die native Funktionalität bei der Nutzung von @capgo/capacitor-zebra-datawedge, Capgo Plugin-Verzeichnis für den Produkt-Workflow im Capgo Plugin-Verzeichnis, Capacitor Plugins von Capgo für das Implementierungsdetail in Capacitor Plugins von Capgo, Plugins hinzufügen oder aktualisieren für das Implementierungsdetail beim Hinzufügen oder Aktualisieren von Plugins, und Ionic Enterprise Plugin-Alternativen für den Produkt-Workflow bei den Ionic Enterprise Plugin-Alternativen.