Wear Tiles
| 最新の更新 | 安定版リリース | リリース候補版 | ベータ版リリース | アルファ版リリース |
|---|---|---|---|---|
| 2025 年 10 月 22 日 | 1.5.0 | - | - | 1.6.0-alpha02 |
依存関係の宣言
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.6
バージョン 1.6.0-alpha02
2025 年 10 月 22 日
androidx.wear.tiles:tiles-*:1.6.0-alpha02 がリリースされました。バージョン 1.6.0-alpha02 には、これらの commit が含まれています。
新機能
- タイル プレビューが更新され、
ProtoLayoutScopeによるリソースの自動処理がサポートされるようになりました。materialScopeWithScopeまたはProtoLayoutScopeを介してレイアウトで画像リソースを直接使用する場合、TilePreviewDataでonTileResourcesRequestとリソースを明示的に指定する必要はなくなります。これらは自動的に収集されます。(I58516)
バグの修正
TileServiceによって内部的に作成されるProtoLayoutScopeに、ProtoLayout Renderer のVersionInfoが含まれるようになりました。(I6eee2、b/450259727)
バージョン 1.6.0-alpha01
2025 年 9 月 24 日
androidx.wear.tiles:tiles-*:1.6.0-alpha01 がリリースされました。バージョン 1.6.0-alpha01 にはこれらの commit が含まれています。
新機能
- クリック アクションとして
PendingIntentを受け入れるためのプロバイダ API を追加しました(I01978、b/433802488) - 更新リクエストでタイル ID を指定できるようにします。(Ia05c3、b/421346031)
- 対応するタイル インスタンスの
ProtoLayoutScopeオブジェクトを取得するメソッドをTileRequestに追加(I5b8de、b/428692428)
API の変更
ProtoLayoutScopeAPI が使用されている場合にonTileResourcesRequestをオーバーライドしないことを許可。(I1773d)
バグの修正
ProtoTilesでPendingIntentをサポートするための実装を追加します。(I38167、b/430610429)ProtoLayoutScopeから使用されたリソースを保存し、Tile レスポンス内にバンドルしない古いレンダラ向けにonTileResourcesRequestで正しく送信できるようにしました。(I063a8、b/428692502)- デフォルトの minSdk を API 21 から API 23 に移行(Ibdfca、b/380448311、b/435705964、b/435705223)
バージョン 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 より高い SDK をターゲットとし、API 34 でタイル更新をリクエストすると
SecurityExceptionが発生するクライアント向けの重大なバグの修正。 - 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 より高い SDK をターゲットとし、API 34 でタイル更新をリクエストすると
SecurityExceptionが発生するクライアント向けの重大なバグの修正。 - 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 は CVE-2024-7254 に対応するため、protobuf 4.28.2 に対してコンパイルされます。脆弱性のリスクに対処するため、
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 は CVE-2024-7254 に対応するため、protobuf 4.28.2 に対してコンパイルされます。脆弱性のリスクに対処するため、
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 にはこれらのコミットが含まれています。
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は、より正確な結果を提供するためにWearSdkAPI を使用するようになりました(利用可能な場合)。(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)TileRenderer.ConfigにplatformDataProviders属性を追加します。(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 で導入された変更点の完全なセットについては、beta01 リリースノートをご覧ください。
バージョン 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 が含まれています。
- ウェアラブル タイル ツールのモジュールがタイル プレビューのサポートのために更新され、公開の準備が整いました。
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) - ウェアラブル タイル ツールのモジュールが、タイル プレビューのサポートに向けて更新され、公開の準備が整いました。(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個以上存在しないようにする必要があります。そうしないと、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)TileRendererに protolayout 型のオーバーロードを追加(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)protolayoutライブラリのState型とDeviceParameters型をサポートするために、ResourcesRequestとTileRequestを更新しました。(88fa01d)TileBuilders.Tileを更新し、protolayoutライブラリのState型とTimeline型をサポートしました。(168619c)
バグの修正
バージョン 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)
バグの修正
バージョン 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が追加されました。このサブライブラリには、タイルの開発を高速化し実装を簡略化するために推奨されるパディングとマージンが適用された独自のタイル レイアウトが含まれています。初期レイアウトは次のとおりです。 - 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 が追加されました。このライブラリには、マテリアル デザインでタイル レイアウトをより迅速かつ簡単に作成するためのコンポーネントが含まれています。最初のコンポーネントは次のとおりです。
ButtonChipCompactChipTitleChip
バグの修正
- キャッシュに保存されたリソースが破棄される原因となっていた
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->requestApiVersiontile/resourcesRequest->requestTile/ResourcesonTileFooEvent->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 を使用するように移植する必要があります。
バグの修正
バージョン 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)
- TileUpdateRequester が
- 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 デバイス用のカスタムタイルを作成するための機能と、システムがタイルをフェッチしてウォッチフェイスのすぐ横に表示することができるクラスが用意されています。