Constraintlayout

相対位置を使用して、ウィジェットの位置とサイズを柔軟に調整します。

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

アーティファクト 安定版リリース リリース候補版 ベータ版リリース アルファ版リリース
constraintlayout 2.2.0 - - -
constraintlayout-compose 1.1.0 - - -
constraintlayout-core 1.1.0 - - -

依存関係の宣言

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

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

Groovy

dependencies {
    implementation "androidx.constraintlayout:constraintlayout:2.2.0"
    // To use constraintlayout in compose
    implementation "androidx.constraintlayout:constraintlayout-compose:1.1.0"
}

Kotlin

dependencies {
    implementation("androidx.constraintlayout:constraintlayout:2.2.0")
    // To use constraintlayout in compose
    implementation("androidx.constraintlayout:constraintlayout-compose:1.1.0")
}

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

フィードバック

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

新しい問題を報告する

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

ConstraintLayout-compose、ConstraintLayout-Core 1.1

バージョン 1.1.0

2024 年 10 月 30 日

androidx.constraintlayout:constraintlayout-compose:1.1.0、androidx.constraintlayout:constraintlayout-compose-android:1.1.0、androidx.constraintlayout:constraintlayout-core:1.1.0 がリリースされました。バージョン 1.1.0 には、これらの commit が含まれています。

1.0.0 以降の重要な変更

  • SharedTransitionLayout とのインタラクションを修正しました。（b/332898040）
  • 再コンポーズによる測定に関連するレイアウトの問題を修正しました（b/219091179、Ibfe8a）。

バージョン 1.1.0-rc01

2024 年 10 月 16 日

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

バージョン 1.1.0-beta01

2024 年 9 月 4 日

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

バージョン 1.1.0-alpha14

2024 年 8 月 7 日

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha14、androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha14、androidx.constraintlayout:constraintlayout-core:1.1.0-alpha14 がリリースされました。バージョン 1.1.0-alpha14 に含まれる commit はこちらをご覧ください。

API の変更

  • フラグはコンパニオン オブジェクトを介して個別に提供されるようになりました。フラグは or 演算子と組み合わせることができます。（I9df53）
  • createRow ヘルパーと createColumn ヘルパーを簡素化。createGrid パラメータ名とドキュメントを改善し、明確にしました。（Iebc92）
  • ConstraintLayout の animateChanges API を簡素化し、null 以外の AnimationSpec のみが必要になりました。InvalidationStrategy の onIncomingConstraints が通常のラムダになりました。fixedWidthRate の名前を shouldInvalidateOnFixedWith に変更しました（高さのパターンも同様です）。（Ie59cd、b/332898040、b/336370035）
  • NestedScroll ソースのドラッグとフリングは、アニメーション（副作用）、マウスホイール、キーボード（ユーザー入力）を含むソースの定義の拡張に対応するため、UserInput と SideEffect に置き換えられます。（I40579）

バージョン 1.1.0-alpha13

2023 年 10 月 4 日

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha13、androidx.constraintlayout:constraintlayout-compose-android:1.1.0-alpha13、androidx.constraintlayout:constraintlayout-core:1.1.0-alpha13 がリリースされました。変更はありません。バージョン 1.1.0-alpha13 に含まれる commit については、こちらをご覧ください。

  • このリリースにより、androidx.constraintlayout ライブラリは最新の Compose リリースと ABI 互換性を持つようになりました。

バージョン 1.1.0-alpha12

2023 年 8 月 9 日

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

API の変更

  • Transition DSL に LayoutScopeMarker を追加しました。（If54ce）

バージョン 1.1.0-alpha11

2023 年 7 月 26 日

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

