Wear Tiles

Wear OS by Google スマートウォッチ向けのアプリを作成します。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 6 月 4 日 1.5.0 - - -

依存関係の宣言

Wear への依存関係を追加するには、Google の Maven リポジトリをプロジェクトに追加する必要があります。詳しくは、Google の Maven リポジトリをご覧ください。

アプリまたはモジュールの build.gradle ファイルに、必要なアーティファクトの依存関係を追加します。

Groovy

dependencies {
    // Use to implement support for wear tiles
    implementation "androidx.wear.tiles:tiles:1.5.0"

    // Use to utilize standard components and layouts in your tiles
    implementation "androidx.wear.protolayout:protolayout:1.3.0"

    // Use to utilize components and layouts with Material Design in your tiles
    implementation "androidx.wear.protolayout:protolayout-material:1.3.0"

    // Use to include dynamic expressions in your tiles
    implementation "androidx.wear.protolayout:protolayout-expression:1.3.0"

    // Use to preview wear tiles in your own app
    debugImplementation "androidx.wear.tiles:tiles-renderer:1.5.0"

    // Use to fetch tiles from a tile provider in your tests
    testImplementation "androidx.wear.tiles:tiles-testing:1.5.0"
}

Kotlin

dependencies {
    // Use to implement support for wear tiles
    implementation("androidx.wear.tiles:tiles:1.5.0")

    // Use to utilize standard components and layouts in your tiles
    implementation("androidx.wear.protolayout:protolayout:1.3.0")

    // Use to utilize components and layouts with Material Design in your tiles
    implementation("androidx.wear.protolayout:protolayout-material:1.3.0")

    // Use to include dynamic expressions in your tiles
    implementation("androidx.wear.protolayout:protolayout-expression:1.3.0")

    // Use to preview wear tiles in your own app
    debugImplementation("androidx.wear.tiles:tiles-renderer:1.5.0")

    // Use to fetch tiles from a tile provider in your tests
    testImplementation("androidx.wear.tiles:tiles-testing:1.5.0")
}

依存関係について詳しくは、ビルド依存関係の追加をご覧ください。

フィードバック

お寄せいただいたフィードバックは Jetpack 改善の参考にさせていただきます。新しい問題が見つかった場合や、このライブラリを改善するアイデアをお持ちの場合は、お知らせください。新しい問題を報告していただく前に、このライブラリの既存の問題をご確認ください。スターボタンをクリックすると、既存の問題に投票できます。

新しい問題を報告する

詳細については、Issue Tracker のドキュメントをご覧ください。

バージョン 1.5

バージョン 1.5.0

2025 年 6 月 4 日

androidx.wear.tiles:tiles-*:1.5.0 がリリースされました。バージョン 1.5.0 に含まれる commit は次のとおりです。

1.4.0 以降の重要な変更

  • インタラクション タイル イベント（Enter / Leave）を一括で処理する新しい API TileService.onRecentInteractionEvents() を追加しました。
    • onEnterEvent と onLeaveEvent の TileService の既存の API は非推奨となり、API 36 以降をターゲットとするアプリでは SDK 36 以降で機能しなくなります
  • SDK 34 以上をターゲットとし、SecurityException を引き起こす API 34 でタイル更新をリクエストするクライアントに関する重大なバグを修正しました。
  • Wear 6（SDK レベル 36 以降）以降、すべてのタイルは各デバイスで定義されたシステム フォントで表示されます。

バージョン 1.5.0-rc01

2025 年 5 月 20 日

androidx.wear.tiles:tiles-*:1.5.0-rc01 がリリースされました。以前のリリースからの変更はありません。バージョン 1.5.0-rc01 に含まれる commit はこちらをご覧ください。

バージョン 1.5.0-beta02

2025 年 5 月 7 日

androidx.wear.tiles:tiles-*:1.5.0-beta02 がリリースされました。バージョン 1.5.0-beta02 には、これらの commit が含まれています。

バージョン 1.5.0-beta01

2025 年 4 月 9 日

androidx.wear.tiles:tiles-*:1.5.0-beta01 がリリースされました。バージョン 1.5.0-beta01 には、これらの commit が含まれています。

新機能

Wear Tiles の 1.5.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear Tiles 1.5 には、次の新機能と API が含まれています。

  • インタラクション タイル イベント（Enter / Leave）を一括で処理する新しい API TileService.onRecentInteractionEvents() を追加しました。
    • onEnterEvent と onLeaveEvent の TileService の既存の API は非推奨となり、API 36 以降をターゲットとするアプリでは SDK 36 以降で機能しなくなります
  • SDK 34 以上をターゲットとし、SecurityException を引き起こす API 34 でタイル更新をリクエストするクライアントに関する重大なバグを修正しました。
  • Wear 6（SDK レベル 36 以降）以降、すべてのタイルは各デバイスで定義されたシステム フォントで表示されます。

バージョン 1.5.0-alpha10

2025 年 3 月 12 日

androidx.wear.tiles:tiles-*:1.5.0-alpha10 がリリースされました。バージョン 1.5.0-alpha10 に含まれる commit はこちらをご覧ください。

バージョン 1.5.0-alpha09

2025 年 2 月 26 日

androidx.wear.tiles:tiles-*:1.5.0-alpha09 がリリースされました。バージョン 1.5.0-alpha09 に含まれる commit はこちらをご覧ください。

バージョン 1.5.0-alpha08

2025 年 2 月 12 日

androidx.wear.tiles:tiles-*:1.5.0-alpha08 がリリースされました。バージョン 1.5.0-alpha08 に含まれる commit はこちらをご覧ください。

API の変更

  • TileService.onRecentInteractionEvents(): ListenableFuture<Void> を返して長時間実行タスクを許可します。（Iaa6c5）

バージョン 1.5.0-alpha07

2025 年 1 月 29 日

androidx.wear.tiles:tiles-*:1.5.0-alpha07 がリリースされました。バージョン 1.5.0-alpha07 には、これらの commit が含まれています。

バージョン 1.5.0-alpha06

