이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Wear OS 5.1

Android 스튜디오의 공식 에뮬레이터에서 사용할 수 있는 최신 버전의 Wear OS를 살펴보세요. 타겟 SDK 버전을 업데이트한 후 앱이 예상대로 실행되는지 확인합니다.

Wear OS 5.1은 Android 15 (API 수준 35)를 기반으로 하므로 Wear OS 5용으로 이미 API 수준 34를 타겟팅하는 앱을 테스트해야 합니다.

테스트용 에뮬레이터 준비

공식 에뮬레이터에서 Wear OS 5.1을 실행하려면 먼저 에뮬레이터에서 실행되는 시스템 이미지를 다운로드하여 설치해야 합니다. 그런 다음 이 시스템 이미지를 실행하는 가상 기기를 만들어야 합니다.

올바른 시스템 이미지를 다운로드하고 설치하려면 다음 단계를 완료하세요.

아직 Android 스튜디오 Meerkat의 최신 버전을 다운로드하지 않았다면 다운로드하여 설치합니다.
Android 스튜디오에서 Tools > SDK Manager를 클릭합니다.
SDK Platforms 탭에서 Android 15.0("VanillaIceCream") 섹션을 펼치고 Wear OS 5.1 - Preview ARM 64 v8a System Image 또는 Wear OS 5.1 - Preview Intel x86_64 Atom System Image를 선택합니다.
OK(확인)을 클릭합니다. 변경사항 확인 창이 표시되면 확인을 다시 클릭합니다.
Android 스튜디오가 시스템 이미지를 다운로드하여 설치할 때까지 기다린 다음 Finish를 클릭합니다.

공식 에뮬레이터에서 이 시스템 이미지를 실행하는 가상 기기를 만들려면 다음 단계를 완료하세요.

Android 스튜디오에서 Tools > Device Manager를 선택하여 기기 관리도구를 엽니다. 기기 관리도구 창이 나타납니다.
Device Manager 창 내 툴바에서 Add a new device(새 기기 추가)> Create Virtual Device(가상 기기 만들기)를 클릭합니다.
Form Factor 창에서 Wear OS를 선택하고 하드웨어 프로필을 선택합니다. Next를 클릭합니다.
사용할 Wear OS 5.1 시스템 이미지를 선택합니다. 시스템 이미지의 API 수준은 35여야 합니다.
다음을 클릭한 후 마침을 클릭합니다.

만든 이 가상 기기에서 앱을 테스트하려면 다음 단계를 완료하세요.

Wear OS 5.1에서 앱을 테스트할 때 앱이 Wear OS 5.1과 동일한 API 수준을 사용하는 Android 15의 모든 앱에 영향을 미치는 시스템 동작 변경사항을 어떻게 처리하는지 확인합니다.

Wear OS 5.1에서는 다음과 같은 몇 가지 동작 변경사항이 적용되지 않습니다.

앱의 타겟 SDK 버전을 API 수준 35로 업데이트하여 앱의 Wear OS 5.1 호환성을 개선할 수 있습니다. 이는 Android 15에서 사용하는 API 수준과 동일합니다.

이렇게 하려면 모듈 수준 build.gradle 또는 build.gradle.kts 파일을 열고 Wear OS 5.1 값으로 업데이트합니다.

빌드 파일에서 값의 형식을 지정하는 방법은 사용 중인 AGP(Android Gradle 플러그인)의 버전에 따라 다릅니다.

AGP 7.0.0 이상을 사용하는 경우 앱의 build.gradle 또는 build.gradle.kts 파일을 다음과 같은 Wear OS 5.1 값으로 업데이트합니다.

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 이하를 사용 중인 경우 앱의 build.gradle 또는 build.gradle.kts 파일을 다음과 같은 Wear OS 5.1 값으로 업데이트합니다.

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

타겟 SDK 버전을 API 수준 35로 업데이트한 후 Wear OS 5.1과 동일한 API 수준을 사용하는 Android 15를 타겟팅하는 앱의 변경사항을 처리합니다.

Wear OS 5.1에는 Wear OS 앱 환경을 개선하는 데 도움이 되는 여러 기능이 도입되었습니다.

살펴볼 만한 주요 기능은 다음과 같습니다.

인증 관리자 지원: Credential Manager API는 비밀번호, 패스키, 제휴 ID (예: Google 계정으로 로그인)를 사용하는 로그인 흐름을 지원하는 통합 인증 솔루션을 제공합니다. 사용자의 사용자 인증 정보는 기기 간에 계정 정보를 동기화하는 사용자 인증 정보 제공업체에 저장됩니다.
시계 스피커 재생: 시계 스피커를 통한 미디어 재생을 지원하는 기기에서 앱이 Wear Output Switcher와 통합된 경우 사용자는 이 스피커를 기본 미디어 출력 옵션으로 선택할 수 있습니다.

Wear OS 5.1 에뮬레이터에서 사용할 수 있는 시스템 이미지는 다음과 같은 특성을 갖습니다.

Wear OS 5.1이 포함된 시스템 이미지에는 다음과 같은 알려진 문제가 있습니다.