新機能

  • InvalidationStrategy を指定して、MotionLayout で無効化を最適化できるようになりました。通常、これがパフォーマンスの低下を招く原因となります。（Iada0c）
  • インライン Modifier DSL（Modifier.constrainAs）で ConstraintLayout を使用するときに animateChanges = true を使用できるようになりました。制約 DSL が変更されると、ConstraintLayout は自動的にその新しい状態にアニメーション化されます。（I9abf1）
  • OnSwipe で limitBoundsTo の機能を有効にしました。（I56522）

API の変更

  • TransitionScope.staggered の名前を TransitionScope.maxStaggerDelay に変更しました（I0fd2d）

バグの修正

  • OnSwipe の dragScale パラメータが機能しない問題を修正しました。（8bef26）。
  • MotionScene の customColor が透明色で正しく機能しない問題を修正しました。（81b2ac）
  • 停止したときに OnSwipe が正しく通知されない問題を修正しました。また、touchUp の初期速度の計算も修正しました。（Ia5f6f）
  • ConstraintLayout コンポーザブルと Constraintset の KDoc を更新しました。（3bfe63）

バージョン 1.1.0-alpha10

2023 年 5 月 24 日

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

API の変更

  • MotionLayout API は試験運用版ではなくなり、MotionLayout の安定版 API の最初のセットとなります。（I288f4）。
  • MotionLayoutState を削除しました。（Id3ac1）
  • DebugFlags を使用して、ビジュアル デバッグ（DebugFlags(showBounds = true)）を行うことができます。（Ic714b）
  • 拡張機能変数 Dp.asDimension をメソッド Dp.asDimension() に変更しました。（I2d6ef）。
  • MotionLayout DSL で分散配信がサポートされるようになりました。TransitionScope.staggered で最大遅延を定義します。また、ConstrainScope.staggeredWeight（MotionSceneScope 内）を使用して、カスタムの分散配信順序を取得することもできます。（I70275）
  • グリッド ヘルパーに 2 つの変更を加えました。1. paddingLeft と paddingRight をそれぞれ paddingStart と paddingEnd に変更し、2. gridSpans と gridSkip の形式を Span オブジェクトと Skip オブジェクトの配列に更新して、より構造化された形式にします。（Idd1eb）

バージョン 1.1.0-alpha09

2023 年 3 月 22 日

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

API の変更

  • Modifier.intermediateLayout に明示的な LookaheadScope は必要ありません。intermediateLayout の測定ブロックには、IntermediateMeasureScope がレシーバーとして設定されています。これにより、便利な CoroutineScope、LookaheadScope、MeasureScope が提供されます。
  • LookaheadLayout は LookaheadScope に置き換えられました。LookaheadScope はレイアウトではなくなっています。これにより、LookaheadScope の子コンテンツを親の MeasurePolicy で直接制御できます。（Ibe2e5）。
  • Easing.Cubic() でオーバーシュート パラメータを使用できるようになりました。（I2d826）

バージョン 1.1.0-alpha08

2023 年 3 月 8 日

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

新機能

  • 一般的なパターンが予期しない動作につながる可能性がある場合に Dimension.percent(1f) と LayoutReference.withChainParams() の使用を提案する lint チェックが追加されました。（I62eb0、I03060）

API の変更

  • Compose の Grid ヘルパーの ReverseSpanDirection フラグと SpansOrderFirst フラグを有効にします。
    1. ReverseSpanDirection: スパンとスキップの幅と高さの指定を反転します。
    2. SpansOrderFirst: スパンはウィジェットの順序を尊重します。（I6ad50）。
  • Modifier.onStartEndBoundsChanged(...) を使用して、アニメーションの影響を受けない MotionLayout 内のコンポーザブルのローカル境界を取得します。DragAndDrop などのアニメーションもトリガーする可能性のあるレイアウト情報を必要とする UI 操作に有用です。（I6b5f9）。
  • Compose でグリッド ヘルパーのスキップとスパンを有効にしました。（I917b6）

バグの修正

  • 想定される値が適用されない翻訳プロパティを修正しました。（I961cd）

バージョン 1.1.0-alpha07

2023 年 2 月 8 日

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