2025 年 1 月 15 日

androidx.wear.tiles:tiles-*:1.5.0-alpha06 がリリースされました。バージョン 1.5.0-alpha06 に含まれる commit はこちらをご覧ください。

API の変更

  • processRecentInteractionEvents メソッドの名前を onRecentInteractionEvents に変更しました。（Iec3d5）

バージョン 1.5.0-alpha05

2024 年 12 月 11 日

androidx.wear.tiles:tiles-*:1.5.0-alpha05 がリリースされました。バージョン 1.5.0-alpha05 には、これらの commit が含まれています。

新機能

  • インタラクション イベントを一括で処理する TileService の API を追加しました。（I04d1b）

バグの修正

  • このライブラリは、型使用である JSpecify nullness アノテーションを使用するようになりました。Kotlin デベロッパーは、次のコンパイラ オプションを使用して、正しい使用を強制する必要があります。-Xjspecify-annotations=strict（これは、Kotlin コンパイラのバージョン 2.1.0 以降のデフォルトです）。（I390e9、b/326456246）
  • アプリの targetSdk が 34 より大きい場合に API 34 でタイルの更新をリクエストすると SecurityException が発生するバグを修正しました。（If62a1）
  • Robolectric テストでの WearSdk への依存関係を修正しました。（I37796）

バージョン 1.5.0-alpha04

2024 年 11 月 13 日

androidx.wear.tiles:tiles-*:1.5.0-alpha04 がリリースされました。バージョン 1.5.0-alpha04 には、これらの commit が含まれています。

バージョン 1.5.0-alpha03

2024 年 10 月 30 日

androidx.wear.tiles:tiles-*:1.5.0-alpha03 がリリースされました。バージョン 1.5.0-alpha03 には、これらの commit が含まれています。

バージョン 1.5.0-alpha02

2024 年 10 月 16 日

androidx.wear.tiles:tiles-*:1.5.0-alpha02 がリリースされました。バージョン 1.5.0-alpha02 に含まれる commit はこちらをご覧ください。

セキュリティに関する修正

  • この変更により、androidx は protobuf 4.28.2 に対してコンパイルされ、CVE-2024-7254 に対処します。androidx.wear.tiles:tiles-proto のバージョン 1.5.0-alpha01 に対する依存関係を 1.5.0-alpha02 にアップグレードして、脆弱性のリスクに対処します。

バージョン 1.5.0-alpha01

2024 年 10 月 2 日

androidx.wear.tiles:tiles-*:1.5.0-alpha01 がリリースされました。バージョン 1.5.0-alpha01 には、これらの commit が含まれています。

バージョン 1.4

バージョン 1.4.1

2024 年 10 月 16 日

androidx.wear.tiles:tiles-*:1.4.1 がリリースされました。バージョン 1.4.1 に含まれる commit はこちらをご覧ください。

セキュリティに関する修正

  • この変更により、androidx は protobuf 4.28.2 に対してコンパイルされ、CVE-2024-7254 に対処します。脆弱性リスクに対処するため、androidx.wear.tiles:tiles-proto バージョン 1.4.0 の依存関係を 1.4.1 にアップグレードします。

バージョン 1.4.0

2024 年 8 月 7 日

androidx.wear.tiles:tiles-*:1.4.0 がリリースされました。バージョン 1.4.0 に含まれるcommit

1.3.0 以降の重要な変更

  • Android Studio でタイルのプレビュー用にカスタム プラットフォーム データを指定するためのツールのサポート。

バージョン 1.4.0-rc01

2024 年 7 月 24 日

androidx.wear.tiles:tiles-*:1.4.0-rc01 がリリースされました。以前のリリースからの変更はありません。バージョン 1.4.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.4.0-beta01

2024 年 7 月 10 日

androidx.wear.tiles:tiles-*:1.4.0-beta01 がリリースされました。バージョン 1.4.0-beta01 には、これらの commit が含まれています。

新機能

Wear Tiles 1.4.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear Tiles 1.4 には、次の新機能と API が含まれています。

  • Android Studio でタイルのプレビュー用にカスタム プラットフォーム データを指定するためのツールのサポート。

バージョン 1.4.0-alpha05

2024 年 6 月 26 日

androidx.wear.tiles:tiles-*:1.4.0-alpha05 がリリースされました。バージョン 1.4.0-alpha05 に含まれる commit はこちらをご覧ください。

バージョン 1.4.0-alpha04

2024 年 5 月 29 日

androidx.wear.tiles:tiles-*:1.4.0-alpha04 がリリースされました。バージョン 1.4.0-alpha04 に含まれる commit はこちらをご覧ください。

バージョン 1.4.0-alpha03

2024 年 5 月 14 日

androidx.wear.tiles:tiles-*:1.4.0-alpha03 がリリースされました。バージョン 1.4.0-alpha03 には、これらの commit が含まれています。

バグの修正

  • TileService#getActiveTilesAsync で WearSdk API（利用可能な場合）を使用して、より正確な結果が得られるようになりました。（I57bd8）

バージョン 1.4.0-alpha02

2024 年 5 月 1 日

androidx.wear.tiles:tiles-*:1.4.0-alpha02 がリリースされました。バージョン 1.4.0-alpha02 に含まれる commit はこちらをご覧ください。

API の変更

  • tileId を必須フィールドとして Builder コンストラクタ パラメータに移動し、ゲッターでデフォルトのタイムスタンプ値を記述しました。（I98c2b）
  • タイル エントリ/タイル 終了イベントのバッチ処理に必要な TileInteractionEvent、TileEnter、TileLeave プロト メッセージと Java ラッパーを追加。（I112b0）
  • TileRenderer.Config オブジェクトの代わりに Builder を使用するように TileRenderer をリファクタリングしました。（Ib66f9）
  • platformDataProviders 属性を TileRenderer.Config に追加します。（I6030d）
  • 新しい TileRenderer.Config クラスをサポートする新しいコンストラクタを TileRenderer に追加しました。他のコンストラクタは非推奨になりました。（Iae7ff）
  • プラットフォームのデータ値のオーバーライドを許可するには、TilePreviewData に platformDataValues フィールドを追加します。（If437a）

