工具链
DearOreUI 周边的开发工具与自动化:运行时构建、发布产物、App 设计器、文档站部署。这一页回答”从哪里拿到东西、怎么让链路自动跑起来”。
运行时构建与发布
发布版从 Releases 下载,产物是 DearOreUI-windows-x64.zip(内含 DearOreUI.dll)。
需要改源码时本地构建,工具链要求:
| 依赖 | 要求 |
|---|---|
| 操作系统 | Windows x64 |
| xmake | 最新稳定版 |
| 编译器 | Visual Studio(含 Clang-CL)或 LLVM |
| LeviLamina | 26.10.x 客户端开发包 |
git clone https://github.com/copper-lamp/Dear-OreUI.git
cd DearOreUI
xmake repo -u
xmake f -a x64 -m release -p windows --target_type=client -y
xmake -v -y构建产物在 bin/,DearOreUI.dll 即模组本体,安装步骤见安装与构建。
发布流程与手动触发说明见 DearOreUI/docs/RELEASE.md 与 docs/release-workflow-manual-trigger.md。
外部 Mod 开发
外部 Mod 通过 DearOreUI 公开 API 集成。两种接入方式:
- 纯 C bridge 导出(推荐):
DearOreUI_QueryApi,不链接 import library,运行时探测;示例见 dearoreui-ExampleMod 的loadBridge()。 - C++ 头文件:
#include "api/IDearOreUIApi.h"等公开头,需要DearOreUI的头文件与依赖。
在 tooth.json 声明依赖:
"dependencies": {
"github.com/copper-lamp/Dear-OreUI": "0.1.*"
}详见在你的模组中使用 的「第一步:声明依赖」。
App 设计器
App/ 是基于 Tauri 2 的离线 OreUI 设计器,当前处于基础工程阶段(Rust + Vite + TypeScript),按 DearOreUI 的资源协议生成 HTML/CSS/JS。
现状:工程骨架已就绪,导出流程对接运行时契约中。设计器产出应可直接用于 registerOverlay / registerComponent。
文档站部署
Web 文档站(本页所属站点)是独立仓库,Next.js 15 + Nextra 4,output: 'export' 静态导出。推送后由 GitHub Actions 自动构建并发布到 GitHub Pages。
push(仓库默认分支)
▼
GitHub Actions(deploy-pages.yml)
├─ pnpm install --frozen-lockfile
└─ pnpm build(→ out/)
▼
upload-pages-artifact → deploy-pages
▼
https://copper-lamp.github.io/dearoreui-docs/本地预览:pnpm dev;构建校验:pnpm build(产物在 out/)。