Skip to content

Compose Multiplatform 1.10.3 の新機能 ​

この機能リリースの主なハイライトは以下の通りです:

このリリースの変更点の完全なリストは、GitHub で確認できます。 特定のコンポーネントバージョンの詳細については、依存関係 セクションを参照してください。

破壊的変更と非推奨 ​

非推奨となった依存関係エイリアス ​

Compose Multiplatform Gradle プラグインでサポートされていた依存関係エイリアス(compose.ui など)は、1.10.0-beta01 リリースで非推奨となりました。 バージョンカタログに直接ライブラリ参照を追加することをお勧めします。 具体的な参照先は、対応する非推奨通知の中で提案されています。

この変更により、Compose Multiplatform ライブラリの依存関係管理がより透明(明確)になるはずです。 将来的には、互換性のあるバージョンのセットアップを簡素化するために、Compose Multiplatform 用の BOM を提供したいと考えています。

非推奨となった PredictiveBackHandler() ​

PredictiveBackHandler() 関数は、Android ネイティブの戻るナビゲーションジェスチャー(Predictive Back)を他のプラットフォームに導入するために Compose Multiplatform で導入されました。 Navigation 3 のリリースに伴い、古い実装は新しい Navigation Event ライブラリとその API に置き換わる形で非推奨となりました。 具体的には、PredictiveBackHandler() 関数の代わりに、より汎用的な NavigationEventHandler() 実装をラップする新しい NavigationBackHandler() 関数を使用する必要があります。

最もシンプルな移行は、以下のようになります:

変更前
kotlin
 PredictiveBackHandler(enabled = true) { progress ->
    try {
        progress.collect { event ->
            // Animate the back gesture progress
        }
        // Process the completed back gesture
    } catch(e: Exception) {
        // Process the canceled back gesture
    }
}
変更後
kotlin
// Use an empty state as a stub to satisfy the required argument
val navState = rememberNavigationEventState(NavigationEventInfo.None)
NavigationBackHandler(
    state = navState,
    isBackEnabled = true,
    onBackCancelled = {
        // Process the canceled back gesture
    },
    onBackCompleted = {
      // Process the completed back gesture
    }
)
LaunchedEffect(navState.transitionState) {
    val transitionState = navState.transitionState
    if (transitionState is NavigationEventTransitionState.InProgress) {
        val progress = transitionState.latestEvent.progress
        // Animate the back gesture progress
    }
}

ここでのポイント:

  • state パラメーターは必須です:NavigationEventInfo は UI 状態に関するコンテキスト情報を保持するように設計されています。 現時点で保存する情報がない場合は、スタブとして NavigationEventInfo.None を使用できます。
  • onBack パラメーターは onBackCancelled と onBackCompleted に分割されたため、キャンセルされたジェスチャーを個別に追跡する必要がなくなりました。
  • NavigationEventState.transitionState プロパティは、物理的なジェスチャーの進行状況を追跡するのに役立ちます。

実装の詳細については、Navigation Event API リファレンスの NavigationEventHandler ページを参照してください。

Kotlin の最小バージョンが引き上げられました ​

プロジェクトに native または web ターゲットが含まれている場合、最新の機能を利用するには Kotlin 2.2.20 へのアップグレードが必要です。

プラットフォーム共通 ​

統合された @Preview アノテーション ​

プラットフォーム間でのプレビューのアプローチを統一しました。 commonMain ソースセットで androidx.compose.ui.tooling.preview.Preview アノテーションを使用できるようになりました。

org.jetbrains.compose.ui.tooling.preview.Preview やデスクトップ専用の androidx.compose.desktop.ui.tooling.preview.Preview など、他のすべてのアノテーションは非推奨となりました。

interop ビューの自動リサイズ ​

Compose Multiplatform は、デスクトップと iOS の両方で、ネイティブの interop(相互運用)要素の自動リサイズをサポートしました。 これらの要素は、コンテンツに合わせてレイアウトを適応させることができるようになり、 手動で正確なサイズを計算したり、事前に固定の寸法を指定したりする必要がなくなります。

  • デスクトップでは、SwingPanel が埋め込まれたコンポーネントの最小、推奨、最大サイズに基づいてサイズを自動的に調整します。
  • iOS では、UIKit interop ビューがビューの fitting size(固有のコンテンツサイズ / intrinsic content size)に応じたサイジングをサポートするようになりました。 これにより、UIHostingController を介した SwiftUI ビューや、NSLayoutConstraints に依存しない基本的な UIView サブクラスを適切にラッピングできるようになります。

