Glance Wear

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

依存関係の宣言

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

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

Groovy

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

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

Kotlin

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

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

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

フィードバック

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

新しい問題を報告する

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

Glance Wear バージョン 1.0

バージョン 1.0.0-alpha19

2026 年 9 月 23 日

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

内部テストの変更のみ。

バージョン 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 の変更

  • WearWidgetPreview に useSafeFallbackRendererVersion パラメータを追加し、古いホストでサポートされているオペレーションの安全なフォールバック セットを使用してウィジェットをプレビューできるようにしました。（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 リモート コンポーズ オペレーションを有効にしました。これにより、RemoteText は、サポートされている Host レンダラでフォント軸や行の高さなどの可変フォント機能を使用できます。サポートされていない場合は自動的にフォールバックします。

解決済みの問題

  • デベロッパーのフィードバックに基づき、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 のフィードバックに基づき、プレビュー用の 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()
 }
 ```

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

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

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）
  • GlanceWearWidget に triggerUpdateAll API を追加し、指定されたアプリのすべてのウィジェットで更新をトリガーできるようにしました。（I6ab20、b/510896410）

バグの修正

  • alpha10 バージョンで生成されたドキュメントの破損を防ぐため、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 は、デベロッパーがシステム 健康に関するデータ にアクセスするために使用できます。

バグの修正

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

バージョン 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 については、こちらをご覧ください。

バグの修正

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

その他

  • 「Updates Compose compileSdk to 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 の変更

  • Widget の更新 API を変更して WidgetInstanceId を取得し、特定の Widget の ID を取得するためのヘルパーを追加新しい API は、指定された ID が無効であるか、呼び出し元が所有していない場合、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 メソッドを含む WearWidgetBrushAPI を追加しました。（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）

バグの修正

  • 一般的な 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 向けウィジェットを作成するためのライブラリです。