我应该为 CFBundleVersion 和 CFBundleShortVersionString 使用什么值？

CFBundleShortVersionString 为您提供应用程序的版本。它通常会在您每次将应用发布到 App Store 时递增。这是在应用程序的 App Store 页面的“版本”部分可见的版本。

CFBundleVersion 为您提供用于开发和测试的内部版本号，即“技术”目的。最终用户很少对内部版本号感兴趣，但在开发过程中，您可能需要了解每个版本正在开发和修复的内容。这通常在内部发布的每次迭代中增加。您可以使用 Jenkins 等持续集成工具在每次构建时自动增加内部版本号。

https://i.stack.imgur.com/HNrrs.jpg

这两个数字不相互依赖，但最好保持它们平行以避免混淆。请记住，一旦您的应用程序通过了 App Store 审核，无论您是否发布它，您都需要像 Phil 和 likeTheSky 所说的那样增加内部版本号。

用例：假设您有一个经过良好测试的构建，可以提交。它的版本号是 1.0.0，内部版本号是 1.0.0.32。提交应用后，您需要将版本更新为 1.0.1，内部版本号更新为 1.0.1.0。

---

可以这样想：“短版”(CFBundleShortVersionString) 是公共版本号。 “版本” (CFBundleVersion) 更像是一个内部版本号，它可能比公开的“短版本”更频繁地更改。就我个人而言，我对两者都使用相同的，但很多人在每次构建时都会更新“版本”。无论哪种方式，您通常会在向 Apple 发布时更新“短版”。您更新“版本”的频率取决于您和您的需求。

---

answer by rmaddy 是正确的。我再补充两点。

第三版号

请注意第三个版本号，它在 iTunesConnect 网站上作为应用程序定义的一部分指定。如果该数字与 Xcode 中的两个不同，Apple 会给您一个警告。您可以忽略警告，因为它不是显示停止器（不是“错误”）。

日期时间作为版本

此外，您不需要使用三个带标点符号的数字。这可能对某些应用程序有意义，传统上第一个数字的变化表明某种戏剧性的变化通常会影响兼容性。

对于其他应用程序，您可能只想使用 ISO 8601 标准格式样式 (YYYYMMDDHHMM) 的日期时间值。例如，201606070620。年-月-日-时-分的顺序呈现一个不断增加的数字，由于填充零，其长度始终相同，按字母顺序排序时也是按时间顺序排列的。

我已经在 iOS 7、8 和 9 中运行的正在发布的 iOS 应用程序上成功使用了这种类型的版本号。

您甚至可以自动生成此值。在您项目的 Target > Build Phases > Run Script 面板：

在 Shell 字段中指定：/bin/sh 粘贴以下 5 行脚本，如下所示。 （可选）选中 Show environment variables in build log 复选框。取消选中仅在安装时运行脚本复选框。

每次构建时，都会捕获 UTC 时区中的当前日期时间。脚本中的 -u 标志使用 UTC 而不是您当前的默认时区。通常最适合程序员和系统管理员在 UTC 而不是本地时区中使用和思考。

#!/bin/bash
buildNumber=$(date -u "+%Y%m%d%H%M")
/usr/libexec/PlistBuddy -c "Set :CFBundleShortVersionString $buildNumber" "$INFOPLIST_FILE"  # Version number
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion $buildNumber" "$INFOPLIST_FILE"  # Build number
echo "DateTime for app version number: $buildNumber"

或者做一个混合，使用传统的 1.2.3 作为版本号和日期时间作为内部版本号。要进行混合，只需在前面加上 # 注释掉 CFBundleShortVersionString 行。

---

对我来说最明智的方案是使用版本号（即CFBundleShortVersionString）作为实际版本号，然后使用内部版本号（即CFBundleVersion）表示提交到App Store。因此，除非有任何问题并因此重新提交，否则此数字始终为 1。对于新版本，如果之前的版本在 TestFlight 测试或审核中出现问题，我会将其重置为 1。

内部版本号提供了一种命名您为特定版本提供的每个提交的方法。如上述定义中所述，您为应用的特定版本提供的所有构建的集合称为该版本的“发布火车”。对于 iOS 应用程序，内部版本号在每个发布系列中必须是唯一的，但它们不需要在不同的发布系列中是唯一的 [我的重点]。也就是说，对于 iOS 应用程序，如果您愿意，您可以在不同的发布序列中再次使用相同的内部版本号。

