如何自定义生成的IPA文件名？带空格IPA在流水线中的问题

一、流水线处理含空格IPA文件的常见问题 #

• 命令执行失败：Shell脚本默认以空格作为参数分隔符，未加引号的情况下，像cp THIS IS MY APP.ipa target/这类命令会被拆解成多个无效参数，直接抛出错误。即使手动加引号，若流水线脚本未统一处理空格场景，也容易出现遗漏导致流程中断。
• 工具兼容性缺陷：部分CI/CD工具的旧版本插件、第三方打包工具对含空格的文件名支持不足，可能出现文件找不到、归档失败、上传至分发平台时丢失或转义异常等问题。
• 后续流程混乱：分发到测试平台或存储时，空格可能被自动转义为%20，导致下载链接失效；依赖文件名的自动化流程（如版本匹配、发布脚本）也会因格式不符出现逻辑错误。

二、修改IPA文件名为指定格式的方法 #

完全可以将IPA文件名修改为my_app_prod_1_2_1或my_app_dev_1_2_1这类格式，且不会影响App安装后的显示名称（设备上的显示名由CFBundleName控制，与IPA文件名无关）。以下是几种常用实现方式：

1. Xcode命令行打包时直接指定 #

使用xcodebuild打包导出归档文件时，通过-exportPath参数直接设置输出文件名：

xcodebuild -exportArchive \
  -archivePath MyApp.xcarchive \
  -exportPath ./my_app_prod_1_2_1.ipa \
  -exportOptionsPlist ExportOptions.plist

2. Fastlane打包时配置输出名称 #

若使用Fastlane的gym动作打包，直接设置output_name参数：

gym(
  scheme: "MyApp",
  output_name: "my_app_prod_1_2_1",
  export_options: {
    # 其他导出配置
  }
)

3. 打包完成后重命名 #

如果是先按默认规则生成带空格的IPA，可通过Shell命令在流水线中执行重命名：

mv "THIS IS MY APP.ipa" "my_app_prod_1_2_1.ipa"

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