新機能

  • DSL を使用して Compose のグリッド ヘルパーを有効にする新しい API を追加しました。（I1143b）

バグの修正

  • 指定された maxElement パラメータに合わせて Flow の Wrap.Chain が正しくレイアウトされない問題を修正しました。（e1f2ed3）
  • MotionLayout(motionScene: MotionScene, progress: Float, transitionName: String) を介して Transition を変更する際に start ConstraintSet が更新されない問題を修正しました。（17ffff1）
  • ConstraintSet(extendConstraintSet: ConstraintSet, description: ConstraintSetScope.() -> Unit) を介して制約を継承する際に ConstraintSet に一部の変更が反映されない問題を修正しました。（740804b）

バージョン 1.1.0-alpha06

2023 年 1 月 25 日

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

新機能

  • JSON 表現を使用して Compose のグリッド ヘルパーを有効にし、コンポーザブルを 2D グリッドに配置できるようにする新しい API を追加しました。（I968ad）

API の変更

  • 円弧上モードと円弧下モード Arc.Above、Arc.Below という方向に依存しない円弧モードのサポートを MotionLayout に追加しました。（I184a9）
  • ベースライン アンカーを上部 / 下部のアンカーに制約する（および上部 / 下部のアンカーをベースライン アンカーに制約する）ことができるようになりました。（I54628）
  • MotionLayoutScope#motionProperties（派生物を含む）の名前を MotionLayoutScope#customProperties に変更しました。この変更は、カスタム プロパティを設定する場合と整合性を取ることを目的としています。（Ib34c9）
  • ConstraintSet と MotionScene で複数の参照（val (box, text, button) = createRefsFor("box", "text","button")）を作成できるようになりました。constrain(box, button, text) を使って複数の要素に制約を適用します。ConstrainScope 内で、Dp.asDimension を使って固定ディメンション（width = 10.dp.asDimension）を直感的に設定することもできるようになります。（I021ec、Ia0960）
  • MotionScene() メソッドと Transition() メソッドがコンポーズ可能ではない関数になりました。これらの関数のオブジェクト（ConstraintSet など）は相互から正しく比較できるようになります。ConstraintLayout の animateChanges = true は、そのプロパティのいずれかが再コンポジションで変更されていれば、1 つの ConstraintSet 参照のみで使用できるようになりました。（I7d22e）

バグの修正

  • ヘルパーが変更されたときに ConstraintLayout が不必要に余分な再コンポジションを常にトリガーする問題を修正しました。（Id83ad、b/222093277）
  • ConstraintLayout と MotionLayout で組み込みを使用する場合の動作を修正しました。（I487ae、b/220527863）
  • コンテンツが変更されたときに再測定できない問題を修正しました。（Ibfe8a、b/219091179）

バージョン 1.1.0-alpha05

2022 年 12 月 7 日

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

新機能

  • DSL にカスタム KeyAttributes のサポートを追加しました（b94e748）
  • ConstrainScope のバイアス プロパティが表示されるようになりました（32625d0）
  • チェーンにカスタム パラメータのサポートを追加しました（72a2e9e）
  • Compose に MotionLayout の Macrobenchmark テストを追加しました（36f43bc）
  • Compose の以前のリリースで変更された点について詳しくは、Wiki ページをご覧ください

API の変更

  • addConstraintSet パラメータと addTransition パラメータを反転しました（152facc）

バグの修正

  • 水平方向チェーンを修正しました（ed5f56e）

バージョン 1.1.0-alpha01

2022 年 5 月 20 日

androidx.constraintlayout:constraintlayout-compose:1.1.0-alpha01 がリリースされました。

MotionLayout API は試験運用版であり、オプトインが必要です。

詳細については、GitHub の Compose 1.1.0-alpha01 の新機能をご覧ください。

バージョン 2.2

バージョン 2.2.0

2024 年 10 月 30 日

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