バグの修正

  • TileRenderer.Config.Builder#setTilesTheme のデフォルト値が 0 であることを記述します。（Iced18）

バージョン 1.4.0-alpha01

2024 年 3 月 6 日

androidx.wear.tiles:tiles-*:1.4.0-alpha01 がリリースされました。バージョン 1.4.0-alpha01 には、これらの commit が含まれています。

バージョン 1.3

バージョン 1.3.0

2024 年 2 月 7 日

androidx.wear.tiles:tiles-*:1.3.0 がリリースされました。バージョン 1.3.0 に含まれる commit については、こちらをご覧ください。

1.2.0 以降の重要な変更

  • タイル プレビューのサポート用ツールを更新しました。
  • アプリに属するアクティブなタイルのクエリをサポート。

その他の変更

バージョン 1.3.0-rc01

2024 年 1 月 24 日

androidx.wear.tiles:tiles-*:1.3.0-rc01 がリリースされました。バージョン 1.3.0-rc01 に含まれる commit については、こちらをご覧ください。

API の変更

  • TileService#getActiveTilesSnapshotAsync の名前を getActiveTilesAsync に変更しました（If6b87）

バージョン 1.3.0-beta01

2024 年 1 月 10 日

androidx.wear.tiles:tiles-*:1.3.0-beta01 がリリースされました。バージョン 1.3.0-beta01 に含まれる commit については、こちらをご覧ください。

Wear Tiles 1.3.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear Tiles 1.3 には、次の新機能と API が含まれています。

  • Wear タイルのツールのモジュールが更新され、タイル プレビューがサポートされ、公開されるようになりました。
  • TileService.getActiveTilesSnapshotAsync で、アプリに属するアクティブなタイルをクエリする機能のサポート。

バージョン 1.3.0-alpha04

2023 年 12 月 13 日

androidx.wear.tiles:tiles-*:1.3.0-alpha04 がリリースされました。バージョン 1.3.0-alpha04 に含まれる commit については、こちらをご覧ください。

バージョン 1.3.0-alpha03

2023 年 11 月 29 日

androidx.wear.tiles:tiles-*:1.3.0-alpha03 がリリースされました。バージョン 1.3.0-alpha03 に含まれる commit については、こちらをご覧ください。

新機能

  • アプリに属するアクティブなタイルをクエリするための新しい API TileService#getActiveTilesSnapshotAsync を追加しました。（I6850e）

API の変更

  • @TilePreview の名前を @Preview に変更しました。（Ifc08a）

バージョン 1.3.0-alpha02

2023 年 11 月 15 日

androidx.wear.tiles:tiles-*:1.3.0-alpha02 がリリースされました。バージョン 1.3.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • 親の内部にあるスペースに基づいてテキストサイズを自動的にスケーリングする試験運用版の API を追加しました。（Ibbe63）

バージョン 1.3.0-alpha01

2023 年 10 月 18 日

androidx.wear.tiles:tiles-*:1.3.0-alpha01 がリリースされました。バージョン 1.3.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • コンテキストは、TilePreviewData コールバック パラメータではなく、プレビュー メソッドのパラメータとして指定します。（I5e97d）
  • Wear タイルのツールのモジュールが更新され、タイル プレビューがサポートされ、公開されるようになりました。（I63d0f）

バージョン 1.2

バージョン 1.2.0

2023 年 8 月 9 日

androidx.wear.tiles:tiles-*:1.2.0 がリリースされました。バージョン 1.2.0 に含まれる commit については、こちらをご覧ください。

1.1.0 以降の重要な変更

  • Wear Tiles 1.2.0 の安定版リリース（詳細）
  • タイル 1.2 では、レイアウト要素をプラットフォーム データにバインドする（更新を高速化）とアニメーションのサポートが追加されました。移行手順については、1.2.0-rc01 のリリースノートをご覧ください。

バージョン 1.2.0-rc01

2023 年 7 月 26 日

androidx.wear.tiles:tiles-*:1.2.0-rc01 がリリースされました。バージョン 1.2.0-rc01 に含まれる commit については、こちらをご覧ください。

  • v1.2 リリースでは、Tiles ライブラリがリファクタリングされ、機能と API の大部分が新しい ProtoLayout ライブラリ（パッケージ androidx.wear.protolayout）に移動されました。一部の機能は Tiles（androidx.wear.tiles）に残っています。

    • クラス名はすべて同じで、v1.1 に追加されたもののみです。
    • ほとんどの API は変更されておらず、変更されているのはパッケージ名のみです。
    • TileService/TileBuilder の一部メソッドが非推奨となり、非推奨の Tiles の代わりに新しい ProtoLayout 型を受け入れるバージョンに名前が変更されました。

  • この移行を容易にするため、この名前変更を行う簡単な手順とスクリプトを用意しました。こちらをご覧ください。

API の変更

  • レイアウトの最大深度は、タイル内のネストされた要素 30 個に制限されています。この深度を超えると、タイルのレンダラは、以前にインフレートされたレイアウトを表示します。（I8a74b）

バージョン 1.2.0-beta01

2023 年 6 月 21 日

androidx.wear.tiles:tiles-*:1.2.0-beta01 がリリースされました。変更はありません。バージョン 1.2.0-beta01 に含まれる commit については、こちらをご覧ください。

バージョン 1.2.0-alpha07

2023 年 6 月 7 日

androidx.wear.tiles:tiles-*:1.2.0-alpha07 がリリースされました。バージョン 1.2.0-alpha07 に含まれる commit については、こちらをご覧ください。

新機能

  • TileRenderer.setState を使用すると、レンダリング セッションの状態を設定できます。この状態は、現在のレイアウトと今後のレイアウト（新しい状態が設定されるまで）に適用されます（Iaaf35）
  • protolayout タイプが、すべてのタイル レンダラ API で完全にサポートされるようになりました。（I428b0）

