不同平台上的預設 UI 行為
Compose Multiplatform 旨在協助您開發在不同平台上行為盡可能一致的應用程式。 在本頁面中，您可以了解在使用 Compose Multiplatform 為不同平台編寫共享 UI 程式碼時， 可能會遇到的不可避免的差異或暫時性的權衡。
專案結構
不論您的目標平台為何，每個平台都需要一個專屬的入口點：
- 對於 Android，是
Activity，其職責是顯示來自通用程式碼的主要可組合項。 - 對於 iOS 應用程式，是初始化應用程式的
@main類別或結構。 - 對於 JVM 應用程式，是啟動應用程式並執行主要通用可組合項的
main()函式。 - 對於 Kotlin/JS 或 Kotlin/Wasm 應用程式，是將主要通用程式碼可組合項附加到網頁的
main()函式。
您的應用程式可能需要某些尚未支援多平台的平台特定 API， 對此您必須在平台特定的原始碼集中實作這些 API 的呼叫。 在實作之前，請查看 klibs.io，這是一個 JetBrains 專案，旨在全面編目所有可用的 Kotlin Multiplatform 程式庫。 目前已有可用於網路程式碼、資料庫、協同程式 (coroutine) 等功能的程式庫。
輸入方法
軟體鍵盤
每個平台處理軟體鍵盤的方式可能略有不同，包括當文字欄位變為活動狀態時鍵盤出現的方式。
Compose Multiplatform 採用了 Compose 視窗內縮 (window insets) 做法 並在 iOS 上模擬此行為，以考慮到 安全區域 (safe areas)。 根據您的實作方式，軟體鍵盤在 iOS 上的位置可能稍有不同。 請務必檢查鍵盤在兩個平台上都不會遮擋重要的 UI 元素。
觸控與滑鼠支援
目前的桌面版實作將所有指標 (pointer) 操作解釋為滑鼠手勢， 因此不支援多點觸控手勢。 例如，通用的捏合縮放 (pinch-to-zoom) 手勢無法在 Compose Multiplatform 桌面版中實作， 因為它需要同時處理兩個觸控點。
UI 行為與外觀
平台特定功能
Compose Multiplatform 並未涵蓋某些通用的 UI 元素，且無法使用該框架進行自訂。 因此，您可以預期它們在不同平台上看起來會有所不同。
原生快顯視圖 (pop-up view) 就是一個例子： 當您在 Compose Multiplatform 文字欄位中選取文字時，預設建議的操作（如 複製 或 翻譯） 會依據應用程式執行的平台而有所不同。
滾動物理特性
對於 Android 和 iOS，滾動感會與平台保持一致。 對於桌面版，滾動支援僅限於滑鼠輪（如 觸控與滑鼠支援 中所述）。
互通視圖 (Interop views)
如果您想在通用可組合項中嵌入原生視圖，或反之亦然， 您需要熟悉 Compose Multiplatform 支援的平台特定機制。
對於 iOS，有分別針對 SwiftUI 與 UIKit 互通程式碼的指南。
對於桌面版，Compose Multiplatform 支援 Swing 互通性。
返回手勢
Android 裝置預設支援返回手勢，且每個畫面都會以某種方式對 返回 按鈕做出反應。
在 iOS 上，預設沒有返回手勢，儘管建議開發者實作類似功能以符合使用者體驗預期。 Compose Multiplatform 為 iOS 預設支援返回手勢，以模擬 Android 的功能。
在桌面版上，Compose Multiplatform 使用 Esc 鍵作為預設的返回觸發器。
如需詳細資訊，請參閱 返回手勢 章節。
文字
在文字方面，Compose Multiplatform 不保證不同平台之間具有像素級完美的對應：
- 如果您未明確設定字型，每個系統都會為您的文字分配不同的預設字型。
- 即使是相同的字型，各平台特有的消除鋸齒 (aliasing) 機制也可能導致明顯的差異。
這對使用者體驗不會產生重大影響。相反地，預設字型在各平台上會以符合預期的方式呈現。 然而，像素差異可能會干擾例如螢幕截圖測試等作業。
開發人員體驗
預覽 (Previews)
預覽 (Previews) 是帶有 @Preview 註解的可組合項版面配置呈現，可以在 IntelliJ IDEA 和 Android Studio 中與共享 UI 程式碼併列呈現。
預覽需要特定的專案組態與明確的相依性。 請參閱 Compose UI 預覽 以了解如何在您的專案中啟用預覽。
熱重載 (Hot reload)
熱重載 (Hot reload) 指的是應用程式即時反映程式碼變更，而不需要額外的輸入。 在 Compose Multiplatform 中，熱重載功能僅適用於 JVM（桌面版）目標。 然而，您可以在切換到預期平台進行微調之前，使用它來快速進行疑難排解。
若要了解更多，請參閱我們的 Compose 熱重載 文章。
後續步驟
閱讀更多關於以下組件在 Compose Multiplatform 中的實作：