实用教程

Bundle ID、版本号和构建号:上传 IPA 时该改哪一个?

用 1.2.0(18)的例子区分应用身份、面向用户的版本与一次具体构建,避免改错字段。

核对日期 ·EasyIPA

01

Bundle ID 标识哪个应用

Bundle ID 是应用标识,例如 com.example.reader;版本号是 CFBundleShortVersionString,构建号是 CFBundleVersion。Apple 会依据包内的 Bundle ID 和版本信息关联应用与版本记录。先检查构建配置和导出的 IPA 信息,不要根据文件名 reader-final.ipa 推断其真实身份。已有应用的正常更新不应随意更换 Bundle ID。

02

同一版本修复问题,更新构建号

假设准备发布版本 1.2.0,已上传构建 18。修复一个问题后仍属于 1.2.0,下一份包可使用构建 19。让构建工具在编译、归档与导出前设置新值,重新生成包,再检查 App Store Connect 显示的信息。只把文件从 app18.ipa 改名为 app19.ipa,不会改变包内构建号;也不应直接篡改已签名包来改版本。

03

发布新版本,核对平台和版本记录

准备向用户发布 1.3.0 时,在项目中设置相应版本,并核对 App Store Connect 中准备提交的平台和版本记录。iOS、macOS 等平台可能有各自的发布节奏,记录时一并注明平台,不要把其他平台的版本误当成当前包。团队应约定构建编号方式并避免多人使用同一编号上传。

04

重复构建报错时的交接方法

把错误中的版本与构建号,同包内值、App Store Connect 历史构建和 CI 日志对照。交给开发者的最小信息应是 Bundle ID、平台、版本、构建号、上传时间和原始错误。确认是否重复后再重新构建,不要靠切换上传工具反复试。EasyIPA 负责上传已有 IPA,版本与签名应由生成包的流程保证。

官方参考

Set the version number and build string Upload builds
← 教程与动态