如何减小KMM库生成的.xcframework体积？构建需考虑哪些因素？

一、哪些因素会影响.xcframework大小？ #

• 目标架构数量：xcframework会打包不同架构的二进制文件，比如arm64（真机）、x86_64（模拟器），多一个架构体积基本就会增加一份；要是还保留armv7这类老旧架构，体积膨胀会更明显。
• 代码与依赖冗余：
  • 库中引入的Kotlin标准库、第三方KMM依赖（比如Coroutines、Serialization）都会被打包进xcframework，依赖越多体积越容易膨胀。
  • 未被使用的死代码如果没被自动清理，也会额外占用空间。
• 编译模式与配置：
  • Debug模式编译会携带大量调试符号、断言、日志内容，体积比Release模式大很多。
  • 未开启链接时优化（LTO）的话，二进制文件没有经过深度优化，体积会偏大。
  • 开启Bitcode会在二进制中嵌入中间代码，直接增加体积（不过上传至App Store后苹果会对其进行优化处理）。
• 资源文件：如果KMM库中包含图片、字符串资源、配置文件等，这些内容都会直接计入xcframework的整体体积。
• Kotlin/Native编译细节：过度使用内联函数、泛型，或者开启某些实验性特性，可能会生成更多冗余代码，导致体积变大。

二、怎么减小.xcframework的体积？ #

1. 精简目标架构 #

• 只保留必要的架构：如果你的App不再支持老旧设备（比如armv7），直接在build.gradle.kts中指定仅编译arm64和x86_64即可；甚至可以分开打包真机和模拟器版本，开发阶段用模拟器包，发布时用真机包。

  ios {
    iosArm64("ios")
    iosX64("iosSimulator")
    // 移除iosArm32这类无用目标
  }
  

2. 优化编译配置 #

• 发布用的xcframework一定要用Release模式构建：Release模式会自动进行代码压缩、调试符号剥离，体积会小很多。
• 开启链接时优化（LTO）：让编译器在链接阶段深度优化，剔除死代码，在build.gradle.kts中添加配置：

  kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
      binaries.all {
        freeCompilerArgs += "-Xlto"
      }
    }
  }
  

• 按需开启Bitcode：如果不上架App Store，仅做国内分发，直接关闭Bitcode能节省不少体积：

  binaries.all {
    isBitcodeEnabled = false
  }
  

3. 清理代码和依赖 #

• 删除无用代码与依赖：Kotlin/Native的Release模式默认会做死代码消除，但自己也要检查避免引入冗余依赖——比如只用Coroutines的部分功能，就别引入整个kotlinx-coroutines-core，尽量找轻量替代或按需引入模块。
• 避免过度使用内联函数：内联虽然能提升性能，但用多了会导致代码膨胀，增加二进制体积。

4. 处理资源文件 #

• 将非必要资源移至主App：别把所有资源都塞进KMM库，能放在主App中的就不要打包进xcframework。
• 压缩资源：图片转成WebP格式，精简字符串内容，删除无用的配置文件。

5. 剥离调试符号 #

• 确保Release模式下剥离调试符号：默认会自动处理，但可以手动配置确认：

  binaries.all {
    stripDebugSymbols = true
  }
  

• 调试符号单独存储：如果需要保留调试能力，把.dSYM文件单独保存，不要放进xcframework中。

6. 使用Kotlin/Native优化参数 #

• 添加-Xoptimize编译参数，进一步优化代码生成：

  freeCompilerArgs += "-Xoptimize"
  

• 避免过度序列化：如果只是简单的JSON解析，不要全量使用Serialization库，手动解析能减少生成的代码量。

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