Glance Wear

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

依存関係の宣言

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

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

Groovy

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

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

Kotlin

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

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

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

フィードバック

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

新しい問題を報告する

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

Glance Wear バージョン 1.0

バージョン 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 で使用する必要がある AssociateWithGlanceWearWidget を追加しました。これにより、関連付けられている GlanceWearWidget の実装を提供します。（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)
  • API を glance:wear:wear-core ライブラリから androidx.glance.wear.core パッケージに移動しました。(I429cf)

バグの修正

  • 一般的なリモート 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 用のウィジェットをビルドするためのライブラリです。