从代码到桌面：Hidden Bar超轻量级菜单栏工具的完整分发之路

你是否也曾被Mac菜单栏上密密麻麻的图标搞得眼花缭乱？作为开发者，如何将一个提升用户体验的小工具从代码顺利送到用户手中？本文将以Hidden Bar（一款超轻量级MacOS菜单栏图标管理工具）为例，带你走完从开发配置到用户安装的全流程，学会如何打造既安全又易用的分发方案。

开发环境与项目结构

Hidden Bar采用Xcode开发环境，项目结构清晰分离了主应用与启动器组件。核心配置文件集中在项目根目录与hidden子目录下，其中：

• 项目配置核心：[Hidden Bar.xcodeproj/project.pbxproj](https://gitcode.com/gh_mirrors/hi/hidden/blob/17fc054313ab1a006a2a93e68f169a7ae8c76212/Hidden Bar.xcodeproj/project.pbxproj?utm_source=gitcode_repo_files) 定义了编译目标、依赖关系和构建设置
• 应用元数据：hidden/Info.plist 包含关键配置，如LSUIElement设为true使应用仅显示菜单栏图标，LSMinimumSystemVersion指定最低支持macOS High Sierra(10.13)
• 本地化支持：提供10种语言的本地化字符串文件，如hidden/zh-Hans.lproj/Localizable.strings实现中文界面

编译与签名流程

关键构建设置

在Xcode中，需配置以下关键项确保应用可分发：

1. 代码签名：在项目设置中指定开发者账号，启用"Automatically manage signing"
2. 构建设置：
   • CODE_SIGN_IDENTITY：设置为"Developer ID Application"用于Mac App Store外分发
   • ENABLE_HARDENED_RUNTIME：启用强化运行时保护
   • OTHER_CODE_SIGN_FLAGS：添加--options=runtime确保符合苹果安全要求

编译产物结构

成功编译后生成的.app文件包含：

• 可执行文件：Contents/MacOS/Hidden
• 资源文件：Contents/Resources存放图片和本地化字符串
• 权限文件：hidden/Hidden.entitlements声明应用权限

多渠道分发策略

Hidden Bar采用三种互补的分发方式，满足不同用户需求：

1. Mac App Store（官方推荐）

通过App Store分发可获得苹果官方审核保障和自动更新支持：

• 提交前需通过Application Loader上传构建
• 需准备截图、描述和隐私政策PRIVACY_POLICY.md
• 用户可直接在App Store搜索"Hidden Bar"下载

2. Homebrew Cask（开发者首选）

为技术用户提供命令行安装方式：

brew install --cask hiddenbar

维护Cask文件需指定正确的下载URL和校验哈希，确保安装包完整性。

3. 手动下载（通用方案）

在GitHub Releases页面提供.zip格式的应用包：

1. 压缩已签名的.app文件
2. 生成SHA256校验值
3. 上传到GitCode仓库发布页面
4. 在README.md中提供下载链接和版本信息

安装与使用引导

标准安装流程

用户获取应用后的安装步骤：

1. 下载压缩包并解压
2. 将Hidden Bar拖入Applications文件夹
3. 首次启动时可能需要右键点击并选择"打开"（绕过未知开发者限制）
4. 按住Command键拖动菜单栏图标调整位置

使用演示

基础操作通过拖放即可完成：

• 点击菜单栏箭头隐藏/显示图标
• 按住Command键拖动图标排序
• 在偏好设置中配置自动隐藏规则

版本更新与维护

版本控制策略

遵循语义化版本规范：

• 主版本号：重大功能更新（如1.0.0到2.0.0）
• 次版本号：新增功能（如1.1.0添加快捷键支持）
• 修订号：bug修复（如1.0.1修复崩溃问题）

版本号在hidden/Info.plist中通过CFBundleShortVersionString(显示版本)和CFBundleVersion(内部版本)控制。

贡献指南

社区贡献流程在CONTRIBUTING.md中有详细说明：

• 使用git-flow工作流，分支命名遵循feature/add-something或bugfix/fix-something格式
• 提交PR前需测试所有现有功能不受影响
• 通过代码审查后合并到develop分支

分发检查清单

发布前确保完成：

• [ ] 代码签名验证：codesign -vvv --deep --strict Hidden.app
• [ ] 公证状态检查：spctl -a -vvv Hidden.app
• [ ] 压缩包大小优化（当前约3MB，保持超轻量特性）
• [ ] 更新所有分发渠道的版本信息
• [ ] 验证README.md中的下载链接和安装说明

通过这套完整的分发流程，Hidden Bar已成功服务全球数万用户，保持着简洁高效的产品特性。无论是个人开发者还是团队，都可以借鉴这套方案，让自己的Mac应用顺利到达用户手中。

项目地址：https://gitcode.com/gh_mirrors/hi/hidden