OpenOats完整部署发布指南从构建、代码签名、DMG打包到Homebrew Cask上架【免费下载链接】OpenOatsA meeting note-taker that talks back.项目地址: https://gitcode.com/gh_mirrors/op/OpenOatsOpenOats是一款 macOS 实时会议转录应用能开口回应的会议记录员它在通话旁实时转写双方对话并基于你的笔记给出即时建议。本文是一份面向新手的完整部署发布指南带你走完 OpenOats 从 Swift 源码构建、代码签名Code Signing、公证Notarization、DMG 打包到最终上架 Homebrew Cask 的全部 6 个步骤。跟着做你也能发布自己的 macOS 应用。发布流程总览5 个脚本搞定一切OpenOats 把整套发布流水线封装在了scripts/目录下的几个脚本中这是它最容易上手的地方脚本作用build_swift_app.sh构建 Release 版.app、签名、安装到/Applicationsmake_dmg.sh生成带拖入 Applications布局的 DMG 并公证package_smoke_check.sh校验产物完整性冒烟检查select_xcode_26.sh一键切换 Xcode 26 开发目录update_homebrew_cask.sh自动更新 Cask 的版本号与 sha256注意第二张图并非图片文件上面表格中已说明此处仅保留第一张真实截图用于展示界面效果。第 1 步环境准备最快配置方法发布 OpenOats 需要满足 Package.swift 声明的平台要求️Apple Silicon MacmacOS 15Sequoia 及以上️Xcode 26 / Swift 6.2 如需发布公开版本还需要Developer ID Application 证书App Store Connect 中免费申请仓库中有一个脚本可以帮你自动选中 Xcode 26 的开发目录./scripts/select_xcode_26.sh它会用xcode-select -s指向Xcode_26*.app并打印当前的xcodebuild -version供你核对。第 2 步构建 macOS .app构建 签名一体完成核心命令只有一条./scripts/build_swift_app.shbuild_swift_app.sh 内部依次做了这些事Release 编译执行swift build -c release产出二进制文件组装 .app 包拷贝二进制、Info.plist、图标、Sparkle 自动更新框架并补齐PkgInfo版本注入从最近的 git tag 自动推导版本号并写入CFBundleShortVersionString避免自更新组件误判也可用APP_VERSION1.87.1显式指定代码签名从内到外依次签名 Sparkle 的 XPC 服务、Autoupdate、Updater.app 和主应用使用 OpenOats.entitlements 权限清单安装拷贝到/Applications新手常用技巧本地调试时没有签名证书加两个环境变量即可跳过签名和安装SKIP_SIGN1 SKIP_INSTALL1 ./scripts/build_swift_app.sh第 3 步代码签名与公证Notarization要点签名身份脚本会自动探测优先找Developer ID Application找不到再回退到Apple Development也可以显式传入CODESIGN_IDENTITYDeveloper ID Application: 你的名字 (TEAMID) ./scripts/build_swift_app.shDMG 的公证在 make_dmg.sh 中完成需要同时设置这 3 个环境变量脚本才会提交公证并用stapler staple装订票据环境变量说明APPLE_ID开发者账号 Apple IDAPPLE_TEAM_ID团队 ID6 位大写字母APPLE_APP_PASSWORDApp 专用密码非登录密码 只有完成签名 公证其他用户下载 DMG 时才不会遇到 Gatekeeper 拦截。第 4 步DMG 打包一键生成可分发的安装包构建出dist/OpenOats.app后执行./scripts/make_dmg.shmake_dmg.sh 会生成一个带视觉设计的 DMGFinder 窗口里左侧是 OpenOats.app 图标、右侧是 Applications 文件夹用户拖拽即可完成安装——这是 macOS 发行版最经典的布局。脚本细节用osascript创建 Finder别名而不是符号链接别名的图标显示更美观通过 AppleScript 精确控制窗口大小640×400、图标位置与尺寸先创建临时 UDRW 格式最后用hdiutil convert转为压缩只读的UDZO格式有签名身份时自动对 DMG 本体签名产物位于dist/OpenOats.dmg可直接上传到 Release 页面分发。第 5 步发布前自检两条命令跑通全部测试在把 DMG 交给用户之前强烈建议跑一遍仓库自带的验证脚本# 产物完整性冒烟检查验证二进制、Info.plist、Sparkle 框架、 # tokenizer 回退配置、rpath 是否齐全 ./scripts/package_smoke_check.sh # UI 冒烟测试xcodebuild 构建并执行 UI 测试 ./scripts/run_ui_smoke.shpackage_smoke_check.sh 会检查swift-transformers_Hub.bundle中的 GPT-2 / T5 tokenizer 回退配置是否存在——这些是本地语音模型首次启动时的关键资源漏拷贝会导致应用启动异常。第 6 步上架 Homebrew Cask让用户一条命令安装OpenOats 的 Cask 定义文件是 Casks/openoats.rb关键配置包括version与sha256对应 Release 中 DMG 的版本和校验值url指向OpenOats.dmg下载地址livecheck使用:github_latest策略自动探测新版本depends_on macos: :sequoia声明最低系统要求zap段卸载时彻底清理~/Library下的缓存与偏好文件每次发版只需两步# 1. 计算新 DMG 的 sha256 shasum -a 256 dist/OpenOats.dmg # 2. 一键更新 Cask 文件 ./scripts/update_homebrew_cask.sh 1.87.2 sha256update_homebrew_cask.sh 会用 Ruby 正则精确替换 Cask 文件中的version和sha256两行其余配置保持不动避免手工编辑出错。用户侧的安装体验brew tap yazinsai/openoats brew install --cask yazinsai/openoats/openoats常见问题FAQQ1构建报 no git tag found 警告版本号是从 git tag 推导的。请给当前发布提交打上 tag如v1.87.2或用APP_VERSION环境变量手动指定。Q2security find-identity找不到签名身份说明本机没有 Developer ID 证书。个人开发者可在 Apple Developer 计划中创建临时调试请用SKIP_SIGN1跳过。Q3Sparkle.framework 找不到它是通过 Package.swift 中的依赖拉取的确认构建日志中没有依赖解析错误即可。写在最后回顾整条流水线环境准备 →build_swift_app.sh构建签名 →make_dmg.sh打包公证 → 冒烟自检 → 更新 Cask 发版。得益于仓库把签名顺序、版本注入、DMG 布局这些繁琐细节全部脚本化即使是第一次发布 macOS 应用的开发者也能在 10 分钟内走完整个流程。祝你的第一个 Release 顺利发布【免费下载链接】OpenOatsA meeting note-taker that talks back.项目地址: https://gitcode.com/gh_mirrors/op/OpenOats创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考