Android Emulator を使用すると、仮想 デバイスで Wear OS アプリケーションをテストできます。その機能の多くはメインのAndroid Emulator ドキュメントで説明されています。このページでは、Wear OS 開発に固有の機能、テスト機能、 トラブルシューティングのヒントについて説明します。
基本的な設定手順については、Wear OS でアプリを作成して実行するをご覧ください。
Wear OS のテスト機能
エミュレータには、Wear OS の機能をテストするための専用ツールが用意されています。
Bluetooth オーディオをテストする
エミュレータで Bluetooth オーディオをテストするをご覧ください。
センサーをシミュレートする
エミュレータでは、データの種類に応じて、ツールバーからさまざまな方法でセンサーデータをシミュレートできます。
- ヘルスサービスのデータ:
- エミュレータのツールバーから専用の [ヘルスサービス] パネルに直接アクセスします(ハート アイコン
を探してください)。このパネルでは、運動指標など、ヘルスサービス に固有のデータをきめ細かく制御してシミュレートできます。詳細な手順については、
ヘルスサービスでセンサーデータをシミュレートするをご覧ください。
- エミュレータのツールバーから専用の [ヘルスサービス] パネルに直接アクセスします(ハート アイコン
- その他のセンサー(位置情報、姿勢、心拍数など):
- その他のセンサータイプの場合は、エミュレータのツールバーのオーバーフロー ボタン(...)をクリックして、[Extended Controls] ウィンドウを開きます。
- 位置情報: Extended Controls > Location に移動して、単一の GPS ポイントを指定するか、ルートをシミュレートします。これは、Fused Location Provider API を使用してアプリをテストし、おおよその位置情報の処理を確認する場合に便利です。
- デバイスの姿勢(加速度計とジャイロスコープ): Extended Controls > Virtual Sensors > Device Pose に移動します。[Rotation](X-Rot、Y-Rot、Z-Rot)スライダーと [Movement](X、Y、Z)スライダーを調整して、モーションベースの操作をテストします。
- 心拍数と追加のセンサー: Extended Controls > Virtual Sensors > Additional Sensors に移動します。心拍数 や 、周囲温度 、磁場 、 近接 、光 、圧力 、相対湿度 などのセンサーをシミュレートします。
スマートウォッチの入力をシミュレートする
- タッチとジェスチャー: 標準のマウス操作でタッチを模倣します。
物理ボタン(回転するサイドボタンとベゼルを含む):
[エミュレータ パネル]の上部にあるボタンを使用して、ハードウェア ボタン(ボタン 1
、ボタン 2
)や、手のひらで覆う ![手のひらアイコン]デバイスを傾ける
、スワイプして戻る

ロータリー入力 の場合は、エミュレータのツールバーのオーバーフロー メニュー (... )を開き、[Rotary input] を選択します。
デバイスをペア設定する
エミュレータは、物理スマートフォンまたは仮想スマートフォンとのペア設定をサポートしています。Android Studio のデバイス マネージャーでWear OS エミュレータ ペア設定アシスタント を使用して、設定をガイドします。詳しくは、スマートウォッチをスマートフォンに接続するをご覧ください。
重要な考慮事項
テストを行う際は、技術面とパフォーマンス面で次の重要な考慮事項に注意してください。
64 ビット アーキテクチャのみ(最新のイメージ)
Wear OS 4(API 33)以降のエミュレータ システム イメージは、64 ビット アーキテクチャ (x86-64、arm64-v8a)のみをサポートしています。
パフォーマンスの違い
エミュレータのパフォーマンス(特にバッテリー消費量とレンダリング速度)は、物理デバイスと大きく異なる場合があります。最終的なパフォーマンスの検証とバッテリーの最適化は、必ず実際のハードウェアで行ってください。
既知の問題
このセクションでは、Wear OS エミュレータに固有の一般的な問題について説明します。エミュレータの一般的な 問題については、メインのAndroid Emulator に関する既知の問題のトラブルシューティングをご覧ください。
- 手首の傾きセンサーの警告:
the host has not provided value yet for sensorHandle=16のようなログメッセージが繰り返し表示されることがあります。これは無視してかまいません。 - Tiles レンダラ:
DashedArcLineオブジェクトとcircularProgressIndicator()で構築された要素は、API 36 エミュレータで正しくレンダリングされない場合があります。 - Google Pixel Watch アプリとのペア設定: ペア設定の手順を完了した後、スマートフォン エミュレータで Google Pixel Watch を 開くと、クラッシュが発生することがあります。スマートフォン エミュレータで [設定] -> [アプリ] -> [Google Pixel Watch] -> [権限] に移動し、[付近のデバイスを許可] の権限を許可します。