wear protolayout

  
このライブラリを使用すると、一連の UI レイアウトと UI 以外の式をリモート サーフェスでレンダリング/評価できます。
最新の更新 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
2025 年 4 月 9 日 1.2.1 - 1.3.0-beta01 -

依存関係の宣言

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

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

Groovy

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation "androidx.wear.protolayout:protolayout-expression:1.2.1"

    // Use to implement support for Wear ProtoLayout
    implementation "androidx.wear.protolayout:protolayout:1.2.1"

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation "androidx.wear.protolayout:protolayout-material:1.2.1"
}

Kotlin

dependencies {
    // Use to implement support for Wear ProtoLayout Expressions
    implementation("androidx.wear.protolayout:protolayout-expression:1.2.1")

    // Use to implement support for Wear ProtoLayout
    implementation("androidx.wear.protolayout:protolayout:1.2.1")

    // Use to utilize components and layouts with Material design in your ProtoLayout
    implementation("androidx.wear.protolayout:protolayout-material:1.2.1")
}

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

フィードバック

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

新しい問題を報告する

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

バージョン 1.3

バージョン 1.3.0-beta01

2025 年 4 月 9 日

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

新機能

Wear ProtoLayout 1.3.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear ProtoLayout 1.3 には、次の新機能と API が含まれています。

  • スマートウォッチにマテリアル 3 のデザインが導入されました。コンポーネントとレイアウトは丸いディスプレイ用に最適化され、小画面から大画面まで適切にスケーリングされます。
    • これには、次のコンポーネントと機能向けの Compose に似た API を備えた Kotlin 専用の protolayout-material3 ライブラリが含まれます。
    • システムとウォッチフェイスから取得されるダイナミック カラーテーマ。色、シェイプ、タイポグラフィに最新のマテリアル 3 テーマを使用
    • MaterialScope: すべての独自のデフォルトを処理し、カスタマイズを容易にします。
    • iconEdgeButton、textEdgeButton
    • iconButton、textButton、button、imageButton、avatarButton、compactButton
    • titleCard、appCard、graphicDataCard、iconDataCard、textDataCard
    • circularProgressIndicator、segmentedCircularProgressIndicator
    • primaryLayout、buttonGroup
    • すべてのコンポーネントは、すべての SDK レベルと ProtoLayout レンダラ バージョンで動作し、必要に応じて適切なフォールバックを提供します。
  • 基本 ProtoLayout 要素用の Kotlin に適した Compose のような API
    • LayoutModifier: ほとんどの修飾子をチェーン関数として追加できる（padding、contentDescription（clearSemantics を含む）、background、clip、opacity など）。既存の Modifiers オブジェクトに変換可能
    • LayoutColors と LayoutString: 動的なフィールドと制約の使用を簡単にサポートする型
    • text、fontStyle
    • StateBuilder のマップ サポートの改善（DynamicDataMap や、AppDataKey オブジェクトを簡単に作成できる intAppDataKey などのファクトリ メソッドなど）
  • Lottie アニメーションは、アニメーションを開始するタイミング（レイアウトの読み込み時やレイアウトが可視化されたときなど）にさまざまなトリガーを設定できるオプションをサポートしています。
    • グラデーションのサポートが改善されました。
    • Brush の一部としてリニア グラデーション API が追加されました。Box や Spacer などの要素の Background 修飾子で使用できます。
    • 線形グラデーションとスイープ グラデーションに使用される ColorStop のダイナミック カラー値を許可
    • 円弧オブジェクトの既存のスイープ グラデーションで、ダイナミックな色と開始角度と終了角度がサポートされるようになりました
  • protolayout-expression のプラットフォーム データ バインディング。レイアウトの可視性が変更されたときにいつでも情報を受信できます。たとえば、タイルをスワイプしているときにレイアウトの特定の部分を非表示にできます。
  • テスト ライブラリ - protolayout-testing - が追加され、ProtoLayout 要素の単体テストの範囲を簡単にサポートできるようになりました
  • 新しい要素 DashedArcLine: 既存の ArcLine とは異なり、線にダッシュを付けられるように機能セットが改善されています。
  • ArcSpacer で、長さを度ではなく DP 単位で設定できるようにしました
  • 一部のフォントに対応する丸み FontSetting 軸を追加しました

バージョン 1.3.0-alpha10

2025 年 3 月 12 日

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

新機能

  • Kotlin の背景修飾子にブラシのヘルパーを追加しました。（I995de）
  • マテリアル 3 タイルのコンポーネントを作成するデベロッパーの関数で簡単に使用できるように、必須の Android コンテキスト フィールドが MaterialScope で公開されました。（I7df73）

API の変更

  • API platformVisibilityStatus の名前を PlatformEventSources.isLayoutVisible に変更し、新しい試験運用版 API PlatformEventSources.isLayoutUpdatePending を追加しました。（Ie1e04）

バグの修正

  • primaryLayout の余白が適切に切り上げられるようになりました。これにより、一部のレイアウトではメインスロットのスペースが最大 2 dp 減少する可能性があります。（I8f5d3）
  • ProtoLayout マテリアル 3 コンポーネントのデフォルトのダイナミック カラーテーマを明確にしました。（Iff5f3）
  • Typography.NUMERAL_* タイポグラフィは、デフォルトで表形式/固定幅文字形式ではなくなりました。テキストをアニメーション化する場合は、FontSetting.tabularNum() 設定を追加することを強くおすすめします。その他のすべてのケースでは、この固定幅オプションは必要ありません。このオプションを使用しない場合、使用できる文字が増えます。（Id3cd9）
  • ProtoLayout マテリアル 3 コンポーネントのデフォルトのダイナミック カラーテーマを明確にしました。（I9d831）

バージョン 1.3.0-alpha09

2025 年 2 月 26 日

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

新機能

  • enterTransition と exitTransition の試験運用版修飾子を追加しました。（I4a4d6）
  • 全画面レイアウトの可視ステータスが変更されたときに受け取るプラットフォーム バインディングを追加しました。（I250c3）
  • 動的な値を評価するために、テストアプリの状態とプラットフォーム データを LayoutElementAssertionsProvider に挿入できるようにします。（Ib5fcb）
  • protolayout テスト ライブラリにコーナー フィルタを追加（Ie2361）
  • ButtonColors、CardColors、ProgressIndicatorColors でコピー メソッドがサポートされるようになりました。一部のパラメータはオーバーライドできます。（Ie2054）

