MongoDB.app 是如何构建的?update.sh 一键发布流水线完整解读

原创2026-10-26 11:18:271,371 阅读

MongoDB.app 是如何构建的?update.sh 一键发布流水线完整解读

MongoDB.app 是一款主打「下载即用」的 macOS 版 MongoDB 数据库应用:拖进应用程序文件夹双击,菜单栏叶片图标亮起,本地 mongod 服务随即自动启动,完全免去手动安装配置。这篇文章带你完整拆解它的构建方式:先看 200 行 Swift 如何撑起一个菜单栏应用,再逐行解读 update.sh 一键发布流水线的五个步骤——版本号检测、官方二进制下载、xcodebuild 命令行编译、zip 打包与 AppCast 发布帖自动生成,看懂一个 Mac 应用从源码到用户自动更新的完整链路。

MongoDB.app 应用图标,构建流水线最终产出的 MongoDB.app 应用图标

项目结构速览:一个 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 参数强制发版。正常流程下:

  1. 抓取项目官网页面上的 current-version,用 grep -o 拆出「数据库版本」CURR_MONGO 与「构建号」CURR_BUILD;
  2. 抓取 MongoDB 官方下载页中标记 "current":true 的版本号作为 VERSION;
  3. 若两者相等且未加 --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」清单:

  1. git commit / git tag / git push --tags 打版本标签;
  2. 把桌面上的 MongoDB.zip 上传到对应 Release 页面;
  3. 切到 gh-pages 分支提交发布帖并推送,刷新静态站点。

把「上传二进制」这一不可逆环节留在脚本之外,是发布安全上的常见做法:脚本负责可重复的部分,人负责不可逆的部分。

这套流水线最值得借鉴的 5 个细节

  1. 幂等 + 强制开关:默认跳过无变更的发版,--force 兜底人工干预;
  2. 双版本号:数据库版本与应用构建号解耦,语义清晰;
  3. 零 GUI 构建:PlistBuddy + 裸 xcodebuild,终端里跑完全程;
  4. 干净替换策略:先删后建 Vendor/mongodb,杜绝新旧二进制混杂;
  5. 产物与元数据同步生成: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 单元测试占位
登录后查看全文
ghaerrb