Google は、黒人コミュニティに対する人種平等の促進に取り組んでいます。取り組みを見る

Wear

Wear OS by Google スマートウォッチ向けのアプリを作成します。

androidx.wear グループ内のすべてのアーティファクトのリストを以下に示します。

アーティファクト 現在の安定版リリース 次のリリース候補 ベータ版リリース アルファ版リリース
wear 1.1.0 - - 1.2.0-alpha02
wear-input - 1.0.0-rc01 - -
wear-complications-data - - - 1.0.0-alpha02
wear-complications-provider - - - 1.0.0-alpha02
wear-watchface - - - 1.0.0-alpha02
wear-watchface-complications-rendering - - - 1.0.0-alpha02
wear-watchface-data - - - 1.0.0-alpha02
wear-watchface-style - - - 1.0.0-alpha02
このライブラリの最終更新日: 2020 年 11 月 11 日

依存関係の宣言

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

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

dependencies {
    implementation "androidx.wear:wear:1.1.0"

    // Add support for wearable specific inputs
    implementation "androidx.wear:wear-input:1.0.0-rc01"
    implementation "androidx.wear:wear-input-testing:1.0.0-rc01"

    // Use to implement wear watchface complications
    implementation "androidx.wear:wear-complications-provider:1.0.0-alpha02"

    // Use to implement wear watchfaces
    implementation "androidx.wear:wear-watchface:1.0.0-alpha02"
}

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

フィードバック

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

新しい問題を報告する

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

Wear Complications と Watchface 1.0.0

バージョン 1.0.0-alpha02

2020 年 11 月 11 日

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