Popup および Dialog プロパティの安定化 ​

DialogProperties の以下のプロパティが安定版(stable)に昇格し、実験的(experimental)ではなくなりました: usePlatformInsets、useSoftwareKeyboardInset、および scrimColor。

同様に、PopupProperties の usePlatformDefaultWidth および usePlatformInsets プロパティも安定版に昇格しました。

PopupProperties パラメーターを持たない Popup オーバーロードの非推奨レベルが ERROR に変更され、更新された API の使用が強制されるようになりました。

Skia が Milestone 138 に更新されました ​

Skiko を通じて Compose Multiplatform で使用されている Skia のバージョンが、Milestone 138 に更新されました。

以前に使用されていた Skia のバージョンは Milestone 132 でした。 これらのバージョン間で行われた変更については、リリースノートで確認できます。

Experimental

Navigation 3 のサポート

Navigation 3 は、Compose で動作するように設計された新しいナビゲーションライブラリです。 Navigation 3 では、バックスタックを完全に制御でき、デスティネーション間の移動はリストへの項目の追加や削除と同じくらいシンプルになります。 新しい設計指針や決定事項については、Navigation 3 のドキュメントや、発表のブログ記事で読むことができます。

Compose Multiplatform 1.10.0-beta01 は、Android 以外のターゲットで新しいナビゲーション API を使用するための Alpha サポートを提供します。 リリースされたマルチプラットフォームアーティファクトは以下の通りです:

  • Navigation 3 UI ライブラリ:org.jetbrains.androidx.navigation3:navigation3-ui
  • Navigation 3 用 ViewModel:org.jetbrains.androidx.lifecycle:lifecycle-viewmodel-navigation3
  • Navigation 3 用 Material 3 アダプティブレイアウト:org.jetbrains.compose.material3.adaptive:adaptive-navigation3

マルチプラットフォームでの Navigation 3 実装の例は、オリジナルの Android リポジトリからミラーリングされた nav3-recipes サンプルで確認できます。

プラットフォーム固有のいくつかの実装詳細:

  • iOS では、EndEdgePanGestureBehavior オプション(デフォルトは Disabled)を使用して、終了エッジのパンジェスチャー(pan gestures)によるナビゲーションを管理できるようになりました。 ここで「終了エッジ(end edge)」とは、LTR インターフェースでは画面の右端、RTL では左端を指します。 開始エッジ(start edge)は終了エッジ의 反対側であり、常に戻るジェスチャーに紐付けられています。
  • Web アプリでは、デスクトップブラウザで Esc キーを押すと、デスクトップアプリと同様に、前の画面に戻る(およびダイアログ、ポップアップ、Material 3 の SearchBar などの一部のウィジェットを閉じる)ようになりました。
  • ブラウザの履歴ナビゲーションのサポートとアドレスバーでのデスティネーションの使用については、Compose Multiplatform 1.10 の Navigation 3 では拡張されません。 これはマルチプラットフォームライブラリの将来のバージョンまで延期されました。

iOS ​

ウィンドウインセット(Window insets) ​

Compose Multiplatform は WindowInsetsRulers をサポートしました。 これにより、ステータスバー、ナビゲーションバー、またはオンスクリーンキーボードなどのウィンドウインセットに基づいて UI 要素を配置し、サイズを調整する機能が提供されます。

ウィンドウインセットを管理するためのこの新しいアプローチでは、プラットフォーム固有のウィンドウインセットデータを取得するために単一の実装を使用します。 つまり、WindowInsets と WindowInsetsRulers の両方が共通のメカニズムを使用して、一貫してインセットを管理します。

以前、WindowInsets.Companion.captionBar は @Composable とマークされていませんでした。 プラットフォーム間での動作を一致させるために、@Composable 属性を追加しました。

IME 設定の改善 ​

1.9.0 で導入された iOS 固有の IME カスタマイズに続き、このリリースでは PlatformImeOptions を使用してテキスト入力ビューを構成するための新しい API が追加されました。

これらの新しい API を使用すると、フィールドがフォーカスを取得して IME がトリガーされたときの入力インターフェースをカスタ備ズできます:

  • UIResponder.inputView は、デフォルトのシステムキーボードを置き換えるカスタム入力ビューを指定します。
  • UIResponder.inputAccessoryView は、IME アクティブ化時にシステムキーボードまたはカスタム inputView にアタッチされるカスタムアクセサリビューを定義します。
