KMM项目中Xcode无法找到IosMainAppKt求助

以下是针对该问题的排查和解决步骤：

1. 确保Kotlin函数的可见性 #

Kotlin默认的internal可见性会阻止iOS端访问函数，需保证IosMainApp.kt中的控制器创建函数为公开状态：

// iosMain/kotlin/[包名]/IosMainApp.kt
package com.your.package.name

import androidx.compose.ui.window.ComposeUIViewController
import com.your.package.name.ClipRApp

// 顶层函数默认public，若嵌套在类中需显式添加public修饰符
fun MainViewController() = ComposeUIViewController {
    ClipRApp()
}

2. 检查KMM框架配置 #

在项目根目录的build.gradle.kts（或build.gradle）中，确认iOS目标的framework配置正确：

kotlin {
    // 声明iOS支持的架构
    iosX64()
    iosArm64()
    iosSimulatorArm64()

    sourceSets {
        val iosMain by getting {
            dependencies {
                // 确保引入所有必要的Compose依赖
                implementation(compose.ui)
                implementation(compose.foundation)
                implementation(compose.material)
                implementation(compose.runtime)
            }
        }
    }

    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
        binaries.framework {
            baseName = "YourFrameworkName" // 自定义框架名称
            isStatic = true // Compose Multiplatform推荐使用静态框架
        }
    }
}

3. 清理缓存并重新构建 #

缓存异常是这类问题的常见诱因，按以下步骤操作：

• 关闭Xcode
• 在Android Studio终端执行：./gradlew clean
• 删除iOS目录下的Pods文件夹和Podfile.lock
• 重新执行：pod install
• 打开xcworkspace，先执行⌘+B构建KMM模块，再构建iOS项目

4. 验证Xcode的导入与调用逻辑 #

在iOS代码中确保正确导入KMM框架，并按Kotlin转Swift的规则调用函数：

import YourFrameworkName // 替换为你的框架名称

// Kotlin顶层函数在Swift中调用格式：文件名Kt.函数名
let mainVC = IosMainAppKt.MainViewController()

5. 匹配Kotlin与Compose版本 #

Compose 1.4.0要求Kotlin版本为1.8.20，检查项目根目录build.gradle.kts中的版本配置：

plugins {
    kotlin("multiplatform") version "1.8.20"
    id("org.jetbrains.compose") version "1.4.0"
    // 其他插件配置...
}

6. 确认文件路径与包名一致 #

确保IosMainApp.kt的包名声明与文件路径匹配，例如文件位于iosMain/kotlin/com/your/package/下，文件开头需声明：

package com.your.package

内容的提问来源于stack exchange，提问作者Abhriya Roy