API の変更

  • ComplicationDetailsComplicationState と呼ばれるようになり、適切にラップされ、ウェアラブル サポート @ComplicationData.ComplicationType の使用は androidx ComplicationType に移行されました。(I4dd36
  • オプションの highlightedComplicationId パラメータを RenderParameters に追加しました。これにより、スクリーンショットで 1 つの追加機能のハイライト表示をリクエストできます。(I66ce9
  • ComplicationProviderService。整合性を保つために新しいスタイル追加機能 API を使用します(Id5aea
  • getPreviewReferenceTimeMillisDeviceConfig から基準時間を取得するようになりました。(I779fe
  • Renderer API サーフェスを簡略化しました。代わりに SurfaceHolder.Callback を使用して変更を監視できます。(I210db
  • CanvasComplicationRendererRenderer から拡張されていません。わかりやすくするために名前を変更しました。(Ibe880

バグの修正

  • androidx.wear:wear-watchface-client の最初のバージョン(I1e35e
  • わかりやすくするために GlesTextureComplication#renderer の名前を変更しました(Ib78f7
  • わかりやすくするために StyleCategory の名前を StyleSetting に変更しました(I488c7)。
  • API を簡潔にするために UserStyleSchema を追加しました(If36f8

バージョン 1.0.0-alpha01

2020 年 10 月 28 日

androidx.wear:wear-complications-*:1.0.0-alpha01androidx.wear:wear-watchface-*:1.0.0-alpha01 がリリースされました。バージョン 1.0.0-alpha01 に含まれるコミットについては、こちらをご覧ください。

API の変更

  • 公開 API で公開することを意図していなかったものを削除しました。(I41669
  • androidx.wear:wear-complications-provider ライブラリを作成しました。(I77f1f
  • ComplicationsUserStyleCategory。追加機能を構成するための新しい推奨カテゴリ(I96909
  • wear-complication-data API を追加しました。(I7c268
  • 戻り値がブール値である関数に付く接頭辞が「get」ではなく「is」になりました(If36ff
  • API のアドバイスは、protected の使用を避けることです。そのため、このクラスはコンストラクタを介してパラメータを取り込むようにリファクタリングされました。(I61644
  • わかりやすくするために setBackgroundComplication の名前を変更しました。(I96fe3
  • ComplicationDrawable の isHighlighted とデータに Kotlin プロパティを使用します(I4dcc8
  • ComplicationRenderer.InvalidateCallback の代わりに Complication#invalidate() を追加しました(I4f4c6
  • これらの API は WearableSupport でサポートが終了し、今回削除されました。(Ib425c
  • Wear 2.0 のレガシー性を強調するように、一部の WatchFace ビルダー メソッドの名前を変更しました。(Idb775
  • wear / wear-watchface の最初のベータ版 API 候補(Id3981
  • API の最初のトラック バージョン。(Ie9fe6
  • ComplicationDrawable.BorderStyle IntDef を適切に非表示にし、整合性を保つために ComplicationStyle に移動しました。(I27f7a
  • 欠落していた ComplicationStyle メソッドのアノテーションを追加しました(I838fd
  • このライブラリには公開 API サーフェスがありません(I88e2b
  • すべてのスタイル カテゴリ オプション クラスが適切に最終版になりました。(Ib8323
  • API の最初のトラック バージョン。(I27c85

バグの修正

  • 明示的な getComplicationPreviewData メソッドを持つように ComplicationProviderService を変更しました。(I4905f
  • MissingGetterMatchingBuilder の API lint チェックが androidx で有効になりました(I4bbeab/138602561
  • wear-complications-rendering の名前を変更しました。(Ifea02
  • スタイル カテゴリの表示名が CharSequences になりました(I28990
  • 現在のテーマとスタイルの命名規則に合わせて、「Override」を「Overlay」に置き換えました。(I4fde9
  • わかりやすくするために、UserStyle#getOptions の名前を変更しました。(I695b6

バージョン 1.2.0

バージョン 1.2.0-alpha02

2020 年 11 月 11 日

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

今回のリリースで、新しい「Ongoing Activities API」が初めて追加されます。デベロッパーはこの API を使用して、フィットネス エクササイズやメディア再生セッションなど、長時間実行されるアクティビティが進行中であることをユーザーに通知できます。これにより、ウォッチフェイスまたはアプリ ランチャーに表示する「走った距離と時間」や「現在再生中のトラック」などのステータスを定期的に更新できます。この機能は、進行中のアクティビティ機能が有効にした今後のデバイスをターゲットとしています。

API の変更

  • 進行中のアクティビティ用の新しい API。「サポートされていないデバイス」では no-op です。(I69a31

バージョン 1.2.0-alpha01

2020 年 10 月 28 日

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

新機能

  • ビューに内接できる最大の円の曲率に沿って曲線テキストを簡単に記述するために、WearCurvedTextView コンポーネントを追加しました。使用例を次に示します。
<androidx.wear.widget.WearCurvedTextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="example curved text"
        app:anchorAngleDegrees="180"
        app:anchorPosition="center"
        app:clockwise="false"
        style="@android:style/TextAppearance.Large"
/>

Android Wear の曲線テキストの例

  • 時計回りまたは反時計回りに子要素を 1 つずつ弧状に配置するために、WearArcLayout コンテナを追加しました。子は、標準の Android ウィジェットでも、ArcLayoutWidget インターフェースを実装した「曲線状の」ウィジェットでも構いません。使用例を次に示します。
<androidx.wear.widget.WearArcLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        app:anchorPosition="center">
      <ImageView
              android:layout_width="20dp"
              android:layout_height="20dp"
              android:src="@drawable/ic_launcher"
      />
      <androidx.wear.widget.WearCurvedTextView
              android:layout_width="match_parent"
              android:layout_height="match_parent"
              android:text="Curved Text"
              style="@android:style/TextAppearance.Small"
              android:padding="2dp"
       />
  </androidx.wear.widget.WearArcLayout>

Android Wear のアーチ型テキストの例

I536da

Wear-Input 1.0.0

バージョン 1.0.0-rc01

2020 年 11 月 11 日

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

このリリースは 1.0.0-beta01 と同一です。

バージョン 1.0.0-beta01

2020 年 10 月 28 日

androidx.wear:wear-input:1.0.0-beta01androidx.wear:wear-input-testing:1.0.0-beta01 がリリースされました。1.1.0-alpha01 からの変更はありません。バージョン 1.0.0-beta01 に含まれるコミットについては、こちらをご覧ください。

Wear-Input-Testing バージョン 1.0.0-alpha01

2020 年 10 月 14 日

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

API の変更

  • androidx.wear:wear-input ライブラリを使用して開発したアプリのテストをサポートするために androidx.wear.input.WearableButtonsProvider を実装する androidx.wear.input.test.TestWearableButtonsProvider を追加しました。(I0ed0c

Wear-Input バージョン 1.0.0-alpha01

2020 年 9 月 2 日

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

新機能

ウェアラブル サポート ライブラリから Jetpack に WearableButtons の機能を移行しました。次回の Jetpack リリースの androidx.wear:wear-input-testing ライブラリに、追加のテストのサポートが提供されます。

バージョン 1.1.0

バージョン 1.1.0

2020 年 10 月 14 日

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

1.0.0 以降の主な変更

  • Android の命名規則を遵守するため、BoxInsetLayout の boxedEdges 属性(現在は layout_BoxedEdges)に layout_ 接頭辞を追加しました。これにより、Android Studio でこの属性に関するリンターエラーが解消されます。(I4272f
  • 確認ダイアログが表示される持続時間を設定できるように、オプションの EXTRA_ANIMATION_DURATION_MILLISConfirmationActivity に追加しました。(adb83ceb/143356547
  • アクション ドロワーが初めて開くまでアクション ドロワーのインフレーションを遅らせるように、WearableActionDrawView を更新しました。(I01026b/163870541

バージョン 1.1.0-rc03

2020 年 9 月 2 日

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

バグの修正

  • アクション ドロワーが開いたときにコンテンツが表示されない問題を修正しました。(I01026b/163870541

バージョン 1.1.0-rc02

2020 年 6 月 24 日

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

バグの修正

  • Android の命名規則を遵守するため、BoxInsetLayout の boxedEdges 属性(現在は layout_boxedEdges)に layout_ 接頭辞を追加しました。これにより、Android Studio でこの属性に関するリンターエラーが解消されます。

バージョン 1.1.0-rc01

2020 年 5 月 14 日

androidx.wear:wear:1.1.0-rc01 がリリースされました。.1.0-beta01 からの変更はありません。バージョン 1.1.0-rc01 に含まれる commit については、こちらをご覧ください

バージョン 1.1.0-beta01

2020 年 4 月 29 日

androidx.wear:wear:1.1.0-beta01 がリリースされました。androidx.wear:wear:1.1.0-alpha01 からの変更はありません。バージョン 1.3.0-beta01 に含まれるコミットについては、こちらをご覧ください

バージョン 1.1.0-alpha01

2020 年 4 月 15 日

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

API の変更

  • 確認ダイアログが表示される持続時間を設定できるように、オプションの EXTRA_ANIMATION_DURATION_MILLISConfirmationActivity に追加しました。(adb83ce134523cb/143356547

バグの修正

  • アクション ドロワーが初めて開くまでアクション ドロワーのインフレーションを遅らせるように、WearableActionDrawView を更新しました。(5cd32f7