API の変更

  • テスト ライブラリに動的データ バインディングのサポートを追加（Ib98de）
  • オーバーレイを削除して、backgroundImage 関数で使用した場合の imageButton を修正しました。また、backgroundImage 関数でオーバーレイの色に null を指定できるようにして、オーバーレイが適用されないようにしました。（Ibec3c）

バグの修正

  • デフォルトの hasValueOfType メソッドを変更し、IllegalArgumentException ではなく UnsupportedOperationException をスローするようにしました。（Ia36c3）
  • デフォルトの色トークンの値が更新され、最新の仕様が反映されました。（I75d44）
  • AndroidX タイル レンダラで円弧線上に表示されるエイリアシングの問題を修正しました。（I88190）

バージョン 1.3.0-alpha08

2025 年 2 月 12 日

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

新機能

  • マテリアル 3 テキストに FontSetting リスト パラメータを追加しました。（Ic102d）
  • アプリの状態の型安全な Kotlin API を改善するため、StateBuilder がサポートする DynamicDataMap クラスを追加しました（I012ba）
  • AppDataKey オブジェクトを簡単に作成できるように、intAppDataKey などのファクトリ メソッドを追加しました（Icea2a）
  • DynamicDataValue に、hasInt/hasColor/.... メソッドに加えて hasValueOfType(Class<?>) メソッドが追加されました。（I4f7a6）
  • 優先度の高いエラーや、安全性通知などの緊急アクションに対応するため、Material3 ProtoLayout ColorScheme に errorDim を追加しました。（Ia17bb）
  • グローバルな reducemotion 設定にアクセスする際のクラッシュを防ぐガードが追加されました。この設定が提供されていない一部のプラットフォームでクラッシュが発生していました。（I01e2c）

API の変更

  • addKeyToValueMapping の名前が addToStateMap に変更され、DynamicDataMap.put メソッドは冗長であるため削除されました。（Ibe9dd）
  • Material3 タイポグラフィで、この軸をサポートするシステム フォントに対して丸み変数軸がサポートされるようになりました。ProtoLayout FontSetting は、この軸をサポートするフォントに対して丸み軸をサポートしています。（I33eb5）
  • マテリアル 3 のテキスト メソッドで multilineAlignment の名前を alignment に変更しました。（I2b66b）
  • 進捗を示す円形インジケーターをボックス型に更新し、constructGraphic の mainContent をボックス型に指定しました（I5a3dc）
  • グラフでの円形進行状況インジケーターの使用をサポート（I039db）

バグの修正

  • ColorStop の動的値と、SweepGradient の開始角度と終了角度を許可します。（I0146d）
  • ドキュメントの修正。（I4a63a）
  • マテリアル 3 コンポーネント（graphicCard と avatarButton）を更新し、weight 展開ディメンションがサポートされていない場合（API 33 未満など）にフォールバックを提供できるようにしました。レンダラで TEXT_OVERFLOW_ELLIPSIZE がサポートされていない場合に TEXT_OVERFLOW_ELLIPSIZE_END にフォールバックするようにテキスト コンポーネントを更新しました。（I19e2c）
  • PrimaryLayoutMargins のドキュメントを更新しました。（Ibaf7b）

バージョン 1.3.0-alpha07

2025 年 1 月 29 日

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

新機能

  • Lottie アニメーションにさまざまなトリガーを設定するための API オプションを追加しました。また、レイアウトが表示されたときにトリガーされる API を追加しました。（I8272d）
  • 修飾子 border、visibility、opacity を追加しました。（I6d3dd）
  • ProtoLayout マテリアル 3 コンポーネントにアバター ボタンを追加しました。（Idb5ae）
  • Material3 primaryLayout で、余白（側面と、場合によっては下部）をカスタマイズできるようになりました。（Ib22f6）
  • 円形の進行状況インジケーターのセグメント化されたバリエーションを追加しました。（I6a648）
  • ProtoLayout Material3 にコンパクトなボタン コンポーネントを追加しました。（Ia3c5c）
  • ProtoLayout Material3 に丸いボタンと画像ボタンのコンポーネントを追加しました。（Ifb88a）

API の変更

  • 想定される動作をより正確に反映するため、LayoutModfier.foldIn を foldRight に変更しました。（Idf242）
  • VisibleOnce トリガーが試験運用版になりました。（Ib2d26）
  • 代替のグラフィック ライブラリがあるため、公開 API から withOpacity を削除しました。（I030c2）
  • LayoutString.kt と LayoutColor.kt の最上位メソッドの名前を変更し、Java に適した名前にしました。（I7aff0）
  • Material3 で、ProtoLayout 以外のタイポグラフィを削除しました。（Idd9ae）
  • Material3 の *Colors クラスのフィールドに接尾辞 Color を追加しました。（I2d114）

バグの修正

  • 非対称のコーナーをサポートしていない古いレンダラ用に EdgeButton フォールバック実装を追加しました。（I63364）
  • 古いレンダラを使用した円形の進行状況インジケーターのフォールバック実装を追加。（I0f134）

バージョン 1.3.0-alpha06

2025 年 1 月 15 日

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

新機能

  • LayoutColor: 静的色と動的色の両方のタイプをサポート（I4c89b）
  • ProtoLayout Material3 textButton コンポーネントを追加しました。（Id680d）
  • iconButton ProtoLayout Material3 コンポーネントを追加しました。（Ica3f0）
  • ProtoLayout マテリアル 3 ボタン コンテナ コンポーネントを追加しました。（I17a38）
  • protolayout-material3 にチェーン可能なセマンティック モディファイアのサポートを追加しました。（I4af62）
  • ProtoLayout マテリアル 3 の単一セグメント CircularProgressIndicator を追加しました。（I2c8a2）
  • padding、metadata 修飾子を追加しました。（I8720a）
  • background、clip、clickable 修飾子を追加しました。（I35478）
  • LinearGradient を Brush に追加し、Background Modifier で使用できるようにします。（Ic4dea）
  • appCard と titleCard に小サイズを追加。（I91f98）
  • ProtoLayout マテリアル 3 の graphicDataCard コンポーネントを追加しました。（I92be7）
  • ProtoLayout マテリアル 3 の iconDataCard コンポーネントと textDataCard コンポーネントを追加しました。（I4e1e4）
  • ProtoLayout マテリアル 3 の appCard コンポーネントを追加しました。（Id4c57）
  • EdgeButtonColors を ButtonColors に抽象化します。（I83624）
  • ProtoLayout マテリアル 3 の titleCard コンポーネントを追加しました。（I2dc72）

