Files
jiapuapp/docs/REFERENCE_PROJECT_AUDIT.md
T

29 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 参考 uni-app 工程结构核对
参考工程:`C:\Users\Rain\Desktop\软件\JOB\3dyjsapp`
## 已确认并采纳
- 参考工程是完整的 HBuilderX uni-app 工程,根目录使用 `App.vue``main.js``pages.json``manifest.json``index.html``uni.scss`
- 参考工程的 `manifest.json` 已声明 Vue 3`main.js` 同时保留 Vue 2 与 Vue 3 的条件入口。家谱项目固定使用 Vue 3,因此保留精简的 Vue 3 入口即可。
- 参考工程的 `uni.scss` 直接定义 Sass 变量,而不是在其中使用相对路径导入。家谱项目已按此方式调整:`uni.scss` 是唯一的设计令牌来源。
- 参考工程把页面清单集中在 `pages.json`,家谱项目已用自动审计校验每条路由都有对应页面文件。
## 本项目的对应实现
- `uni.scss`:朱砂红、宣纸暖白、墨色、鎏金等 Sass 令牌。
- `styles/global.scss`:只由 `App.vue` 从根目录引入的全局通用样式。
- `tests/compile-audit.ps1`:校验路由、入口、Sass 引用与模块引用。
- `tests/uni-scss-injection.ps1`:防止在 `uni.scss` 中再次写入会被页面按错误目录解析的相对 Sass 导入。
## 不照搬的部分
- 彩票业务页面、接口、数据模型与大量业务组件。
- 参考工程中的第三方 UI 模块、OAuth 配置和过宽设备权限;家谱 App 按实际功能逐项添加,避免无关权限与凭据进入工程。
## 后续仍需补齐
- 家谱 App 的 Android/iOS 应用图标尺寸与启动图资源。
- 登录后的真实接口配置与测试账号联调。
- HBuilderX 登录后的本地 H5 发行构建及 Android/iOS 云打包验证。