バグの修正

  • ProtoLayoutViewInstance でカスタムテーマを設定できるようになりました。（Iae8c0）

バージョン 1.2.0-alpha06

2023 年 5 月 24 日

androidx.wear.tiles:tiles-*:1.2.0-alpha06 がリリースされました。バージョン 1.2.0-alpha06 に含まれる commit については、こちらをご覧ください。

API の変更

  • StateEntryValue の名前を DynamicDataValue に変更し、DynamicDataKey を使用するように状態 API を更新しました。（If1c01）
  • StateStore のインスタンスごとにメモリ使用量と状態更新時間を適切に抑制および制御するため、StateStore で許可されるエントリ数を制限しています。そのため、マップ内に MAX_STATE_ENTRY_COUNT を超えるエントリがないようにする必要があります。そうしないと、StateStore の作成または更新時に IllegalStateException が発生します。（Ibadb3）

バージョン 1.2.0-alpha05

2023 年 5 月 10 日

androidx.wear.tiles:tiles-*:1.2.0-alpha05 がリリースされました。バージョン 1.2.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • タイルイベントとリクエストにタイル ID を追加しました。この ID を使用して、カルーセル内のタイル インスタンスにデータを関連付けることができます。（Ic4f83）

API の変更

  • TileRenderer.inflateAsync は ListenableFuture を返すようになりました。（I2f2b9）
  • protolayout ライブラリに置き換えがあるタイルビルダーは非推奨になりました。（Ie2029）

バグの修正

  • TileService.onTileResourcesRequest の javadoc で、システムがメソッドを呼び出す可能性があるタイミングを明確にしました。（Iee037）

バージョン 1.2.0-alpha04

2023 年 4 月 19 日

androidx.wear.tiles:tiles-*:1.2.0-alpha04 がリリースされました。バージョン 1.2.0-alpha04 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 必要に応じて、Gradle の依存関係が implementation ではなく api に正しく設定されるようになりました。（I40503）

バージョン 1.2.0-alpha03

2023 年 4 月 5 日

androidx.wear.tiles:tiles-*:1.2.0-alpha03 がリリースされました。バージョン 1.2.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • androidx.wear.protolayout 型のサポートを TileRenderer に追加しました（I4ac7f）
  • ObservableStateStore の名前を StateStore に変更しました。（Ieb0e2）
  • protolayout 型のオーバーロードを TileRenderer に追加しました。（I4ac7f）
  • TileRenderer でアニメーションを有効にする（I07dcf）

バージョン 1.2.0-alpha02

2023 年 3 月 22 日

androidx.wear.tiles:tiles-*:1.2.0-alpha02 がリリースされました。バージョン 1.2.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • Tiles Material ライブラリは非推奨になりました。同じ機能を備えた新しい ProtoLayout Material ライブラリを使用してください。（If242b）

バグの修正

  • TileRenderer が更新され、protolayout ライブラリの新機能を使用できるようになりました。（I832f9）

バージョン 1.2.0-alpha01

2023 年 3 月 8 日

androidx.wear.tiles:tiles-*:1.2.0-alpha01 がリリースされました。バージョン 1.2.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • protolayout ライブラリからリソースを提供するために、TileService に onTileResourceRequest を追加しました。（983d9c5）
  • ResourcesRequest と TileRequest を更新し、protolayout ライブラリの State 型と DeviceParameters 型をサポートしました。（88fa01d）
  • TileBuilders.Tile を更新し、protolayout ライブラリの State 型と Timeline 型をサポートしました。（168619c）

バグの修正

  • Javadoc の改善。（I3ed73）
  • onPrimary とサーフェスのデフォルトの色が変更されました。（I0b039）

バージョン 1.1

バージョン 1.1.0

2022 年 8 月 24 日

androidx.wear.tiles:tiles-*:1.1.0 がリリースされました。バージョン 1.1.0 に含まれる commit については、こちらをご覧ください。

1.0.0 以降の重要な変更

  • これは、Tiles Material ライブラリを含む最初の安定版リリースです（詳しくはブログをご覧ください）。
  • このライブラリには、マテリアル ガイドラインに沿って簡単に使用できるコンポーネントとレイアウトが含まれています。含まれるコンポーネントは Button、Chip、CompactChip、TitleChip、CircularProgressIndicator、Text です。これらのコンポーネントには、メインの Colors クラスで作成できる独自のカラー オブジェクトがあります。これにより、すべてのコンポーネントに同じテーマを簡単に適用できます。また、カラーに加えて Typography クラスもあります。これにより、タイポグラフィ名を使用して FontStyle オブジェクトを簡単に取得できます。
  • コンポーネント以外にも、推奨のタイル レイアウトの PrimaryLayout、EdgeContentLayout、MultiButtonLayout、MultiSlotLayout があります。すべてのレイアウトには、マテリアル ガイドラインに沿った推奨のパディングとスタイルが適用されています。
  • Tiles Material ライブラリのコンポーネントとレイアウトのリストについては、Tiles のリリースノートをご覧ください。

バージョン 1.1.0-rc01

2022 年 8 月 10 日

androidx.wear.tiles:tiles-*:1.1.0-rc01 がリリースされました。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください。

  • ベータ版と RC 版リリースとの間で新しい変更はありません。

バージョン 1.1.0-beta01

2022 年 7 月 27 日

androidx.wear.tiles:tiles-*:1.1.0-beta01 がリリースされました。バージョン 1.1.0-beta01 に含まれる commit については、こちらをご覧ください。

Tiles Material ライブラリの 1.0.0-beta01 リリースには、マテリアル ガイドラインに沿って簡単に作成できるコンポーネントとレイアウトが含まれています。