API の変更

  • ProtoLayout Material3 API で LayoutString がサポートされ、静的テキストと動的テキストの両方をサポートできるようになりました。（I9c24a）

バグの修正

  • DashedArcLine の膨張用レンダラの実装を追加しました。（I0c700）
  • ArcSpacer が dp の長さを受け取れるようにレンダラを変更。（I1437b）

バージョン 1.3.0-alpha05

2024 年 12 月 11 日

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

新機能

  • バインディング可能なレイアウト文字列フィールドをサポートするために LayoutString を追加しました。（Ida650）
  • ProtoLayout Material3 カード コンテナ コンポーネントを追加しました。（Ic985a）

バグの修正

  • このライブラリは、型使用である JSpecify nullness アノテーションを使用するようになりました。Kotlin デベロッパーは、次のコンパイラ引数を使用して、正しい使用を強制する必要があります。-Xjspecify-annotations=strict, -Xtype-enhancement-improvements-strict-mode（Id1f9b、b/326456246）

バージョン 1.3.0-alpha04

2024 年 11 月 13 日

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

新機能

  • Material3 シェイプを更新し、Wear Compose と同様に、実際の Corner 値を保持するフィールドを持つクラスにしました。（Ied8cd）
  • Wear Compose と同様に、ColorScheme コンセプトを含むようにマテリアル 3 の色を更新しました。（If645e）
  • よく使用される複数のマッチング条件をテスト ライブラリに追加しました。（Ie5cec）

バージョン 1.3.0-alpha03

2024 年 10 月 30 日

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

新機能

  • テスト ライブラリに LayoutElementAssertionsProvider、LayoutElementAssertion、LayoutElementMatcher を追加しました。（Id1110）

バージョン 1.3.0-alpha02

2024 年 10 月 16 日

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

新機能

  • マテリアル 3 ライブラリの初期バージョン。text、edgeButton、buttonGroup、primaryLayout コンポーネントが含まれています。

セキュリティに関する修正

  • この変更により、androidx は CVE-2024-7254 に対処するために protobuf 4.28.2 に対してコンパイルされます。androidx.wear.protolayout:protolayout-proto と androidx.wear.protolayout:protolayout-external-protobuf のバージョン 1.3.0-alpha01 の依存関係を 1.3.0-alpha02 にアップグレードして、脆弱性リスクに対処します。

外部からの協力

バージョン 1.3.0-alpha01

2024 年 10 月 2 日

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

バグの修正

  • Roboto と Roboto Flex のフォント ファミリー名の可用性はデバイスによって異なることを明確にしました。（I193be）
  • AndroidX タイル レンダラで Roboto Flex フォント ファミリーを有効にしました。（I08e94）

バージョン 1.2

バージョン 1.2.1

2024 年 10 月 16 日

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

セキュリティに関する修正

  • この変更により、androidx は CVE-2024-7254 に対処するために protobuf 4.28.2 に対してコンパイルされます。脆弱性リスクに対処するため、androidx.wear.protolayout:protolayout-proto と androidx.wear.protolayout:protolayout-external-protobuf のバージョン 1.2.0 の依存関係を 1.2.1 にアップグレードします。

バージョン 1.2.0

2024 年 8 月 7 日

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

1.1.0 以降の重要な変更

  • FontStyle が更新され、可変軸のフォント サポートが追加され、今後の Flex フォントに対応するフォント選択 API が改善されました。
  • その他の修飾子のサポート:
    • アニメーションの有無にかかわらず、移動、回転、スケーリングを提供する変換修飾子。
    • 角の半径に異なる値（水平方向と垂直方向）を指定します。
  • Clickable 修飾子を使用する要素のタップ可能領域を 48dp × 48dp 以上に拡張し、すべてのタップ ターゲットのユーザー補助機能を改善しました。
  • setResponsiveContentInsetEnabled を追加して PrimaryLayout と EdgeContentLayout を改善し、さまざまな画面サイズでこれらのレイアウトのレスポンシブ動作をより適切にサポートし、タイルの一貫性を改善しました。
  • Android 14 の非線形フォント スケーリング用に、マテリアル テキストのスケーリングと非スケーリングを改善しました。
  • すべての円弧要素で RTL レイアウト方向のサポートを改善しました。

その他の変更

バージョン 1.2.0-rc01

2024 年 7 月 24 日

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

バグの修正

  • 標準の Material Chip を修正し、プライマリ ラベルまたはセカンダリ ラベルのいずれも渡されていない場合にのみ、アイコンとして使用できるようにしました。（Iceef9）
  • マテリアル レイアウトのドキュメントが更新され、レイアウトをより簡単に理解できるように、関連ページのビジュアルが追加されました。（I0256a）

バージョン 1.2.0-beta01

2024 年 7 月 10 日

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

新機能

Wear ProtoLayout 1.2.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear ProtoLayout 1.2 には、次の新機能と API が含まれています。

  • FontStyle が更新され、次のフォントがサポートされるようになりました。
    • FontSetting.weight や FontSetting.width など、異なるフォント バリエーション設定を設定する
    • すべての数字文字に同じ幅を設定する - 表記数字（FontSetting.tnum フォント機能の設定）
    • フォント選択 API を改善し、使用する優先フォント ファミリー名を指定して、今後の Flex フォントをサポートできるようにしました。
  • Corner 修飾子を拡張し、各 CornerRadius に水平方向と垂直方向の値を個別に指定して、非対称のコーナーを持つ要素を作成できるようにしました。
  • LayoutElement の移動、回転、スケーリングを提供する新しい Transformation 修飾子を追加しました。これらの変換は、動的値を使用してアニメーション化できます。
  • さまざまなレイアウトの向き（LTR や RTL など）をより適切にサポートするため、すべての円弧要素（Arc、ArcLine、ArcText）に Clockwise、CounterClockwise、Normal のオプションを持つ setArcDirection を追加しました。
  • Clickable 修飾子を使用する要素のタップ可能領域を少なくとも 48dp × 48dp に拡張し、すべてのタップ ターゲットのユーザー補助を改善しました。
  • setResponsiveContentInsetEnabled を追加して PrimaryLayout と EdgeContentLayout を改善し、さまざまな画面サイズでこれらのレイアウトのレスポンシブ動作をより適切にサポートし、タイルの一貫性を改善しました。これらの API の使用と簡単な修正を提案する lint 警告を追加しました。
  • Android 14 の非線形フォント スケーリング用に、マテリアル Text のスケーリングと非スケーリングを改善しました。