2.1.0 以降の重要な変更

  • 基盤となる constraintlayout-core ライブラリとのパリティ リリース。

バージョン 2.2.0-rc01

2024 年 10 月 16 日

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

バージョン 2.2.0-beta01

2024 年 9 月 4 日

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

バージョン 2.2.0-alpha14

2024 年 8 月 7 日

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

バージョン 2.2.0-alpha13

2023 年 10 月 4 日

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

バージョン 2.2.0-alpha12

2023 年 8 月 9 日

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

バージョン 2.2.0-alpha11

2023 年 7 月 26 日

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

API の変更

  • セッター メソッドを追加して、デベロッパーがプログラムで mInfiniteCarousel の値を設定できるようにしました（I0a8ca）。

バージョン 2.2.0-alpha10

2023 年 5 月 24 日

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

バグの修正

  • MotionLayout ドキュメントの無効なリンクを修正（51cbe88）。

バージョン 2.2.0-alpha09

2023 年 3 月 22 日

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

バージョン 2.2.0-alpha08

2023 年 3 月 8 日

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

バージョン 2.2.0-alpha07

2023 年 2 月 8 日

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

バグの修正

  • ConstraintLayout ページのコンテンツ欠落に関する問題を修正しました。（I82e25）

バージョン 2.2.0-alpha05

2022 年 12 月 7 日

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

バグの修正

  • View Carousel のリークを修正しました（eb67b82）

バージョン 2.2.0-alpha01

2022 年 5 月 20 日

androidx.constraintlayout:constraintlayout:2.2.0-alpha01 がリリースされました。

新しい Grid ヘルパーのプレビューが追加されました。

詳細については、GitHub の 2.2.0-alpha01 の新機能をご覧ください。

ConstraintLayout-compose 1.0

ConstraintLayout-compose 1.0 では、Jetpack Compose に ConstraintLayout 機能が提供されます。

バージョン 1.0.1

2022 年 5 月 20 日

androidx.constraintlayout:constraintlayout-compose:1.0.1 がリリースされました。

MotionLayout API は試験運用版であり、オプトインが必要です。

詳細については、GitHub の Compose 1.0.1 の新機能をご覧ください。

バージョン 1.0.0

2022 年 1 月 13 日

androidx.constraintlayout:constraintlayout-compose:1.0.0 がリリースされました。

MotionLayout API は試験運用版であり、オプトインが必要です。

詳細については、GitHub の 1.0 の新機能（Compose）をご覧ください。

バージョン 1.0.0-rc02

2021 年 11 月 16 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc02 がリリースされました。

詳細については、GitHub の 1.0 の新機能（Compose）をご覧ください。

バージョン 1.0.0-rc01

2021 年 9 月 27 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-rc01 がリリースされました。

このリリースは第 2 ベータ版です。フィーチャー コンプリートとみなされ、Compose に ConstraintLayout と MotionLayout を提供します。

詳細については、GitHub の 1.0 の新機能（Compose）をご覧ください。

バージョン 1.0.0-beta02

2021 年 7 月 30 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta02 がリリースされました。

このリリースは第 2 ベータ版です。フィーチャー コンプリートとみなされ、Compose に ConstraintLayout と MotionLayout を提供します。

詳細については、GitHub の 1.0 の新機能（Compose）をご覧ください。

バージョン 1.0.0-beta01

2021 年 7 月 22 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-beta01 がリリースされました。

このリリースは最初のベータ版です。フィーチャー コンプリートとみなされ、Compose に ConstraintLayout と MotionLayout を提供します。

詳細については、GitHub の 1.0 の新機能（Compose）をご覧ください。

バージョン 1.0.0-alpha07

2021 年 5 月 18 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha07 がリリースされました。

  • Compose バージョン 1.0.0-beta07 との互換性を確保するための更新が行われました。

バージョン 1.0.0-alpha06