これに含まれるコンポーネントは次のとおりです。

  • Button - クリック可能な円形のオブジェクト。アイコン、テキスト、画像のいずれかで、3 つのサイズが事前定義されています。
  • Chip - クリック可能なスタジアムの形をしたオブジェクト。アイコン、プライマリ ラベル、セカンダリ ラベルを含めることができます。高さは固定されていますが、幅はカスタマイズ可能です。
  • CompactChip と TitleChip - 標準の Chip の 2 つのバリエーションで、高さが前者はより低く、後者はより高くなっています。1 行のテキストを含めることができます。
  • CircularProgressIndicator - 画面の端付近に表示される、特定の開始角度と終了角度を持った色付きの円弧。完了した進行状況を示す円弧を背景として、円の全体または部分を描画できます。
  • Text - 推奨される Wear マテリアルのタイポグラフィ スタイルを使用したスタイル設定済みテキスト。

上記の各コンポーネントには、メインの Colors クラスで作成できる独自のカラー オブジェクトがあります。これにより、すべてのコンポーネントに同じテーマを簡単に適用できます。また、カラーに加えて Typography クラスもあります。これにより、タイポグラフィ名を使用して FontStyle オブジェクトを簡単に取得できます。

コンポーネントに加えて、次のような推奨されるタイル レイアウトがあります。

  • PrimaryLayout - プライマリ ラベルまたはセカンダリ ラベル、中央のコンテンツ、下部のプライマリ チップを追加してカスタマイズできるレイアウト。このレイアウト内のメイン コンテンツは、MultiSlotLayout オブジェクトまたは MultiButtonLayout オブジェクトとして追加できます。
  • EdgeContentLayout - 画面の端付近で CircularProgressIndicator をホストするレイアウト。内部にメイン コンテンツ、その周囲にプライマリ ラベルまたはセカンダリ ラベルが配置されます。
  • MultiButtonLayout - 1～7 個のボタンを含めることができるレイアウト。ボタンは、その数に応じて、マテリアル ガイドラインに沿って配置されます。
  • MultiSlotLayout - 行のようなスタイルのレイアウト。スロットが間隔を空けて水平に並べられます（アイコンまたはその他の小さなコンテンツに適しています）。

すべてのレイアウトには、マテリアル ガイドラインに沿った推奨のパディングとスタイルが適用されています。

API の変更

  • Chip コンポーネントに対する大規模なリファクタリングの一環として、ビルダーのセッターが分離され、コンテンツの各部分（プライマリ ラベル、セカンダリ ラベル、画像リソース ID）がガイドラインに沿って変更された名前で別個に渡されるようになりました。また、コンテンツの説明が設定されなかった場合は、自動生成されます。（I57622）
  • ProgressIndicatorLayout の名前を EdgeContentLayout に変更しました。（Ic1aa6）
  • ボタンサイズ コンテンツの名前を without _BUTTON 接尾辞が含まれない名前に変更し、Javadoc の Button に関する記述をより明確にしました。（I1dfe2）

バグの修正

  • マテリアル レイアウトのマージン、パディング、および全体的な配置が更新され、あらゆるタイプの推奨されるレイアウト、画面サイズ、形状に対応できるようになりました。
  • マテリアル レイアウトの改善: MultiSlotLayout のスロットの柔軟性が向上し、固定サイズの幅の代わりにコンテンツをラップする幅を利用できるようになりました。（I52919、If18b4）
  • ユーザー補助ガイドラインに準拠するため、CompactChip でタップできる領域を拡大しました。（Ie8264）

バージョン 1.1.0-alpha09

2022 年 6 月 29 日

androidx.wear.tiles:tiles-*:1.1.0-alpha09 がリリースされました。バージョン 1.1.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

  • ProgressIndicatorLayout にオプションのラベルを追加するためのサポートを追加しました。（I30788）

API の変更

  • ElementMetadata のヘルパー メソッドが Modifiers ではなく ElementMetadata を受け取るようになりました。（I5a70f）

バグの修正

  • CompactChip の 9 文字という制限が削除されました。テキストが大きすぎて PrimaryLayout で画面内に収まらない場合は、省略されます。（Id56ec）
  • Chip のゲッターに接尾辞 Content が付くようになりました。（Iba437）
  • Tiles Material クラスに javadoc の説明を追加しました。（I56e41）、（I80f31）、（Iba437）

バージョン 1.1.0-alpha08

2022 年 6 月 1 日

androidx.wear.tiles:tiles-*:1.1.0-alpha08 がリリースされました。バージョン 1.1.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

  • Helper クラスに追加されたヘルパー メソッドでコンポーネントのメタデータを管理する場合に使用するメタデータタグが修飾子に追加されました。（I70db2）、（I30c3d）
  • 静的メソッド fromLayoutElement が Tiles Material 内のすべてのコンポーネントとレイアウトに追加されました。テストで、コンテナのコンテンツにアクセスして取得した LayoutElement を元の型にキャストする場合に使用します。（Ia572a）、（Idbd8a）、（I3ae13）、（I292fe）、（I8b20f）、（I3cacb）、（I84b24）

バージョン 1.1.0-alpha07

2022 年 5 月 18 日

androidx.wear.tiles:tiles-*:1.1.0-alpha07 がリリースされました。バージョン 1.1.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

  • コンテンツの異なるセッターに関連するゲッターが ProgressIndicatorLayout と PrimaryLayout に追加されました。これらのクラスのすべてのセッターが一致するゲッターを持つようになりました。（Iddbe5）（Iabe4e）
  • マテリアル コンポーネントのコンテンツ説明のゲッターは、セッターが必須ではないため null を返すことができます。
  • コンテンツを渡さずにボタンを作成しようとすると、IllegalArgumentException が発生します。（I7fc0c）
  • ChipColors のアイコンの色に関連するフィールドの名前が iconTintColor から iconColor に変更されました。（Ic053b）

バグの修正

  • Tiles Material のレイアウトに androidTests を追加しました。（I96404）

バージョン 1.1.0-alpha06

2022 年 5 月 11 日

androidx.wear.tiles:tiles-*:1.1.0-alpha06 がリリースされました。バージョン 1.1.0-alpha06 に含まれる commit については、こちらをご覧ください。