API の変更

  • デフォルトのフォント ファミリー名（DEFAULT_SYSTEM_FONT）は、preferredFontFamilies API を使用しないことが暗黙的に示されているため削除されました。（I39dab）
  • FontSetting.width に渡されるパラメータは正の値にする必要があります。（I1266f）

バージョン 1.2.0-alpha05

2024 年 6 月 26 日

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

新機能

  • hasText メソッドを Material.CompactChip に追加して、テキスト コンテンツが設定されているかどうかを確認します。（I6e8fc）

API の変更

  • FontFamily const が、ビルダークラスではなく FontStyle に移動されました。（I06ced）
  • FontSetting.weight API と FontSetting.width API を更新し、範囲アノテーションを含めて、重みのパラメータを int に変更しました。（Ia726c）

バグの修正

  • マテリアル ライブラリのスケーリング不可のテキストが、Android 14 の非線形フォント スケーリングで正しく動作するようになりました。（I6601e）

バージョン 1.2.0-alpha04

2024 年 5 月 29 日

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

API の変更

  • 非対称のコーナー API を追加し、2 つの値で各コーナーの半径を個別に指定できるようにしました。（Icbd69）
  • FontSetting API を拡張して、次を追加しました。
    • フォントの機能設定（フォントを表形式に設定するなど）。（If12b7）
    • フォント バリエーションの設定（可変フォント用のカスタム幅の設定など）。（I2b36d）
  • FontStyle にフォント ファミリー API を追加し、使用するフォント ファミリーの順序リストを指定できるようにしました。（Iba9f5）
  • マテリアルの LayoutDefaults で、コンテンツとセカンダリ ラベル間のスペースの高さの定数の名前を変更しました。最初は「エッジ コンテンツ」という接頭辞が付いていましたが、PrimaryLayout と EdgeContentLayout の両方に適用できるため、より汎用的な名前に変更しました。（I4dc32）

バグの修正

  • 可変フォント軸の名前を axisName から axisTag に変更しました。（I02ba3）

バージョン 1.2.0-alpha03

2024 年 5 月 14 日

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

新機能

  • FontStyle のカスタム重み値を設定する API を追加しました。（I7390a）

バグの修正

  • ターゲット マップが空であるために getTouchDelegateInfo で発生するエラーを修正しました。（I2accf）

バージョン 1.2.0-alpha02

2024 年 5 月 1 日

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

API の変更

  • クリック可能な個々の要素でリップル フィードバックを無効にするためのサポートを追加しました。（If1ede）
  • 変換の API は、その機能をサポートしていないため ArcModifiers から削除されました（Ic0827）
  • ArcDirectionProp ビルダーでコンストラクタに値が想定されるようになりました。（I76ada）
  • PlatformDataValues.Builder.putAll メソッドを使用すると、1 つの PlatformDataValue を別の PlatformDataValue に統合できます。（I50ba3）
  • Text#setIsScalable の名前が Text#setScalable に変更されました。（If920e）
  • Material Text では、サイズ変更可能なサイズ（ユーザーのフォントサイズが変更されたときに大きくなる）を使用するかどうかを設定できます。（Ibc849）
  • コンテンツの説明を TitleChip に設定するオプションを追加しました。（I5d21f）
  • アイコンのみで正しく動作するように CompactChip を修正し、このオプションを許可するように API を更新しました。（I6589e）

バグの修正

  • 初期化中にプラットフォーム データが重複する可能性がある問題を修正しました。（Iba0fd）
  • ノードの費用を取得する新しいゲッターを DynamicDataNode に導入しました。この費用は、動的ノード割り当ての取得時に使用されます。現在、固定値を持つノードにはコストが 0 が割り当てられ、他のすべてのノードにはコストが 1 が割り当てられます。（Ia33e1）
  • NO_OP_QUOTA_MANAGER からカウント ロジックを削除しました。（Ib50b8）
  • setResponsiveContentInsetEnabled なしで PrimaryLayout が使用されている場合に警告を報告し、簡単な修正を提示する lint ルールを追加しました。（I12025）
  • 動的式ノードの数には上限があります。（Iffae8）

バージョン 1.2.0-alpha01

2024 年 3 月 6 日

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

新機能

  • ProtoLayout Arc 要素に ArcDirection（Clockwise、Counterclockwise、Normal）を追加できるようになりました。この動作を Arc、ArcLine、または ArcText に追加すると、RTL レイアウトでの動作が修正されます。（I90699）
  • EdgeContentLayout が更新され、新しい setResponsiveContentInsetEnabled セッターが追加されました。これにより、UX ガイドラインとの整合性が向上し、プライマリ ラベルを固定された上部に配置し、ラベルをレスポンシブにインセットすることで、タイルの一貫性が確保されます。（I60175）
  • コンテンツが画面の端から外れないように、このレイアウトのプライマリ ラベル、セカンダリ ラベル、下部チップにレスポンシブ インセットを追加する PrimaryLayout.setResponsiveContentInsetEnabled を追加しました。（I0c457）
  • CircularProgressIndicator から外側の余白を削除して、小さいコンポーネントとして使用できるようにするメソッドを追加しました。（I55c06）

API の変更

  • タイル レンダラで、すべてのテキスト要素のフォント パディングがデフォルトで除外されるようになりました。このパディングを追加するオプションはありません。（I3e300）