从 Technical Note TN2420: Version Numbers and Build Numbers。

---

我使用 CFBundleVersion 来指示 CFBundleShortVersionString 的内部构建。我使用试飞来为我的测试人员提交构建，因此它们之间的差异非常有用。

苹果文件说 CFBundleVersion “应该是一个由 3 个非负的、以句点分隔的整数组成的字符串”但实际上它可以是超过 3 个部分（如上面的答案所示）。我用它来表示我的开发版本，比如我的 CFBundleShortVersionString 是 1.0.0，我可以使用 1.0.0.11 表示 CFBundleVersion 来表示这是我发布 1.0.0 的第 11 个版本

提交到应用商店的每个 CFBundleVersion 都应该比以前大，否则你会得到 ERROR ITMS-90478: "Invalid Version. The build with version "xxx" can't import because a later version has been closed for new build submissions. 选择不同的版本号。”

CFBundleShortVersionString 只能有 3 个部分，否则您将收到错误 ITMS-90060：Info.plist 文件中键 CFBundleShortVersionString 'xxx' 的值必须是最多三个非负整数的句点分隔列表。”

Basil Bourque 提到的第三个数字，即 iTunesConnect 上显示的版本号是事情可能变得复杂的地方。

我使用与 CFBundleShortVersionString 不同的 iTunesConnect 编号，因为当我第一次将我的应用提交到应用商店时，我们已经有很多轮内部发布。所以我使用 1.0 作为 iTunesConnect 编号，使用 5.x 作为 CFBundleShortVersionString。在应用商店的下一个版本中，我提供了一个功能来检查应用商店中是否有更新的版本，并意识到我现在遇到了麻烦，因为我只能获得 iTunesConnect 号码（使用 http://itunes.apple.com/lookup?bundleId=）所以我需要做一些计算来在将其与 CFBundleShortVersionString 编号进行比较之前。

我试图通过使用 iTunesConnect 号码作为我的 CFBundleShortVersionString 来解决这个问题，但得到了错误，错误 ITMS-90062：“此捆绑包无效。Info.plist 文件中键 CFBundleShortVersionString [xxx] 的值必须包含比该版本更高的版本先前批准的版本 [xxx]。”

因此，我建议始终使它们相同。

---

截至目前，the Apple documentation for CFBundleVersion 指出 [强调我的]：

标识捆绑包迭代的构建版本。 ...这个键是一个机器可读的字符串，由一到三个以句点分隔的整数组成，例如 10.14.1。该字符串只能包含数字字符 (0-9) 和句点。 ...您可以包含更多整数，但系统会忽略它们。

对于 CFBundleShortVersionString [强调我的]：

捆绑包的发行版或版本号。 ...此键是捆绑版本的用户可见字符串。所需格式为三个以句点分隔的整数，例如 10.14.1。该字符串只能包含数字字符 (0-9) 和句点。

我建议为每个构建（或 TestFlight 的每个版本）自动增加 CFBundleVersion，并在您更改 CFBundleShortVersionString 时将其重置为 0。

您应该明确计划或设计一致的方法来更新 CFBundleShortVersionString 中的用户可见版本。

---

我从未在任何地方讨论过的问题是 CFBundleVersion 中每个字段的最大数量是多少？

通过将应用程序中的 CFBundleVersion 设置为 1.1.1 并查看“lsregister -dump”中版本的十六进制值，我确定第一个字段的最大值为 (2^22)-1 或 4194303，最大值第二个和第三个字段的值为 (2^21)-1 或 2097151。

3 个字段加起来为 64 位。

这对我们这些根据日期和时间使用 CFBundleVersion 的人来说是有影响的。

我将第一个字段设置为 YYYYMMDD。这总是大于允许的最大版本，并且会导致不可预知的结果，至少可以说，当启动服务决定运行哪个版本的应用程序时，当您安装了多个版本并使用类似 'open -a Appname ' 从命令行。

请广泛传播。我相信很多人都会对此感到困惑。

---