2021 年 5 月 4 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha06 がリリースされました。

  • Compose の最適化: Constraintlayout インライン コンポーザブル（#193）
  • Compose で再測定を最小限に抑える（#210）

バージョン 1.0.0-alpha05

2021 年 3 月 15 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha05 がリリースされました。

  • 最適化エンジンへの修正が含まれています（b/182657720）
  • optimizationLevel パラメータを ConstraintLayout コンポーザブルに追加しました

バージョン 1.0.0-alpha04

2021 年 3 月 11 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha04 がリリースされました。

最新の constraintlayout-core エンジンを使用するように更新が行われました

バージョン 1.0.0-alpha03

2021 年 2 月 24 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha03 がリリースされました。

Jetpack Compose beta01 リリースのアップデートをリリースしました

バージョン 1.0.0-alpha02

2021 年 2 月 10 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha02 がリリースされました。

Jetpack Compose alpha12 リリースのアップデートをリリースしました

バージョン 1.0.0-alpha01

2021 年 2 月 2 日

androidx.constraintlayout:constraintlayout-compose:1.0.0-alpha01 がリリースされました。

ライブラリの最初のリリース。制約を表すためのインラインと外部 DSL を提供します。

バージョン 2.1

ConstraintLayout 2.1.0 では、MotionLayout や新しいヘルパー（カルーセルなど）の機能がさらに充実しています。

バージョン 2.1.4

2022 年 5 月 20 日

androidx.constraintlayout:constraintlayout:2.1.4 がリリースされました。

詳細については、GitHub の 2.1.4 の新機能をご覧ください。

バージョン 2.1.3

2022 年 1 月 13 日

androidx.constraintlayout:constraintlayout:2.1.3 がリリースされました。

詳細については、GitHub の 2.1 の新機能をご覧ください。

バージョン 2.1.2

2021 年 11 月 16 日

androidx.constraintlayout:constraintlayout:2.1.2 がリリースされました。

詳細については、GitHub の 2.1 の新機能をご覧ください。

バージョン 2.1.1

2021 年 9 月 27 日

androidx.constraintlayout:constraintlayout:2.1.1 がリリースされました。

これは 2.1.1 の最終リリースです。

詳細については、GitHub の 2.1 の新機能をご覧ください。

バージョン 2.1.0

2021 年 7 月 30 日

androidx.constraintlayout:constraintlayout:2.1.0 がリリースされました。

これは 2.1.0 の最終リリースです。

詳細については、GitHub の 2.1 の新機能をご覧ください。

バージョン 2.1.0-rc01

2021 年 7 月 22 日

androidx.constraintlayout:constraintlayout:2.1.0-rc01 がリリースされました。

これは 2.1.0 のリリース候補であり、最後のベータ版から軽微な改善と修正を行っています。詳細については、GitHub の 2.1 の新機能をご覧ください。

バージョン 2.1.0-beta02

2021 年 5 月 4 日

androidx.constraintlayout:constraintlayout:2.1.0-beta02 がリリースされました。

MotionLayout の新機能:

  • バネ（剛性、減衰性、質量など）や未完成を含む OnSwipe の追加機能
  • jumpToState 機能
  • Down をタップすると 100 まで再生され、Up をタップすると 0 まで巻き戻しされる ViewTransition downUp モード

以下を中心とするさまざまな修正を行いました。

  • 垂直方向のスクロールに関する MotionLayout の問題を修正（#173）
  • ネストされた MotionLayout に関するパフォーマンスの改善（#189）
  • MotionLayout での NestedScrollView による高速遷移（#189）
  • MotionLayout の ConstraintSet を削除（#189）
  • MotionLayout での downUp ViewTransition のサポート（#190）
  • ドローアブルを再利用する際の ImageFilter の修正（#192）
  • MotionLayout にバネのサポートを追加（#199）
  • CircularFlow のパフォーマンスの改善（#200）
  • 派生制約 / 制約のオーバーライドの修正（#212）