バグの修正

  • テキストで、省略記号、文字間隔、中央揃えがすべて使用されている場合のテキストの配置に関する問題を修正しました。（I716c7）
  • Skia の円弧描画に関する問題の回避策を追加しました。（I08f09）
  • RTL レイアウトの ArcLine の描画方向を修正。（I6c141）

バージョン 1.1

バージョン 1.1.0

2024 年 2 月 7 日

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

1.0.0 以降の重要な変更

  • ArcLine でグラデーションのサポートと 360 度を超える長さの表現を改善。
  • 日時形式では、動的なデータ型に異なるタイムゾーンを指定できます。
  • テキストの自動サイズ調整と省略オプションが改善され、切り捨てられたテキストを処理できるようになりました。
  • スペーサーは、拡張されたディメンションとオプションの重みをサポートしています。
  • すべての ProtoLayout API にスキーマ バージョンの要件のアノテーションを追加。
  • ユーザー補助の要件を満たすため、Clickable 要素のタップ ターゲット領域を 48 dp x 48 dp に拡大しました。
  • フォント パディングはデフォルトでオフになっています。これは、テキストを含むすべての Text 要素とマテリアル コンポーネントで唯一の動作です。

その他の変更

バージョン 1.1.0-rc01

2024 年 1 月 24 日

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

バグの修正

  • PlatformTimeUpdateNotifierImpl は、更新を有効にした直後にティックします。（I77145）
  • CircularProgressIndicator が RTL レイアウトで修正されました。今後は、すべてのケースで時計回りに表示されます。（I95ee3）
  • Skia の円弧描画に関する問題の回避策を追加しました。（I08f09）

バージョン 1.1.0-beta01

2024 年 1 月 10 日

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

新機能

Wear ProtoLayout 1.1.0-beta01 リリースでは、ライブラリのこのリリースは機能が完成し、API がロックされていることが表明されました（試験運用版としてマークされている場合を除く）。Wear ProtoLayout 1.1 には、次の新機能と API が含まれています。

  • ArcLine で、SweepGradient に Brush を追加してグラデーションをサポートし、既存の StrokeCap に Shadow を追加してキャップ上にシャドウを表示し、360 度を超える長さをより適切に表現できるようになりました。
  • DynamicInstant は、ゾーン付きの日時書式をサポートしています。DynamicInstant と DynamicDuration は、状態データ型またはプラットフォーム データ型として使用できます。
  • テキストサイズの自動サイズ調整機能。複数のサイズを FontStyle.setSizes に設定できます。テキストサイズは、親の内部にあるスペースに基づいて自動的にスケーリングされます。また、TEXT_OVERFLOW_ELLIPSIZE を追加し、TEXT_OVERFLOW_ELLIPSIZE_END を非推奨にすることで、オーバーフローするテキストの省略オプションを改善しました。
  • Spacer が、オプションの重みを持つ拡張ディメンションをサポートするようになりました。ExpandedDimensionProp のビルド用にヘルパー メソッド DimensionBuilders.weight を追加しました。
  • Modifier.visible によるレイアウト要素の動的な非表示化と表示のサポート。これには、BoolProp に動的値が含まれていることも含まれます。
  • すべての ProtoLayout API にスキーマ バージョン要件のアノテーションが追加され、新しい API を呼び出す前にバージョンを確認できるようになりました。
  • Clickable を持つすべての要素のターゲット領域がレンダラで 48 x 48 以上に拡張され、ユーザー補助要件をより適切にサポートできるようになりました。
  • 他のマテリアル コンポーネントと Compose のイニシアチブに沿って、すべての Text 要素でフォント パディングがデフォルトでオフになりました。また、AndroidTextStyle と関連するセッターは公開 API から削除されました。また、以下のバグが修正されました。
  • 他のコンテンツの前に配置できるように、EdgeContentLayout にエッジ コンテンツを配置するためのセッター機能を追加しました。
  • 認識できない列挙値が検出された場合に、常に例外をスローする。
  • 無効な数値（NaN または無限）を返すか、ArithmeticException をスローしたときに、式の結果を無効にします。

API の変更

  • コンストラクタで色または ColorStops のいずれかを受け入れるように SweepGradient API を更新しました。（I6676f）

バグの修正

  • 円弧要素の描画方向を設定するための制限付き API とレンダラ サポートを追加しました。（Idef5a）
  • RoundMode は、指定しない場合、FloatToInt32Node の Floor にデフォルトで設定されます。指定された RoundMode が認識されない場合は、ノードは引き続き例外をスローします。（I1b2d8）

バージョン 1.1.0-alpha04

2023 年 12 月 13 日

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

新機能

  • VersionInfo クラスは Comparable インターフェースを実装していません。（I8d13c）
  • レンダラで TEXT_OVERFLOW_ELLIPSIZE オプションがサポートされるようになりました。（I7f085）

API の変更

  • テキスト オーバーフロー オプション TEXT_OVERFLOW_ELLIPSIZE_END のサポートを終了しました。動作が非常に類似している新しい API TEXT_OVERFLOW_ELLIPSIZE を使用してください。（I822d8）
  • 他のマテリアル コンポーネントと Compose のイニシアチブに沿って、すべての Text 要素でフォント パディングがデフォルトでオフになりました。また、AndroidTextStyle と関連する setter が公開 API から削除されました。（I79094、Ib0b03、I32959、Iaf7d5、Ifa298、I0a4ae、Ida9d3）
  • Modifier.hidden が Modifier.visible に置き換えられました。（I56902）
  • FontStyle#setSizes が SpProp 引数ではなく int 引数を受け取るようになりました。（I02b37）

バグの修正

  • 未定義または認識されない列挙型の値が見つかった場合に例外をスローします。（I9d2cf）
  • DynamicTypeBindingRequest をリファクタリングします。（I27b57）
  • 無効な数値（NaN または無限）を返すか、ArithmeticException をスローしたときに、式の結果を無効にします。（I681ae）

バージョン 1.1.0-alpha03

2023 年 11 月 29 日

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

