Glance Wear

  
Glance Wear は、Wear OS 用のウィジェットをビルドするためのライブラリです。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2026 年 9 月 9 日 - - - 1.0.0-alpha18

依存関係の宣言

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

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

Groovy

dependencies {
    implementation "androidx.glance.wear:wear:1.0.0-alpha13"

    implementation "androidx.glance.wear:wear-core:1.0.0-alpha13"
}

Kotlin

dependencies {
    implementation("androidx.glance.wear:wear:1.0.0-alpha13")

    implementation("androidx.glance.wear:wear-core:1.0.0-alpha13")
}

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

フィードバック

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

新しい問題を報告する

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

Glance Wear バージョン 1.0

バージョン 1.0.0-alpha18

2026 年 9 月 9 日

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

API の変更

  • 古いホストでサポートされているオペレーションの安全なフォールバック セットを使用してウィジェットをプレビューできるように、useSafeFallbackRendererVersion パラメータを WearWidgetPreview に追加しました。(I9c324)

バグの修正

  • Compose ライブラリの compileSdk を 37.1 に更新しました。これにより、Compose を使用するすべてのアプリとライブラリの compileSdk を推移的に更新する必要があります。(I05b0f)
  • Wear ウィジェットで冗長な fontFamily パラメータの使用を警告する lint チェックを追加しました。(I7730c)

バージョン 1.0.0-alpha17

2026 年 8 月 26 日

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

新機能

  • Glance Wear に lint チェックを追加し、ウィジェット メタデータの <wearwidget-provider> XML の各 <container> で、サポートされているタイプ属性が明示的に指定され、重複するタイプが定義されていないことを強制するようにしました。(I52c9a、b/464458215)

バージョン 1.0.0-alpha16

2026 年 8 月 12 日

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

新機能

  • <wearwidget-provider> XML メタデータに Lint 検証を追加し、必要な構成要素（container や previewImage など）が存在することを確認しました。(Ia9983、b/464458215)
  • Wear ウィジェットに黒または透明の背景を設定する場合に Lint エラー警告を追加しました（Idedb0、b/529269573）
  • Wear ウィジェット プロファイルで CORE_TEXT Remote Compose オペレーションを有効にしました。これにより、サポートされているホスト レンダラで、RemoteText がフォント軸や行の高さなどの可変フォント機能を使用できるようになり、サポートされていない場合は自動的にフォールバックされます。

解決済みの問題

  • デベロッパーからのフィードバックに基づいて、AssociateWithGlanceWearWidget アノテーションの KDoc を更新しました

バージョン 1.0.0-alpha15

2026 年 7 月 29 日

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

新機能

  • Wear ウィジェット ドキュメントに空の背景を設定する場合に Lint 警告を追加しました。(Ic6475、b/529269573)

バージョン 1.0.0-alpha14

2026 年 7 月 15 日

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

API の変更

  • 完全に丸い Glance Wear ウィジェット用に、RoundAllWidgetPreviewParams、RoundSmallWidgetPreviewParams、RoundLargeWidgetPreviewParams のプレビュー パラメータ プロバイダを追加しました。(If5336、b/512405233)

新機能

  • Glance Wear ウィジェット用に Linter ライブラリを設定して追加しました。（If4218、b/527402079）
    • GlanceWearWidgetService のサブクラスが、@AssociateWithGlanceWearWidget アノテーションを使用して、関連付けられたウィジェット クラスを明示的に宣言していることを確認する lint チェックを追加しました。（Idc575、b/477024153）
  • サポートされているオペレーションを WearWidgetParams を介して伝播し、許可されているオペレーションのプロファイルをフィルタリングすることで、古いホストで実行されているウィジェットの下位互換性を改善しました。（Ib0a1b、I83cb1、[b/526716195]）

バージョン 1.0.0-alpha13

2026 年 7 月 1 日

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

API の変更

  • heartRateAccuracy から権限チェックを削除しました（I14269、b/522444636）

バグの修正

  • UX のフィードバックに基づいて、プレビュー用の Squircle 型の Wear ウィジェット パラメータを調整しました

バージョン 1.0.0-alpha12

2026 年 6 月 17 日

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