バージョン 2.1.0-beta01

2021 年 3 月 11 日

androidx.constraintlayout:constraintlayout:2.1.0-beta01 がリリースされました。

ConstraintLayout

android:layout_width と android:layout_height が、互換性の問題が原因で再び任意ではなくなりました。

MotionLayout

  • Transition での onSwipe と onClick の挿入と削除に対するプログラム サポート
  • 画面の回転による Transition の試験運用版でのサポート
  • Transitions に対する duration 引数のサポート
  • ブール値である customAttribute または Reference のサポート強化

ヘルパー

  • Carousel の特定のアイテムをアニメーション化または特定のアイテムに直接ジャンプする方法を追加しました
  • 新しい CircularFlow ヘルパー

このリリースに関する追加情報については、こちらとクローズされたバグをご覧ください。

バージョン 2.1.0-alpha2

2020 年 12 月 17 日

androidx.constraintlayout:constraintlayout:2.1.0-alpha2 がリリースされました。

この第 2 アルファ版ではいくつかの新機能が追加されています。

ConstraintLayout

  • android:layout_width と android:layout_height がオプションになり、wrap_content がデフォルトの動作になりました。
  • ディメンションの制約を表現する、新しい layout_constraintWidth 属性と layout_constraintHeight 属性。
  • 制約の負のマージンをサポートします。
  • 上端からベースラインおよび下端からベースラインまでの制約をサポートします。
  • ベースライン マージンの制約をサポートします。
  • SharedValues を使用すると、外部の値を ConstraintLayout に挿入できます。

MotionLayout

  • Overshoot Interpolators（anticipate、overshot）をサポートします。
  • MotionHelper のサポートを強化しました。
  • ConstraintSet のアニメーション化のアップデートを MotionLayout updateStateAnimate(id,cset,duration); に追加しました。
  • 共有値ベースの ViewTransition。
  • scheduleTransitonTo を使用すると、遷移を待ち行列に入れて、現在の遷移の完了時に実行することができます。

ヘルパー

  • カルーセルで無限（ラップアラウンド）モードがサポートされるようになりました。
  • ReactiveGuide: SharedValue 変更時の自動配置のガイドライン。
  • MotionEffect: 特定の方向に動く参照ビューに Keyframe を挿入します。
  • MotionLabel - 1 行のテキストをアニメーション化するためのビュー。

このリリースに関する追加情報についてはこちらをご覧ください。

バージョン 2.1.0-alpha1

2020 年 11 月 19 日

androidx.constraintlayout:constraintlayout:2.1.0-alpha1 がリリースされました。

2.1 リリースの最初のアルファ版。次の機能のサポートが導入されています。

  • カスタム カルーセル ビューを構築するためのカルーセル モーション ヘルパー。
  • MotionLayout シーンは、インクルードと制約のオーバーライドをサポートします。
  • MotionLayout により、さらに充実した回転（入力と出力）のサポートが追加されます。
  • MotionLayout により ViewTransition が追加され、制約セットのミューテーションのための単一ビュー遷移が可能になります。

このリリースに関する追加情報についてはこちらをご覧ください。

バージョン 2.0

ConstraintLayout 2.0 には、仮想レイアウトなどの新しいレイアウト機能と、ビューのアニメーションを簡単に作成できる新しい MotionLayout クラスが追加されています。

バージョン 2.0.4

2020 年 10 月 29 日

androidx.constraintlayout:constraintlayout:2.0.4 がリリースされました。

バグの修正

このリリースでは、実行時に子ビューを削除した場合に発生する可能性のある NPE が修正されています。このバージョンに更新することをおすすめします。

クローズされた問題のリストは、こちらをご覧ください。

バージョン 2.0.3

2020 年 10 月 27 日

androidx.constraintlayout:constraintlayout:2.0.3 がリリースされました。

バグの修正

