直感的な理解
スクロールのピクセルごとにリコンポーズするコンポーザブルと、再計測だけで済むコンポーザブルは、プレビュー上では同じように見えることがある。しかし実機の画面上では、片方だけがディスプレイに追従できなくなる。その違いを生むのは状態そのものではなく、どのフェーズでそれを読み取っているかだ。
すべてのフレームは三つのフェーズを通過し、それぞれが専用のスナップショットオブザーバーを持ち、そのフェーズの内部で行われた状態の読み取りに対してのみ再実行される。
- コンポジション:何が存在するか(最もコストが高い)
- レイアウト:どこに、どのくらいの大きさで(中程度)
- 描画:どのピクセルか(最も安い)
このコストは三者で均等ではない。コンポジションの再実行が最もコストが高く、レイアウトは中程度、描画は最も安い。
したがって重要な問いは「この値はどこで使われているか」ではなく、「自分はどのフェーズでこれを読み取っているか」であり、それが「この読み取りが載せられる最も安いフェーズはどこか」という問いへの答えになる。
このコストの順位が重要になるのは、三つのフェーズがすべて一つの締め切りを共有しているからだ。それはディスプレイのリフレッシュクロックである。コンポジション、レイアウト、描画はすべて次ののタイミングより前に終わらなければならず、終わらなければ前のフレームが再表示される(これがフレームドロップであり、ジャンクとして見える)。
| リフレッシュレート | フレームあたりの予算 |
|---|---|
| 60 Hz | 16.6 ms |
| 90 Hz | 11.1 ms |
| 120 Hz | 8.3 ms |
この共有予算は不均等に分配されている。不要なリコンポジションが最もコストが高く、不要な再レイアウトはそれより安く、不要な再描画が最も安い。
120 Hzでは三つのフェーズとGPUを合わせて合計8.3 msしかない。スクロールのピクセルごとにリコンポーズするコンポーザブルは、この予算を最初に食い尽くしてスタッターを引き起こすものだ。
Tip 1:リコンポジション、早くではなく遅く読む
// ❌ offsetPxがコンポジション時にModifierチェーンに焼き込まれる →
// 変化するたびにチェーンが再構築される → スクロールのピクセルごとにリコンポーズする
Modifier.offset(x = offsetPx.dp)
// ✅ offsetPxを値として渡さず、配置ラムダの内部で読み取る →
// Modifierのアイデンティティは安定したまま、配置だけが再実行される
Modifier.offset { IntOffset(0, offsetPx.roundToInt()) }Modifier.offset(x: Dp, y: Dp) は単純な値を受け取るため、offsetPx.dp はModifierチェーンが存在する前に、コンポジション中に解決されなければならない。変化が起きるたびに新しいModifierが生成され、リコンポーズが強制される。
一方、Modifier.offset { IntOffset(...) } はラムダそのものを保持し、レイアウトフェーズの一部である配置時にのみそれを呼び出す。そのためModifierのアイデンティティは一切変化せず、コンポジションは再実行されない。同じState、画面上の同じ効果でも、どのフェーズが代償を払うかが異なる。
唯一の例外
ノードがそもそも存在するかどうか(AnimatedVisibilityのvisible)はコンポジションで決定する必要がある。レイアウトと描画は、コンポジションが既に出力したものを移動・再描画するだけしかできない。
Tip 2:レイアウト、制約は下へ、サイズは上へ、位置は親が決める
// ❌ コンポーザブルの本体で読み取る → heightPxの変化がリコンポーズを引き起こす
val heightPx = lerp(maxHeightPx, minHeightPx, collapseFraction()).roundToInt()
Modifier.layout { measurable, constraints ->
val placeable = measurable.measure(constraints.copy(maxHeight = heightPx))
layout(placeable.width, heightPx) {
placeable.placeRelative(0, 0)
}
}
// ✅ modifier自身のラムダ内で読み取る → 再計測だけで済み、リコンポジションは起きない
Modifier.layout { measurable, constraints -> // constraints:自分が満たすべき箱
val heightPx = lerp(maxHeightPx, minHeightPx, collapseFraction()).roundToInt()
val placeable = measurable.measure( // measurable:保留中、これを呼ぶまでサイズは決まらない
constraints.copy(maxHeight = heightPx) // 下に何を渡すかは自分で選ぶ(heightを固定)
)
layout(placeable.width, heightPx) { // 自分のサイズを親に報告する
placeable.placeRelative(0, 0) // 子をどこに置くかを決めるのは自分だけ
}
}子は親から渡された[min, max]の箱の中でサイズを選ぶことしかできず、自分の位置を選ぶことは決してない。
Modifier.layout はレイアウトフェーズで状態を読み取るため、コストは中程度、コンポジションより安いが描画よりは高い。そのためheightPxはTip 1と同じ理由で、ラムダの内部で読み取る必要がある。そうしなければ、コラプスドラッグのピクセルごとに再計測ではなくリコンポーズが起きてしまう。
Tip 3:DrawScope、ピクセル、左上原点、中央揃えのストローク
// ❌ コンポーザブルの本体で読み取る → progressの変化がリコンポーズを引き起こす
val progress = scrollProgress()
Modifier.drawBehind {
val stroke = 8.dp.toPx()
// ストローク幅の半分だけ内側にずらす。そうしないと外側半分がクリップされる
drawCircle(Color.Blue.copy(alpha = progress),
radius = size.minDimension / 2 - stroke / 2, style = Stroke(stroke))
}
// ✅ drawBehind自身のラムダ内で読み取る → 再描画だけで済み、リコンポジションは起きない
Modifier.drawBehind {
val stroke = 8.dp.toPx()
val progress = scrollProgress()
drawCircle(Color.Blue.copy(alpha = progress),
radius = size.minDimension / 2 - stroke / 2, style = Stroke(stroke))
}DrawScopeの内部では、すべてが既にピクセル単位であり、原点は左上、+yは下方向を指す。ストロークはパスの内側ではなく、パスを中心として描かれる。そのため上記のように半分の幅だけ内側にずらす必要があり、そうしないと外側半分がクリップされる。
drawBehind:ノード自身のコンテンツより前だけに描画し、描画パスごとに実行され、キャッシュはされない。単に何かを下に敷きたいだけなら最もシンプルな選択。drawWithContent:drawContent()を自分で呼び出すため、その呼び出しを自分の描画に対してどこに置くかによって、前・後・両方という順序を自分で制御できる。drawWithCache:外側のラムダはサイズ/レイアウトが変化したときだけ再実行され、フレームごとには実行されない。コストの高いオブジェクト(Brush、Path、Shader)はそこで一度だけ構築し、それらを再利用するonDrawBehind { }やonDrawWithContent { }ブロックを返せば、実際の描画ごとにそれらが再利用される。
描画は三つのフェーズの中で再実行コストが最も安いため、progressはTip 1、2と同じ理由でこれらのいずれかの内部で読み取る必要がある。ここで読み取る限り、再計測はおろかリコンポジションも一切強制されない。
他の領域でも:同じ根本原理、異なるフレームワーク
- ブラウザのレンダリングパイプライン(CSS):スタイル再計算、レイアウト(リフロー)、ペイント、コンポジットは、名前こそ違うが同じコストの順序を持つ。
transform/opacityのアニメーションはコンポジットへ直接スキップし、リフローもリペイントも発生しない。一方width/topのアニメーションはパイプライン全体を強制する。「コンポジタースレッドに留まる」というアドバイスは、本記事のTip 1と3を、Composeの文脈ではなくブラウザのDevToolsパフォーマンスのTipとして述べたものにすぎない。 - Flutter:同じ三フェーズの分割がbuild、layout、paintと呼ばれ、
markNeedsBuild()、markNeedsLayout()、markNeedsPaint()がRenderObject上の文字通り三つの無効化ノブになっている。正しい最も安いものを呼び出すという規律は、Composeの正しいフェーズで状態を読み取るという規律とまったく同じものだ。 - 古典的なAndroid
Viewシステム:invalidate()(描画のみ)とrequestLayout()(計測とレイアウト、その後描画)の区別は、Tip 2と3の区別の直接の先祖であり、コンポジションフェーズが存在しない点だけが異なる。これはViewシステムがそもそも宣言的に設計されていなかったためだ。 - UIKit:
setNeedsDisplay()とsetNeedsLayout()の区別も同じ線を引いているが、上記の古典的なViewシステムと同様、コンポジションフェーズが存在しない。 - SwiftUI:同じ三フェーズの分割が、body再評価(コンポジション)、
LayoutプロトコルのsizeThatFits/placeSubviews(レイアウト)、CanvasのGraphicsContext(描画)として存在し、同じピクセル空間、左上原点、DrawScopeと同じ中央揃えストロークの落とし穴まで共通している。Tip 1の「早くではなく遅く読む」はAnimatableに直接対応するものがある。ShapeやViewModifierはvar animatableDataを宣言し、SwiftUIはそれを補間してレイアウト/描画を通じてフレームごとに再レンダリングし、bodyを再呼び出しすることは一切ない。



