如何通过CMake基于.app生成iOS平台的.ipa安装包

完全可以实现，既支持基于已生成的.app产物二次打包，也可以直接在CMake配置中集成ipa生成逻辑，无需脱离CMake构建流程单独操作。

.ipa文件本质 #

ipa本质是后缀名修改为.ipa的zip压缩包，核心要求是压缩包根目录下存在名为Payload的文件夹，且构建生成的.app bundle完整存放在Payload目录中；如果项目使用Swift开发，还需要在压缩包根目录附带对应平台的SwiftSupport依赖库目录，避免安装后启动闪退。

方案1：基于已生成的.app手动打包 #

如果已经拿到编译好的.app文件，直接执行以下命令即可完成打包：

# 进入.app所在的构建产物目录
cd /path/to/your/build/output
# 创建Payload目录，大小写必须完全匹配
mkdir -p Payload
# 将.app拷贝到Payload目录下
cp -r YourApp.app Payload/
# （可选）Swift项目需要拷贝对应平台的Swift支持库
# cp -r $(xcrun --sdk iphoneos --show-sdk-path)/../../SwiftSupport-iphoneos SwiftSupport
# 压缩为zip包后重命名为.ipa
zip -r YourApp.ipa Payload SwiftSupport
# 清理临时目录
rm -rf Payload SwiftSupport

注意：打包前请确认.app已经使用对应平台的有效证书、描述文件完成签名，否则生成的ipa无法安装到真机。

方案2：CMake配置自动生成ipa #

可以通过CMake自定义目标，在.app编译完成后自动执行打包流程，配置完成后仅需指定构建ipa目标即可直接产出安装包。
示例配置如下（请将YourApp替换为你调用add_executable时定义的实际target名）：

# 配置ipa输出路径
set(IPA_OUT_PATH "${CMAKE_BINARY_DIR}/$<TARGET_FILE_NAME:YourApp>.ipa")

add_custom_target(ipa
    # 创建临时Payload目录
    COMMAND ${CMAKE_COMMAND} -E make_directory "${CMAKE_BINARY_DIR}/Payload"
    # 拷贝编译生成的.app到Payload目录
    COMMAND ${CMAKE_COMMAND} -E copy_directory
        "$<TARGET_BUNDLE_DIR:YourApp>"
        "${CMAKE_BINARY_DIR}/Payload/$<TARGET_FILE_NAME:YourApp>.app"
    # 清理旧的ipa文件
    COMMAND ${CMAKE_COMMAND} -E rm -f "${IPA_OUT_PATH}"
    # 压缩生成ipa
    COMMAND cd "${CMAKE_BINARY_DIR}" && zip -q -r "${IPA_OUT_PATH}" Payload
    # 清理临时文件
    COMMAND ${CMAKE_COMMAND} -E rm -rf "${CMAKE_BINARY_DIR}/Payload"
    # 绑定依赖，确保.app编译完成后才执行打包
    DEPENDS YourApp
    COMMENT "Building ipa package: ${IPA_OUT_PATH}"
)

配置完成后，执行以下命令即可自动完成编译、打包全流程：

cmake --build <你的构建目录> --target ipa --config Release

补充说明 #

• 如果需要产出App Store分发、AdHoc分发的正式签名包，可以将上述自定义命令中的压缩逻辑替换为xcodebuild -exportArchive命令，配合exportOptions.plist完成符合分发要求的ipa导出
• iOS、iPadOS、tvOS平台的打包逻辑完全一致，仅需要保证CMake构建时指定的目标平台正确，生成对应架构的.app即可
• 构建前请正确配置CMake的Xcode签名属性：包括CMAKE_XCODE_ATTRIBUTE_CODE_SIGN_IDENTITY、CMAKE_XCODE_ATTRIBUTE_PROVISIONING_PROFILE_SPECIFIER、CMAKE_XCODE_ATTRIBUTE_DEVELOPMENT_TEAM，避免生成的.app签名无效。

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