Zui近把自己的 NBA 数据应用 HoopsNow 从纯 Android 多模块架构迁移到了 KMP + CMP，实现了 Android/iOS 共享一套代码。

这篇文章记录整个迁移过程中的思路、踩坑和Zui终方案。

HoopsNow 是一个 NBA 数据展示应用，功Neng包括比赛比分、球队信息、球员搜索和收藏管理。

迁移前的架构参考了 Google 的 Now in Android 项目，是一个标准的 Android 多模块架构：

hoopsnow/
├── app/                        # 入口 + Navigation3
├── core/                       # 7 个核心模块
│   ├── common/                 # 工具类
│   ├── data/                   # Repository
│   ├── database/               # Room
│   ├── datastore/              # DataStore
│   ├── designsystem/           # 主题
│   ├── model/                  # 数据模型
│   ├── network/                # Ktor
│   ├── testing/                # 测试工具
│   └── ui/                     # 共享 UI
├── feature/                    # 4 个功Neng模块 
│   ├── games/
│   ├── teams/
│   ├── players/
│   └── favorites/
└── build-logic/                # 5 个 Convention Plugins

技术栈：Hilt + Navigation3 + Room + ViewModel + Coil

这套架构在纯 Android 场景下hen好用，模块边界清晰，构建并行度高。

但当我想把应用 到 iOS 时这些 Android 专属的库就成了障碍。

考虑过几个方案：

Zui终选了 KMP + CMP，原因hen简单：现有代码是 Kotlin + Compose，迁移成本Zui低，UI 也Neng共享。

第一步是创建 KMP 共享模块。

// shared/build.gradle.kts plugins { alias alias alias alias alias alias } kotlin { androidTarget { compilerOptions { jvmTarget.set } } listOf, iosArm64, iosSimulatorArm64).forEach { it.binaries.framework { baseName = "Shared" isStatic = true } } sourceSets { commonMain.dependencies { implementation implementation implementation implementation // Ktor, SQLDelight, Koin, Voyager, Coil ... } androidMain.dependencies { implementation implementation } iosMain.dependencies { implementation implementation } } } 二、数据库迁移：Room → SQLDelight

这是迁移中工作量Zui大的部分。

Room 不支持 KMP，必须换成 SQLDelight。

SQLDelight 用 .sq 文件定义表结构和查询，放在 commonMain/sqldelight/ 目录下：

-- Team.sq
CREATE TABLE TeamEntity (
    id INTEGER PRIMARY KEY NOT NULL,
    conference TEXT NOT NULL,
    division TEXT NOT NULL,
    city TEXT NOT NULL,
    name TEXT NOT NULL,
    fullName TEXT NOT NULL,
    abbreviation TEXT NOT NULL
);
getAll: SELECT * FROM TeamEntity;
getById: SELECT * FROM TeamEntity WHERE id = ?;
upsert: INSERT OR REPLACE INTO TeamEntity VALUES ;

生成的 Queries 属性名基于 .sq 文件名，不是表名。

比如 Game.sq 生成 database.gameQueries，不是 database.gameEntityQueries。

Hilt 依赖 Android 的注解处理器，不支持 KMP。

Koin 是纯 Kotlin 实现，天然跨平台。

// commonMain - KoinModules.kt
val sharedModule = module {
    // Network
    single { KtorNbaNetwork) }
    // Database
    single { get.createDriver }
    single { NbaDatabase) }
    // Repositories
    single { OfflineFirstGamesRepository, get) }
    single { OfflineFirstTeamsRepository, get) }
    single { OfflineFirstPlayersRepository, get) }
    single { OfflineFirstFavoritesRepository, get) }
    // ScreenModels
    factory { GamesListScreenModel) }
    factory { params -> GameDetailScreenModel, get) }
}
// 平台模块通过 expect/actual 提供
expect fun platformModule: Module

Voyager 提供了 TabNavigator+Navigator)的组合，hen适合底部 Tab + 页面栈的场景。

@Composable
fun HoopsNowApp {
    HoopsNowTheme {
        TabNavigator {
            Scaffold(
                bottomBar = {
                    NavigationBar {
                        TabNavigationItem
                        TabNavigationItem
                        TabNavigationItem
                        TabNavigationItem
                    }
                },
            ) {
                CurrentTab
            }
        }
    }
}

每个 Tab 内嵌独立的 Navigator，Tab 切换时各自的导航栈互不影响。

// 定义tab 
object GamesTab : Tab {    
    override val options @Composable get = TabOptions(
        index = 0u,
        title = "Games",
        icon = rememberVectorPainter,
)
@Composable    
override fun Content {        
    Navigator) { navigator ->
        SlideTransition        
    }    
}
}

页面间传参hen简单直接：

// 传参class GameDetailScreen : Screen {// 使用navigator.push)}

Voyager 的 ScreenModel 和 ViewModel 几乎一模一样：

// 迁移前@HiltViewModelclass GamesListViewModel @Inject constructor(    
private val gamesRepository: GamesRepository,) : ViewModel 
{    
    val uiState = gamesRepository.getGames        
    .stateIn, Loading)
// 迁移后class GamesListScreenModel(    
private val gamesRepository: GamesRepository,) : ScreenModel 
{    
    val uiState = gamesRepository.getGames        
    .stateIn, Loading)

// 定义factory { params -> GameDetailScreenModel, get) }// 使用val screenModel=koinScreenModel{parametersOf}

// iOSApp.swift@mainstruct iOSApp: App 
{    
    init 
    {        
        KoinHelperKt.doInitKoin    
    }    
    var body: some Scene 
    {        
    WindowGroup 
        { ContentView }    
    }
}
// ContentView.swiftstruct ContentView: View 
{    
    var body: some View 
    {        
    ComposeView
         .ignoresSafeArea   
      }
struct ComposeView: UIViewControllerRepresentable 
{
    func makeUIViewController -> UIViewController 
    {
       Main_iosKt.MainViewController
    func updateUIViewController {}
}

// iosMain - Main_ios.ktfun MainViewController=ComposeUIViewController{HoopsNowApp}