新機能

  • 新しいレイアウトが Material Layouts サブライブラリ MultiButtonLayout に追加されました。これにより、マテリアル ガイドラインに沿って 1～7 個のボタンが配置されるレイアウトを表現できます。ほとんどの場合、このレイアウトはコンテンツとして PrimaryLayout に渡す必要があります。（Ib727f）

API の変更

  • MultiSlotLayout が、スロットのみを含むようにリファクタリングされました。このレイアウトは、コンテンツとしてメインの PrimaryLayout に渡す必要があります。（I1870f）
  • CircularProgressIndicator のデフォルト色の定義を、プライマリとセカンダリではなく 1 つの値になるように変更しました。（I64a51）
  • MultiSlotLayout に水平スペーサー用のゲッターを追加しました。（I11e1e）

バグの修正

  • コンポーネント用の Android テストが Tiles Material に追加されました。（I20041）

バージョン 1.1.0-alpha05

2022 年 4 月 6 日

androidx.wear.tiles:tiles-*:1.1.0-alpha05 がリリースされました。バージョン 1.1.0-alpha05 に含まれる commit については、こちらをご覧ください。

新機能

  • LayoutElement を Layout、Timeline、TimelineEntry に変換するためのヘルパー メソッドをこれらのクラスに追加して、タイルを簡単に作成できるようにしました。（I2f6d1）
  • Colors オブジェクトがマテリアル ライブラリに追加され、コンポーネントのカラー間でテーマとして渡されるようになりました。（I0792c）

API の変更

  • Material Text コンポーネントでは、コンストラクタにテキストを渡す必要があります。このコンポーネントは、ウェイトを設定してカスタマイズできるようになりました。（I25dbd）
  • パブリック セッターで使用されていない定数を ChipDefaults から削除しました。（I7baed）
  • 一致するセッターがないゲッターを CompactChip と TitleChip から削除しました。（I99e85）
  • DEFAULT_PADDING を ProgressIndicatorDefaults から削除しました。（Idabcd）
  • マテリアル コンポーネントが、コンテンツの説明に String ではなく CharSequence を受け入れるようになりました。（I5b21a）

バグの修正

  • Button で省略可能なパラメータのセッター実装をリファクタリングしました。（Ib7135）
  • フォント スタイルのバリエーションがタイポグラフィのフォントに追加されました。（I8dbc6）

バージョン 1.1.0-alpha04

2022 年 3 月 23 日

androidx.wear.tiles:tiles-*:1.1.0-alpha04 がリリースされました。バージョン 1.1.0-alpha04 に含まれる commit については、こちらをご覧ください。

新機能

  • オプションのメインラベルまたはセカンダリ ラベルを PrimaryLayout に追加できます。（Ib9916）
  • テキスト コンポーネントは、オーバーフロー、斜体、下線などを設定してカスタマイズできます。（I703f7）

API の変更

  • Tiles Material API からデフォルトのカラー定数が削除されました。（I0ab55）
  • タイル マテリアルでクリック可能なすべてのコンポーネントには、アクションではなく、ビルダーのコンストラクタに Clickable オブジェクトが必要になります。（I2f101）

バグの修正

  • チップとテキスト コンポーネントで、テキストがオーバーフロー時に省略記号を描画するようになりました。（I8a2f8）
  • ユーザーのフォント スケールが大に設定されたときのコンポーネントの外観を改善しました。（Ib63b1）
  • PrimaryLayout の setPrimaryChipContent の Javadoc を明確にしました。（Ie6296）

バージョン 1.1.0-alpha03

2022 年 2 月 23 日

androidx.wear.tiles:tiles-*:1.1.0-alpha03 がリリースされました。バージョン 1.1.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • 推奨されるタイポグラフィ スタイルを持つ Text コンポーネントが TIles Material に追加されました。（Iec0ae）

バージョン 1.1.0-alpha02

2022 年 2 月 9 日

androidx.wear.tiles:tiles-*:1.1.0-alpha02 がリリースされました。バージョン 1.1.0-alpha02 に含まれる commit については、こちらをご覧ください。

新機能

  • Tiles Material に新しいサブライブラリ layouts が追加されました。このサブライブラリには、タイルの開発を高速化し実装を簡略化するために推奨されるパディングとマージンが適用された独自のタイル レイアウトが含まれています。初期レイアウトは次のとおりです。
    • PrimaryLayout（I7ba91）: 下部にメインのチップ、中央にコンテンツが配置されているレイアウトを示します。
    • MultiSlotLayout（I32104）: 行 1 と行 3 にラベルがあり、行 2 にスロットが間隔を空けて水平方向に配置され、後に続く 4 番目の行にメインのチップが含まれているレイアウトを示します。
    • ProgressIndicatorLayout（I9fec6）: 画面の端付近に円形の進行状況インジケーター、内側に指定されたコンテンツが配置されているレイアウトを示します。
  • Tiles Material コンポーネントに CircularProgressIndicator（Ic4b88）が追加されました。

API の変更

  • TitleChip で使用される残りの定数の名前を変更し、名前にタイトルを追加しました。（I14f4c）
  • setHorizontalAlignment メソッドが Chip に追加されました。（Ie6e0b）

バージョン 1.1.0-alpha01

2022 年 1 月 26 日

androidx.wear.tiles:tiles-*:1.1.0-alpha01 がリリースされました。バージョン 1.1.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • 新しいライブラリ Tiles Material が追加されました。このライブラリには、マテリアル デザインでタイル レイアウトをより迅速かつ簡単に作成するためのコンポーネントが含まれています。最初のコンポーネントは次のとおりです。
    • Button
    • Chip
    • CompactChip
    • TitleChip

バグの修正

  • キャッシュに保存されたリソースが破棄される原因となっていた TileUiClient のバグを修正しました。（I60e0b）

バージョン 1.0

バージョン 1.0.1

2022 年 1 月 26 日

androidx.wear.tiles:tiles-*:1.0.1 がリリースされました。バージョン 1.0.1 に含まれる commit については、こちらをご覧ください。

バグの修正

  • キャッシュに保存されたリソースが破棄される原因となっていた TileUiClient のバグを修正しました。（I60e0b）

