MongoDB.app 是如何构建的?update.sh 一键发布流水线完整解读
MongoDB.app 是如何构建的?update.sh 一键发布流水线完整解读
MongoDB.app 是一款主打「下载即用」的 macOS 版 MongoDB 数据库应用:拖进应用程序文件夹双击,菜单栏叶片图标亮起,本地 mongod 服务随即自动启动,完全免去手动安装配置。这篇文章带你完整拆解它的构建方式:先看 200 行 Swift 如何撑起一个菜单栏应用,再逐行解读 update.sh 一键发布流水线的五个步骤——版本号检测、官方二进制下载、xcodebuild 命令行编译、zip 打包与 AppCast 发布帖自动生成,看懂一个 Mac 应用从源码到用户自动更新的完整链路。
项目结构速览:一个 Mac 应用的最小工程
仓库结构非常克制,核心只有三块:
ghaerrb/
├── update.sh # 一键发布流水线脚本(本文主角)
├── README.md # 使用说明与版本规则
├── MongoDB/ # 应用源码
│ ├── AppDelegate.swift # 全部业务逻辑:启动/停止 mongod、菜单栏
│ ├── Info.plist # 版本号、Sparkle 自动更新配置
│ ├── Base.lproj/MainMenu.xib # 界面布局
│ └── Images.xcassets/ # 应用图标资源
├── MongoDB.xcodeproj/ # Xcode 工程与构建 Scheme
└── MongoDBTests/ # 单元测试占位
几个关键事实:
- 业务逻辑全部集中在 AppDelegate.swift 一个文件里;
- 自动更新依赖 Sparkle 框架,通过 Swift Package 锁定在 Package.resolved;
- Info.plist 中
LSUIElement设为true,所以应用没有 Dock 图标,只出现在菜单栏 🍃
版本号规则:数据库版本 + 构建号
项目采用「双版本号」约定,让用户一眼看懂「壳」和「核」各自迭代到哪:
| 组成 | 示例 | 含义 |
|---|---|---|
| 主版本 | 7.0.3 |
跟随内置的 MongoDB 二进制版本 |
| 构建号 | build.2 |
应用自身的迭代号,独立于数据库版本递增 |
当前 Info.plist 中 CFBundleVersion 与 CFBundleShortVersionString 均为 7.0.3-build.2,即内置 MongoDB 7.0.3 的第 2 次应用级构建。
应用本体:200 行 Swift 拉起整个 mongod 服务
AppDelegate 的启动流程只做三件事:创建数据/日志目录、初始化菜单栏、启动 mongod。
核心:把 mongod 当子进程管理
在 AppDelegate.swift#L65-L97 中,startServer() 从应用包内的 Vendor/mongodb/bin 目录找到 mongod 可执行文件,以 Process 子进程方式拉起:
mongod --dbpath ~/Library/Application\ Support/MongoDB/Data \
--nounixsocket --bind_ip 127.0.0.1 \
--logpath ~/Library/Application\ Support/MongoDB/Logs/mongo.log
退出时 stopServer() 调用 task.terminate() 收尾。应用本质上是一个「mongod 进程管理器 + 菜单栏遥控器」,这也解释了为什么发布流水线只需要替换 Vendor 目录下的二进制文件。
菜单栏交互与自动更新
菜单项包括:版本显示、运行状态(端口 27017)、打开日志目录、检查更新、关于、文档与退出。其中「Check for Updates」调用 Sparkle 的 SPUStandardUpdaterController;Info.plist 里 SUScheduledCheckInterval 为 86400——即每天自动静默检查一次更新,更新源正是发布流水线生成的 AppCast。
update.sh 一键发布流水线逐行解读 🚀
update.sh 共 130 余行,用 5 个阶段完成一次完整发版:
| 阶段 | 关键命令 | 产出 |
|---|---|---|
| ① 版本对比 | curl + grep |
判断是否跳过本次发版 |
| ② 下载替换 | curl -o / tar xzf |
最新官方 mongod 二进制 |
| ③ 编译 | PlistBuddy + xcodebuild |
build/Release/MongoDB.app |
| ④ 打包 | zip -r -y |
桌面上的 MongoDB.zip |
| ⑤ 发布帖 + 手动推送 | _posts/release/*.md |
Sparkle 可消费的 AppCast 条目 |
第 1 步:双版本检测与 --force 开关
脚本开头支持 --force 参数强制发版。正常流程下:
- 抓取项目官网页面上的
current-version,用grep -o拆出「数据库版本」CURR_MONGO与「构建号」CURR_BUILD; - 抓取 MongoDB 官方下载页中标记
"current":true的版本号作为VERSION; - 若两者相等且未加
--force,直接打印No need to update :)并退出。
这是典型的幂等设计:脚本可以放心重复执行,不会重复发版。
第 2 步:下载官方二进制并替换 Vendor 目录
- 从 MongoDB 官方 CDN 下载
mongodb-macos-x86_64-$VERSION.tgz到/tmp; - 删除旧的
Vendor/mongodb目录后重建,保证干净替换; tar xvzf解压到/tmp,再将内容移入Vendor/mongodb/;- 清理
/tmp中的压缩包与临时目录。
这一步决定了最终 App 包的大小——整个「应用」其实只是一个壳 + 完整的 MongoDB 二进制。
第 3 步:改版本号 + xcodebuild 命令行编译
RELEASE_VERSION="${VERSION}-build.${NEW_BUILD}"
/usr/libexec/PlistBuddy -c "Set :CFBundleVersion ${RELEASE_VERSION}" MongoDB/Info.plist
/usr/libexec/PlistBuddy -c "Set :CFBundleShortVersionString ${RELEASE_VERSION}" MongoDB/Info.plist
xcodebuild
三个细节值得注意 ⚙️
- 构建号策略:加
--force时构建号在旧值基础上 +1,普通更新则重置为 1; - PlistBuddy 是 macOS 系统自带的 plist 编辑工具,用它精确改版本号,无需打开 Xcode;
- 裸跑
xcodebuild:不带参数时使用 MongoDB.xcscheme 默认配置(Release,Swift 5.0,Bundle ID 前缀io.blimp),产物落在build/Release/MongoDB.app,整条流水线全程终端完成。
第 4 步:zip 打包 + 生成 AppCast 发布帖 📦
cd build/Release && zip -r -y ~/Desktop/MongoDB.zip MongoDB.app,其中-y保留符号链接以减小包体;- 用
du取得 zip 大小FILE_SIZE; - 在
_posts/release/下生成一篇 Front Matter 风格的发布帖,文件名形如2026-10-26-7.0.4-build.1.md,元数据包含version、mongo_version、package_url、package_length四个字段,正文一句话说明本次更新内容。
这篇发布帖会被 gh-pages 静态站点渲染进 appcast.xml——正是 Sparkle 每天访问的更新源。于是第 4 步一次性完成了「可下载产物 + 更新元数据」两件事,用户侧的自动更新链路自动闭合。
第 5 步:打印手动发布清单
脚本最后一段不做任何 git 操作,而是打印「Next steps」清单:
git commit/git tag/git push --tags打版本标签;- 把桌面上的
MongoDB.zip上传到对应 Release 页面; - 切到
gh-pages分支提交发布帖并推送,刷新静态站点。
把「上传二进制」这一不可逆环节留在脚本之外,是发布安全上的常见做法:脚本负责可重复的部分,人负责不可逆的部分。
这套流水线最值得借鉴的 5 个细节
- 幂等 + 强制开关:默认跳过无变更的发版,
--force兜底人工干预; - 双版本号:数据库版本与应用构建号解耦,语义清晰;
- 零 GUI 构建:
PlistBuddy+ 裸xcodebuild,终端里跑完全程; - 干净替换策略:先删后建
Vendor/mongodb,杜绝新旧二进制混杂; - 产物与元数据同步生成:zip 包和 AppCast 条目一次生成,自动更新链路自动闭合。
用户侧彩蛋:PATH 与 Homebrew
对日常使用 MongoDB.app 的开发者,README.md 还给了两个快捷方式:
- 把内置二进制加入 PATH:
export PATH="/Applications/MongoDB.app/Contents/Resources/Vendor/mongodb/bin:$PATH"; - 通过 Homebrew Cask 一键安装:
brew cask install gcollazo-mongodb。
关键文件索引
| 文件 | 说明 |
|---|---|
| update.sh | 一键发布流水线脚本 |
| MongoDB/AppDelegate.swift | 应用全部业务逻辑 |
| MongoDB/Info.plist | 版本号与 Sparkle 更新配置 |
| MongoDB/Base.lproj/MainMenu.xib | 主菜单界面定义 |
| MongoDB.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved | Sparkle 依赖锁定 |
| MongoDB.xcodeproj/xcshareddata/xcschemes/MongoDB.xcscheme | xcodebuild 使用的构建 Scheme |
| MongoDBTests/MongoDBTests.swift | 单元测试占位 |