新闻详情

新闻详情

首页 / 资讯中心 / 详情

如何从源码构建与测试OmniWM:贡献者开发环境搭建与验证完整清单

发布时间:2026/11/22 3:35:25来源:尧图网络
如何从源码构建与测试OmniWM:贡献者开发环境搭建与验证完整清单
如何从源码构建与测试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),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

【外设】之大彩串口显示屏 2026/11/21 14:14:45

【外设】之大彩串口显示屏

大彩串口屏初步使用 1 .官网下载 STM32 屏幕 GUI 设计资料 http://www.gz-dc.com/category/typeid/4112 找到 STM32 Keil 工程,移植相关代码因项目而异进行移植,由于项目简单,本人只对用到的指令接口进行修改。 比如:注意事项&…

阅读更多 →
无法下载Windows系统iso文件 2026/11/21 14:14:26

无法下载Windows系统iso文件

当我遇到这个问题的时候,我打开了一个网站: 登录 然后我打算下载的时候: 突然那个官方的连接就可以下载了:

阅读更多 →
【清华代码熊】DeepSeek V4.1 Flash 后训练详解 2026/11/21 21:08:55

【清华代码熊】DeepSeek V4.1 Flash 后训练详解

📌 上期解析了 DeepSeek V4.1 Flash 模型架构改进,本期解析 DeepSeek V4.1 Flash 预训练/后训练技术: 🌟 预训练:45T 文本 多模态混合语料、直接训练 sparse attention(取消 DeepSeek V4 的 dense 冷启动&…

阅读更多 →
Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ... 2026/11/22 1:51:41

Shuffle-R1: Efficient RL framework for Multimodal Large Language Models via Data-centric Dynamic ...

文章主要内容和创新点 主要内容 本文聚焦于多模态大语言模型(MLLM)强化学习(RL)训练中的效率问题,提出了一个名为Shuffle-R1的框架。研究发现,当前RL训练存在两个关键缺陷: 优势值坍缩(Advantage Collapsing):批次中大多数优势值集中在零附近,导致有效梯度信号被淹…

阅读更多 →
PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction 2026/11/21 19:02:25

PRvL: Quantifying the Capabilities and Risks of Large Language Models for PII Redaction

一、文章主要内容总结 本文聚焦于利用大型语言模型(LLMs)实现个人身份信息(PII)脱敏的研究,旨在解决传统脱敏方法(如基于规则的系统、领域特定命名实体识别(NER)模型)泛化能力差、跨格式/跨语境适应性弱的问题。 研究通过全面评估多种LLM架构(包括密集型LLM(D-LLM…

阅读更多 →
LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model 2026/11/21 14:13:11

LLaVA-RE: Binary Image-Text Relevancy Evaluation with Multimodal Large Language Model

文章主要内容和创新点 主要内容 本文聚焦于二进制图像-文本相关性评估任务(判断图像与文本“相关”或“不相关”),针对该任务中文本格式多样、相关性定义随场景变化等挑战,提出了基于多模态大语言模型(MLLM)的解决方案LLaVA-RE。 模型设计:LLaVA-RE基于LLaVA 1.5架构,…

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞 ✉