タイルを実行してデバッグする

タイルはアプリではないため、異なるメカニズムを使用してデプロイおよび起動されます。デバイスで開発者向けオプションが有効になっている場合（エミュレータではこれらの機能がデフォルトで有効になっています）、タイル開発をサポートする追加機能が Android Studio と adb の両方で使用できるようになります。

タイルをデプロイする

タイルをデプロイするには、アプリをビルドして実行するで説明されているように、Android Studio を使用して実際のデバイスまたはエミュレータにアプリをインストールします。その後、一般ユーザーと同じ手順で、タイルをタイル カルーセルに追加します。

開発が活発な期間中は、Android Studio の 「Wear OS Tile」実行/デバッグ構成機能を使用する方が簡単で迅速な場合があります。この方法では、タイルが自動的にデプロイされて有効になるため、手動による追加の手順なしですぐに操作できます。

構成を自動的に作成する

タイルをデプロイして実行する最も簡単な方法は、ガターの [サービスを実行] アイコンを使用することです。実行構成がまだ存在しない場合は、自動的に作成されます。詳しくは、Wear OS の実行/デバッグ構成をご覧ください。

ガターの [▷] をクリックします

実行構成が自動的に作成されます

構成を手動で作成する

自動構成が機能しない場合や、結果をより詳細に制御したい場合は、次の手順をご覧ください。スクリーンショットは Android Studio Meerkat（2024.3.1）のものです。

1. タイトルバーから [⋮]（ハンバーガー）オプションを選択します。

   

2. [編集...] を選択します。

   

3. 表示されたダイアログで「+」を選択して、構成を追加します。

   

4. 新しい構成のタイプとして [Wear OS Tile] を選択します。

   

5. 構成の名前を入力し、必要に応じてモジュールとタイルを選択します。

   

6. [OK] をタップします。構成がタイトルバーに表示されます。[▷]（実行）ボタンをタップすると、タイルがデプロイされ、有効になります。

Android Studio でタイルをプレビューする

Android Studio Koala Feature Drop 以降では、Wear OS アプリのタイルのスナップショットを表示できます。このパネルは、デバイスのディスプレイ サイズに応じてコンテンツが変わる場合や、スポーツ イベントがハーフタイムに達した場合など、条件に応じてタイルの外観が変わる場合に特に便利です。

Android Studio のタイル プレビュー パネル。

依存関係を追加する

アプリの build.gradle.kts ファイルまたは build.gradle ファイルに次の依存関係を含めます。

dependencies {
    implementation("androidx.wear.tiles:tiles-tooling-preview:1.5.0")
    debugImplementation("androidx.wear.tiles:tiles-tooling:1.5.0")
    implementation("androidx.wear:wear-tooling-preview:1.0.0")
}

タイルのプレビューを設定する

さまざまな Wear OS ディスプレイ サイズでのタイルの外観をプレビューするには、@Preview アノテーションを追加して、device パラメータを渡します。この @Preview アノテーションは、コンポーザブル プレビューに使用するパッケージとは異なるパッケージのものです。

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
@Preview(device = WearDevices.LARGE_ROUND)
fun tilePreview(context: Context) = TilePreviewData(
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

注: @Preview アノテーションは Wear OS タイルに固有のものですが、device、name、group、fontScale、locale などの他のオプションは、Wear OS 版 Compose を使用するコンポーネントのプレビューと同様に、Wear OS タイルのプレビューでも機能します。

リソースを追加して登録する

タイルで Android リソースを使用する場合は、次のコード スニペットに示すように、TilePreviewData の onTileResourceRequest パラメータ内で登録する必要があります。

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithResources(context: Context) = TilePreviewData(
    onTileResourceRequest = { request ->
        Resources.Builder()
            .setVersion(myResourcesVersion)
            .addIdToImageMapping(
                    myImageId, getImageById(R.drawable.myDrawableImageId))
            .build()
    },
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

fun getImageById(
    @DrawableRes id: Int,
): ImageResource =
    ImageResource.Builder()
        .setAndroidResourceByResId(
            AndroidImageResourceByResId.Builder()
                .setResourceId(id)
                .build(),
        )
        .build()

プラットフォーム データソースから特定の値を表示する

タイルが心拍数、カロリー、距離、歩数などのプラットフォーム データを使用している場合、タイルにはそれらのデフォルト値が表示されます。

特定の値を表示するには、次のコード スニペットに示すように、TilePreviewData オブジェクトの作成時に platformDataValues パラメータを設定します。

import androidx.wear.tiles.tooling.preview.Preview

@Preview(device = WearDevices.SMALL_ROUND)
fun previewWithPlatformOverride(context: Context) = TilePreviewData(
    platformDataValues = PlatformDataValues.of(
        PlatformHealthSources.Keys.HEART_RATE_BPM,
        DynamicDataBuilders.DynamicDataValue.fromFloat(160f)
    ),
    onTileRequest = { request ->
        TilePreviewHelper.singleTimelineEntryTileBuilder(
            buildMyTileLayout()
        ).build()
    }
)

adb を使用してタイルを操作する

adb を使用すると、開発中にタイルをプログラムでインストール、削除、有効化できます。

次のコマンドでは、ComponentName はパッケージ名とそのパッケージ内のクラスで構成される文字列です（例: com.example.wear.tiles/com.example.wear.tiles.PreviewTileService）。

add-tile

COMPONENT_NAME によって提供されたタイルを追加し、インデックスを返します。

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation add-tile --ecn component [COMPONENT_NAME]

出力例:

Broadcast completed: result=1, data="Index=[0]"

カルーセルにタイルがすでに存在する場合は、タイルが削除され、同じ場所に再挿入されます。それ以外の場合は、Index[0] に挿入されます。また、カルーセルの容量が上限に達している場合は、最後のタイルが削除されて新しいタイルが追加されます。

show-tile

インデックス TILE_INDEX のタイルを有効にします。

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SYSUI --es operation show-tile --ei index [TILE_INDEX]

出力例:

Broadcast completed: result=1

remove-tile

COMPONENT_NAME に関連付けられているカルーセルのすべてのタイル インスタンスを削除します。

adb shell am broadcast -a com.google.android.wearable.app.DEBUG_SURFACE --es operation remove-tile --ecn component [COMPONENT_NAME]

出力例:

result=1, data="Tile(s) removed."

戻り値

• result=0: このコマンドに応答したブロードキャスト レシーバはありません。Wear OS のバージョンが古すぎるか、デバッグ プロセスが実行されていない可能性があります。
• result=1: 成功。
• result>1: エラー。