原生應用程式入口點
雖然 Compose Multiplatform UI 可以完全在共用程式碼中實作, 但實際的應用程式是從原生入口點啟動的。 這些入口點是你可以修改應用程式特定平台行為的地方。
例如,在由 KMP IDE 精靈產生的基本專案中, UI 的基礎是共用程式碼中的 App() 函式。 然後在各個平台上呼叫此函式:
- 在 Android 上,該呼叫由 activity 管理。
- 在 iOS 上,由 view controller 管理。
- 在桌面上,由視窗管理。
- 在 Web 上,由容器管理。
在這些範例中,App() 函式不接受任何參數。 在較大型的應用程式中,你通常會將參數傳遞給特定平台的相依性。 這些相依性可以手動提供,或是使用相依注入程式庫傳遞。
在 Android 上
對於 Android,該呼叫是從名為 MainActivity 的 Android activity 中的 setContent() Lambda 內部進行的:
class MainActivity : ComponentActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
enableEdgeToEdge()
super.onCreate(savedInstanceState)
setContent {
// 呼叫共用的 App() composable
App()
}
}
}Compose Multiplatform 提供了對所有 Jetpack Compose API 的存取權, 但其中某些 API 僅適用於 Android 應用程式。
在 iOS 上
對於 iOS,共用的 App() composable 是在 view controller 內呼叫的, 其扮演著與 Android 上的 activity 相同的角色:
fun MainViewController() = ComposeUIViewController { App() }iOS 的 view controller 和 Android 的 activity 都只是單純叫用共用程式碼中的 App() composable。
如需進一步了解 Compose Multiplatform 與 iOS UI 架構的整合, 請參閱與 SwiftUI 架構整合以及與 UIKit 架構整合。
在桌面上
在桌面上,Compose Multiplatform 被建置到 JVM 應用程式中。 對共用 App() composable 的呼叫是在 main() 函式中進行的, 並封裝在 application()(或 singleWindowApplication())呼叫中:
fun main() = application {
Window(
onCloseRequest = ::exitApplication,
title = "ComposeDemo"
) {
App()
}
}通常,在 application() 函式內部,你會建立一個 Window、指定其屬性, 並使用 onCloseRequest 回呼來定義關閉視窗時發生的行為。 在預設專案中,整個應用程式會關閉(::exitApplication)。
與 Android 和 iOS 一樣,App() composable 負責整個 UI 配置。
進一步了解桌面專用的 Compose Multiplatform 元件 與 Swing 互通性。
在 Web 上
Web 應用程式(其程式碼位於預設專案的 webApp 模組中) 會從 main.kt 檔案中的 main() 函式呼叫共用的 App() composable:
// Web API 為實驗性功能,需要選擇加入 (opt-in)
@OptIn(ExperimentalComposeUiApi::class)
fun main() {
// 為 Web 應用程式設定 Compose 環境
ComposeViewport {
// 產生 UI 配置
App()
}
}如需進一步了解 Web 入口點,請參閱設定視區 (viewport)。
取得協助
- Kotlin Slack:取得協助並參與關於 KMP 和 Compose Multiplatform 的討論。 申請邀請並加入 #multiplatform 與 #compose 頻道。
- Kotlin 問題追蹤器:回報新問題。