新機能

  • GlanceWearWidgetService で使用して、関連付けられている GlanceWearWidget の実装を提供する AssociateWithGlanceWearWidget を追加しました。（Ifcabb、b/514679763）

    • 次に例を示します。
     @AssociateWithGlanceWearWidget(MyGlanceWearWidget::class)
 class MyGlanceWearWidgetService : GlanceWearWidgetService() {
   override val widget = MyGlanceWearWidget()
 }
 ```

  • WearWidgetBrush に image ブラシを追加し、Wear ウィジェットでビットマップの背景をサポートしました。(I9a228、b/513481558)

  • @Composable ヘルパー関数 WearWidgetPreview を導入し、IDE プレビューに必要なボイラープレートを削除することで、Glance Wear ウィジェットの開発を簡素化しました。

API の変更

  • androidx.glance.wear.health.DataType の名前を androidx.glance.wear.health.HealthData に変更しました（I4cb0b、b/516746689）
  • isHeartRateBpmAvailable が公開され、ホストで heartRateBpm が使用可能かどうかを判断できるようになりました。（I5999d、b/514641567）
  • RemoteInt 比較演算子を公開しました。(I5fe3d、b/513228889)
  • captureRemoteDocument Flow API と、新しい captureSingleRemoteDocument オーバーロード（RemoteCreationDisplayInfo を受け取る）を公開 API として公開しました。(I87b0e、b/513228889)
  • GlanceWearWidgetService ライフサイクル メソッドに @CallSuper を追加しました

バージョン 1.0.0-alpha11

2026 年 6 月 3 日

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

API の変更

  • Android Studio で Wear ウィジェットをプレビューするための WearWidgetPreview を追加しました。(I36504、b/485147770)
  • 関連するヘルスデータ型が使用可能で有効かどうかを確認するために、is*Available（isDailyStepsAvailable など）変数を公開しました。（Ib98a7、b/498179656）
  • 指定されたアプリのすべてのウィジェットで更新をトリガーする triggerUpdateAll API を GlanceWearWidget に追加しました。（I6ab20、b/510896410）

バグの修正

  • alpha10 バージョンで生成されたドキュメントの破損を防ぐため、Renderer バージョン情報を内部フィールドとして WearWidgetParams に含めました。（Idcf8e、b/511263591、b/512830184）
  • Wear ウィジェットのデバッグモードまたはエミュレータで強制プル更新フローをトリガーします。

バージョン 1.0.0-alpha10

2026 年 5 月 19 日

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

API の変更

  • Wear ウィジェットで glance.wear.health.DataType API を公開しました。デベロッパーはこれらの API を使用して、システムの健康に関するデータにアクセスできます。

バグの修正

  • Glance Wear ウィジェットの Player に空のフォント軸を送信できないようにすることで、Wear 7 エミュレータまたは 1.6 レンダラを実行しているデバイスで alpha09 バージョンで発生していたクラッシュ ループを修正しました。

バージョン 1.0.0-alpha09

2026 年 5 月 6 日

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

API の変更

  • 試験運用版の Glance Wear 機能に使用される ExperimentalGlanceWearApi を追加しました。（Id2f76、b/498179813）

バグの修正

  • 起動時にウィジェットを認識するように、Wear ウィジェット XML メタデータのパーサーを更新しました。

バージョン 1.0.0-alpha08

2026 年 4 月 22 日

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

バグの修正

  • PackageManager がプッシュ更新の正しいサービスをクエリするように、glance:wear:wear ライブラリのマニフェストに <queries> タグを追加しました。(I192787)

その他

  • 「Compose compileSdk を 37 に更新」を元に戻しました（I6007）。これは glance-wear にも適用されるため、このリリースでは compileSdk の要件は 37 ではなくなりました。

バージョン 1.0.0-alpha07

2026 年 4 月 8 日

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

新機能

  • WearWidgetBrush が空の場合、または指定されていない場合に、デフォルトの Wear ウィジェットの背景を追加します。（I8300b）
  • getActiveWidgets API を更新して、ウィジェットのコンテナタイプを返すようにしました。（2772eb1）

API の変更

  • ウィジェット更新 API を変更して WidgetInstanceId を受け取るようにし、指定されたウィジェットの ID を取得するヘルパーを追加しました。指定された ID が無効な場合、または呼び出し元が所有していない場合、新しい API は IllegalArgumentException をスローします。（I6f3c5、b/446828899）
  • WearWidgetBrush に縦方向と横方向のグラデーションを追加しました。（If70ae、b/470080675）

バージョン 1.0.0-alpha06

2026 年 3 月 25 日

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

新機能

  • Wear ウィジェット プロファイルのオペレーションをインラインで定義します。

API の変更

  • 全画面表示互換ウィジェットをより適切に区別するために、CONTAINER_TYPE_FULLSCREEN の名前を CONTAINER_TYPE_TILE_COMPAT に変更しました。これには、以前に FULLSCREEN タイプをウィジェット パラメータの LARGE にマッピングしたものを元に戻すことも含まれます。

バージョン 1.0.0-alpha05

2026 年 3 月 11 日

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

API の変更

  • Wear ウィジェットの背景に使用する color メソッドを含む WearWidgetBrush API を追加しました。（I66f54、b/464273091）
  • fetchActiveWidgets がすでに存在するため、fetchActiveWidgetsForProvider メソッドを削除しました。（I85e4e、b/486197890）

バージョン 1.0.0-alpha04

2026 年 2 月 25 日

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

API の変更

  • アプリがアクティブなウィジェットとタイルをクエリできるように、GlanceWearWidgetManager API を追加しました。(I5be95)
  • glance:wear:wear-core ライブラリから androidx.glance.wear.core パッケージに API を移動しました。(I429cf)

バグの修正

  • 一般的な Remote Composable 型と Modifier 型を公開しました（Id1d40）

バージョン 1.0.0-alpha03

2026 年 2 月 11 日

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

API の変更

  • GlanceWearWidget にインタラクション イベントのサポートを追加しました。（Ia4e28、b/469808447）

バージョン 1.0.0-alpha02

2026 年 1 月 28 日

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

新機能

  • ウィジェット パラメータで FULLSCREEN を LARGE に再マッピングしました（ad78d95）

バグの修正

  • 複数のウィジェット インスタンスが表示されないようにする DataStore の使用を修正しました（474f3e4）

バージョン 1.0.0-alpha01

2026 年 1 月 14 日

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

  • Glance Wear は、RemoteCompose を使用して Wear OS 用のウィジェットをビルドするためのライブラリです。