今回のリリースではいくつかの問題の修正を行いました。このバージョンに更新することをおすすめします。

  • Windows インセットの処理
  • 特定の状況におけるアスペクト比の処理
  • 一部の RTL レイアウトでのクラッシュ

クローズされた問題のリストは、こちらをご覧ください。

バージョン 2.0.2

2020 年 10 月 6 日

androidx.constraintlayout:constraintlayout:2.0.2 がリリースされました。

バグの修正

今回のリリースでは、パフォーマンスの改善といくつかの問題の修正を行いました。このバージョンに更新することをおすすめします。

  • 状況によっては、ConstraintLayout で view GONE の可視状態の処理が正しく行われない問題を修正
  • 状況によっては、ConstraintLayout でパッケージ化されたチェーンの処理が正しく行われない問題を修正
  • Flow の仮想レイアウト ヘルパーに対する API 15 のインフレーションの例外を修正
  • MotionLayout の limitsBoundsTo が破損していた問題を修正
  • 特定の状況（遷移のチェーン作成）で MotionLayout の jumpToEnd が破損していた問題を修正

クローズされた問題のリストは、こちらをご覧ください。

バージョン 2.0.1

2020 年 8 月 25 日

androidx.constraintlayout:constraintlayout:2.0.1 がリリースされました。

Android Studio で MotionEditor を使用できるようにするためのマイナー アップデートです。

バージョン 2.0.0

2020 年 8 月 21 日

androidx.constraintlayout:constraintlayout:2.0.0 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。

重要な修正:

  • MotionLayout Transition の遅延と TransitionListener の修正
  • ConstraintLayout のフローとバリアの修正

バージョン 2.0.0-rc1

2020 年 7 月 29 日

androidx.constraintlayout:constraintlayout:2.0.0-rc1 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。

重要な修正:

  • フローの修正
  • RecyclerView の修正（recyclerview 1.2.0 alpha 5 以降へのアップデートをおすすめします）
  • MotionLayout TransitionListener の修正
  • MotionLayout のメモリリークの修正

バージョン 2.0.0-beta8

2020 年 7 月 7 日

androidx.constraintlayout:constraintlayout:2.0.0-beta8 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。

重要な修正:

  • プレースホルダの動作
  • レイヤの表示と非表示
  • フロー、バリアの修正
  • TransitionListener の修正

バージョン 2.0.0-beta7

2020 年 6 月 12 日

androidx.constraintlayout:constraintlayout:2.0.0-beta7 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。

重要な修正:

  • MotionLayout でのスクロール ビューのネストの問題
  • MotionLayout での遷移リスナーの問題
  • MotionLayout でのメモリリーク
  • RecyclerView の問題
  • グループの公開設定
  • パディングの問題

バージョン 2.0.0-beta6

2020 年 5 月 13 日

androidx.constraintlayout:constraintlayout:2.0.0-beta6 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。重要な修正は、MotionLayout でのグループ可視性の処理と派生制約の問題です。

バージョン 2.0.0-beta5

2020 年 5 月 7 日

androidx.constraintlayout:constraintlayout:2.0.0-beta5 がリリースされました。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。

バージョン 2.0.0-beta4

2019 年 12 月 16 日

androidx.constraintlayout:constraintlayout:2.0.0-beta4 がリリースされました。

新機能

MotionLayout

Transition の新しい属性:

  • layoutDuringTransition: MotionLayout が遷移中に子の requestLayouts 呼び出しに対してどのように対応するかを設定できます。指定可能な値は {ignoreRequest、honorRequest} です。
  • pathMotionArc: 移動する要素がたどる軌跡に円弧を使用します。指定可能な値は {startVertical | startHorizontal | flip | none} です。

ConstraintSets の開始と終了を省略するだけで、デフォルトの遷移を定義できるようになりました。現在の開始または終了の状態に一致する既存の遷移が他にない場合は、デフォルトの遷移が使用されます。

バグの修正

クローズされた問題のリストは、こちらをご覧ください。