参考资料/开发规范

长文档建议按当前分组逐页阅读；右侧辅助栏会保留当前位置和快速操作。

开发与构建

本页覆盖本地开发、构建规则、发布注意事项和 iOS 侧载安装流程。

环境准备

Node.js 20+ 与 npm。
Rust stable（建议 1.78+）与 Tauri 2.x。
Android 构建需要 Android SDK/NDK。
iOS 构建需要 macOS + Xcode。

目录结构速览

tauri-app/
  src/                # Vue UI
  src/utils/axios_adapter.js
  src-tauri/
    src/http_client/  # 业务网络层
    src/modules/      # 业务模块
    src/http_server.rs
    src/lib.rs
    src/main.rs

新增功能流程

在 src-tauri/src/modules 新增业务逻辑。
在 src-tauri/src/lib.rs 注册 Tauri Command。
前端通过 axios_adapter 新增 /v2 映射。
补充缓存、降级和错误处理路径。

质量与安全规范

禁止在日志中输出密码、token、cookie。

避免 unwrap / expect，统一返回 Result。

请求失败必须给出可读错误信息。

Bridge 默认仅监听本地回环。

高频接口需要限频与缓存。

新增接口必须给出输入输出示例。

iOS 侧载安装流程（iLoader + LiveContainer + SideStore）

目标文件：Mini-HBUT_<version>_iOS.ipa（GitHub Release 提供）。

先完成 SideStore 安装、Apple ID 绑定与证书信任。
在 SideStore 安装 LiveContainer 与 iLoader。
把 IPA 传到 iPhone（文件 App / AirDrop / 网盘）。
在 iLoader 中选择 IPA，完成导入与签名安装。
回到 SideStore 刷新签名，再启动 Mini-HBUT。

常见问题排查：

“无法验证完整性”：重新信任证书并刷新 SideStore。
“AFC invalid pairing”：重新做手机和电脑配对。
出现 localhost 开发地址报错：请使用最新 Release IPA，不要用 dev 包。

推荐阅读路径

相关文档

当前页面读完后，可以按下面的交叉链接继续。用户文档、开发者文档、故障排查、参考资料和历史文档会互相补充。

开发者总览

回到开发者阅读路径。

结合质量门禁和发布流程。

安全与隐私

结合敏感信息和权限边界。

返回索引。