Wear Tiles

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

依存関係の宣言

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

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

Groovy

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

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

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

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

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

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

Kotlin

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

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

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

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

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

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

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.4

バージョン 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 を必須フィールドとしてビルダー コンストラクタ パラメータに移動し、ゲッターにデフォルトのタイムスタンプ値をドキュメント化しました。（I98c2b）。
  • タイルの入退室イベントのバッチ処理に必要な TileInteractionEvent、TileEnter、TileLeave の proto メッセージと Java ラッパーを追加しました。（I112b0）。
  • TileRenderer をリファクタリングして、TileRenderer.Config オブジェクトではなくビルダーを使用するようにします。（Ib66f9）。
  • platformDataProviders 属性を TileRenderer.Config に追加します。（I6030d）。
  • 新しい TileRenderer.Config クラスをサポートする新しいコンストラクタを TileRenderer に追加します。他のコンストラクタは非推奨となりました。（Iae7ff）。
  • platformDataValues フィールドを TilePreviewData に追加して、プラットフォームのデータ値をオーバーライドできるようにしました。（If437a）。

バグの修正

  • TileRenderer.Config.Builder#setTilesTheme のデフォルト値はゼロであることをドキュメント化します。（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 Tiles ツールのモジュールがタイル プレビューのサポート用に更新され、公開される予定です。
  • 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 Tiles ツールのモジュールがタイル プレビューのサポート用に更新され、公開される予定です。（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 の安定版リリース（詳細）
  • Tiles 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）。

バグの修正

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

バージョン 1.2.0-alpha01

2023 年 3 月 8 日

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

新機能

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

バグの修正

  • Javadocs の改善。（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 デバイス用のカスタムタイルを作成するための機能と、システムがタイルをフェッチしてウォッチフェイスのすぐ横に表示することができるクラスが用意されています。