App 版本号管理指南

在开发 App 时，版本号管理是一个不可忽视的环节。合理的版本号管理不仅能帮助开发者追踪版本变化，也能让用户清楚地了解每次更新的内容。本篇文章将详细介绍如何设置和管理 App 的版本号。

---

版本号的格式

通常，版本号采用 语义化版本控制（Semantic Versioning）标准，格式如下：

MAJOR.MINOR.PATCH

• MAJOR（主版本号）： 重大变更或不兼容更新时递增。
• MINOR（次版本号）： 添加新功能但向下兼容时递增。
• PATCH（修订号）： 修复问题或小的改进时递增。

例如：

• 1.0.0 表示第一版正式发布。
• 1.1.0 表示新增了功能但兼容现有版本。
• 1.1.1 表示修复了 Bug 或小幅优化。

---

第一个版本号如何设置

• 1.0.0：常见的正式发布版本。
• 0.1.0：测试版本（Beta 版），发布给少量用户进行试用。
• 0.0.1：非常早期的开发版本，仅供内部测试使用。

建议

如果你的 App 已完成核心功能并准备上线，建议直接以 1.0.0 开始。

---

版本号升级规则

1. 修复 Bug 或小优化：

   • 增加修订号（PATCH）。
   • 示例：1.0.0 → 1.0.1

2. 新增小功能或改进：

   • 增加次版本号（MINOR）。
   • 示例：1.0.0 → 1.1.0

3. 重大改动或不兼容更新：

   • 增加主版本号（MAJOR），次版本号和修订号归零。
   • 示例：1.0.0 → 2.0.0

---

在 iOS 和 Android 项目中设置版本号

iOS 项目（Xcode）

1. 打开项目的 .xcodeproj 或 .xcworkspace 文件。
2. 选择左侧项目名称，进入 General 标签。
3. 找到 Version 和 Build：
   • Version（版本号）： 对应 MAJOR.MINOR.PATCH，例如 1.0.0。
   • Build（构建号）： 用于内部版本管理（例如 1，2，3...）。

Android 项目（Gradle）

1. 打开 android/app/build.gradle 文件。

2. 修改以下字段：

   versionCode 1       // 构建号，每次发布递增
   versionName "1.0.0" // 显示给用户的版本号
   

---

版本号升级策略

1. 内部测试版本：

   • 使用 0.x.x 或带 Beta 标记的版本号。
   • 示例：0.1.0-beta

2. 正式版本：

   • 正式上线时从 1.0.0 开始。

3. 修复和改进：

   • 根据变更内容选择升级 PATCH、MINOR 或 MAJOR。

4. 用户期望管理：

   • 在更新日志中清楚描述每次版本升级的内容，帮助用户了解。

---

注意事项

1. 版本号递增：

   • iOS 和 Android 应用商店要求版本号必须递增，否则无法提交。

2. 区分内部版本和外部版本：

   • 开发阶段可使用内部版本号管理（如 0.x.x），正式发布时使用清晰的版本号。

3. 构建号与版本号分开管理：

   • 构建号（Build）用于开发团队内部追踪，版本号（Version）是用户可见的。

---

总结

合理设置版本号有助于开发团队高效管理产品迭代，也能提升用户的体验和信任。按照语义化版本控制规则，通过 MAJOR、MINOR 和 PATCH 的调整，清晰表达每次更新的意义。希望这篇文章能帮你更好地管理 App 的版本号！