중국용 Wear OS 앱을 만드는 경우 Google Play 서비스가 사전 설치되지 않은 핸드셋을 고려해야 합니다. 이 페이지에는 국제 개발자가 중국 시장에 맞게 채택해야 할 수도 있는 공통 변경 사항이 포함되어 있습니다.
올바른 버전의 Google Play 서비스 사용
Google Play 서비스 버전 10.2.0은 Fused Location Provider API 및 Data Layer API에 관한 전 세계적인 지원을 제공합니다. 개발자가 이러한 API를 사용하는 경우 이 버전이 사용되어야 합니다. 그 외의 경우 이 종속 항목은 선택사항입니다.
Google Play 서비스에 이제 Wear 앱용 새 API가 포함되어 있기는 하지만 중국용 Wear OS 앱에서는 GoogleApiClient
와 관련된 API를 계속 사용해야 합니다. Wearable API 액세스를 참조하세요.
Fused Location Provider API
Fused Location Provider API를 사용하는 경우 Wear 모듈의 build.gradle
파일에 다음 종속 항목을 포함해야 합니다.
dependencies { ... compile 'com.google.android.gms:play-services-location:10.2.0' }
Data Layer API
중요: Data Layer API 사용은 Wear 2.0 이후 더 이상 권장되지 않습니다. 이제 앱이 인터넷에 직접 액세스할 수 있어 코드 개발이 단순화되기 때문입니다. 그뿐만 아니라 iOS와 페어링된 Wear 기기는 Data Layer API를 지원하지 않습니다.
앱이 Data Layer API를 사용하는 경우 Wear 모듈의 build.gradle
파일에 다음 행을 추가해야 합니다. 이 행이 실행되려면 클라이언트 라이브러리 10.2.0 버전을 사용해야 합니다.
dependencies { ... compile 'com.google.android.gms:play-services-wearable:10.2.0' ... }
또한 모바일 모듈의 build.gradle
파일에 다음 행을 추가해야 합니다. Google Play 서비스 종속 항목을 10.2.0 버전 참조로 대체합니다.
dependencies { ... compile 'com.google.android.gms:play-services-wearable:10.2.0' }
인증
인증을 구현하기 전에 사용 사례를 검토하여 인증이 실제로 필요한지 확인합니다. 예를 들어 일기 예보를 제공하는 앱의 경우 로그인할 필요가 없으므로 인증을 받을 필요도 없습니다.
인증이 필요한 경우 OAuth 2.0을 사용하거나 대체 방법으로 기기상의 입력을 사용하는 것이 좋습니다. 또는 데이터 영역을 사용하여 보안 토큰을 전달할 수 있습니다. 그러나 데이터 영역은 iOS 기기와 페어링된 Wear OS 기기를 지원하지 않으므로 사용하지 않는 것이 좋습니다.
브리지된 알림
브리지된 알림은 중국에서 지원되지 않습니다. Wear 기기가 블루투스를 통해 휴대전화에 연결된 경우에만 휴대전화 알림이 Wear OS에 브리지됩니다.
위치 및 매핑 좌표 호환성
다른 국가와 마찬가지로 중국에서도 FusedLocationProvider를 사용하여 사용자 위치를 감지해야 합니다. 이렇게 하면 앱이 시계 하드웨어 및 시계가 페어링된 휴대전화 플랫폼에 관계없이 최상의 정보를 고려하게 됩니다. Wear OS 플랫폼에 내장된 배터리 최적화의 이점도 있습니다.
FusedLocationProvider
를 제3자 지도 SDK와 통합하는 경우 제공자 간의 좌표 호환성을 고려해야 합니다.
FusedLocationProvider
는 WGS84 표준에 따라 위치를 보고합니다. 좌표계를 적절하게 변환해야 합니다.
Google 피트니스 지원
Google 피트니스의 누적된 단계 카운터, 운동 시간 및 심장 강화 점수가 중국에서 지원되며, 최대 7일간 기록이 유지됩니다. 사용자 인증 정보를 제공하지 않고 액세스할 수 있습니다.
에뮬레이터 지원
Wear OS 에뮬레이터 이미지의 중국 버전을 사용하여 앱을 테스트할 수 있습니다. 이 기능은 Android 스튜디오 3.0 이상에서 지원됩니다.
에뮬레이터의 중국 버전에서 앱을 테스트하려면 다음 단계를 따르세요.
- Android Emulator 26.1.2 버전을 설치했는지 확인합니다.
- SDK 관리자에서 중국용 Wear OS 이미지를 다운로드합니다.
- AVD 프로필을 만들 때 중국용 Wear OS 이미지를 사용하도록 선택합니다.
- 개발을 위한 중국용 Wear OS 에뮬레이터를 실행합니다.