バージョン 1.0.0

2021 年 11 月 3 日

androidx.wear.tiles:tiles-*:1.0.0 がリリースされました。バージョン 1.0.0 に含まれる commit については、こちらをご覧ください。

1.0.0 の主な機能

  • Wear Tiles ライブラリには、Wear OS デバイス用のカスタムタイルを作成するための機能と、システムがタイルをフェッチしてウォッチフェイスのすぐ横に表示することができるクラスが用意されています。
  • tiles-renderer を使用すると、Android Activity の一部として Tile を表示できるため、タイル レイアウトの迅速なテストが容易になります。

バージョン 1.0.0-rc01

2021 年 10 月 27 日

androidx.wear.tiles:tiles-*:1.0.0-rc01 がリリースされました。バージョン 1.0.0-rc01 に含まれる commit については、こちらをご覧ください。

バージョン 1.0.0-beta01

2021 年 10 月 13 日

androidx.wear.tiles:tiles-*:1.0.0-beta01 がリリースされました。バージョン 1.0.0-beta01 に含まれる commit については、こちらをご覧ください。

バグの修正

  • 空のリソース バージョンが指定されたときの TileUiClient の NullPointerException を修正しました。（I0586e）

バージョン 1.0.0-alpha12

2021 年 9 月 29 日

androidx.wear.tiles:tiles-*:1.0.0-alpha12 がリリースされました。バージョン 1.0.0-alpha12 に含まれる commit については、こちらをご覧ください。

バグの修正

  • UpdateScheduler は弱参照を使用しなくなり、TileUiClient が更新されない問題が解決されました。（I1120d、b/199061124）

  • SysUiTileUpdateRequester が PacakgeManager をクエリすることを宣言し、R 以降のデバイスでタイル更新が機能しないバグを修正しました。（I1120d）

バージョン 1.0.0-alpha11

2021 年 9 月 1 日

androidx.wear.tiles:tiles-*:1.0.0-alpha11 がリリースされました。バージョン 1.0.0-alpha11 に含まれる commit については、こちらをご覧ください。

新機能

  • デベロッパーがタイルを簡単にテストできるように、テスト ライブラリ androidx.wear.tiles:tiles-testing ライブラリを追加してリリースしました。（Iedb6b）

API の変更

  • TileProviderService の名前を TileService に変更しました。（I1ad2c）
  • タイルビルダーを更新しました。new Foo.Builder() の呼び出しが導入されたため静的 .builder() メソッドのサポートが終了し、Builder インスタンスを受け入れるセッター オーバーロードが削除されました。（Ia9606）
  • TileRenderer がアプリ コンテキストではなく UI コンテキストを使用するようになりました。（I84b61）

バグの修正

  • 特定の状況で複数の下線が適用されるバグを修正しました。（Ib6712）

バージョン 1.0.0-alpha10

2021 年 8 月 18 日

androidx.wear.tiles:tiles:1.0.0-alpha10、androidx.wear.tiles:tiles-proto:1.0.0-alpha10、androidx.wear.tiles:tiles-renderer:1.0.0-alpha10 がリリースされました。バージョン 1.0.0-alpha10 に含まれる commit については、こちらをご覧ください。

API の変更

  • 公開 API からレイアウト チェッカーを削除しました。これらは常に有効になりますが、チェックが失敗した場合にのみ警告が出されます。（Ie9f29）
  • TileRenderer がアプリ コンテキストではなく UI コンテキストを受け入れるようになりました。

バグの修正

  • Spannable のクリック可能要素がクリックされないバグを修正しました。

バージョン 1.0.0-alpha09

2021 年 7 月 21 日

androidx.wear.tiles:tiles:1.0.0-alpha09、androidx.wear.tiles:tiles-proto:1.0.0-alpha09、androidx.wear.tiles:tiles-renderer:1.0.0-alpha09 がリリースされました。バージョン 1.0.0-alpha09 に含まれる commit については、こちらをご覧ください。

新機能

  • Wear Tiles のレンダラにレイアウト チェッカーを追加しました。（I3a869）
    • タイルのベスト プラクティスを検証するために使用されます。まず、タイルに Semantics 修飾子を持つ要素が含まれていない場合、警告が出されます。
  • DefaultTileProviderClient と TestingTileProviderClient constructors のドキュメントを追加しました。（I9f4b9）

API の変更

  • TileProviderClient での名前の変更（I0ec36）:
    • getApiVersion -> requestApiVersion
    • tile/resourcesRequest -> requestTile/Resources
    • onTileFooEvent -> sendOnTileFooEvent
  • Wear Tiles のレンダラにレイアウト チェッカーを追加しました。（I3a869）

バグの修正

  • LaunchAction ターゲットが特別な権限を持たないようにしました。（I39136）

バージョン 1.0.0-alpha08

2021 年 6 月 30 日

androidx.wear.tiles:tiles:1.0.0-alpha08、androidx.wear.tiles:tiles-proto:1.0.0-alpha08、androidx.wear.tiles:tiles-renderer:1.0.0-alpha08 がリリースされました。バージョン 1.0.0-alpha08 に含まれる commit については、こちらをご覧ください。

新機能

  • Spannable で、line_spacing ではなく line_height がサポートされるようになりました。

API の変更

  • Spannable の line_height のサポートを追加し、line_spacing のサポートを削除します。（Ibeb54）
    • line_spacing を使用するコードは、代わりに line_height を使用するように移植する必要があります。

バグの修正

  • 比例したディメンションを使用するときのバグを修正しました。（I37ace）
  • テキスト要素にコンテンツの説明が含まれないバグを修正しました。（Id2c7d）

バージョン 1.0.0-alpha07

2021 年 6 月 16 日

androidx.wear.tiles:tiles:1.0.0-alpha07、androidx.wear.tiles:tiles-proto:1.0.0-alpha07、androidx.wear.tiles:tiles-renderer:1.0.0-alpha07 がリリースされました。バージョン 1.0.0-alpha07 に含まれる commit については、こちらをご覧ください。

