HarmonyOS 분산 데이터 API를 활용한 크로스 디바이스 클립보드 앱 개발 가이드

핵심 기술

HarmonyOS의 강력한 분산(distributed) 기능을 활용하여 스마트폰과 태블릿 간에 실시간으로 텍스트를 공유하는 크로스 디바이스 클립보드 애플리케이션을 ArkTS 언어로 구축하는 방법을 안내합니다.

기술적 세부사항

• 애플리케이션 개요: HarmonyOS 기기 간 텍스트를 즉시 공유하는 분산 클립보드 앱 개발.
• 개발 환경: DevEco Studio를 사용하여 ArkTS 언어로 새로운 프로젝트 생성 (템플릿: Empty Feature Ability - Stage Model).
• 필수 권한: config.json 파일에 ohos.permission.DISTRIBUTED_DATASYNC 및 ohos.permission.DISTRIBUTED_DEVICE_MANAGER 권한 추가.
• 분산 데이터 API 활용: entry/src/main/ets/common/clipboard.ets 파일에서 distributedData API를 사용하여 KVStore를 생성하고 데이터를 관리합니다.
  • createKVManager: KVManager 인스턴스 생성.
  • getKVStore: SINGLE_VERSION 타입의 KVStore 인스턴스 획득.
  • put: 'shared_text' 키에 값을 저장.
  • get: 'shared_text' 키의 값을 비동기적으로 반환.
• UI 구현: pages/Index.ets 파일에서 ArkTS @Component를 사용하여 UI를 구성합니다.
  • @State를 사용하여 UI 상태 관리.
  • TextInput 위젯으로 텍스트 입력 및 변경 처리.
  • Button 위젯으로 텍스트 공유 기능 트리거.
  • 공유된 텍스트를 Text 위젯으로 표시.
• 실행 및 테스트: 두 개의 HarmonyOS 기기를 동일한 Wi-Fi에 연결하고 'Distributed Networking' 활성화 후 테스트.
• 문제 해결: kvStore is undefined (init 미호출), 텍스트 미동기화 (네트워크 설정), 권한 오류 (권한 미등록/미허용), 중복 storeId 오류 등의 일반적인 문제와 해결 방안 제시.