시작하기
이 플러그인의 설치 단계와 전체 마크다운 가이드가 포함된 설정 프롬프트를 복사하세요.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-zebra-datawedge`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/zebra-datawedge/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
설치
“설치” 섹션AI-Assisted Setup으로 플러그인을 설치할 수 있습니다. 다음 명령어로 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.수동 설정을 선호한다면, 다음 명령어를 실행하여 플러그인을 설치하고 아래의 플랫폼별 지침을 따르세요:
-
플러그인 설치
터미널 창 bun add @capgo/capacitor-zebra-datawedge -
네이티브 플랫폼 동기화
터미널 창 bunx cap sync android -
기기에서 DataWedge 설정하기
- 앱 패키지와 연결된 Zebra DataWedge 프로필을 생성하거나 선택하세요.
- 활성화
Intent Output. - 설정
Intent delivery대상Broadcast Intent. - 다음과 같은 동작을 선택하세요:
app.capgo.zebra.SCAN.
-
Android 동작 방식 확인
- 앱 스위처 동작에 대한 Android 참고 사항 프로덕션 환경에서 소프트 트리거를 활성화하기 전에.
빠른 시작
“빠른 시작” 섹션import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';
await ZebraDataWedge.cloneProfile({ destProfileName: 'dest-profile', sourceProfileName: 'source-profile',});예시: createProfile
“예시: createProfile” 섹션import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';
await ZebraDataWedge.createProfile({ profileName: 'profile' });예시: deleteProfile
“예시: deleteProfile” 섹션import { ZebraDataWedge } from '@capgo/capacitor-zebra-datawedge';
await ZebraDataWedge.deleteProfile({ profileNames: ['profile'] });자주 하는 실수
“흔한 실수” 섹션- 리스너: 화면이 언마운트될 때 핸들을 제거합니다.
- 네이티브 동기화: 실행
bunx cap sync플러그인 업그레이드 후. - 신뢰할 수 있는 소스: 신뢰
src/definitions.tsGitHub 레포지토리에서.
기본 설정
“기본 설정” 섹션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활성 프로필, 연결된 앱, 스캐너 상태, 스캐너 목록 및 버전 정보를 읽어옵니다.ZebraRuntimeDataWedge 활성화/비활성화, 스캐너 전환 및 스캔을 실행합니다.
플랫폼 범위
“플랫폼 범위” 섹션- Android: DataWedge가 설치된 Zebra 기기에서 완벽하게 지원됩니다.
- iOS: DataWedge는 Zebra Android 전용이므로 사용할 수 없습니다.
- Web: API 수준의 구조적 유사성 외에는 지원되지 않습니다.
시작하기 다음 단계
“Getting Started에서 계속하기” 섹션사용 중이라면 시작하기 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-zebra-datawedge 사용하기 @capgo/capacitor-zebra-datawedge 사용 시 네이티브 기능에 대해서는, Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.