如何从源码构建与测试OmniWM贡献者开发环境搭建与验证完整清单【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWMOmniWM 是一款免费开源的 macOS 平铺窗口管理器专为 Apple Silicon Mac 打造支持 Niri 风格的滚动容器和 Hyprland 风格的 Dwindle BSP 布局。想为它贡献代码本文带你从零完成 OmniWM 源码构建安装 Xcode 27、一键拉取依赖、编译运行 Dev 版本并用make verify与swift test完成全部验证。一、环境准备构建 OmniWM 的 3 个硬性前提 官方贡献指南要求非常明确详见 CONTRIBUTING.md缺一不可前提最低要求说明硬件Apple SiliconM 系列需原生 arm64 终端不能走 Rosetta系统macOS 26.6 或更高已发布的 OmniWM 应用支持 macOS 26.0但构建需要更新的系统工具链Xcode 27 Swift 6.4Xcode 26.6 只带 Swift 6.3无法编译当前代码另外还需要系统自带的Python 3用于开发工具测试和本地化脚本。⚠️常见踩坑点单独的 Command Line Tools 不能替代完整 Xcode。安装 Xcode 27 后务必在Xcode → Settings → Locations → Command Line Tools中选择它然后在终端执行以下命令确认版本xcrun swift --version输出必须显示Swift 6.4。这些检查逻辑由 Scripts/dev-tools.sh 自动执行版本不达标时make setup会直接报错。二、获取代码克隆仓库并创建分支在 Fork 仓库后克隆你的副本下面以 GitCode 镜像为例git clone https://gitcode.com/gh_mirrors/om/OmniWM cd OmniWM git switch -c my-change main分支名请替换成有描述性的名字。约定俗成每个改动都从main拉新分支且只聚焦一个问题。三、一键安装依赖make setup 做了什么进入仓库后只需一条命令完成全部依赖安装make setup它会自动做三件事目标定义在 Makefile版本与校验和锁定在 Scripts/dev-tools.env下载 GhosttyKit 预编译框架到Frameworks/GhosttyKit.xcframework并校验 SHA-256——你不需要自己编译 GhosttyKit安装锁定版本的 SwiftFormat 0.63.0 和 SwiftLint 0.65.1到仓库内的.cache/dev-tools无需 Homebrew检查签名身份与关键路径并打印 Dev 版/正式版各自的配置文件位置。如果已有依赖且校验通过setup 会直接复用。工具版本变更时只需重新运行 setup 即可自动更新。四、构建与运行make build 与 make run只构建不安装等价于 CI 的构建检查针对 arm64 架构make build构建 打包 签名 安装 启动make runmake run会把你的代码打包为OmniWM Dev.app安装到~/Applications/OmniWM Dev.app并打开。首次启动需在权限窗口为 Dev 版授予辅助功能和输入监控屏幕录制可选用于概览缩略图等截图功能。Dev 版与正式版完全隔离Dev 版使用固定身份com.barut.OmniWM.dev配置和状态存放在独立目录数据正式版Dev 版设置~/.config/omniwm/settings.toml~/.config/omniwm-dev/settings.toml保存状态~/.local/state/omniwm/~/.local/state/omniwm-dev/所以大胆折腾——你的正式环境不受任何影响。改完代码再跑一次make run即可热更。日常开发命令速查命令作用make setup检查前置条件并拉取依赖make doctor只诊断不修改工具、依赖、签名、路径make build仅构建不安装make run构建并切换到 Dev 版make use-dev/make use-release在已安装的两个副本间切换五、验证完整清单提交 PR 前必跑这是新手最容易漏的一步。CI 会分开运行Verify和Tests两个任务定义见 .github/workflows/ci.yml你本地也应该跑齐make verify # 格式检查 SwiftLint 本地化目录 arm64 构建 swift test # 完整串行测试套件⚠️注意make verify不跑测试。对运行时行为有改动的 PR 必须补上swift test涉及并发改动时还要额外跑swift test --parallel。其他场景化检查改了设置/打包/安装脚本→ 追加make test-dev-tools运行 Tests/DevToolingTests 的 Python 工具测试改动了本地化源码文本→make localization-sync重新生成字符串目录动效、焦点、布局等可见行为→ 用文字描述你手动验证过的步骤依赖 GhosttyKit 的实时测试是 opt-in 的例如make test-skylight-live。所有 Swift 文件都会通过 SwiftFormat 强制两行 GPL-2.0 头部运行make format可以自动补齐。六、可选创建本地签名证书 重复开发时建议创建一个自签名证书无需付费 Apple 开发者账号这样 macOS 能在多次重编译后保留 Dev 版权限打开钥匙串访问→证书助理 → 创建证书名称填OmniWM Dev类型选自签名根 代码签名双击证书把代码签名设为始终信任运行make doctor确认身份被识别然后make run。跳过这一步也能构建自动改用 ad-hoc 签名只是每次重建后可能需要重新授权。七、遇到问题从 make doctor 开始排障官方推荐的排障路径是先看make doctor再看失败命令的第一个报错。常见对照Swift 版本不对→ 回 Xcode Locations 选中 Xcode 27再查xcrun swift --version依赖缺失/校验失败→ 运行make setup已有 GhosttyKit 与锁不匹配时它不会覆盖需你手动移走旧框架权限反复请求→ 检查签名身份是否稳定Dev 与正式版权限互不相通切换卡在OmniWM 还在运行→ 先从菜单栏退出正在运行的副本再重试脚本不会强杀进程。结语你的第一份 PR ✅到这里你已经掌握了完整闭环环境自检 →make setup→make run迭代开发 →make verifyswift test双重验证。提交前请附上验证结果含没跑成的检查及原因附上截图或录屏效果更佳。完整规范参考 CONTRIBUTING.md祝构建顺利【免费下载链接】OmniWMFree, open-source tiling window manager for Apple Silicon Macs, with Niri-style scrolling containers and Hyprland-style Dwindle BSP.项目地址: https://gitcode.com/gh_mirrors/om/OmniWM创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考