ネイティブアプリケーションのエントリーポイント
Compose Multiplatform の UI は完全に共通コードで実装できますが、実際のアプリケーションはネイティブのエントリーポイントから開始されます。 これらのエントリーポイントで、アプリのプラットフォーム固有の動作を変更できます。
例えば、KMP IDE ウィザードによって生成された基本プロジェクトでは、UI のベースは共通コードにある App() 関数です。 この関数が各プラットフォームで呼び出されます。
- Android では、アクティビティによって呼び出しが管理されます。
- iOS では、ビューコントローラーによって管理されます。
- デスクトップでは、ウィンドウによって管理されます。
- Web では、コンテナによって管理されます。
これらの例では、App() 関数はパラメータを取りません。 より大規模なアプリケーションでは、通常、プラットフォーム固有の依存関係にパラメータを渡します。 これらの依存関係は、手動で提供することも、依存性注入(DI)ライブラリを使用して渡すこともできます。
Android
Android では、MainActivity と呼ばれる Android アクティビティ内の setContent() ラムダから呼び出しが行われます。
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
// 共通の App() コンポーザブルを呼び出す
App()
}
}
}Compose Multiplatform はすべての Jetpack Compose API へのアクセスを提供しますが、その一部は Android アプリでのみ利用可能です。
iOS
iOS では、Android のアクティビティと同じ役割を果たす ビューコントローラー 内で共通の App() コンポーザブルが呼び出されます。
fun MainViewController() = ComposeUIViewController { App() }iOS のビューコントローラーと Android のアクティビティはどちらも、単に共通コードから App() コンポーザブルを呼び出しているだけです。
Compose Multiplatform と iOS UI フレームワークの統合の詳細については、SwiftUI フレームワークとの統合および UIKit フレームワークとの統合を参照してください。
デスクトップ
デスクトップでは、Compose Multiplatform は JVM アプリにビルドされます。 共通の App() コンポーザブルの呼び出しは main() 関数内で行われ、application()(または singleWindowApplication())の呼び出しでラップされます。
fun main() = application {
Window(
onCloseRequest = ::exitApplication,
title = "ComposeDemo"
) {
App()
}
}通常、application() 関数の内部で Window を作成し、そのプロパティを指定して、ウィンドウが閉じられたときの動作を onCloseRequest コールバックで定義します。 デフォルトのプロジェクトでは、アプリケーション全体が終了します(::exitApplication)。
Android や iOS と同様に、App() コンポーザブルが UI レイアウト全体を担当します。
詳細については、デスクトップ固有の Compose Multiplatform コンポーネントおよび Swing との相互運用性を参照してください。
Web
デフォルトプロジェクトで webApp モジュールにコードが配置されている Web アプリケーションは、main.kt ファイルの main() 関数から共通の App() コンポーザブルを呼び出します。
// Web API は実験的であり、オプトインが必要です
@OptIn(ExperimentalComposeUiApi::class)
fun main() {
// Web アプリ用の Compose 環境をセットアップ
ComposeViewport {
// UI レイアウトを生成
App()
}
}Web のエントリーポイントの詳細については、ビューポートのセットアップを参照してください。
サポートを受ける
- Kotlin Slack: KMP や Compose Multiplatform に関するサポートを受けたり、ディスカッションに参加したりできます。招待をリクエストして、#multiplatform および #compose チャンネルに参加してください。
- Kotlin 課題トラッカー: 新しい課題を報告する。