新機能

  • レイアウト要素の動的な非表示化/表示の切り替えの試験運用版のサポートを追加しました。（I64a78）
  • BoolProp に動的値のサポートを追加しました。（I2fe96）
  • ProtoLayout API にスキーマ バージョンの要件アノテーションを追加しました。（I0f03c）
  • TextOverflow に新しいオプションを追加して API を拡張し、最大行数に達していない場合でも（ただしテキストのスペースが足りない場合）、固定された親コンテナ内のテキストを省略記号で表示できるようにしました。（I110a9）
  • 重み付きの ExpandedDimensionProp をビルドするためのヘルパー メソッド DimensionBuilders.weight を追加しました。（I4f72b）
  • DynamicInstant と DynamicDuration は、状態データ型またはプラットフォーム データ型として使用できます。（I6819f）

API の変更

  • DynamicZonedDateTime を非表示にして、すべてのオペレーションを DyanamicInstant に移動するように API を更新しました。（I34b94）
  • スペーサーで、幅と高さの拡張ディメンションがサポートされるようになりました。（Ie7c94）
  • レンダラでクリック ターゲット領域の拡張をサポート（I39c79）

バージョン 1.1.0-alpha02

2023 年 11 月 15 日

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

新機能

  • API に ArcLine StrokeCap Shadow フィールドを追加しました。（I830ec）
  • API を拡張して、拡張する Spacer の幅または高さを指定できるようにしました。（I757ca）
  • 親の内部にあるスペースに基づいてテキストサイズを自動的にスケーリングする試験運用版の API を追加しました。（Ibbe63）
  • クリック可能な最小サイズをサポート（I178e3）
  • StrokeCap Shadow のレンダラ サポートを追加しました。（I48b17）
  • ArcLine でスイープ グラデーションのレンダラ サポートを追加。（I4d5bb）

バージョン 1.1.0-alpha01

2023 年 10 月 18 日

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

新機能

  • Arcline にブラシ オプションを追加し、SweepGradient をサポートしました。（Ie7ce3）
  • ゾーン付きの日時形式のサポートを追加しました。（Ibfae0）
  • ゾーン付きの日時形式に必要なプロトコルと Java ラッパーを追加しました。（I97126）
  • DynamicDataValue に保存されている値を読み取るためのゲッターを追加しました。（Ie6cea）
  • 他のコンテンツの前に配置できるように、EdgeContentLayout にエッジ コンテンツを配置するセッター機能を追加しました。（Ie8e8a）

バグの修正

  • 複数の時間データソース登録を含む式がすぐに更新されない問題を修正しました。（I8e1a8）
  • 差分更新中にルート要素を中央に配置するバグを修正しました。（Ie48f7）
  • 未設定（または空）のレイアウト制約値は無視されなくなりました。（Ibc785）
  • レイアウトが表示されてからパイプライン ノードが初期化されるまでの遅延を短縮しました。（I38d4e）

バージョン 1.0

バージョン 1.0.0

2023 年 8 月 9 日

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

1.0.0 の主な機能

ProtoLayout ライブラリには、さまざまな Wear OS サーフェスで使用できるレイアウトと式を作成する API が導入されています。たとえば、Tiles ライブラリはこれらの API を使用して、プラットフォームのデータ バインディング（タイルデータの更新を高速化）とアニメーションをサポートしています。

バージョン 1.0.0-rc01

2023 年 7 月 26 日

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

  • Tiles から ProtoLayout に移行する手順については、こちらをご覧ください。

API の変更

  • Arc 要素から setLayoutConstraintForDynamicAnchorAngle メソッドと getLayoutConstraintForDynamicAnchorAngle メソッドを削除しました。これらのメソッドは誤って追加されたもので、指定されたレイアウトには影響しませんでした。（If7d01）
  • ProtoLayout のレイアウトの最大深度は、ネストされた LayoutElements 30 個に制限されています。（I8a74b）

バグの修正

  • SpanText に DynamicColor が設定されている場合にスローするチェックを追加しました。（I0e5bc）
  • DAILY_CALORIES データソースの単位が kcal であることを明確にしました。（Iaa785）

バージョン 1.0.0-beta01

2023 年 6 月 21 日

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

新機能

  • 時間バインディング テストでクロックの設定を許可。（I05622）

API の変更

  • PlatformDataReceiver.onData() と StateBuilders.Builder.addKeyToValueMapping が、安全でない汎用型ではなく、DynamicDataKey から DynamicDataValue への型安全なマッピングを受け入れるようになりました。つまり、DynamicDataValue は DynamicType で型付けされます。他の Android 定数の配置に合わせて、HEART_RATE_ACCURACY_X 定数を PlatformHealthSources のルートに移動しました。HEART_RATE_ACCURACY_X int 定数が、値定数の代わりに DynamicHeartRateAccuracy.constant() と DynamicHeartRateAccuracy.dynamicDataValueOf() で直接使用されるようになりました。（I82ff5）
  • PlatformHealthSources.Constants クラスが誤ってインスタンス化可能になりました。この問題は修正されています。（Icb849）
  • PlatformTimeUpdateNotifier#setReceiver が、通知する Supplier 関数と Executor ではなく、Runnable を受け取るようになりました。（I9d938）
  • PlatformTimeUpdateNotifier#setReceiver のパラメータ型を Callable から Supplier に変更しました。（I664bf）
  • CompactChip と TitleChip にアイコンを追加できるようになりました。（I5a01e）

バグの修正

  • 動的フィールドを使用して Prop メッセージを更新し、代わりに oneof を使用するようにする（I81739）
  • セッターがあるオーバーロードでセッターの実装を再利用（Ied70c）
  • オーバーロードがあるセッター内で指紋を適切に記録する（I86ed2）

バージョン 1.0.0-alpha11

2023 年 6 月 7 日

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

新機能

  • 心拍数測定の精度に関する PlatformDataKey を追加しました。（I7f9b8）

API の変更

  • StateBuilders#getIdToValueMapping の名前を getKeyToValueMapping に変更し、戻り値の型を Map<<AppDataKey<?>,DynamicDataValue> に変更します。（Iaa7ae）
  • StateStore を最終クラスにしました。（I408ca）
  • TimeGateway インターフェースは、時間データを更新する目的の頻度を提供する protolayout-expression-pipeline ライブラリの PlatformTimeUpdateNotifier に置き換えられました。（I60869）
  • PlatformDataProvider の register/unregisterForData の名前を set/clearReceiver に変更しました。（I14b02）
  • マテリアル テキストで、getExcludeFontPadding の名前が hasExcludeFontPadding に変更されました。（Iea01d）
  • すべてのチップ コンポーネントに、ラベルを完全に調整するためのセッターが追加されました。すべてのチップに最小タップ可能ターゲットが適用されるようになりました。（I8ae92）
  • LayoutDefaults#BUTTON_MAX_NUMBER の名前を MAX_BUTTONS に変更しました。（I84788）
  • DAILY_DISTANCE の名前が DAILY_DISTANCE_M に変更されました。（I4f758）

