Android Studio の公式エミュレータで利用できる Wear OS の最新バージョンをご確認ください。targetSdkVersion のバージョンを更新した後、アプリが想定どおりに動作することを確認します。
Wear OS 5.1 は Android 15(API レベル 35)をベースとしています。そのため、Wear OS 5 で API レベル 34 をすでにターゲットとしているアプリをテストする必要があります。
テスト用にエミュレータを準備する
公式エミュレータで Wear OS 5.1 を実行するには、まずエミュレータで実行するシステム イメージをダウンロードしてインストールする必要があります。次に、このシステム イメージを実行する仮想デバイスを作成する必要があります。
システム イメージをダウンロードしてインストールする
適切なシステム イメージをダウンロードしてインストールする手順は次のとおりです。
- Android Studio Meerkat の最新リリースをダウンロードしてインストールします(まだインストールしていない場合)。
- Android Studio で [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] をクリックします。[変更の確認] ウィンドウが表示されたら、もう一度 [OK] をクリックします。
Android Studio がシステム イメージをダウンロードしてインストールするまで待ち、[完了] をクリックします。
仮想デバイスを作成する
公式エミュレータでこのシステム イメージを実行する仮想デバイスを作成する手順は次のとおりです。
- Android Studio でデバイス マネージャーを開くには、[Tools] > [Device Manager] を選択します。[デバイス マネージャー] ペインが表示されます。
- [デバイス マネージャー] ペインのツールバーで、[新しいデバイスを追加] > [仮想デバイスを作成] をクリックします。
- [Form Factor] ペインで [Wear OS] を選択し、ハードウェア プロファイルを選択します。[Next] をクリックします。
- 使用する Wear OS 5.1 システム イメージを選択します。システム イメージの API レベルは 35 である必要があります。
- [次へ]、[完了] の順にクリックします。
エミュレータでアプリをテストする
作成したこの仮想デバイスでアプリをテストするには、次の手順を完了します。
- Android Studio のツールバーに移動し、仮想デバイスを選択します。
- 実行アイコン をクリックします。
- 仮想デバイスにアプリをインストールし、アプリで使用するさまざまなユーザー向けワークフローを操作します。
すべてのアプリに影響する変更点
Wear OS 5.1 でアプリをテストする際は、Wear OS 5.1 と同じ API レベルを使用する Android 15 のすべてのアプリに影響するシステム動作の変更をアプリがどのように処理するかを確認してください。
Wear OS 5.1 では、いくつかの動作変更が適用されません。
- Wear OS 5.1 ではプライベート スペースはサポートされていません。
- 予測型「戻る」アニメーションが表示されないことがあります。
アプリのターゲット SDK バージョンを更新する
アプリのターゲット SDK バージョンを API レベル 35 に更新することで、アプリの Wear OS 5.1 との互換性を高めることができます。(これは、Android 15 で使用されている API レベルと同じです)。
これを行うには、モジュール レベルの build.gradle
ファイルまたは build.gradle.kts
ファイルを開き、Wear OS 5.1 の値で更新します。
ビルドファイルでの値の形式は、使用している Android Gradle プラグイン(AGP)のバージョンによって異なります。
AGP 7.0.0 以上
AGP 7.0.0 以上を使用している場合は、Wear OS 5.1 を表す次の値でアプリの build.gradle
または build.gradle.kts
ファイルを更新します。
Groovy
android { compileSdk 35 ... defaultConfig { targetSdk 35 } }
Kotlin
android { compileSdk = 35 ... defaultConfig { targetSdk = 35 } }
AGP 4.2.0 以下
AGP 4.2.0 以下を使用している場合は、Wear OS 5.1 を表す次の値でアプリの build.gradle
または build.gradle.kts
ファイルを更新します。
Groovy
android { compileSdkVersion "35" ... defaultConfig { targetSdkVersion "35" } }
Kotlin
android { compileSdkVersion = "35" ... defaultConfig { targetSdkVersion = "35" } }
API レベル 35 をターゲットとするアプリのみに影響する変更
ターゲット SDK バージョンを API レベル 35 に更新したら、Wear OS 5.1 と同じ API レベルを使用する Android 15 をターゲットとするアプリの変更に対処します。
新機能を確認する
Wear OS 5.1 には、Wear OS アプリのエクスペリエンスを向上させる機能がいくつか導入されています。
主な機能は次のとおりです。
- 認証情報マネージャーのサポート: 認証情報マネージャー API は、パスワード、パスキー、フェデレーション ID(Google でログインなど)を使用したログインフローをサポートする統合認証ソリューションを提供します。ユーザーの認証情報は認証情報プロバイダに保存され、デバイス間でアカウント情報が同期されます。
- スマートウォッチのスピーカーでの再生: スマートウォッチのスピーカーでのメディア再生をサポートしているデバイスでは、アプリが Wear Output Switcher と統合されている場合、ユーザーは、このスピーカーを優先するメディア出力オプションとして選択できます。
リリースノート
Wear OS 5.1 エミュレータで使用できるシステム イメージには、次の特性があります。
- リリース日: 2024 年 11 月 19 日
- ビルド ID: AP4A.241205.004.F1
既知の問題
Wear OS 5.1 を含むシステム イメージには、次の既知の問題があります。
- エミュレータでは、デバイスのリセット後のセットアップ フロー中にユーザーがアカウントを追加できない場合があります。
- 通知をタップしても、ユーザーが画面をスクロールするまで、通知を送信したアプリは開きません。
- Wear ヘルスサービスでエクササイズを開始できないことがある。