Kotlin多平台移动：iOS Kotlin框架编译提速方案咨询

针对你提到的iOS框架编译缓慢（主要耗时在linkPodDebugFrameworkIosX64、linkPodDebugFrameworkIosArm64、linkPodDebugFrameworkIosSimulatorArm64、linkPodDebugFrameworkIosFat任务），结合老旧MacBook Air的硬件限制，以下是可行的优化手段：

1. 替换Fat Framework为XCFramework，跳过架构合并 #

Fat Framework需要合并多个CPU架构的二进制文件，linkPodDebugFrameworkIosFat任务正是这个高耗时环节。改用XCFramework可以避免合并步骤，直接生成各架构独立的框架：

• 在build.gradle.kts的iOS目标配置中，修改框架类型为XCFramework：

iosX64 {
    binaries.framework {
        baseName = "YourFramework"
        isStatic = true // 静态框架编译速度更快
        xcf.set(true) // 启用XCFramework
    }
}
iosArm64 {
    binaries.framework {
        baseName = "YourFramework"
        isStatic = true
        xcf.set(true)
    }
}
iosSimulatorArm64 {
    binaries.framework {
        baseName = "YourFramework"
        isStatic = true
        xcf.set(true)
    }
}

• 编译时不再生成Fat Framework，省去合并架构的大量时间。

2. 开发阶段精简编译目标 #

无需每次编译所有iOS架构，只针对当前使用的环境编译：

• 比如使用M系列Mac的模拟器，仅编译iosSimulatorArm64目标，执行命令：

./gradlew linkPodDebugFrameworkIosSimulatorArm64

• 可以在gradle.properties中添加默认启用的目标，避免每次手动指定：

kotlin.mpp.enabledTargets=iosSimulatorArm64

• 切换环境时再临时修改参数或配置即可。

3. 开启Gradle与Kotlin Native的增量编译和缓存 #

• 在gradle.properties中添加以下配置，最大化缓存和增量编译效率：

# Gradle全局优化
org.gradle.caching=true
org.gradle.parallel=true
org.gradle.configureondemand=true
org.gradle.daemon=true

# Kotlin Native增量编译
kotlin.native.incremental=true
kotlin.native.cacheKind=both
kotlin.incremental=true

• 注意：修改共享代码的公共API会导致增量编译失效，尽量在内部实现层修改，避免暴露新的类、方法或属性。

4. 硬件与系统层面优化 #

• 关闭后台不必要的应用程序，释放CPU和内存资源（老旧Mac的内存瓶颈尤为明显）；
• 如果你的2017款MacBook Air支持内存升级，优先升级到16GB，编译过程对内存需求较高；
• 确保Mac剩余磁盘空间充足（至少保留20GB以上），编译会生成大量临时文件，磁盘空间不足会拖慢速度；
• 关闭Spotlight索引等后台资源占用高的服务，临时提升编译优先级。

5. 其他实用技巧 #

• 升级到Kotlin 1.8及以上版本，官方对KMP iOS编译速度有持续优化；
• 将共享代码拆分为多个独立模块，修改单个模块时仅编译该模块，而非整个共享库；
• 保持Gradle Daemon持续运行，避免每次编译启动Daemon的开销（默认已启用，尽量不要手动停止）。

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