Primeros pasos

Instalación

Puedes usar nuestro setup asistido por IA para instalar el plugin. Añade las skills de Capgo a tu herramienta de IA con el siguiente comando:

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

Luego usa el siguiente prompt:

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

Si prefieres la configuración manual, instala el plugin ejecutando estos comandos y sigue las instrucciones de cada plataforma:

1. Instalar el plugin

   bun add @capgo/capacitor-zebra-datawedge

2. Sincronizar plataformas nativas

   bunx cap sync android

3. Configura DataWedge en el dispositivo

   • Crea o selecciona un perfil de Zebra DataWedge asociado al package de tu app.
   • Activar Intent Output.
   • Configurar Intent delivery a Broadcast Intent.
   • Elige una acción como app.capgo.zebra.SCAN.

4. Revisa el comportamiento de Android

   • Lee la Notas de Android antes de habilitar soft triggers en producción.

Inicio rápido

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

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

Ejemplo: createProfile

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

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

Ejemplo: deleteProfile

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

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

Errores comunes

• Listeners: elimina los handles cuando se desmonten las pantallas.
• Sync nativo: ejecuta bunx cap sync tras actualizar los plugins.
• Fuente de verdad: confianza src/definitions.ts en el repo de GitHub.

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

Grupos de ejecución principales

• ZebraConfiguration gestiona perfiles y la configuración de apps deshabilitadas.
• ZebraNotification se registra para recibir notificaciones de DataWedge, como el estado del escáner y cambios de perfil.
• ZebraQuery lee perfiles activos, apps asociadas, estado del scanner, listas de scanners e info de versión.
• ZebraRuntime activa o desactiva DataWedge, cambia de scanner y dispara escaneos.

Alcance de la plataforma

• Android: soporte completo en dispositivos Zebra con DataWedge instalado.
• iOS: no disponible porque DataWedge es específico de Zebra Android.
• Web: no disponible más allá de la paridad de API.

Continúa desde Getting Started

Si estás usando Primeros pasos para planificar el trabajo con plugins nativos, conéctalo con Usando @capgo/capacitor-zebra-datawedge para la capacidad nativa en Uso de @capgo/capacitor-zebra-datawedge, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.