앱 관련 블루투스 및 Wi-Fi 채널 시작
Wear OS는 네트워크 요청을 자동으로 라우팅합니다. 대부분의 경우 앱이 앱 관련 블루투스 및 Wi-Fi 채널을 열지 않아도 됩니다.
중국에서 앱이 앱 관련 블루투스 및 Wi-Fi 채널을 요청하는 경우 요청이 자동으로 실패합니다. 사용자에게 확인을 요청하는 팝업 대화상자가 표시됩니다. 사용자가 확인하면 채널이 열립니다. 이 동작은 처음 사용할 때만이 아니라 BluetoothAdapter.enable()
또는 WifiManager.setEnabled(true)
가 호출될 때마다 발생합니다.
참고: Android 10(API 수준 29) 이상을 타겟팅하는 앱에서 WifiManager.setEnabled()
를 호출하려면 앱이 시스템 앱이거나 기기 정책 컨트롤러(DPC)여야 합니다.
권한 검토 모드
중국에서는 중국용 Wear OS 기기가 Permission Review Mode
로 실행되므로 targetApiLevel
이 23 미만인 앱의 사용 방법에 몇 가지 제한이 적용됩니다.
- 설치 시 권한을 부여한 경우에도
targetApiLevel
이 23 미만인 앱을 처음 시작하면 사용자에게 이 앱의 권한을 확인하는 대화상자가 나타납니다. - broadcast receiver, 서비스, 활동 등 앱의 모든 구성요소가 앱을 처음 사용하기 전의 이벤트에 응답하지 않습니다.
따라서 targetApiLevel
23 이상을 사용하고 런타임 권한 권장사항을 채택하는 것이 좋습니다.
다른 Google Play 서비스 API 사용
Wearable API 이외의 Google Play 서비스 API를 사용하는 앱은 런타임 중에 이 API를 사용할 수 있는지 확인하고 적절하게 응답해야 합니다. 다음 두 가지 방법으로 Google Play 서비스 API의 가용성을 확인할 수 있습니다.
- 기타 API에 연결하는 데는 별도의 GoogleApiClient 인스턴스를 사용합니다. 이 인터페이스에는 연결의 성공 또는 실패를 앱에 알리는 콜백이 포함되어 있습니다. 연결에 실패하면 ConnectionResult에 API_UNAVAILABLE이 표시됩니다. 연결 실패를 처리하는 방법을 알아보려면 Google API 액세스를 참조하세요.
- 필수 API에 연결하는 데는 GoogleApiClient.Builder의 addApiIfAvailable() 메서드를 사용합니다. onConnected() 콜백이 실행되면 hasConnectedApi() 메서드를 사용하여 각각의 요청된 API가 올바르게 연결되었는지 확인합니다.
중국에서 앱 배포
중국용 Wear OS의 사용자에게 효과적으로 도달하기 위해, 제3자 Wear OS 앱 스토어를 통해 배포할 수 있습니다.
- Huawei App Store - Huawei 기기
- Mobvoi - 다른 모든 기기