Skip to main content
如果你要修改 Vibex、审查实现，或你的平台没有现成安装包，可以从源码构建。普通使用者请改用安装页面的发布产物。

​
前置条件

​
获取并运行桌面端

pnpm dev:desktop 会准备开发用图标，然后以调试模式编译并运行 vibex-desktop。首次编译需要较长时间。 只做 Rust 侧检查时可以跳过前端：

​
打包桌面端

Linux 使用 cargo-packager 和随仓库审查的 PDFium 运行时：
三个通道命令分别对应预览 / RC / Stable 三种产品身份，生成的包与运行时二进制属于构建产物，不进入版本库。发布 RC 或 Stable 之前请先阅读仓库中的 docs/operations/release.md。

​
构建 Android

需要 Android SDK/NDK、cargo-ndk，以及目标 ABI 对应的 Rust target。Debug 默认构建 arm64-v8a 与 x86_64，Release 默认只构建 arm64-v8a。
用 VIBEX_MOBILE_ANDROID_TARGETS（空格分隔）可以覆盖 Debug 的 ABI 列表。本地 pnpm package:mobile:android 生成的是未签名的 Release APK，分发前必须自行对齐并签名；打 tag 的 GitHub Release 会由发布流程自动完成签名。

​
构建 iOS

需要 macOS、Xcode、XcodeGen，以及 aarch64-apple-ios 和 aarch64-apple-ios-sim 两个 Rust target。
脚本会构建 VibexFFI.xcframework 并生成 Xcode 工程。代码签名、真机或模拟器选择以及分发凭据都由本机环境管理，不要提交证书或 provisioning profile。

​
本地运行 Relay 与服务端

详细配置见自托管 Relay与自托管无头运行时。

​
提交前检查

pnpm check 汇总 Rust 质量、前端类型与 lint、许可证、UI 分层与视觉基线检查。pnpm release:build-smoke 校验桌面端、移动端和 Relay 的构建图。完整命令清单见构建与测试。