Wear Compose マテリアル 3

  
マテリアル 3 Expressive デザイン システムを使用して、さまざまなデバイスサイズとナビゲーション操作をサポートする機能を提供して、Wear OS デバイス向けの Jetpack Compose アプリを作成します。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 6 月 4 日 - - 1.5.0-beta03 -

依存関係の宣言

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

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

Groovy

dependencies {
    implementation "androidx.wear.compose:compose-foundation:1.5.0-beta03"

    // For Wear Material Design UX guidelines and specifications
    implementation "androidx.wear.compose:compose-material3:1.5.0-beta03"

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation "androidx.wear.compose:compose-navigation:1.5.0-beta03"

    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03")
    
    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

Kotlin

dependencies {
    implementation("androidx.wear.compose:compose-foundation:1.5.0-beta03")

    // For Wear Material Design UX guidelines and specifications
    implementation("androidx.wear.compose:compose-material3:1.5.0-beta03")

    // For integration between Wear Compose and Androidx Navigation libraries
    implementation("androidx.wear.compose:compose-navigation:1.5.0-beta03")
    
    // For Wear preview annotations
    implementation("androidx.wear.compose:compose-ui-tooling:1.5.0-beta03")

    // NOTE: DO NOT INCLUDE dependencies on androidx.wear.compose:compose-material
    // or androidx.compose.material:material.
    // androidx.wear.compose:compose-material3 is designed as a replacement,
    // not an addition, to both of these other libraries.
    // If there are features from that you feel are missing from
    // androidx.wear.compose:compose-material3, please raise a bug to let us know.
}

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

フィードバック

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

新しい問題を報告する

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

Wear Compose Material3 バージョン 1.5

バージョン 1.5.0-beta03

2025 年 6 月 4 日

androidx.wear.compose:compose-*:1.5.0-beta03 がリリースされました。バージョン 1.5.0-beta03 に含まれる commit はこちらをご覧ください。

API の変更

  • OpenOnPhoneDialog で、TalkBack でメッセージ テキストのみを読み上げ、アイコンのセマンティクスをスキップするようになりました。OpenOnPhoneDialogDefaults が更新され、icon() から iconContentDescription パラメータと contentDescription パラメータが削除されました。また、ConfirmationDialogDefaultsSuccessIcon コンポーザブルと FailureIcon コンポーザブルの修飾子パラメータが追加されました。(Id2ae2

バグの修正

  • SurfaceTransformation パラメータの効果を適用する順序を変更しました。以前は、Wear Material3 コンポーネントに適用される変換は、背景ペインター、コンテナ変換、コンテンツ変換の順に行われていました。最初の 2 つは反転され、渡された修飾子はその間に適用されるため、コンテナ変換の影響を受けます。これにより、変換パラメータを使用して TLC 内の要素でプレースホルダのシマー効果を使用する場合などの問題が修正されます。(I786cf
  • RevealState.Saver が追加され、アクティビティまたはプロセスが再作成されたときに SwipeToReveal の状態を復元するために使用できるようになりました。rememberRevealState 関数で、このセーバーがデフォルトで使用されるようになりました。(Ie0ecb
  • SwipeToReveal メイン アクション ボタンとサブアクション ボタンはデフォルトで ButtonDefault.Height になります(高さの大きいボタンの最大高までボタンが占有されるバグを修正しました)。(Ibfba1
  • SwipeToReveal を変更し、右にスワイプ ジェスチャーを実行したときに、最後に操作したコンポーネントをリセットするようにしました。(Ia8450
  • SwipeToReveal が変更され、スワイプの終了位置が開くアンカーと開いたアンカーの間にあり、開くアンカーに近い場合は、Revealing 状態に落ち着くようになりました。(If4458
  • RTL レイアウトで ButtonGroup のコンテンツが正しく反転されるようになりました。(Ib378d
  • AnimatedText で RTL テキスト方向をサポートしました。(I4533c
  • TransformingLazyColumn で、一番下のアイテムを削除したときにアイテムのサイズが正しく調整されるようになりました。(Idacab
  • TransformingLazyColumn が測定パスを 1 回だけ行うようになりました。これにより、フレーム時間が短縮され、パフォーマンスが向上します。(I501a1

バージョン 1.5.0-beta02

2025 年 5 月 20 日

androidx.wear.compose:compose-*:1.5.0-beta02 がリリースされました。バージョン 1.5.0-beta02 には、これらの commit が含まれています。

バグの修正

  • foundation、material、material3 ライブラリのベースライン プロファイルを更新しました。(I53f06
  • 下部アイテムが削除されたときにアイテムのサイズが変更される TransformingLazyColumn のバグを修正しました。(Idacab
  • リストの一番上または一番下にリストが固定される TransformingLazyColumn のバグを修正しました。(I49d00
  • OpenOnPhoneDialog で、TalkBack がアイコンの内容説明ではなく、湾曲したテキストを読み上げるようにする必要があります。(I4efe8
  • hasPartiallyRevealedState が false に設定されている場合に RevealState.currentValue で誤ったアンカーを報告する SwipeToReveal のバグを修正しました。(I9c7cf
  • SwipeToReveal 元に戻すボタンがデフォルトで ButtonDefaults.Height になりました。(I1f6c8
  • BasicSwipeToDismissBox のパフォーマンスを改善しました。スクリムの描画に Canvas を使用しなくなりました。(I68f2c
  • スライダーのユーザー補助バグを修正しました。更新後に読み上げられる割合が値と一致しませんでした。(I91146
  • placeholderShimmer の実装に関するバグを修正しました。(Iee39b
  • ScrollProgress の計算を 30% 最適化することで、TransformingLazyColumn のパフォーマンスが向上しました。(I4c4cb

バージョン 1.5.0-beta01

2025 年 5 月 7 日

androidx.wear.compose:compose-*:1.5.0-beta01 がリリースされました。バージョン 1.5.0-beta01 には、これらの commit が含まれています。

Wear OS 向け Compose 1.5.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました(試験運用版としてマークされている場合を除く)。

Wear Compose 1.5.0-beta01 には、Wear Compose Material3 ライブラリが含まれています。このライブラリは、Material 3 Expressive という新しい UI デザイン システムをサポートしています。アプリに新しいビジュアル デザインを導入し、次のような新しいコンポーネントを活用するには、マテリアルから Material3 にアップグレードすることをおすすめします。

  • MaterialTheme: 更新および拡張されたカラーパターン、タイポグラフィ、シェイプにより、デザインに深みと多様性をもたらします。
  • ダイナミック カラー テーマ設定: ウォッチフェイスの色に合わせてアプリのカラーパターンを自動的に生成します。
  • 新しいコンポーネントは、デフォルトで大きな画面サイズに自動的に適応
  • シェイプ モーフィング - IconButtonTextButtonIconToggleButtonTextToggleButton などの丸いボタン コンポーネントは、押されたときやチェックされたときにアニメーション化するバリエーションをサポートしています。
  • EdgeButton - 画面の下部用に特別な形状で設計された、新しいエッジを覆うボタン。
  • スキャフォールディング - AppScaffoldScreenScaffold を導入して画面の構造をレイアウトし、ScrollIndicatorTimeText のアニメーションを調整します。
  • ボタン - さまざまなスタジアム型のボタンがサポートされています。柔軟なシングルスロット コンテナと、アイコンとラベル付きのボタン用のマルチスロット バリエーションがあります。CheckboxButtonSwitchButton は切り替えボタンが必要な場合に使用され、RadioButton は選択ボタンとして使用されます(切り替えボタンと選択ボタンの「分割」バリエーションも用意されています)。
  • ButtonGroup - タップしたときにシェイプモーフィングする、行に並んだ表現力豊かなボタンのグループを実装します。
  • AlertDialog のバリエーションは、OK ボタンまたはキャンセル ボタン、または EdgeButton をサポートしています。
  • ConfirmationDialog を使用すると、タイムアウト付きのメッセージを表示できます。成功、失敗、スマートフォンでの開く場合の特別なアニメーションがサポートされています。
  • 選択ツール - TimePickerDatePicker のバリエーションがサポートされています。また、独自の選択ツール画面を構築するための Picker コンポーネントと PickerGroup コンポーネントもサポートされています。
  • ProgressIndicators - 円形と線形の進行状況インジケーターがサポートされています(CircularProgressIndicator にはセグメント化された進行状況インジケーターと不確定な進行状況インジケーターがあります)。
  • カード - タイトル、時刻、サブタイトル、コンテンツ スロットを含むカードの特定のレイアウトを提供する TitleCard など、さまざまなカードバリエーションを使用できます。TitleCard に画像の背景を指定すると、カード内の情報を強調できます。
  • ページャー - HorizontalPagerScaffoldVerticalPagerScaffoldAnimatedPage コンポーネントは、HorizontalPageIndicator アニメーションと VerticalPagerIndicator アニメーションを調整します。HorizontalPagerVerticalPager は Wear Compose Foundation ライブラリでリリースされています。
  • プレースホルダ - 暫定的なコンテンツが使用できない場合に、コンポーネントの上にスケルトン シェイプを描画します。
  • スライダーとステッパー - スライダーとステッパーの両方を使用すると、ユーザーは値の範囲から選択できます。スライダーはよりコンパクトで、セグメント化できます。一方、ステップバーは通常 StepperLevelIndicator とペアになるフルスクリーン コンポーネントです。
  • SwipeToReveal - 右から左にスワイプしたときに、コンポーザブルに追加のアクションを追加するために使用されます。

Wear Compose Foundation 1.5.0-beta01 には、次の新しいコンポーネントも含まれています。

  • TransformingLazyColumn - スケーリングとモーフィング アニメーションをサポートする、遅延ありの縦方向にスクロールするリスト
  • 階層型フォーカス グループ - アプリケーション内のコンポーザブルにアノテーションを付け、コンポジションのアクティブな部分を追跡してフォーカスを調整するために使用されます。
  • ページャー - HorizontalPager コンポーネントと VerticalPager コンポーネント。Compose Foundation コンポーネントをベースに、Wear 固有の機能強化を施し、パフォーマンスと Wear OS ガイドラインへの準拠を改善しています。

API の変更

  • Hierarchical Focus API を更新 - Modifier.hierarchicalFocus の名前を Modifier.hierarchicalFocusGroup に変更し、コールバック パラメータを削除。FocusRequester パラメータを持つ Modifier.hierarchicalFocusRequester のオーバーロードを削除。コンポーネントがアクティブな画面を通知および確認できるように、新しい CompositionLocal LocalScreenIsActive を作成。(I5ff7c)。
  • Wear Compose Foundation の SwipeToReveal を非推奨とし、Wear Compose Material と Wear Compose Material3 の SwipeToReveal API に置き換えました。API を引き続き使用するには、Wear Foundation SwipeToReveal のインポートを Wear Compose Material または Wear Compose Material3 のインポートに置き換えてください。(Ia147d)。
  • Wear Compose の Material3 の SwipeToReveal が Foundation に依存している場合、その依存関係は material3 パッケージに移動されました(例: RevealValueRevealDirectionRevealActionTypeRevealStaterememberRevealState)。デベロッパーは、これらのクラスと関数のインポートを androidx.wear.compose.foundation から androidx.wear.compose.material3 に変更する必要があります。(I640e6)。
  • Wear Compose Material3 SwipeToReveal API を次のように更新しました。SwipeToReveal コンポーザブルに primaryActiononFullSwipesecondaryActionundoPrimaryActionundoSecondaryActionhasPartiallyRevealedState パラメータを追加しました。RevealState から positionalThresholdanimationSpec のカスタマイズ機能を削除しました。RevealState から lastActionTyperevealThreshold、幅を削除しました。RevealState コンストラクタを変更して、アンカーではなく RevealDirection を受け取れるようにしました。createRevealAnchors、アンカー、bidirectionalAnchors 関数を削除しました。SwipeToRevealScope 関数 primaryActionsecondaryActionundoPrimaryActionundoSecondaryAction の名前を PrimaryActionButtonSecondaryActionButtonUndoActionButton に変更し、コンポーザブル関数にしました。RevealActionType を内部としてマークしました。(I885d0)。
  • SwipeToReveal API を次のようにさらに更新しました。onFullSwipe の名前を onSwipePrimaryAction に変更しました。hasPartiallyRevealedState パラメータの使用を示すために SwipeToRevealNonAnchoredSample の名前を変更しました。デフォルトはボタンのデフォルトの高さであり、より大きな高さは修飾子を使用して設定できるため、actionButtonHeight を削除しました。SwipeToRevealDefaults から SmallActionButtonHeight を削除しました。RevealValue コンストラクタと RevealDirection コンストラクタの value パラメータを非公開にしました。(I465ce)。

バグの修正

  • TransformingLazyColumn アイテムが削除された後に EdgeButton がアニメーションで配置されるように、ScreenScaffoldEdgeButton の処理を修正しました。(I6d366)。
  • Compose ライブラリに対する Wear Compose の依存関係をバージョン 1.8.0 に更新しました。(I2ef3f)。
  • 未確定の CircularProgressIndicator の動きが更新され、一時的に後退しないようにしました。(Ieddb1)。
  • SwipeDismissableNavHost のバグを修正しました。後方にスワイプした後にフォーカスが正しく切り替わらず、ロータリー入力が失敗する問題を修正しました(これは、予測型「戻る」を使用する API 36 以降に該当します)。(Ieddb1)。
  • Hierarchical Focus API(Idf2ff)のドキュメントを修正しました。
  • Button と Card のドキュメントを更新し、containerPainterdisabledContainerPaintercontainerColordisabledContainerColor をオーバーライドする方法について説明しました。(I4a453
  • ナビゲーション中に独自のスレッドを管理するアプリで問題が発生するため、BroadcastReceiver をワーカー スレッドに移動した、前回のリリースTimeText の変更を元に戻しました。(I34d02)。
  • Picker のサンプルを更新し、不要な remember 呼び出しを削除し、代わりに Picker で rememberUpdatedState を使用して最新の contentDescription ラムダ関数を記憶するようにしました。(Icb5b1)。
  • TimePickerDatePicker のテキスト スタイルを更新し、フォント変更によるテキストの切り捨てを防ぎました。(I26194)。
  • ListHeaderListSubHeader のデフォルトのテキスト配置が、それぞれ中央揃えと先頭揃えになりました。(I78339)。
  • カスタム ユーザー補助アクションを通知するように、Foundation とマテリアルの「スワイプして表示」のサンプルとデモを更新しました(カスタム アクションは、SwipeToReveal コンポーザブル自体ではなく、コンテンツのセマンティクスとして追加する必要があります)。(Ie92a3)。
  • サイズに応じて EdgeButton コンテンツに設定されるデフォルトの MaxLines を更新しました。超小サイズは 1、小サイズと中サイズは 2、大サイズは 3 になりました。(Ie35f6)。
  • パフォーマンスを向上させるため、オブザーバーが 1 回だけ登録されるように LocalReduceMotion を簡素化しました。(Ib1979)。
  • パフォーマンスを改善するために、ScrollIndicator の再描画回数を最小限に抑えました。(Ia7a67)。
  • TransformingLazyColumn のバグを修正しました。EdgeButton の全高に達したときに、リスト内の上部に表示されるアイテムが正しくスケーリングされませんでした。(I30580)。

Wear Compose Material3 バージョン 1.0

バージョン 1.0.0-alpha37

2025 年 4 月 23 日

androidx.wear.compose:compose-material3:1.0.0-alpha37 がリリースされました。バージョン 1.0.0-alpha37 に含まれる commit はこちらをご覧ください。

API の変更

  • 公開 API サーフェスから scrollTransform を削除しました。同じ機能を実現する必要がある場合は、transformedHeight 修飾子と graphicsLayer 修飾子を組み合わせて使用します。(Ie181d
  • ImageButton コンポーザブルと ImageCard コンポーザブルを、それぞれ Button オーバーロードと Card/TitleCard オーバーロードに置き換えました。imageButtonColors の名前を buttonWithContainerPainterColors に、imageCardColors の名前を cardWithContainerPainterColors に変更しました。公開 ButtonDefaults.scrimBrushCardDefaults.scrimBrush を追加しました。ボタン imageBackgroundGradientStartColorimageBackgroundGradientEndColor の名前を scrimGradientStartColorscrimGradientEndColor に変更しました。CardDefaults.ImageContentPadding の名前を CardDefaults.CardWithContainerPainterContentPadding に変更しました。(I7b8b6
  • PickerPickerGroupcontentDescription をラムダとして受け取るようになり、不要な再コンポーズを回避できるようになりました。(I002dd

バグの修正

  • 幅が高さと同じでない場合、未確定の CircularProgressIndicator がアニメーション中に揺れる問題を修正しました。(I76bfe
  • 無効なサイズでのエッジボタンのレイアウトに関する問題を修正しました。高さが NaN の場合にエッジボタンのレイアウトが更新されなくなりました。(I32b93
  • OpenOnPhoneDialog の最大スイープ角度を増やし、デフォルトの「スマートフォンを確認してください」というテキストが最大フォントサイズで切り詰められないようにしました。(I90af9

バージョン 1.0.0-alpha36

2025 年 4 月 9 日

androidx.wear.compose:compose-material3:1.0.0-alpha36 がリリースされました。バージョン 1.0.0-alpha36 には、これらの commit が含まれています。

API の変更

  • ButtonDefaults.imageBackgroundButtonColorsImageButtonButtonDefaults.imageButtonColorsButtonDefaults.containerPainterButtonDefaults.disabledContainerPainter に置き換えました。カードにも同様の変更が加えられます。ペインターは ButtonColorsCardColors から削除されました。(I8c6a1
  • API を簡素化するためにプレースホルダを更新しました。2 つの修飾子(コンポーネント レベルでシマー効果を適用する Modifier.placeholderShimmer と、読み込まれていないコンテンツの上にマスクを適用する Modifier.placeholder)が追加されました(Iaee7a

バグの修正

  • ScrollIndicator にオーバースクロールを統合しました。(Icfb7f
  • マテリアル 3 ダイアログを起動すると背景が空白になる、ダイアログが表示されない問題に対処しました。(Ice597
  • テキストが複数行にまたがる場合に FadingExpandingLabel で発生する問題を修正しました。(I04eb7
  • ボタンのプライマリ ラベルとセカンダリ ラベル間のパディングを更新しました。(I99b7b
  • ArcLarge20sp から 18sp に引き下げ、ArcLargeArcSmall の文字間隔を更新しました。ConfirmationDialog/OpenOnPhoneDialog で、18sp にオーバーライドするのではなく、デフォルトの ArcLarge が使用されるようになりました。(Id39a8

依存関係の更新

  • このライブラリは Kotlin 2.0 言語レベルをターゲットとするようになりました。KGP 2.0.0 以降が必要です。(Idb6b5

バージョン 1.0.0-alpha35

2025 年 3 月 26 日

androidx.wear.compose:compose-material3:1.0.0-alpha35 がリリースされました。バージョン 1.0.0-alpha35 に含まれる commit はこちらをご覧ください。

API の変更

  • AlertDialog の上部パディングが、アイコンが指定されている場合にデフォルトで縮小されるようになりました。これにより、利用可能な画面サイズを最大限に活用できます。(Ief06c
  • PagerScaffoldDefaults.FadeOutAnimation の名前を PagerScaffoldDefaults.FadeOutAnimationSpec に変更しました。AnimatedPage の page パラメータの名前が pageIndex に変更されました。(I701f2
  • TransformingLazyColumnSurfaceTransformation の命名を更新 - applyTransformationapplyContainerTransformationapplyContentTransformation に分割し、createBackgroundPainter の名前を createContainerPainter に変更しました。TransformationSpecResponsiveTransformationSpec の命名をさらに更新しました。(I1c534
  • AppScaffold backgroundColor の名前が containerColor に変更されました。(I4e63f

バグの修正

  • FadingExpandingLabel で、テキストが正しく拡大されない問題を修正しました。(I0e773
  • ArcLarge は 20sp から 18sp に縮小され、ArcLargeArcSmall の文字間隔が更新されました。ConfirmationDialog/OpenOnPhoneDialog で、18sp にオーバーライドするのではなく、デフォルトの ArcLarge を使用するようになりました。(Id39a8
  • DatePickerTimePicker ベースのヘディング アニメーションを更新し、フェードアウト アニメーションとフェードイン アニメーションが 1 つのスプリング アニメーションとして機能するようにしました。(I68963
  • AnimatedPage コンポーズ可能関数で currentPageOffsetFraction の読み取りを回避することで、PagerScaffold を最適化しました。(I433ef
  • すべての種類のスケールが更新され、デフォルトで比例数値が使用されるようになりました。これは、比例数値が最も一般的なユースケースと見なされ、デフォルトで表形式が使用されていると、特定の数値のペアの間にスペースが多すぎるためです。TimePickerDatePicker では、表形式の数字に引き続き FontFeatureSetting=tnum が適用されます。(I88929
  • TimePickerDatePicker の RSB 入力の初期フォーカスを修正しました。(I1c773
  • OpenOnPhoneDialog のデフォルトのテキストを「スマートフォンを確認してください」に更新しました。(I00a3f
  • 重み 600 が太字として扱われる問題を回避するため、ArcLargeArcMedium の重みを 600 から 599 に更新しました(I2a51d
  • コンテンツとアクション ボタンの間、およびアクション ボタンのアイコンとテキストの間のパディングを SwipeToReveal に更新しました。(Ic46cb

バージョン 1.0.0-alpha34

2025 年 3 月 12 日

androidx.wear.compose:compose-material3:1.0.0-alpha34 がリリースされました。バージョン 1.0.0-alpha34 に含まれる commit はこちらをご覧ください。

API の変更

  • PagerScaffoldPager コンポーネントをエミットしなくなりました。代わりに、content コンポーザブルを介して提供する必要があります。AnimatedPagesnapWithSpringFlingBehaviour が公開され、Wear Foundation Pager とともに使用して、以前の M3 PagerScaffold の動作を実現できるようになりました。(更新されたサンプルをご覧ください)。(Ia4724
  • PagerState を更新し、Compose Foundation の PagerState をベースクラスとして削除し、currentPagecurrentPageOffsetFractionpageCount プロパティを追加しました。GestureInclusion インターフェースを更新し、メソッドの名前を ignoreGestureStart に変更しました。(I4ae07
  • LevelIndicator スイープ角度パラメータに FloatRange(0, 360) のアノテーションが追加されました。(I7e636
  • CurvedModifier.clearAndSetSemantics を追加して、湾曲セマンティクスをオフにする手段を提供しました。CurvedText では引き続きコンテンツの説明がデフォルトでテキストになりますが、timeTextCurvedTexttimeTextSeparator ではコンテンツが読み上げられなくなります。(I4b568
  • AppScaffold に背景とデフォルトのコンテンツ色のパラメータを追加しました。(I56652
  • HorizontalPager のスワイプ操作のデフォルトの処理の名前が PagerDefaults.gestureInclusion に変更されました。デフォルトの動作は、最初のページの左端から始まるスワイプ操作のみを無視し、TalkBack がオフの場合にのみ無視するように変更されました。それ以外の場合、デフォルトの動作では、スワイプ操作はページャーによって無視されないため、スワイプして閉じるハンドラで使用できません。(Iee486
  • ボタン、カード、リストヘッダー コンポーネントに SurfaceTransformation パラメータを追加しました。これにより、TransformingLazyColumn など、アイテムの位置に基づいてアイテムの外観を変更するコンテナで使用する場合、異なる背景とコンテンツの変換を適用できるようになりました。(Iabe3f
  • 値がインライン化されないように、Wear Compose Material3 API の「public const val」プロパティを「public val」に更新しました。(Ib0f32
  • SwipeToReveal にエッジスワイプ ゾーンのサポートを追加しました。Foundation SwipeToReveal のデフォルトの動作が変更され、操作が端から始まった場合にスワイプが禁止されるようになりました。Material3 の SwipeToReveal’ のデフォルトの動作が変更され、SwipeDirection が単一方向に設定されている場合に、ジェスチャーがエッジから開始されたときにスワイプが禁止されるようになりました。(I32ef0
  • FadingExpandingLabel コンポーザブルを追加しました。これにより、アニメーションでテキストを 1 行ずつフェードインできます。(Ic60fa
  • TransformingLazyColumn が、最初のアイテムと最後のアイテムを中央に配置するのではなく、デフォルトで空の contentPadding を使用するようになりました。(I77ab7
  • Wear Compose マテリアル 3 ライブラリから SwipeToRevealrememberRevealState を削除しました。(I8c0e0

バグの修正

  • Wear Compose ライブラリが Kotlin 2.0 コンパイラに更新されました。(I2de79
  • 丸以外の ScrollIndicatorPageIndicator のサポートは、Material3 から削除されました。また、Wear OS の要件から正方形の画面のサポートが削除されました。詳しくは、スタートガイドをご覧ください。(I9a852
  • ConfirmationDialogDefaultsOpenOnPhoneDialogDefaults で使用される CurvedTextStyle が更新され、サイズ 18sp と文字間隔 1.8spArcLarge タイポグラフィが使用されるようになりました。(Ic9ced
  • CardListHeaderRadioButtonCheckboxButtonSwitchButton で、デフォルトでコンテンツの高さが制限されなくなりました。必要に応じて、Modifier.height(IntrinsicSize.Min) を使用して以前の動作を復元します。(I80bb8
  • デフォルトの TimeTextScrollIndicator の色を更新し、グレーの色調を追加しました。これは、OnBackground(白)を使用すると、画面上の他のコンテンツ(タイトルなど)と競合する際に視覚的な重みが過度に大きくなるためです。(I8b36f
  • スキャフォールド コンポーネントの TimeTextScrollIndicator のアニメーション化のタイムアウトを 2 秒に短縮しました。(I52021
  • ダイアログの背景のスケールが、スワイプして閉じる操作と同期されるように、ダイアログのモーションが更新されました。(I925a9
  • edgeSwipeToDismiss 修飾子を使用した M3 SwipeToReveal のデモを追加しました。(I02b07
  • TalkBack の DatePickerTimePicker に見出しを追加し、日時を設定するためにスクロールするようユーザーに伝えるようにしました。(Id738d
  • AnimatedText がモーションの軽減設定に従うようになりました。(Ib6578
  • ダイアログ コンテンツの表示に AppScaffold を使用する最適化が改善され、複数のダイアログを重ねて表示できるようになりました(I1209c

バージョン 1.0.0-alpha33

2025 年 2 月 26 日

androidx.wear.compose:compose-material3:1.0.0-alpha33 がリリースされました。バージョン 1.0.0-alpha33 に含まれる commit はこちらをご覧ください。

API の変更

  • SwipeToRevealScopeprimaryActionsecondaryAction からラベル パラメータを削除しました。カスタム アクションのセマンティクスは、デベロッパーが SwipeToReveal コンポーネントの内容に直接追加する必要があります。(Ia67f3
  • IconToggleButtonDefaultsTextToggleButtonDefaults のサイズ、テキスト スタイル、色関数から「Button」接頭辞を削除しました(I5471d
  • 試験運用版の LocalMinimumInteractiveComponentEnforcement を削除しました。(I4ad8a
  • PickerGroupScope DSL がコンポーザブルに置き換えられました。そのため、PickerGroupScope から pickerGroupItem メソッドを削除し、代わりに @Composable PickerGroupItem を追加しました。これは、PickerGroup に Picker を追加するために使用する必要があります。また、PickerGroup の「content」パラメータの型を @Composable PickerGroupScope.() -> Unit に更新しました。(Ic6aec
  • 小数値の LevelIndicator オーバーロードを追加し、範囲パラメータを含むオーバーロード(Stepper コンポーネントでの使用に適している)に Stepper 接頭辞を追加しました。(If4234
  • TransformingLazyColumnTransformationSpec を API に追加しました。これにより、TLC をスクロールするときにアイテムに対して行われる正確な変換を定義できるようになりました。(I21856
  • IconButtonShapesIconToggleButtonShapesTextButtonShapesTextToggleButtonShapes を更新し、compose/material3 クラスと整合性を持たせました。(I5a081
  • overscrollEffect パラメータを ScalingLazyColumnTransformingLazyColumnScreenScaffold に追加しました。(I0cee8
  • rememberRevealStateswipeDirection パラメータの名前を revealDirection に変更しました。(I7472f
  • Wear Pager は、Compose PagerScope を使用する代わりに、独自の PagerScope を使用できるようになりました。(I9195b
  • LinearProgressIndicatorContent コンポーザブルは削除されました。値の変更がデフォルトでアニメーション化されるように、LinearProgressIndicator を直接使用してください。(I2c4ad
  • CircularProgressIndicatorStatic コンポーザブルを削除し、同じ機能を備えた公開 DrawScope 関数 drawCircularProgressIndicator を追加しました。変更がデフォルトでアニメーション化されるように CircularProgressIndicator を直接使用してください。カスタム アニメーションが必要な場合は、drawCircularProgressIndicator から独自の Compose を作成してください。(Ie762f
  • DrawScope.drawCircularProgressIndicator のパラメータの順序を変更し、targetProgress パラメータを上に移動しました。(I8ab92
  • OpenOnPhoneDialog API が更新され、明確性が高まり、他のダイアログとの整合性が向上しました。show パラメータの名前が visible に変更され、curvedText はデフォルト値ではなく呼び出し元から提供されるようになりました。(Idec2d
  • openOnPhoneCurvedText の名前を openOnPhoneDialogCurvedText に変更しました。(I65bdd
  • ScrollIndicator にカスタム色を指定するための ScrollIndicatorColors を追加しました。(I9eb8c
  • TimeText の背後に描画する背景に使用する色を設定できるようにします。(I9f5d9
  • ArcLargeArcMediumArcSmall のタイポグラフィを CurvedTextStyle に更新しました。(Iffc41
  • ScreenScaffoldDefaults.contentPaddingWithEdgeButton を削除しました。(Ia923e
  • 優先度の高いエラーや緊急アクション(安全性アラート、失敗したダイアログ オーバーレイ、停止ボタンなど)用に、ColorSchemeerrorDim を追加しました。(I70998

バグの修正

  • wear.compose.material3androidx.core.core のバージョン 1.15.0 に固定しました。(I132e9
  • AppScaffold を使用してダイアログを他の画面コンテンツの上に重ねることで、ダイアログのパフォーマンスを改善しました。(I1b9a4
  • EdgeButton の内部垂直パディングを減らしました。(I1a5bb
  • スライダー ボタンにボタンのセマンティクスを追加しました。(I80cc6

バージョン 1.0.0-alpha32

2025 年 1 月 29 日

androidx.wear.compose:compose-material3:1.0.0-alpha32 がリリースされました。バージョン 1.0.0-alpha32 に含まれる commit はこちらをご覧ください。

API の変更

  • CurvedTextStyle では、文字間隔を時計回りの文字間隔と反時計回りの文字間隔に分割しました。これは、時計回りの文字はベースラインから外側に広がりますが、反時計回りの文字は内側に広がるため(文字間隔を大きくする必要があります)、必要となります(I4b848
  • Material3 ライブラリ間の一貫性を改善するため、IconButtonShapesIconToggleButtonShapesTextButtonShapesTextToggleButtonShapes を更新しました。また、この変更によりシェイプ キャッシュが導入され、割り当て回数が削減されます。(I049fc
  • IconToggleButtonTextToggleButtonvariantAnimatedShape メソッドから pressedShapeCornerSizeFraction パラメータを削除しました。(I58a65
  • 丸い画面と互換性のない湾曲したテキストのレンダリング(TimeText を含む)を改善しました。丸以外の画面のサポートも Wear OS の要件から除外されました。詳しくは、スタートガイドをご覧ください。(I1cc1c
  • ButtonGroupButtonGroupScope を更新し、DSL ベースの ButtonGroupItemModifier.weightModifier.minWidthModifier.enlargeOnPress に置き換えました。(I16c3c
  • ButtonGroup API で、新しい修飾子ベースの ButtonGroupScope が更新されました。enlargeOnPressanimateWidth に改名され、変更する必要がないため MutableInteractionSource ではなく InteractionSource を受け取ります。また、ButtonGroup 内のボタンのデフォルトの最小幅である公開定数 ButtonGroupDefaults.DefaultMinWidth も追加しました。(Ie27ec
  • ListHeaderDefaults.contentColor はコンポーザブル プロパティであるため、先頭を小文字にするように更新しました。(I125a5
  • SliderDefaults.DecreaseIconSliderDefaults.IncreaseIcon にコンテンツ説明パラメータを追加し、適切なデフォルト値を設定しました。(I2e1a7
  • PickerPickerGroupspacing パラメータの名前を verticalSpacing に変更しました。(Ib75cc
  • ConfirmationDialog の呼び出し元は、よりコンテキストのある文字列を提供する必要があるため、ConfirmationDialogDefaults.successTextfailureText を削除しました。また、confirmationCurvedText の名前を confirmationDialogCurvedText に変更しました。最後に、ダイアログの show パラメータの名前を visible に変更し、ダイアログの最近の他の更新との整合性を保ちました。(I10074
  • IconButton で、disabledImageOpacity の名前を DisabledImageOpacity に変更しました。(I5f94a

バグの修正

  • 各フレームで正しいサイズが使用されるように、EdgeButton アニメーションのバグを修正しました。(Id3b58
  • animateContentSizeButton で機能しない問題を修正しました。(Ib18a0
  • タイトルの大文字のスケールを変更し、フォントサイズを 18dp にしました。(Ic9d52
  • AlertDialog の間隔とアイコンサイズを更新しました。(Iac28c
  • 大画面のブレークポイントの不整合を修正しました(225 dp 以上の画面は大画面です)(I36474
  • ボタンの配置に関する軽微なバグを修正しました。(I952c2

バージョン 1.0.0-alpha31

2025 年 1 月 15 日

androidx.wear.compose:compose-material3:1.0.0-alpha31 がリリースされました。バージョン 1.0.0-alpha31 に含まれる commit はこちらをご覧ください。

API の変更

  • すべての Wear Compose ライブラリが「明示的な API」モードに更新されました。(Iebf9f
  • ScreenScaffold API と EdgeButton API が更新され、EdgeButton を含む画面でコンテンツの余白を簡単に指定できるようになりました。新しい API では、EdgeButtonsizeEdgeButton にのみ渡され、ScreenScaffoldEdgeButton とリスト コンテンツ間のスペースに edgeButtonSpacing パラメータを受け取ります。(I424fd
  • DatePicker で、パラメータ minDate の名前を maxDate に、minValidDate の名前を maxValidDate に変更しました。DatePickerColors で、パラメータ selectedPickerContentColor の名前を activePickerContentColor に、unselectedPickerContentColor の名前を inactivePickerContentColor に変更しました。(Iba17b
  • ArcProgressIndicator のデフォルトを strokeWidth=6dp に更新し、画面の高さの diameter = 81.24% を推奨しました。(I6f248
  • ダイアログとしての使用を反映するように Confirmation API を更新しました。composable の名前が ConfirmationDialog に変更され、それに伴い、色とデフォルト クラスの名前が更新されました。また、他の Compose アニメーション API との互換性を確保するため、show パラメータの名前を visible に変更しました。また、デベロッパーが導入/終了ダイアログのアニメーションをカスタマイズする必要がある状況に備えて、ConfirmationDialogContentSuccessConfirmationDialogContentFailureConfirmationDialogContent も利用可能になりました。(Iaeb33
  • CircularProgressIndicatorContentCircularProgressIndicatorStaticCircularProgressIndicator のアニメーションなしのバリエーション)に更新し、カスタム アニメーションを使用して CircularProgressIndicator を作成できるようにしました。(I1346f
  • ArcProgressIndicator のパラメータの順序を修正し、修飾子パラメータを先頭に配置しました(I4656a
  • SwipeToReveal API を改善し、アクションのラベル(セカンダリ アクションを除く)のテキスト スロット パラメータを受け取るようにし、元に戻すアクションからラベル パラメータを削除しました。(I5b3db

バグの修正

  • ButtonCardIconButtonTextButtonLongPress ハプティクスが複数回トリガーされるバグを修正しました。(Ia8b0f
  • AlertDialog の UX の変更 - 大画面では、確認ボタンと閉じるボタンが小さくなりました。また、[確認] ボタンと [閉じる] ボタンの下のスペースも広がりました。(I4f066
  • SwipeToReveal コンポーネントのアクション ボタン ラベルのアニメーション仕様を変更しました。(Ib87fb
  • SwipeToReveal を変更し、テキストの表示と同時にコンテナを展開するようにしました。(I44cf8
  • SwipeToReveal を改善し、プライマリ アクションが commit されるしきい値を超えるスワイプ時にハプティクス フィードバックを実行するようにしました。(I23efe
  • SwipeToReveal を更新し、メイン アクションと元に戻すアクションで、テキスト オーバーフローの場合にデフォルトで省略記号を表示するようにしました。(I71f5a
  • ButtonGroup アニメーションでジッターが発生する問題を修正しました。(I63f8f
  • AnimatedText にテキスト セマンティクスを追加しました。(I6063c
  • ダイアログがコンポジションから削除されたときに、ダイアログの背景スケーリングがリセットされるようになりました(この修正を行わないと、起動画面が縮小された状態のままになる可能性があります)(Id24ac
  • Stepper コンポーネントのボタンにシェイプ モーフ アニメーションを追加しました。(Id6ed3

バージョン 1.0.0-alpha30

2024 年 12 月 11 日

androidx.wear.compose:compose-material3:1.0.0-alpha30 がリリースされました。バージョン 1.0.0-alpha30 に含まれる commit はこちらをご覧ください。

API の変更

  • TransformingLazyColumnscrollTransform 修飾子がリファクタリングされ、API の変更がトリガーされました。(I0c6dc
  • IconToggleButtonShapesTextToggleButtonShapes を更新し、2 つの異なるシェイプ パラメータ uncheckedPressedcheckedPressed を追加しました。(I85dbd
  • minDate または maxDate を使用している場合、無効な月/日のオプションが DatePicker に新しい invalidPickerContentColor とともに表示されるようになります。(If4541
  • Stepper API を更新して、increaseIcon スロットと decreaseIcon スロットを提供しました。これらのコンテンツは、通常どおり Icon コンポーザブルから作成できます。(Id35da
  • dynamicColorScheme を更新し、オプションの defaultColorScheme パラメータを削除して、null 許容の ColorScheme を返すようにしました。つまり、ダイナミック カラーパターンが指定されていない場合は、呼び出し元がフォールバック ケースを明示的に処理する必要があります。(I6d62e
  • CompactButton で使用するために、ButtonDefaults のアイコンサイズを更新しました。アイコンのみを含む CompactButton には ButtonDefaults.SmallIconSize = 24.dp を使用し、アイコンとテキストの両方を含む CompactButton には ButtonDefaults.ExtraSmallIconSize = 20.dp を使用します。CompactButton は、最大幅に収めるのではなく、コンテンツを折り返すことをおすすめします。サンプルは、この点が反映されるように更新されています。(I0582c
  • 4 種類の EdgeButtonSizes の推奨アイコンサイズを示す EdgeButtonDefaults を追加しました。また、EdgeButton のレイアウトを更新し、上部パディングよりも下部パディングを少し大きくしました。これにより、アイコンとテキストの両方のコンテンツの外観が改善されます。(Id772a
  • LinearProgressIndicator にモーションを追加し、アニメーションのないビジュアル コンテンツを提供する LinearProgressIndicatorContent を公開しました。(Idee99
  • アニメーションなしで CircularProgressIndicator のビジュアル コンテンツを表示する新しい CircularProgressIndicatorContent コンポーザブルを追加しました。(Ie33d4
  • TransformingLazyColumn にコンポジション ローカル LocalTransformingLazyColumnItemScope が新たに提供されました。CardButtonListHeader は、TransformingLazyColumn 内に配置されたときに自動的にモーフィングするために、この LocalTransformingLazyColumnItemScope を使用します。呼び出し元は、新しい TransformExclusion ラッパーを使用して自動モーフィングを無効にできます。(I1652f
  • ButtonDefaults.shape の型を RoundedCornerShape に更新しました。(Iccdf2

バグの修正

  • TimeText の背景の既存のアルファを尊重するバグを修正しました。(I1eb60
  • タイポグラフィでは、スケーリング オペレーション中に文字グリフがピクセル境界にスナップされることによるテキストのジッターを回避するため、デフォルトで TextMotionAnimated に設定しています。(I626fa
  • 視認性を高めるために、ScrollIndicator の幅と隙間サイズを大きくして外観を更新しました。(Ied7cb
  • アイテムの追加、削除、移動時に Modifier.scrollTransform で発生するバグを修正しました。(I6830f
  • 短いタップによる丸いボタンのアニメーションの問題を修正しました(以前は、アニメーションの最小時間が常に守られていませんでした)。(I757a7
  • LevelIndicator のスウィープ角度を 20%(72 度)に更新しました。(Idde5c
  • ScalingLazyColumnAutoCenteringParams で使用されている場合の ScrollIndicator の配置を修正しました。(I387dd
  • ListHeaderListSubHeader の色とタイポグラフィを更新しました。また、CheckboxButtonSwitchButton の切り替えコントロールの色も変更できます。(I39817
  • LazyColumnScalingLazyColumnScrollIndicator の位置を ContentPadding で修正しました。(I2bc51
  • 新しい CircularProgressIndicatorContent を使用して、OpenOnPhoneDialog の進行状況アニメーションで発生していたバグを修正しました。(I3e443
  • モーションの軽減が有効になっているときにアニメーションを無効にするように HorizontalPagerScaffoldVerticalPagerScaffold を更新しました。(Iaaf68
  • 進行状況が 100% を超えた場合の円形の進行状況インジケーターに、別のアニメーションを実装しました。(I47135
  • Pager コンポーネントで EdgeButton が誤った形状で描画されるバグを修正しました。(I91db9

バージョン 1.0.0-alpha29

2024 年 11 月 13 日

androidx.wear.compose:compose-material3:1.0.0-alpha29 がリリースされました。バージョン 1.0.0-alpha29 に含まれる commit は次のとおりです。

API の変更

  • TimeText を更新して、時刻を表示するデフォルト コンテンツを提供しました。(Id23b3
  • orientation パラメータが不要になったため、PagerStateScrollInfoProvider を簡素化しました。新しい動作では、TimeText は水平方向と垂直方向の両方のページングで同じ位置に留まります。(I71767
  • LocalHapticFeedback で、Vibrator API がハプティクスがサポートされていることを示す場合に、デフォルトの HapticFeedback 実装が提供されるようになりました。HapticFeedbackTypeConfirmContextClickGestureEndGestureThresholdActivateRejectSegmentFrequentTickSegmentTickToggleOnToggleOffVirtualKey が追加されました。Wear Compose の長押し可能なコンポーネント(ButtonIconButtonTextButtonCard など)で、長押しハンドラが指定されている場合に LONG_PRESS ハプティクスが実行されるようになりました。(I5083d

バグの修正

  • 確認のモーションを更新しました。(I04bff
  • Compose ライブラリの最小 API 依存関係を 1.7.4 に更新しました。(I88b46
  • OpenOnPhone ダイアログに新しいモーション追加。(I1e10a
  • LevelIndicator のバグを修正しました。これにより、レベルがゼロの場合に正しく表示されるようになりました。(Ie95a4
  • HorizontalPageIndicator アニメーションと VerticalPageIndicator アニメーションを更新しました。(I5c8f3
  • 未確定の ArcProgressIndicator に、ドットになるまで縮小するアニメーションを追加しました。(I9fd51

バージョン 1.0.0-alpha28

2024 年 10 月 30 日

androidx.wear.compose:compose-material3:1.0.0-alpha28 がリリースされました。バージョン 1.0.0-alpha28 に含まれる commit はこちらをご覧ください。

API の変更

  • 不確定形式の円形の進行状況インジケーター(I2efc1)に円弧のバリエーションを追加しました
  • AlertDialog API を構成する AlertDialogContent コンポーザブルと Dialog コンポーザブルを公開しました。これにより、必要に応じてカスタマイズを追加できます(推奨コンテンツ レイアウトを維持しながら AlertDialog アニメーションをカスタマイズするなど)。また、AlertDialogDefaultsEdgeButtonConfirmButtonDismissButton メンバーに Modifier パラメータと Color パラメータを追加しました。(I4eb71
  • Placeholder API を次のように更新しました。PlaceholderState.startPlaceholderAnimation の名前を PlaceholderState.animatePlaceholder に、PlaceholderState.isShowContent の名前を PlaceholderState.isHidden に、PlaceholderDefaults.shape の名前を PlaceholderDefaults.Shape に変更しました。painterWithPlaceholderOverlayBackgroundBrushpainter パラメータの名前を originalPainter に変更しました。PlaceholderState.placeholderProgression の公開設定を公開から内部に変更し、名前を placeholderShimmerProgression に変更しました。プレースホルダ アニメーションの長さの定数を PlaceholderDefaults に追加しました。(Ie5a59
  • EdgeButton API を次のように更新しました。ScreenScaffold のパラメータの名前を bottomButton から edgeButton に変更し、EdgeButtonSize を値クラスにしました。(Ieef15
  • Wear material3 Colors クラスで copy() の公開設定を public に変更しました(I0287f

バグの修正

  • クリック時の IconToggleButtonTextToggleButton の最小アニメーション時間を追加しました。(Ieb333
  • IconButtonTextButton のシェイプ アニメーションの最小時間を追加しました(Iebcee
  • DatePicker の繰り返しオプションの状態を修正しました。(I3587c
  • アラート ダイアログと確認ダイアログのモーションが追加されました。(I173b1

バージョン 1.0.0-alpha27

2024 年 10 月 16 日

androidx.wear.compose:compose-material3:1.0.0-alpha27 がリリースされました。バージョン 1.0.0-alpha27 に含まれる commit はこちらをご覧ください。

API の変更

  • Wear Compose Foundation LazyColumn の名前を TransformingLazyColumn に変更したため、ScreenScaffoldScrollIndicator を更新しました。(I0608b
  • EdgeButtonpreferredHeight パラメータの名前が buttonSize に変更されました。その値は、新しく導入された EdgeButtonSize 値クラスの 4 つの定数からのみ選択できます。(Icdd70
  • ListSubheader の名前を ListSubHeader に変更し、ListHeaderListSubHeader に公開アクセス可能なデフォルト値を追加しました。(I96730
  • Wear 向けに新しい HorizontalPagerScaffold コンポーネントと VerticalPagerScaffold コンポーネントを追加しました。これにより、新しいアニメーションと、時刻テキストとページインジケーター コンポーネント間の調整が可能になりました。(Iff7d0
  • HorizontalPagerScaffoldVerticalPagerScaffold にロータリーのサポートを追加しました。これにより、ロータリー入力デバイスを使用してページャーを操作できるようになりました。(I9770d
  • MotionScheme API の使用を簡素化し、一貫性を改善するために変更を加えました。インライン化された remember 関数を削除し、組み込みの Motion Schemes を専用の MotionScheme コンパニオン オブジェクトに移動しました。standardMotionSchemeexpressiveMotionScheme の名前を標準と表現力に変更しました。(I5fd45
  • システムカラーに基づく動的カラーパターンのサポートを追加しました。(I073e9
  • 最新の UX 仕様に沿って Stepper を更新しました。(I622bb

バグの修正

  • カード コンポーネントのタイポグラフィとパディングが更新されました。(I3ae48
  • UX 仕様(Ie55f0)に従い、AlertDialog の [確認] ボタンと [閉じる] ボタンと残りのコンテンツの間のパディングを 8 dp から 12 dp に変更しました。
  • スライダー コンポーネントの色の不透明度を更新しました。(Idb383

バージョン 1.0.0-alpha26

2024 年 10 月 2 日

androidx.wear.compose:compose-material3:1.0.0-alpha26 がリリースされました。バージョン 1.0.0-alpha26 に含まれる commit はこちらをご覧ください。

API の変更

  • HorizontalPageIndicator の API と外観を更新し、VerticalPager で使用するための VerticalPageIndicator を追加しました。(Ic9309
  • AlertDialog で、EdgeButton が不要なカスタム レイアウトの場合に、ボタンスタック バリエーションからデフォルトの下部ボタンを省略できるようになりました。(I34fa9
  • Wear マテリアル 3 の SwipeToReveal コンポーネントを追加しました。(Ic38b2
  • SwipeToReveal で双方向スワイプのサポートを追加しました。現在の画面でスワイプして閉じることができないまれなケースに対応します。デフォルトでは、引き続き右から左へのスワイプのみでスワイプして表示する動作になります。スワイプして閉じる操作との競合を避けるため、デフォルトの動作を尊重することを強くおすすめします。(Ifac04
  • EdgeButtonbuttonHeight パラメータの名前を preferredHeight に変更しました。(I4fab3
  • Kotlin のバージョンが 1.9(I1a14c)に更新されました
  • Icon との競合を回避するため、OpenOnPhoneDialogDefaults.Icon の名前を OpenOnPhoneDialogDefaults.OpenOnPhoneIcon に変更しました。(I0f391
  • LazyColumnScrollIndicator のサポートを追加しました。(Ia546a
  • TextToggleButtonIconToggleButton のデフォルト値を更新しました。(I7aaa9
  • Picker API と PickerGroup API を簡素化しました。(Id0653
  • CardDefaults.ShapeCardDefaults.Height を追加しました。これらはトークンであるため、ライブラリを使用するデベロッパーに限定されていました。(I1594ab/347649765
  • バイナリ セグメント化された円形の進行状況インジケーターの進行状況パラメータの名前を segmentValue に変更しました。(Ib72d9
  • スライダーの色とレイアウトを更新しました。(Ic3eec

バグの修正

  • openOnPhone アイコンのアニメーションを更新しました。(I66f85
  • SliderTimePickerDatePicker で Google シンボル アイコンが使用されるようになりました。(I46c7c
  • ConfirmationOpenOnPhoneDialog のパディングを更新しました。(Iaa82e

バージョン 1.0.0-alpha25

2024 年 9 月 18 日

androidx.wear.compose:compose-material3:1.0.0-alpha25 がリリースされました。バージョン 1.0.0-alpha25 に含まれる commit はこちらをご覧ください。

API の変更

  • 不確定形式の円形進行状況インジケーターを追加しました。(I427a7
  • CircularProgressIndicatorSegmentedCircularProgressIndicator の両方で、進行状況のオーバーフロー(進行状況が 100% を超える)のサポートを追加しました。進行状況が 1.0 を超えると、新しい overflowTrack の色で示されます。(Iaaa3d
  • 丸い IconToggleButtonTextToggleButton で、新しい形状アニメーションのバリエーションをサポートするようになりました。このアニメーションでは、チェック状態、未チェック状態、押下状態を異なる形状で表します。押下直後の状態の以前のアニメーション化されたシェイプのバリエーションは引き続きサポートされます。(I29f03
  • ScreenScaffoldEdgeButton の高さを明示的に指定する必要があるため、ColumnEdgeButton を使用するサポートを削除しました。(Ie353d
  • ScreenScaffold で Wear Compose の LazyColumn のサポートを追加しました(LazyColumnStateScrollInfoProvider の実装も追加しました)。(Ib8d29
  • 今後、よりスケーラブルなソリューションを提供するために、LocalTextMaxLinesLocalTextAlignLocalTextOverflow を 1 つのローカル LocalTextConfiguration コンポジションに統合しました。(I5edbc
  • 追加のタイプスケールとして arc-large を追加しました。これは、確認オーバーレイなど、画面の一番上または一番下の短いヘッダー テキスト文字列用に予約されています。(I60e3e
  • 推奨される大サイズと特大サイズのアイコンサイズとコンテンツの余白について、Button にデフォルトを追加しました。(I84675

バグの修正

  • IconButtonTextButton の色を更新しました。(I48324
  • 他のオーバーロードとの整合性を保つため、ベースの Button のオーバーロードを垂直方向に中央揃えに変更しました。以前の動作を復元するには、RowScopeModifier.align を使用します。(I66e57

バージョン 1.0.0-alpha24

2024 年 9 月 4 日

androidx.wear.compose:compose-material3:1.0.0-alpha24 がリリースされました。バージョン 1.0.0-alpha24 に含まれる commit はこちらをご覧ください。

API の変更

  • Material3 テーマにモーション スキームを追加しました。これは、ライブラリ全体のコンポーネントで使用され、表現力豊かなモーションのスプリングなどのアニメーション仕様を適用します。(I54ff3
  • Material3 ライブラリに AppScaffold コンポーネントと ScreenScaffold コンポーネントが追加されました。これには、TimeTextScrollIndicator のレイヤリングと遷移を調整する機能が含まれています。AppScaffold は、すべての画面の上に配置される最上位のスキャフォールド コンポーネントを提供します。そのため、AppScaffoldTimeText を追加すると、画面をスワイプしてもその位置を維持できます。画面自体で時刻のテキストをオーバーライドまたは非表示にできます。ScreenScaffoldScrollIndicator のスロットを提供します。スクロール時にスクロール インジケーターを自動的にアニメーション化します。また、無操作状態が続くとスクロール インジケーターを非表示にするタイムアウトも設定できます。(I047d6
  • 新しい Material3 デザインの ScrollIndicator を追加しました。遅延読み込みコンテンツがリストに読み込まれたときにサイズが変化しないように、サムネイルのサイズは初期リストの内容に基づいて固定されています。(Ic228d
  • 今後必要に応じてステージを追加できるように、ScreenStage が列挙型クラスではなく値クラスになるように ScrollAway API を変更しました。(I48c93
  • EdgeButton を追加しました。これは、画面下部の湾曲に沿った形状の Wear 固有のボタンです(I16369
  • ScreenScaffold に、スクロール コンテンツに応じて表示とサイズ変更が行われる、下部ボタン(EdgeButton など)の新しいスロットを追加しました。(I032eb
  • Modifier.scrollTransformModifier.targetMorphingHeight を追加して、LazyColumn のアイテムに Material3 モーション効果を追加しました。(Ie229a
  • CircularProgressIndicator のバリエーションとして SegmentedCircularProgressIndicator を追加しました。セグメント化されたバリエーションでは、すべてのセグメントにわたる単一の進行状況値が表示されるか、各セグメントがオンまたはオフとして表示されます。(I6e059
  • 既存の CircularProgressIndicator の代替として LinearProgressIndicator を追加しました。(I89182
  • AlertDialog を追加し、ユーザーに重要なプロンプトを表示するためのレイアウトを提供しました。バリエーションには、確認/閉じるボタンのペア、またはオプションのスタックの下にある単一の下部ボタン(通常は EdgeButton)が含まれています。どちらのバリエーションにも、アイコン、タイトル、追加のテキスト用のスロットがあり、詳細情報を提供できます。(Ieb873
  • OpenOnPhoneDialog が追加されました。これは、ユーザーのスマートフォンで続行されるアクションを示すために使用します。OpenOnPhoneDialog は、指定したタイムアウト後に閉じられます。(I978fd
  • アイコンと曲線または直線のテキスト用のスロットがあるダイアログ コンポーネント Confirmation を追加しました。成功/失敗メッセージには、特定のバリエーションが用意されています。確認メッセージはタイムアウト後に自動的に閉じられます。(Ib43e8
  • TimeText に背景を追加し、基盤となるコンテンツと TimeText が重なって時間が見えづらくなる問題を軽減しました。(Ia11fd
  • LevelIndicator を追加しました。これは、音量などの設定の値を表示し、既存の Stepper コンポーネントと組み合わせて音量画面を作成できます。LevelIndicatorScrollIndicator に似ていますが、画面の反対側に表示され、ストロークの太さが広く、デフォルトでインジケーターの色が異なります。(I8a4ac
  • TimePicker を追加しました。24 時間表記(秒ありまたは秒なし)または 12 時間表記(AM/PM 選択可)のレイアウトがあります。(Ia5124
  • DatePicker を追加しました。列の順序(日-月-年、月-日-年、年-月-日)と最小日付と最大日付(省略可)を構成できます。(Ibf13b
  • TimeTexttext 関数に重みパラメータを追加しました。TimeText が複数のテキスト要素で構成されている場合は、スペースの分割方法を制御できます。(I36700
  • RadioButtonSplitRadioButton を追加しました。これらのコンポーネントは、(分割)SelectableButton と子ラジオ コントロール(If7ae8)の両方を組み合わせることで、以前の API を簡素化します。
  • CheckboxButtonSplitCheckboxButton を追加しました。これらのコンポーネントは、(分割)ToggleButton と子チェックボックス コントロール(Ia8f70)の両方を組み合わせることで、以前の API を簡素化します。
  • SwitchButtonSplitSwitchButton を追加しました。これらのコンポーネントは、(Split)ToggleButton と子スイッチ コントロールの両方を組み合わせることで、以前の API を簡素化します(I0d349
  • AnimatedText のドキュメントを更新し、オーバーシューティングの動作について説明しました。(Iff30a
  • ButtonGroup を追加して、2 つまたは 3 つのボタンを組み合わせ、ボタンを押すと連動したアニメーションが表示されるようにしました。(Ie27db
  • IconButtonTextButton の押下時にオプションのシェイプ アニメーションを追加しました。(Iffca5
  • ButtonIconButtonTextButtonCompactButtonEdgeButton に色のバリエーション FilledVariant を追加しました。(I65fc3
  • forcedSize パラメータを ImageWithScrimPainter に追加しました。これにより、ボタン画像の背景はデフォルトでコンポーネントのサイズを維持するようになりました。forcedSize = null を設定すると、代わりに Painter.instrinsicSize が採用されます。(Ic57af
  • ボタンに長押しを追加しました(Ib613d
  • IconButtonTextButton にも長押しのサポートが追加されました。(I38891
  • カードに長押しに対応しました。(I305d5
  • LocalTextMaxLinesLocalTextAlignLocalTextOverflowCompositionLocals として追加し、Text のパラメータのデフォルトとして使用しました。コンポジションのローカル変数を CheckboxButtonSwitchButtonRadioButton などのコンポーネントで使用して UX ガイダンスを実装できるようになりました。ただし、必要に応じてデベロッパーがパラメータをオーバーライドできます。(Iab841
  • データが読み込まれるまで、ボタンやカードなどのコンポーネントのコンテンツをマスクするのに役立つ Placeholder が追加されました。(I1a532
  • 削除された ToggleButtonColors に代わる IconToggleButtonColorsTextToggleButtonColors を追加しました。(Ie0bf1

バグの修正

  • ButtonFilledTonalButtonOutlinedButtonChildButtonCompactButton を更新し、新しい CompositionLocals LocalTextMaxLinesLocalTextAlignLocalTextOverflow を使用して UX ガイダンスを実装できるようにしました。これらのパラメータは、必要に応じてデベロッパーが Text で直接オーバーライドできます(Ie51f7
  • LevelIndicator のデフォルトのストローク幅を 6dp に変更しました。これは、ストローク幅が 4dpScrollIndicator と区別するためです。(If6f63
  • TimeText の問題を修正し、より大きなスイープ角度をサポートできるようにしました。(Ie489f
  • EdgeButton の再コンポジション中に発生する問題を修正しました。(I4cdca
  • カスタマイズされたコンテンツの余白が指定されている場合の分割切り替えボタンのレイアウトを修正しました。(Ia33d3
  • 小さな進行状況値は、進行状況インジケーターの線幅以上に切り上げます。(I3bd84

バージョン 1.0.0-alpha23

2024 年 5 月 14 日

androidx.wear.compose:compose-material3:1.0.0-alpha23 がリリースされました。バージョン 1.0.0-alpha23 に含まれる commit はこちらをご覧ください。

API の変更

  • 無効な色を構成できるように ToggleButton API と RadioButton API を更新しました。(If13a7
  • Material3 に新しい CircularProgressIndicator を追加しました。(Ib3bd7

バグの修正

  • 選択可能なボタンが、すでに選択されているときにダブルタップして切り替える音声を読み上げるバグを修正しました。(I7ed88

バージョン 1.0.0-alpha22

2024 年 5 月 1 日

androidx.wear.compose:compose-material3:1.0.0-alpha22 がリリースされました。バージョン 1.0.0-alpha22 に含まれる commit はこちらをご覧ください。

API の変更

  • Material3 の ColorScheme を更新しました。(I7b2b8
  • Material3 Switch を更新しました。色を変更し、チェックボックスで使用されているものと一致するチェックマークを追加しました。(Icac7b

バグの修正

  • 新しい rotaryScrollable 修飾子を使用するように、すべての統合デモを更新しました。(I25090

バージョン 1.0.0-alpha21

2024 年 4 月 17 日

androidx.wear.compose:compose-material3:1.0.0-alpha21 がリリースされました。バージョン 1.0.0-alpha21 に含まれる commit はこちらをご覧ください。

  • このリリースは、ソース JAR が欠落するという技術的な問題が原因で、以前のリリースでトリガーされました。このリリースには新しい commit はありません。

バージョン 1.0.0-alpha20

2024 年 4 月 3 日

androidx.wear.compose:compose-material3:1.0.0-alpha20 がリリースされました。バージョン 1.0.0-alpha20 に含まれる commit はこちらをご覧ください。

バグの修正

  • 押下状態とフォーカス状態の Ripple のアルカを調整し、コントラストを改善しました。(I59f0a
  • タイポグラフィ スタイルと行の高さに最近行われた変更に伴い、ButtonToggleButtonRadioButton のプライマリ ラベルとセカンダリ ラベルの間にスペースを追加しました。(I2c0ba

バージョン 1.0.0-alpha19

2024 年 3 月 6 日

androidx.wear.compose:compose-material3:1.0.0-alpha19 がリリースされました。バージョン 1.0.0-alpha19 に含まれる commit はこちらをご覧ください。

API の変更

  • Wear Compose Material3 ライブラリに TimeText を追加しました。このコンポーネントは、画面上部に現在時刻(および追加のステータス)を表示します。新しい簡潔な Material3 API により、リニア コンテンツとカーブ コンテンツの重複を回避できます。(I4d7c3
  • RadioButton のパラメータ名を onSelected から onSelect に更新しました。(I1a971
  • RadioButtonSplitRadioButton をトークン化し、既存のメソッドをリファクタリングして、色のキャッシュに保存されたインスタンスを追加し、RadioButtonColorsSplitRadioButtonColors のメソッドを内部にすることで、CompositionLocal のルックアップ回数を減らしました。(I02b33

バージョン 1.0.0-alpha18

2024 年 2 月 21 日

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

API の変更

  • CardColorsToggleButtonColorsSplitToggleButtonColors のデフォルト パターンをリファクタリングし、内部でキャッシュに保存されたインスタンスを作成して CompositionLocal の使用を削減しました。(If3fec

バージョン 1.0.0-alpha17

2024 年 2 月 7 日

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

API の変更

  • デフォルトで buttonColors を使用するように Button API を更新し、重複する filledButtonColors を削除しました。(I4fe3b
  • ButtonColorsIconButtonColorsTextButtonColors のデフォルト パターンをリファクタリングし、内部でキャッシュに保存されたインスタンスを作成して CompositionLocal の使用を削減しました。(I5f51c
  • コンポーネント固有のカラークラスの rememberUpdatedState のオーバーヘッドを削除し、カラークラス内のアクセサラ メソッドを内部としてマークしました。(If6571

バグの修正

  • Modifier.node を使用するように Modifier.minimumInteractiveComponentSize を更新しました。(Iba6b7

バージョン 1.0.0-alpha16

2024 年 1 月 24 日

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

新機能

  • CompactButton が追加されました。これは、Button と同じ塗りつぶし、塗りつぶしトーン、枠線の色を使用できます。(I05df0

API の変更

  • ラジオ コントロールなどの選択コントロールのコンテナとして RadioButton/SplitRadioButton を追加しました。これは、RadioButton は選択可能(選択グループ内で動作)であるのに対し、ToggleButton は切り替え可能(独立)であるという点で、既存の ToggleButton とは異なります。(I61275
  • Compose マテリアル 3 ライブラリとの整合性を確保するため、Wear Compose マテリアル 3 ライブラリから LocalContentAlpha を削除します。(I49a0a
  • API で MutableInteractionSource を公開する Wear material コンポーネントと Wear material3 コンポーネントが更新され、デフォルトで null になる null 許容型の MutableInteractionSource を公開するようになりました。意味的な変更はありません。null を渡すことは、MutableInteractionSource をホイスティングしないことを意味し、必要に応じてコンポーネント内に作成されます。null に変更すると、一部のコンポーネントでは MutableInteractionSource が割り当てられなくなり、他のコンポーネントでは必要な場合にのみインスタンスを遅延作成できるため、これらのコンポーネントのパフォーマンスが向上します。これらのコンポーネントに渡す MutableInteractionSource を使用していない場合は、代わりに null を渡すことをおすすめします。独自のコンポーネントでも同様の変更を行うことをおすすめします。(Ib90fcb/298048146
  • 非推奨の rememberRipple に代わる新しいリップル API を wear:compose-material ライブラリと wear:compose-material3 ライブラリに追加しました。また、一時的な CompositionLocalLocalUseFallbackRippleImplementation を追加して、非推奨の rememberRipple/RippleTheme API を使用するようにマテリアル コンポーネントを元に戻します。これは次の安定版リリースで削除される予定です。これは、カスタム RippleTheme を提供するケースの一時的な移行支援のみを目的としています。移行情報とこの変更の背景情報については、developer.android.com をご覧ください。(af92b21
  • HorizontalPageIndicator API とそのドキュメントを若干改善しました。(I60efc
  • ColorScheme を変更不可に更新しました。これにより、個々の色の更新は効率が低下しますが、色の一般的な使用は効率化されます。この変更の背景には、ほとんどのアプリで個々の色の更新が主なユースケースではないという理由があります。引き続き可能ですが、以前よりも再コンポーズが増えます。これにより、マテリアル コード全体で状態サブスクリプションの量が大幅に減り、より標準的なユースケースの初期化とランタイム コストに影響します。(Ibc2d6
  • 無効な色をカスタマイズできるように ToggleButton API と SplitToggleButton API を更新しました。また、色とタイポグラフィの値にマテリアル デザイン トークンが使用されるようになりました。(If087c
  • マテリアル デザイン トークンを使用するように、ボタン画像の背景色を更新しました。(Iba215
  • クリック処理を削除して、CheckboxSwitchRadioButton コンポーネントを表示専用に変更しました。これらのコンポーネントはクリックを処理する (Split)ToggleButton で使用されることが想定されているため、コンポーネントがディスプレイ専用であることが明確に示されるようになりました(Wear でのスタンドアロンでの使用は想定されていません)。(I2322e

バグの修正

  • Wear Compose マテリアル 3 に、時間とイージングのモーション値のトークンを追加しました。(I437cd
  • ToggleButtonSplitToggleButtonCheckboxSwitchRadioButton のバグを修正し、ユーザー補助に関するお知らせが繰り返されないようにしました(以前は、セマンティック ロールが重複していました)。(Ica281
  • パフォーマンスを改善するため、CompactButton の materialcore レイヤを削除しました。(7902858

バージョン 1.0.0-alpha15

2023 年 11 月 15 日

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

API の変更

  • 基盤レベルの SwipeToDismissBox の名前を BasicSwipeToDismissBox に変更しました。これにより、Foundation レベルのコンポーネントと Material3 レベルの SwipeToDismissBox の違いが明確になります。後者は、スクリムで使用される色を MaterialTheme から取得し、残りの実装を BasicSwipeToDismissBox に委任します。(Ibecfc

バグの修正

  • パフォーマンスを改善するため、マテリアル 3 ボタンの material-core レイヤを削除しました。(I55555

バージョン 1.0.0-alpha14

2023 年 10 月 18 日

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

API の変更

  • Material3 HorizontalPageIndicator から indicatorStyle パラメータを削除しました。代わりに、デバイスの画面の形状(直線または円形)に従います。(I83728
  • 新しい SplitToggleButtonColors クラスを追加して、SplitToggleButton の色と ToggleButton の色を分離しました。(I78bee

バージョン 1.0.0-alpha13

2023 年 10 月 4 日

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

API の変更

  • オプションの Subtitle フィールドを TitleCard に追加しました。(Ifc45a
  • TextButton にマテリアル デザインのカラートークンが追加されました。(I769dc

バージョン 1.0.0-alpha12

2023 年 9 月 20 日

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

API の変更

  • マテリアル デザイン トークンを使用するように IconButton を更新しました。(I3f137
  • マテリアル デザイン トークンを使用するように IconToggleButton を更新しました。(I7d263
  • CheckboxColorsRadioButtonColorsSwitchColors のコンストラクタを公開しました。(I82b73

バージョン 1.0.0-alpha11

2023 年 9 月 6 日

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

バグの修正

  • Material3 カードのタイポグラフィを TitleMedium に更新しました。(I597bd
  • マテリアル 3 の ListHeaderListSubheader のタイポグラフィと配置を更新しました。(Ib5ceb

バージョン 1.0.0-alpha10

2023 年 8 月 23 日

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

新機能

  • Wear Material3 ライブラリに HorizontalPageIndicator を追加。(Ifee99

API の変更

  • マテリアル 3 デザイン トークンを使用するようにボタンのコードが更新されました。(I92fe4
  • Wear マテリアル 3 の Stepper API と Slider API を試験運用版として宣言します。ユーザー インターフェースの詳細はまだ確定していません。(I84d54
  • ExtraSmall サイズは IconButton にのみ適用されるため、丸い TextButtonTextToggleButton から削除しました。(Ibc7d5

バグの修正

  • TextToggleButton のタイポグラフィに関するガイダンスを更新し、LargeButtonSize に LabelLarge を使用するようにしました。(Ib10fa
  • TextButton のタイポグラフィに関するガイダンスを更新し、LargeButtonSize に LabelLarge を使用するようにしました。(I8f3a7
  • ユーザー補助のため、カードのタップ ターゲットの最小サイズは 48 dp に設定されています。(Ieb9b1
  • 画像付き AppCard のデモを追加し、背景付き AppCard のデモを削除しました。(Id735f
  • 丸いボタンで修飾子が正しく連結されないバグを修正しました。(I5e162

バージョン 1.0.0-alpha09

2023 年 8 月 9 日

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

新機能

  • マテリアル 3 に ToggleButton を追加しました。(I6bed6

API の変更

  • 以前コメントで述べたように、API 制約として FloatRange アノテーションを有効にしました。(Icb401
  • 最新の Material3 ガイドラインに準拠するよう、Wear Material3 のタイポグラフィを更新しました。(I1bad6

バグの修正

  • ButtonIconButtonTextButton の色を、マテリアル 3 のデザインに合わせて更新しました。(Ib2495
  • 無効な状態のチェックボックスのチェックマークの可視性を修正しました。(Ib25bf

バージョン 1.0.0-alpha08

2023 年 7 月 26 日

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

新機能

  • マテリアル 3 に、SwitchCheckboxRadioButton の選択コントロールを追加しました。(Ib918c
  • Material3 に IconToggleButtonTextToggleButton を追加しました。これは、アイコンとテキスト用にそれぞれ 1 つのスロットを備えた円形の切り替えボタンです。ToggleButton のサイズが異なる場合は、それぞれの切り替えボタンで指定されたサイズの Modifier.touchTargetAwareSize を使用することをおすすめします。(I9f015
  • Material3 コンポーネントに ListHeaderListSubheader を追加しました。(Ibaefe
  • Material3 SwipeToDismissBox が追加されました。これは、新しい Foundation SwipeToDismissBox を呼び出し、そのテーマのデフォルトのカラー値を指定します。(I275fb
  • Wear Compose にマテリアル 3 の InlineSlider を追加しました。ユーザーは値の範囲から選択できます。選択範囲は、範囲の最小値と最大値の間にバーとして表示され、ユーザーはそこから値を 1 つ選択できます。InlineSlider は、音量や明るさなどの設定を調整するのに最適です。(I7085f

API の変更

  • Wear マテリアル 3 テーマのシェイプを更新し、Shape ではなく RoundedCornerShape ベースを使用するようにしました。(Idb133
  • Button の高さ定数を公開しました(Idbfde
  • 互換性抑制のアノテーションを付けるように API ファイルを更新しました。(I8e87ab/287516207
  • Wear Compose Material 3 の InlineSliderColors を更新し、パブリック コンストラクタとパブリック プロパティを追加しました。(I6b632
  • Wear Compose マテリアル 3 のすべてのカラークラスを更新し、パブリック コンストラクタとパブリック プロパティを追加しました。(I17702
  • Button の水平方向と垂直方向のパディング定数を公開しました。(Ieeaf7

バグの修正

  • 必要に応じて、ユーザー補助用の大きなフォントによってコンテンツが拡大した場合に、ボタンの高さが調整されるようになりました。(Iaf302
  • ユーザー補助に関する問題に対処するため、いくつかの Button デモを更新しました。(I61ce9
  • StepperInlineSlider で長押し時の連続クリックがサポートされるようになりました。これにより、+ ボタンまたは - ボタンを長押しして StepperInlineSlider の値をすばやく増減できるようになりました(I27359

バージョン 1.0.0-alpha07

2023 年 6 月 21 日

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

新機能

  • Stepper コンポーネントを Wear OS 向け Compose マテリアル 3 ライブラリに追加しました。これは以前のマテリアル バージョンと似ていますが、デベロッパーからのフィードバックに基づき、デフォルトで範囲のセマンティクスが省略されています。範囲セマンティクスが必要な場合は、Modifier.rangeSemantics を使用します。(Ic39fd
  • Compose for Wear OS マテリアル 3 ライブラリに curvedText を追加しました。(Ia8ae3

バグの修正

  • wear.compose.foundation を更新し、wear.compose.material3 の API 依存関係にしました。(I72004b/285404743

バージョン 1.0.0-alpha06

2023 年 6 月 7 日

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

バグの修正

  • TextButton を更新し、無効なアルファ値を修正するために toDisabledColor 拡張関数を使用するようにしました。(I814c8

バージョン 1.0.0-alpha05

2023 年 5 月 24 日

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

新機能

  • Material3 に TextButton を追加しました。これは、テキスト用の 1 つのスロットを備えた円形のボタンです。TextButton のサイズが異なる場合は、TextButtonDefaults で提供されている Modifier.touchTargetAwareSizeExtraSmallButtonSizeSmallButtonSizeDefaultButtonSizeLargeButtonSizeIcon を使用することをおすすめします。デフォルトの TextButton には枠線がなく、強調度が低いアクションの背景は透明です。高強調が必要なアクションには filledTextButtonColors を使用します。中程度の強調が必要なアクションには、枠線付きの TextButton を使用し、枠線を ButtonDefaults.outlinedButtonBorder に設定します。枠線と塗りつぶしの中間の場合は、filledTonalTextButtonColors を使用します。(I667e4
  • Wear Compose マテリアル 3 ライブラリに CardOutlinedCardAppCardTitleCard が追加されました。AppCardTitleCard には、CardDefaults.outlinedCardColorsCardDefaults.outlinedCardBorder を使用して枠線を付けることもできます。(I80e72

API の変更

  • 後置ラムダ構文をサポートするため、ボタンのラベル パラメータを最後に移動し、ロール パラメータを削除しました(これは Modifier.semantics を使用してオーバーライドできるため)。ButtonColors コンストラクタが公開されました。(Ie1b6d

バージョン 1.0.0-alpha04

2023 年 5 月 10 日

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

新機能

  • Material3 に IconButton を追加しました。これは、アイコン/画像用の 1 つのスロットを備えた円形のボタンです。バリエーションは IconButtonFilledIconButtonFilledTonalIconButtonOutlinedIconButton の 4 つです。IconButton のサイズが異なる場合は、IconButtonDefaults で提供されている Modifier.touchTargetAwareSizeExtraSmallButtonSizeSmallButtonSizeDefaultButtonSizeLargeButtonSizeIcon を使用することをおすすめします。また、特定のボタンサイズに推奨されるアイコンサイズを決定するための IconButtonDefaults.iconSizeFor も用意されています。(I721d4

バージョン 1.0.0-alpha03

2023 年 4 月 19 日

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

API の変更

  • マテリアル 3 のボタン コンポーネントが追加されました。これはスタジアム型のボタンで、以前は Wear Compose マテリアル ライブラリで Chip という名前でしたが、Compose マテリアル 3 ライブラリとの整合性を確保するため、Button に名前が変更されました。デフォルトの Button は背景が塗りつぶされています。ボタンのバリエーションには、FilledTonal(背景が薄い)、Outlined(透明で細い枠線)、Child(背景が透明で枠線なし、最も目立たない補足アクションに使用)があります。シンプルなアイコンとテキスト コンテンツ用の丸いボタンは、今後のリリースで提供される予定です。(Ia6942

バージョン 1.0.0-alpha02

2023 年 4 月 5 日

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

バグの修正

  • Wear Compose Material 3 に DefaultTextStyle を追加しました。これにより、PlatformTextStyle.includeFontPadding がデフォルトで true(現在の設定)になります。これにより、今後、デフォルトでフォント パディングをオフにすることを Compose ライブラリと同期できるようになります(背景の Compose でフォント パディングを修正するをご覧ください)。(I7e461

バージョン 1.0.0-alpha01

2023 年 3 月 22 日

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

新機能

  • マテリアル 3 はマテリアル デザインの進化版であり、テーマ設定の更新とコンポーネントの再設計が含まれています。Wear Compose のマテリアル 3 は、Android のマテリアル 3 Compose ライブラリと連携するように設計されています。この最初のアルファ版リリースには、次のものを備えた初期段階の機能実装が含まれています。

    • マテリアル テーマ - ライブラリ内のコンポーネント全体でカラースキーム、タイポグラフィ、シェイプを統一して構成します。Material3 テーマでは、ユーザー補助のコントラストをサポートする色が改訂されました。(I84005
    • テキスト/アイコン - Wear Compose アプリのビルディング ブロック(I8e06a
  • Wear マテリアル(androidx.wear.compose:compose-material)と Wear マテリアル 3(androidx.wear.compose:compose-material3)は引き続き並行して開発されます。今後の material3 リリースでは、ウィジェット セットが拡張され、ボタン、選択ツール、スライダーなど、Wear OS 向け Compose の使い慣れた他のコンポーネントが追加される予定です。

  • Wear Material ライブラリと Wear Material 3 ライブラリは互いに排他的であり、同じアプリで混在させることはできません。主な理由は、異なるテーマを参照するため、予期しない不整合が生じる可能性があるためです。