バグの修正

  • プロパティ型のドキュメントを更新し、静的値が適用される理由を明確にしました。静的値が指定されていない場合に使用されるデフォルト値を指定します。（I155aa）
  • PlatformDataKey Namespace は、Java スタイルの命名に従う必要があります。（I47bda）

バージョン 1.0.0-alpha10

2023 年 5 月 24 日

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

新機能

  • アプリのプッシュ状態にアクセスするための AppDataKey を追加。プラットフォーム データにアクセスするための PlatformDataKey を追加。StateStore に名前空間のサポートを追加。（I7985e）
  • DynamicBool の Equal オペレーションと NotEqual オペレーションをサポート。（I6a0c1）

API の変更

  • FontStyles クラスは今回が最終版です。（Iaa2ea）
  • LayoutElementBuilders#FontStyles が非推奨になりました。androidx.wear.protolayout.Typography を使用するか、独自の FontStyle を作成してください。（Ic929b）
  • Action#Builder ネストされたインターフェースを Action インターフェースから非表示にしました。Builder の実装は、LoadAction クラスと LaunchAction クラスですでに用意されています。（I1d70c）
  • FloatProp での DynamicFloat の使用を許可します。FloatProp はレイアウト変更プロパティとして使用されないため、レイアウト制約は必要ありません。I286ac
  • LoalAction アクションと SetStateAction アクションは、まだサポートされていなかったため削除されました。（I5d6a6）
  • インライン画像リソースの ARGB_8888 形式のサポートを追加しました。（I8a07c）
  • StateEntryValue の名前を DynamicDataValue に変更し、DynamicDataKey を使用するように状態 API を更新しました。（If1c01）
  • StateStore のインスタンスごとにメモリ使用量と状態更新時間を適切に抑制および制御するため、StateStore で許可されるエントリの数を制限しています。そのため、マップ内に MAX_STATE_ENTRY_COUNT を超えるエントリがないようにする必要があります。そうしないと、StateStore の作成または更新時に IllegalStateException が発生します。（Ibadb3）
  • OnLoadTrigger クラスと OnConditionMetTrigger クラスを非表示にし、setTrigger の名前を OnConditionMetTrigger の setCondition に変更しました。（Ibf629）
  • パフォーマンスと互換性の理由から、ProtoLayout レンダラは AnimatedVectorDrawable リソースのすべての機能をサポートしていません。サポート対象のセットを確定するまで、これらの API は試験運用版としてマークされます。（Ic6daf）
  • 1 日の距離、1 日の消費カロリー、1 日の階数の動的タイプを追加しました。プラットフォームの健全性情報源のキーが PlatformHealthSources.Keys に移動しました（Ib7637）
  • Easing.cubicBezier メソッドは CubicBezierEasing.Builder に置き換えられます。これにより、EasingFunction クラスが削除され、そのクラスの減衰定数に Easing インターフェースから直接アクセスできるようになりました。また、setInfiniteRepeatable は INFINITE_REPEATABLE_WITH_RESTART と INFINITE_REPEATABLE_WITH_REVERSE に置き換えられました。（Ib41e7）
  • PlatformDataProvider を実装して、心拍数と 1 日の歩数を提供します。SensorGateway インターフェースが公開 API から削除されました。（I55b84）
  • PlatformDataProvider を追加し、式パイプラインのノードでプロバイダのサポート対象キーが必要な場合に、StateStore を更新して PlatformDataProvider に登録します。（Ib616a）
  • SensorGateway は状態を保持しなくなったため、Closeable ではなくなりました。（I6b4f7）
  • CircularProgressIndicator の進行状況に DynamicFloat で FloatProp を使用できるようにします。これは、バージョン 1.2 をサポートするレンダラでサポートされています。古いレンダラは、指定されている場合は staticValue にフォールバックし、指定されていない場合は 0 にフォールバックします（I0d91b）
  • MultiButtonLayout 定数が LayoutDefaults.MultiButtonLayoutDefaults クラスにリファクタリングされ、レイアウト内のボタンの数に応じたボタンサイズの定数が含まれるようになりました。（I13973）
  • マテリアル テキストで DynamicString で StringProp の使用をサポート。これは、バージョン 1.2 をサポートするレンダラでサポートされています。古いレンダラは、指定された静的な値にフォールバックします。Text#getText の戻り値の型を String から StringProp に更新しました。（I7275b）

バージョン 1.0.0-alpha09

2023 年 5 月 10 日

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

新機能

  • 試験運用版の拡張機能レイアウト要素を追加しました。ただし、これはデフォルトでは使用できず、レイアウト要素を認識できるレンダラ拡張機能が必要です。（I6581d）
  • ArcLine の StrokeCap サポートを追加しました。（I94951）
  • 条件付きインスタント オペレーションのサポートを追加しました。（I489a7）
  • 条件付き期間オペレーションのサポートを追加しました。（Iab469）
  • 秒単位で時間の長さを作成するサポートを追加しました。（Ib5fa1）

API の変更

  • enable/disablePlatformSource メソッドが DynamicTypeEvaluator から削除されました。更新は呼び出し元が行う必要があります。（I78c6d）
  • バインドされたデータ型のサイズの上限を設定できるようにします。（Ie2966）
  • protolayout-material で動的コンテンツの説明のサポートを追加しました。（I62c8e）
  • AnimationParameters の duration と delay には long と @IntRange を使用します。（I388b6）

バージョン 1.0.0-alpha08

2023 年 4 月 19 日

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

新機能

  • AndroidTextStyle を LayoutElementBuilders に追加しました。（I8d967）
  • ProtoLayout マテリアル テキストで、フォント パディングを除外する設定のサポートを追加しました。（I17f5d）
  • インライン画像で ARGB_8888 がサポートされるようになりました。（I18c1e）
  • DynamicColor が onCondition オペレーションをサポートするようになりました。（I10927）

