아키텍처 규칙
초점 동작이 허용되는 제어된 양식 입력 작업 흐름에는 웨지를 사용하세요. 구조화된 스캔 전달이 가능하고 스캐너 구성이 외부에 유지될 수 있는 경우 인텐트를 사용하세요. 앱이 트리거 세션, 기호, 출력 모드 또는 세부 스캐너 상태를 소유해야 하는 경우 SDK 를 사용하세요. 정확한 장치와 펌웨어를 검증하십시오.
키보드 웨지: 로우 코드, 숨겨진 상태
웨지 모드는 집중 제어에 문자를 삽입하고 웹 또는 레거시 앱과 함께 작동할 수 있습니다. 입력 수준에서는 이식 가능하지만 포커스, 키보드 레이아웃, IME, 접두사, 접미사 및 타이밍에 따라 달라집니다.
스캔이 검색, 메모 또는 인증 필드에 입력되는 것을 방지합니다. Enter 또는 Tab이 추가되는지 정의하고 긴 코드, 빠른 스캔 및 수동 입력을 테스트합니다.
- 명시적인 스캔 준비 필드 상태
- 접두사와 접미사가 문서화됨
- IME 및 키보드 레이아웃이 수정되었습니다.
- 중복 제출 보호
브로드캐스트 의도: Android 수명 주기 규칙을 사용한 구조화된 전달
의도 출력은 스캔 데이터를 텍스트 포커스와 분리합니다. 수신자는 작업과 추가 항목을 검사하고, 길이를 확인하고, 이벤트를 활성 워크플로로 라우팅할 수 있습니다.
작업 이름, 추가 항목 및 수신자 요구 사항은 공급업체 및 SDK 버전에 따라 다릅니다. 적절한 수명 주기에 따라 등록 및 등록 취소하고, 가능한 경우 노출을 제한하고, 예상치 못한 페이로드를 거부하세요.
- 정확한 동작 및 추가 키
- 수신기 내보내기 및 권한 검토
- 전경 및 배경 동작
- 원시 바이트와 디코딩된 문자열
공급업체 SDK: 명시적 제어 및 명시적 결합
SDK 는 스캐너를 열고 닫고, 출력 모드를 선택하고, 기호를 구성하고, 디코딩 세션을 시작하거나 중지할 수 있습니다. 이는 스캔 동작이 애플리케이션 상태 머신의 일부인 경우에 적합합니다.
애플리케이션 인터페이스 뒤에서 공급업체 호출을 래핑하고, 반환 값을 기록하고, 정리를 멱등적으로 만듭니다. API 가용성이 동일한 엔진 또는 펌웨어 동작을 보장하지 않으므로 장치 호환성 매트릭스를 유지하세요.
- 공급업체 API 주변 어댑터
- 소유권 열기, 시작, 중지 및 닫기
- 가능한 경우 구성 다시 읽기
- 실패 및 시간 초과 상태 표시
데이터 무결성 및 수명주기 검증
콜드 스타트, 재개, 화면 잠금, 앱 전환, 지원되는 경우 회전, 재부팅, MDM 키오스크 모드 및 빠른 반복 트리거를 테스트합니다. 각 물리적 스캔이 하나의 의도된 비즈니스 이벤트를 생성하는지 확인하십시오.
비ASCII 및 제어 문자에 대해 알려진 바이트 시퀀스를 사용합니다. 애플리케이션이 원시 바이트, 디코딩된 텍스트, 기호 및 타임스탬프를 저장할지 여부를 결정합니다. 민감한 스캔 값을 기록하지 마세요.
- 스캔 한 번은 거래 한 번과 같습니다
- 스캔이 잘못된 화면으로 이동하지 않습니다.
- 인코딩 및 길이 확인됨
- 복구에는 장치 재부팅이 필요하지 않습니다.
웨지 vs 인텐트 vs SDK
필요한 제어를 제공하는 최소 통합 수준을 선택하십시오.
| 기준 | 키보드 웨지 | 방송 의도 | 공급업체 SDK |
|---|---|---|---|
| 구현 노력 | 낮음 | 중간 | 중간에서 높음 |
| 초점 의존성 | 높음 | 낮음 | 낮음 |
| 스캐너 제어 | 대부분 외부 구성 | 외부 또는 제한 | 애플리케이션 소유 |
| 데이터 구조 | 문자 및 접미사 | 명명된 엑스트라 | API 이벤트 또는 브로드캐스트 |
| 이식성 | 입력 수준 이식성 | 공급업체 작업 매핑 | 공급업체 API 어댑터가 필요합니다. |
통합 검증 체크리스트
장치, OS, 펌웨어, SDK 및 애플리케이션 빌드별로 결과를 기록합니다.
- 01
의도한 출력 모드만 활성화됩니다.
- 02
웨지에 대해 테스트된 포커스 및 접미사 동작
- 03
인텐트 작업 및 추가 항목이 검증되었습니다.
- 04
수신기 수명주기 및 노출 검토
- 05
SDK 열기 및 닫기 반환 값이 처리되었습니다.
- 06
테스트된 신속한 트리거 및 중복 이벤트
- 07
절전, 재개, 재부팅 및 앱 전환 테스트됨
- 08
인코딩 및 긴 페이로드가 확인되었습니다.
- 09
로그에서 제외된 제한된 데이터
- 10
롤백 및 구성 재설정 문서화
자주 묻는 질문
키보드 웨지는 생산에 충분히 신뢰할 수 있습니까?
워크플로가 포커스, 키보드 구성, 접미사 및 중복 제출을 엄격하게 제어하는 경우일 수 있습니다. 입력을 받을 수 있는 모든 화면을 확인합니다.
Android 스캐너 의도가 표준화되어 있나요?
아니요. 브로드캐스트 작업 이름, 추가 기능, 구성 및 권한은 장치 공급업체 및 SDK 버전에 따라 다를 수 있습니다.
앱은 항상 SDK 공급업체를 사용해야 하나요?
아니요. 애플리케이션에 스캐너 제어가 필요하거나 웨지 및 구성된 인텐트가 제공할 수 없는 상태가 있을 때 사용하세요. SDK 는 수명 주기 및 호환성 작업을 추가합니다.
증거와 한계
엔지니어링 아키텍처 지침/정확한 동작에는 장치 검증이 필요합니다.
Android 플랫폼 원칙은 UROVO SDK 증거와 결합됩니다. 공급업체 간 API 동등성이 주장되지 않습니다.
검토됨: 2026-08-10
- Android 개발자 문서: 입력 이벤트 및 브로드캐스트 수신기
- RuggedLayer가 UROVO Android SDK v4를 승인했습니다.1.0326 API 참조

