Wear OS でアプリを作成して実行する

このページでは、Android Studio のテンプレートを使用して、Wear OS 用に初めてのアプリを作成する方法を示します。このアプリでは、Wear OS デバイスで情報を一目で確認できるさまざまな方法を示し、プラットフォーム上でアプリを開発するためのベスト プラクティスをいくつか紹介します。

このガイドは、Android プラットフォームと Android Studio IDE に関するある程度の予備知識をもとに作成されています。Android を初めて使う場合は、こちらの Codelab を使用してアプリを作成してください。Android Studio の機能の詳細については、Android Studio の概要のページをご覧ください。

Wear OS アプリを作成する

最新バージョンの Android Studio をダウンロードしてインストールした後、「新しいプロジェクト」ウィザードを完了します。

  1. Android Studio を開き、[File] > [New] > [New Project] と移動します。[New Project] ウィンドウが表示されます。
  2. [Templates] ペインで [Wear OS] を選択します。次に、メインペインで [Empty Wear App] を選択します。
  3. プロジェクトに名前を付けて、[Finish] をクリックします。Android Studio で、必要な依存関係がダウンロードされ、プロジェクトの初期バージョンがビルドされます。

  4. [Tools] > [SDK Manager] に移動し、[Show Package Details] をクリックして、次のパッケージをインストールします。

    • Android 15.0（VanillaIceCream）（API レベル 35-ext15）。Wear OS 5.1 ARM 64 v8a システム イメージと Wear OS 5.1 Intel x86 Atom_64 システム イメージが含まれています。
    • Android 14.0（「UpsideDownCake」）（API レベル 34）。Wear OS 5 ARM 64 v8a システム イメージと Wear OS 5 Intel x86 Atom_64 システム イメージが含まれています。
    • Android 13.0（Tiramisu）（API レベル 33）。Wear OS 4 ARM 64 v8a システム イメージと Wear OS 4 Intel x86 Atom_64 システム イメージが含まれます。

    SDK Manager を閉じるには、[OK] をクリックします。

これで、Wear OS で初めてのアプリを実行する準備ができました。

エミュレータでアプリを実行する

初めての Wear OS アプリを実行するには、エミュレータを構成するのが最も簡単な方法です。

エミュレータを構成する

Android Studio でエミュレータを構成する手順は次のとおりです。

  1. SDK Manager で、[SDK Tools] タブを開きます。Android SDK Platform-Tools が最新バージョンであることを確認します。
  2. [Tools] > [Device Manager] と移動します。
  3. [作成（+）] を選択します。[Virtual Device Configuration] ウィザードが表示されます。
  4. [Category] ペインで [Wear OS] を選択し、[Wear OS Small Round] などのハードウェア プロファイルを選択します。[Next] をクリックします。

  5. 中国以外で使用されるシステム イメージの場合は、リリース名 [UpsideDownCake] を選択します。このリリースは Android 14.0（Wear OS 5）を対象としています。中国で使用されるシステム イメージの場合は、リリース名 [R] を選択します。このリリースは Android 11.0（Wear OS 3）を対象としています。デバイス定義と一致する Wear OS 5 システム イメージをまだインストールしていない場合は、[Release Name] の横にある [Download] をクリックして入手します。[次へ] をクリックします。

    注: Wear OS エミュレータのシステム イメージには、サードパーティのファイルとソースコードに関する通知が含まれます。特定のシステム イメージに対するサードパーティの通知については、次のいずれかのディレクトリにある NOTICE.txt ファイルでご確認ください。

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI: 中国以外で使用されるエミュレータの場合
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI: 中国で使用されるエミュレータの場合

  6. エミュレータをカスタマイズする場合を除き、この画面のすべての設定のデフォルト値を維持できます。[Finish] をクリックします。

エミュレータの使い方について詳しくは、Android Emulator 上でアプリを実行する方法についてのガイドをご覧ください。

エミュレータでアプリを開く

  1. [Run] > [Select Device] と移動します。作成したエミュレータを選択します。
  2. Android Studio のツールバーで、実行ボタン をクリックします。エミュレータが起動してアプリが開きます。
  3. しばらくすると、エミュレータに「Hello...」というメッセージが表示されます。

エミュレータを使用して Bluetooth オーディオをテストする

Wear OS 4 以上を搭載したシステム イメージのエミュレータでは、エミュレートされた Bluetooth がサポートされているため、複数のユースケースで Bluetooth オーディオをテストできます。

最近のシステム イメージは 64 ビット アーキテクチャのみをサポート

Wear OS 4 以降のエミュレータ システム イメージは、64 ビット アーキテクチャ（x86-64 と arm64-v8a）のみをサポートしています。アプリが（Kotlin や Java プログラミング言語で記述されていない）ネイティブ コードを使用していることがわかっている場合や、その疑いがある場合は、アプリに 32 ビットと 64 ビットのネイティブ ライブラリがともに含まれていることを確認します。

64 ビット アーキテクチャのサポート方法をご覧ください。

実際のスマートウォッチでアプリを実行する（省略可）

実際のスマートウォッチでアプリを実行してデバッグすると、全体的なユーザー エクスペリエンスをより適切に評価できます。アプリがセンサーや GPU などの特定のハードウェアに依存している場合は、これが特に重要です。

実際のスマートウォッチでアプリを実行するには、テスト用のデバイスを準備してから、開発マシンに接続します。

テスト用のスマートウォッチを準備する

テスト用にスマートウォッチを準備するには、次の手順で ADB デバッグを有効にします。

  1. スマートウォッチで [設定] メニューを開きます。
  2. メニューの一番下までスクロールします。[開発者向けオプション] 項目が表示されていない場合は、次のサブステップを行います。それ以外の場合は、次のステップに進みます。
    1. [システム] > [基本情報] または [システム] > [基本情報] > [バージョン] をタップします。
    2. [ビルド番号] 項目を 7 回タップします。スマートウォッチが PIN またはパターンで保護されている場合は、入力を求めるメッセージが表示されてから入力します。
  3. [設定] メニューで [開発者向けオプション] をタップします。
  4. [ADB デバッグ] オプションを有効にします。

スマートウォッチを開発マシンに接続する

一部のスマートウォッチは USB 経由で接続できます。その他はワイヤレス接続が必要です。

USB 経由で有線接続を設定する

次の手順に沿ってスマートウォッチを接続します。

  1. USB ケーブルを使用して、スマートウォッチを開発マシンに接続します。
  2. スマートウォッチで、[このパソコンからの USB デバッグを常に許可する] を有効にして [OK] をタップします。

ワイヤレス接続を設定する

スマートウォッチに USB ポートがない場合は、Wi-Fi または Bluetooth を使用してスマートウォッチを接続する方法をご覧ください。

特定バージョンの Wear OS をインストールする（省略可）

アプリのテストケースが特定のバージョンの Wear OS に依存している場合は、USB（有線）データ接続をサポートするスマートウォッチにソフトウェア イメージを書き込むことができます。たとえば、Google Pixel Watch 3 または Google Pixel Watch 2 デバイスには、ファクトリー イメージやフル OTA イメージを書き込むことができます。

スマートウォッチでアプリを開く

  1. [Run] > [Select Device] と移動します。マシンに接続されているスマートウォッチを選択します。
  2. Android Studio のツールバーで、実行ボタン をクリックします。エミュレータが起動してアプリが開きます。
  3. しばらくすると、スマートウォッチに「Hello...」というメッセージが表示されます。