API の変更

  • TileProviderClient インターフェースを追加して DefaultTileProviderClient を公開することで、実装を TileProviderService インターフェースにバインドできるようにしました。（I69165）

バージョン 1.0.0-alpha06

2021 年 6 月 2 日

androidx.wear.tiles:tiles:1.0.0-alpha06、androidx.wear.tiles:tiles-proto:1.0.0-alpha06、androidx.wear.tiles:tiles-renderer:1.0.0-alpha06 がリリースされました。バージョン 1.0.0-alpha06 に含まれる commit については、こちらをご覧ください。

API の変更

  • すべてのビルダークラスで、すべてのプロパティにゲッターを追加しました。これはテストのみを目的としています（I9d155）。
  • パッケージの変更: androidx.wear.tiles.builders のクラスを androidx.wear.tiles に移動しました。
  • Tiles に実験的なティントのサポートを追加しました。（I38929）
  • LayoutElementBuilders.HALIGN_* の名前を LayoutElementBuilders.HORIZONTAL_ALIGN_* に変更しました（I67e58）
  • LayoutElementBuilders.VALIGN_* の名前を LayoutElementBuilders.VERTICAL_ALIGN_* に変更しました（I67e58）
  • LayoutElementBuilders.SPAN_VALIGN_* の名前を LayoutElementBuilders.SPAN_VERTICAL_ALIGN_* に変更しました（I67e58）
  • リクエスト用とイベント用のビルダークラスを追加しました。（Ib5cf4）
  • TileProviderService の移行により、RequestReaders / EventReaders の代わりに RequestBuilders および EventBuilders のリクエスト クラスとイベントクラスが使用されます（例: onTileRequest は、RequestReaders.TileRequest ではなく、RequestBuilders.TileRequest を提供するようになりました）。（I46ea1）

バグの修正

  • Tiles レンダラの非同期画像読み込みのバグを修正しました。（Iad9b0）
  • 幅または高さが wrap() に設定されている Box 内に、幅または高さが expand() に設定されている画像を配置した際のレイアウト バグを修正しました。（I33770）

バージョン 1.0.0-alpha05

2021 年 5 月 18 日

androidx.wear.tiles:tiles:1.0.0-alpha05、androidx.wear.tiles:tiles-proto:1.0.0-alpha05、androidx.wear.tiles:tiles-renderer:1.0.0-alpha05 がリリースされました。バージョン 1.0.0-alpha05 に含まれる commit については、こちらをご覧ください。

API の変更

  • 受信タイルイベント（TileAddEvent、TileRemoveEvent、TileEnterEvent、TileLeaveEvent、TileRequest）から getTileId を削除しました。（Ifbba2）
  • ImageResource#setAndroidResourceByResid の名前を setAndroidResourceByResId に変更しました。（I4ba6e）
  • TimelineManager#deInit の名前を close に変更し、AutoCloseable を実装しました。（I5dff2）

バージョン 1.0.0-alpha04

2021 年 5 月 5 日

androidx.wear.tiles:tiles:1.0.0-alpha04、androidx.wear.tiles:tiles-proto:1.0.0-alpha04、androidx.wear.tiles:tiles-renderer:1.0.0-alpha04 がリリースされました。バージョン 1.0.0-alpha04 に含まれる commit については、こちらをご覧ください。

API の変更

  • 非表示の TileProviderService クラス。
    • TileUpdateRequester が Class<? extends TileProviderService> を取得するようにしました。（Ib7cca）
  • AndroidActivity にエクストラを追加する機能を追加しました。（I748f4）

Tiles バージョン 1.0.0-alpha03

2021 年 4 月 21 日

androidx.wear.tiles:tiles:1.0.0-alpha03、androidx.wear.tiles:tiles-proto:1.0.0-alpha03、androidx.wear.tiles:tiles-renderer:1.0.0-alpha03 がリリースされました。バージョン 1.0.0-alpha03 に含まれる commit については、こちらをご覧ください。

API の変更

  • TileManager -> TileClient に名前を変更しました。
    • TileManager#create -> TileClient#connect に名前を変更しました。（I91839）

バグの修正

  • Proguard が有効な場合に tiles と tiles-renderer が正常に動作するよう ProGuard ルールを追加しました。（Ie3d85）

バージョン 1.0.0-alpha02

2021 年 4 月 7 日

androidx.wear.tiles:tiles:1.0.0-alpha02、androidx.wear.tiles:tiles-proto:1.0.0-alpha02、androidx.wear.tiles:tiles-renderer:1.0.0-alpha02 がリリースされました。バージョン 1.0.0-alpha02 に含まれる commit については、こちらをご覧ください。

API の変更

  • androidx.wear:wear-tiles はグループを移動したため、androidx.wear.tiles:tiles として参照されるようになりました
  • androidx.wear:wear-tiles-renderer はグループを移動したため、androidx.wear.tiles:tiles-renderer として参照されるようになりました
  • TileRenderer.LoadActionListener で、androidx.wear.tiles.proto.StateProto.State ではなく androidx.wear.tiles.builders.StateBuilders.State のインスタンスが使用されるようになりました。
  • TileRenderer で、androidx.wear.tiles.renderer.ResourceAccessors のインスタンスではなく、androidx.wear.tiles.builders.ResourceBuilders.Resources からの Tile リソースを受け入れるようになりました。

バグの修正

  • 内部クラスが公開されるため LoadActionListener を使用できない不具合を修正しました。

バージョン 1.0.0-alpha01

2021 年 3 月 10 日

androidx.wear:wear-tiles:1.0.0-alpha01、androidx.wear:wear-tiles-proto:1.0.0-alpha01、androidx.wear:wear-tiles-renderer:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれる commit については、こちらをご覧ください。

新機能

  • Wear Tiles Renderer ライブラリには、Wear OS デバイス用のカスタムタイルを作成するための機能と、システムがタイルをフェッチしてウォッチフェイスのすぐ横に表示することができるクラスが用意されています。