解密MongoDB.app版本编号规则:App版本如何对应捆绑的MongoDB
解密MongoDB.app版本编号规则:App版本如何对应捆绑的MongoDB
MongoDB.app 是一款让 Mac 用户"拖进应用程序文件夹即可使用"的菜单栏应用,其版本编号采用 X.Y.Z-build.N 格式:前半部分 X.Y.Z 精确对应 App 内部捆绑的 MongoDB 服务端版本,后半部分 build.N 则是 App 自身的独立构建号。看懂这个规则,你只需瞥一眼版本号,就知道这台 Mac 上跑的是哪个版本的 MongoDB。🍃
版本号格式解读:X.Y.Z-build.N 两段各是什么意思
以当前仓库 MongoDB/Info.plist 中的实际值为例:
| 字段 | 当前值 | 含义 |
|---|---|---|
CFBundleShortVersionString |
7.0.3-build.2 |
App 对外显示的"人话"版本号 |
CFBundleVersion |
7.0.3-build.2 |
App 内部构建标识 |
把 7.0.3-build.2 拆开看,规则一目了然:
7.0.3(三段式主体):App 内捆绑的mongod二进制文件版本。也就是说,App 版本 7.0.3-build.2 里跑的 MongoDB 服务端,和官方发布的 MongoDB 7.0.3 是同一份内核。-build.2(构建号):App 自身的第几次构建,与捆绑的 MongoDB 版本无关。它用于同一份 MongoDB 内核下,App 代码有修复或调整时再发版,而无需"假升" MongoDB 版本号。
💡 一句话记忆:主体版本跟着 MongoDB 走,build 号跟着 App 自己走。
这个设计理念在 README.md 中有官方说明:
Version numbers of this project try to communicate the included version of the included mongoDB binaries bundled with each release. The build number is independent from the bundled mongoDB's version.
版本如何写入:update.sh 发布脚本的三个关键步骤
版本号并非手工填写,而是由仓库根目录的 update.sh 脚本在每次发版时自动生成。它的核心流程分三步:
第一步:获取 MongoDB 官方最新生产版本
脚本会访问 MongoDB 官方下载中心,抓取标记为 "current":true 的生产版本(例如 7.0.3),并与 App 当前捆绑的版本比对——相同则直接提示 "No need to update",节省一次无意义构建。
第二步:下载并捆绑 mongod 二进制
确定新版本后,脚本从官方 CDN 下载对应的 macOS 发行包,解压后统一放入 Vendor/mongodb 目录。App 运行时正是从这个目录启动服务的,MongoDB/AppDelegate.swift 中对应代码为:
Bundle.main.path(forResource: "mongod", ofType: "", inDirectory: "Vendor/mongodb/bin")
第三步:生成版本号并写回 Info.plist
这是理解 build 号规则最关键的部分,脚本逻辑如下:
- 捆绑的 MongoDB 版本发生变化时:
NEW_BUILD=1,即 build 号重置为 1; - MongoDB 版本没变、但强制重新构建(
--force参数)时:NEW_BUILD=$((CURR_BUILD + 1)),即 build 号累加 1。
最终拼出发布版本号并写入 MongoDB/Info.plist:
RELEASE_VERSION="${VERSION}-build.${NEW_BUILD}"
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion ${RELEASE_VERSION}" MongoDB/Info.plist
所以你能这样解读历史版本:
7.0.3-build.1→ 首次捆绑 MongoDB 7.0.3 的 App 构建;7.0.3-build.2→ 仍捆绑 MongoDB 7.0.3,但 App 本身做了第二次构建(如修复、适配);7.1.0-build.1→ 升级到 MongoDB 7.1.0,build 号重新从 1 开始计。
版本号在应用中的呈现位置
版本号写入 Info.plist 后,会在两处直接面向用户:
- 菜单栏状态图标:App 以菜单栏形式常驻(
LSUIElement开启,不占 Dock),点击叶子图标后,菜单首项直接显示MongoDB v7.0.3-build.2。该值由 MongoDB/AppDelegate.swift 读取CFBundleShortVersionString后拼接生成,无需手动查询。 - 自动更新提示:App 内置 Sparkle 自动更新框架,升级时会按 AppCast 中登记的版本号推送新版,你看到的更新提示同样遵循这套编号规则。
另外,App 的用户数据存放在 ~/Library/Application Support/MongoDB/ 下的 Data 与 Logs 子目录,由 MongoDB/AppDelegate.swift 的 createDirectories() 在首次启动时自动创建——按目录隔离数据,让不同版本的 App 各用各的,避免数据格式互相干扰。
MongoDB.app 版本编号常见疑问
Q1:build 号变大,说明 MongoDB 升级了吗?
没有。build.N 只表示 App 自身的第 N 次构建。MongoDB 是否升级,只看 X.Y.Z 主体部分是否变化。
Q2:为什么主体版本号与 MongoDB 官方版本号完全一致? 因为脚本直接取用官方生产版本号作为主体,不做任何加工。这样用户无需查文档,仅凭 App 版本号就能确认捆绑内核的确切版本,排查兼容性问题时一目了然。
Q3:如何确认我安装的 MongoDB.app 捆绑了哪个 MongoDB?
三种方式任选其一:菜单栏点开 App 图标看首项版本;查看 App 信息中的版本字段;或直接执行捆绑的 mongod --version,路径位于 /Applications/MongoDB.app/Contents/Resources/Vendor/mongodb/bin。
Q4:项目工程文件在哪里? Xcode 工程为 MongoDB.xcodeproj/project.pbxproj,应用源码在 MongoDB/ 目录,测试在 MongoDBTests/MongoDBTests.swift。
小结:一张速查表看懂版本规则
| 场景 | 版本号变化 | 例子 |
|---|---|---|
| MongoDB 大/小版本升级 | 主体变,build 归 1 | 7.0.3-build.2 → 7.1.0-build.1 |
| App 自身修复、MongoDB 不变 | 主体不变,build +1 | 7.1.0-build.1 → 7.1.0-build.2 |
版本未变重新构建(--force) |
同上,build +1 | 用于紧急补丁发布 |
核心结论:MongoDB.app 的版本号 = 「捆绑 MongoDB 版本」+「App 独立构建号」。主体部分忠实映射官方 MongoDB 版本,build.N 提供 App 层面的迭代粒度,两者正交、互不干扰——这正是 update.sh 自动化发版流程所保证的规则一致性。✅