API の変更

  • リバース アニメーションのカスタム時間のサポート（I3251f）
  • SemanticDescription 修飾子を追加しました。また、ContentDescription はバインディングできません。（I3f1d）
  • DynamicBool.isFalse() メソッドは DynamicBool.negate() に置き換えられ、DynamicBool.isTrue() は削除されました。また、NaN DynamicFloat 値と DynamicInt32 を DynamicFloat に絞り込むと、無効な動的結果が生成されるようになりました。（I6ac1e）
  • Int と浮動小数点数フォーマッタでビルダー パターンが使用されるようになりました。（Ieb213）

バグの修正

  • アニメーション可能フィールドからフォールバック静的値を削除しました。（Ifcb01）
  • DynamicTypeValueReceiver#onPreUpdate を削除しました。（I2dc35）
  • 動的式の文字列の長さに上限が設定されました。（I4c93）
  • 必要に応じて、Gradle の依存関係が implementation ではなく api に正しく設定されるようになりました。（I40503）

バージョン 1.0.0-alpha07

2023 年 4 月 5 日

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

新機能

  • StringProp に動的値のサポートを追加しました。（I04342）
  • バインディング可能なレイアウト要素をマークする（Ia110b）

API の変更

  • sensorGateway#registerSensorGatewayConsumer は、Consumer のメソッドではなく、データ型をパラメータとして受け取ります。（Icf314）
  • ObservableStateStore の名前を StateStore に変更しました。（Ieb0e2）
  • コンストラクタ引数の代わりに DynamicTypeEvaluator.Builder を追加し、ObservableStateStore など、より多くのオプション引数を許可しました。デフォルトで空のストアになります。（I6f832）
  • DynamicTypeEvaluator のパラメータの順序をリファクタリングしました。（Ic1ba4）

バグの修正

  • プラットフォーム センサー ソースからダウンストリーム ノードにシグナルを正しく伝播する（I5a922）

バージョン 1.0.0-alpha06

2023 年 3 月 22 日

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

新機能

  • 動的式で心拍数と 1 日の歩数を使用するための試験運用版 API を追加しました。（Ifd711）
  • アニメーションの逆再生と順再生の遅延のサポートを追加しました。（Ic25f7）
  • 枠線と背景に DynamicColor のサポートを追加しました
  • DimensionBuilder の型に動的値のサポートを追加しました
  • tiles-material のレイアウトとコンポーネントが protolayout-material に移動

API の変更

  • 「LoadActionListener」を「ProtoLayoutViewInstance」に追加しました。（If7806）

バグの修正

  • FloatNodesTest を追加しました。（Id7281）
  • 構造化ビットマップを読み込めない場合にレンダラがクラッシュする問題を修正しました。

バージョン 1.0.0-alpha05

2023 年 3 月 8 日

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

新機能

  • Modifiers オブジェクトに試験運用版の「コンテンツの更新」アニメーションを追加しました。このアニメーションは、レイアウトの更新中に（この修飾子を持つ）要素またはその子のいずれかが変更されるたびにトリガーされます。（bd03e5d）

API の変更

  • Repeatable に forwardRepeatDelayMillis と reverseRepeatDelayMillis を追加しました。また、AnimationSpec の delayMillis の名前を startDelayMillis に変更しました。（Ifb266）
  • DynamicTypeEvaluator.bind メソッドが Executor を受け取るようになりました。（I346ab）
  • 動的型がバインドされた後に評価をトリガーするために、BoundDynamicType に startEvaluation メソッドを追加しました。（I19908）

バグの修正

  • Animator オブジェクトは、1 つの要素の後のアニメーションで再利用されます。（Ia3be9）

バージョン 1.0.0-alpha04

2023 年 2 月 22 日

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

新機能

  • ObservableStateStore で、キーが削除されたときにリスナーに通知されるようになりました。
  • レンダラ スキーマのバージョンとフォント スケールを DeviceParameters に追加しました（これは、さまざまなバージョンとフォント設定に応じてレイアウトを条件付きで作成するために使用できます）。
  • DynamicInt32 値のアニメーション化のサポートを追加しました。（I05485）
  • OnLoad トリガーと OnConditionalMet トリガーを追加しました。これらを使用して、トリガーをサポートするアニメーションを開始できます。
  • 拡張ディメンションのレイアウト重みと、折り返しディメンションの最小サイズを追加しました。
  • 時間と即時動的型が追加されました。これらは、動的な式で時間の瞬間または時間を表すために使用できます。
  • レイアウト リソースとして AnimatedVectorDrawable と SeekableAnimatedVectorDrawable のサポートを追加しました。

API の変更

  • センサーデータには API 29 以降が必要です。（I8099e）
  • 2 つの launchAction ヘルパー メソッド（アクティビティの起動用）を追加しました。

バグの修正

  • タイル アニメーションで set/getSpec の名前を set/getAnimationSpec に変更しました（I3d74b）

バージョン 1.0.0-alpha03

2023 年 2 月 8 日

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

新機能

  • protolayout-express ライブラリ内の Dynamic 型に toByteArray() と fromByteArray() を追加しました。
  • protolayout-expression ライブラリ内の Dynamic 型に toString() を追加しました。
  • Dynamic 型の評価サポートを追加しました。protolayout-expression-pipeline ライブラリの DynamicTypeEvaluator クラスを使用して、以前作成の Dynamic 型（DynamicString、DynamicFloat など）について評価する（および更新された値を受け取る）ことができます。
  • アニメーションを（エバリュエータによって無効化されているか、実行中のアニメーションの上限に達したために）再生できない場合は、アニメーション化可能なノードに設定された静的な値が、アニメーションの置換に使用されます。

バージョン 1.0.0-alpha02

2023 年 1 月 25 日

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

新機能

  • androidx.wear.tiles:tiles のレイアウト ビルダーが androidx.wear.protolayout:protolayout に移動しました。androidx.wear.tiles:tiles 内のレイアウト ビルダーは次のアルファ版リリースのいずれかで非推奨となります。

バージョン 1.0.0-alpha01

2023 年 1 月 11 日

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

新機能

  • このリリースでは、動的変数から式を作成するための新しいライブラリ「ProtoLayout Expression」が導入されました。