Experimental

interop ビューのオーバーレイ配置

実験的な placedAsOverlay フラグを使用して、UIKitView および UIKitViewController ビューを Compose UI の上に配置できるようになりました。 このフラグにより、interop ビューで透明な背景やネイティブのシェーダー効果をサポートできるようになります。

interop ビューをオーバーレイとしてレンダリングするには、@OptIn(ExperimentalComposeUiApi::class) アノテーションを使用し、UIKitInteropProperties で placedAsOverlay パラメーターを true に設定します:

kotlin
UIKitViewController(
    modifier = modifier,
    update = {},
    factory = { factory.createNativeMap() },
    properties = UIKitInteropProperties(placedAsOverlay = true)
)

この構成では、ビューが Compose UI レイヤーの最前面にレンダリングされることに注意してください。 その結果、同じエリアにある他のコンポーザブル(composable)は視覚的に覆い隠されます。

Web ​

Experimental

リソースのキャッシュ

Compose Multiplatform は Web Cache API を使用して、静的アセットや文字列リソースの成功したレスポンスをキャッシュするようになりました。 このアプローチにより、HTTP リクエストを繰り返して保存されたコンテンツを検証するブラウザのデフォルトキャッシュに伴う遅延を回避でき、特に低帯域幅の接続で低速になる問題を解消できます。 キャッシュは、リソースがアプリケーションの現在の状態と一致することを保証するため、アプリの起動やページの更新のたびにクリアされます。

詳細については、プルリクエストおよび Web リソースのキャッシュのドキュメントを参照してください。

デスクトップ ​

Compose Hot Reload の統合 ​

Compose Hot Reload プラグインが Compose Multiplatform Gradle プラグインに同梱されるようになりました。 デスクトップをターゲットとする Compose Multiplatform プロジェクトではデフォルトで有効になっているため、Hot Reload プラグインを個別に構成する必要はもうありません。

Compose Hot Reload プラグインを明示的に宣言しているプロジェクトへの影響:

  • Compose Multiplatform Gradle プラグインによって提供されるバージョンを使用するために、宣言を安全に削除できます。
  • 特定のバージョンの宣言を維持することを選択した場合は、同梱されているバージョンの代わりにそのバージョンが使用されます。

同梱されている Compose Hot Reload Gradle プラグインの最小 Kotlin バージョンは 2.1.20 です。 古いバージョンの Kotlin が検出された場合、ホットリロード機能は無効になります。

Gradle ​

AGP 9.0.0 のサポート ​

Compose Multiplatform は、Android Gradle Plugin (AGP) のバージョン 9.0.0 のサポートを導入しました。 新しい AGP バージョンとの互換性のために、Compose Multiplatform 1.9.3 または 1.10.0 へのアップグレードを確認してください。

長期的にアップデートプロセスをよりスムーズにするために、プロジェクト構造を変更して専用の Android アプリケーションモジュールを使用することをお勧めします。

依存関係 ​

ライブラリMaven 座標ベースとなる Jetpack バージョン
Runtimeorg.jetbrains.compose.runtime:runtime*:1.10.3Runtime 1.10.5
UIorg.jetbrains.compose.ui:ui*:1.10.3UI 1.10.5
Foundationorg.jetbrains.compose.foundation:foundation*:1.10.3Foundation 1.10.5
Materialorg.jetbrains.compose.material:material*:1.10.3Material 1.10.5
Material3org.jetbrains.compose.material3:material3*:1.10.0-alpha05Material3 1.5.0-alpha08
Material3 Adaptiveorg.jetbrains.compose.material3.adaptive:adaptive*:1.3.0-alpha02Material3 Adaptive 1.3.0-alpha03
Lifecycleorg.jetbrains.androidx.lifecycle:lifecycle-*:2.10.0Lifecycle 2.10.0
Navigationorg.jetbrains.androidx.navigation:navigation-*:2.9.2Navigation 2.9.7
Navigation3org.jetbrains.androidx.navigation3:navigation3-*:1.0.0-alpha06Navigation3 1.0.0
Navigation Eventorg.jetbrains.androidx.navigationevent:navigationevent-compose:1.0.1Navigation Event 1.0.2
Savedstateorg.jetbrains.androidx.savedstate:savedstate*:1.4.0Savedstate 1.4.0
WindowManager Coreorg.jetbrains.androidx.window:window-core:1.5.1WindowManager 1.5.1