2025-09-16 05:56:27 +00:00
|
|
|
|
# uni-Identify-quality
|
|
|
|
|
|
|
|
|
|
|
|
一个使用 uni-app 开发并面向微信小程序运行/发布的项目。
|
|
|
|
|
|
|
|
|
|
|
|
## 环境要求
|
|
|
|
|
|
- HBuilderX（推荐使用最新稳定版 3.x）
|
|
|
|
|
|
- 微信开发者工具（最新稳定版）
|
|
|
|
|
|
- Node.js 14+（用于安装依赖）
|
|
|
|
|
|
|
|
|
|
|
|
## 安装依赖
|
|
|
|
|
|
- 在项目根目录执行：`npm i`
|
|
|
|
|
|
|
|
|
|
|
|
## 运行到微信小程序（开发调试）
|
|
|
|
|
|
1. 安装并登录「微信开发者工具」。
|
|
|
|
|
|
2. 在 HBuilderX 中设置「微信开发者工具路径」：偏好设置 -> 运行配置 -> 小程序-微信。
|
|
|
|
|
|
3. 在清单文件中填写微信小程序 AppID：
|
|
|
|
|
|
- 打开并编辑 manifest.json 的「小程序-微信」配置（项目根目录：/Users/fiee/Projects/uni-Identify-quality/manifest.json）。
|
|
|
|
|
|
4. 使用 HBuilderX 菜单：运行 -> 运行到小程序模拟器 -> 微信开发者工具。
|
|
|
|
|
|
5. 重要：运行到微信小程序时，请勾选「运行时压缩代码」（可有效减小包体积并避免部分语法在未压缩下的兼容问题）。
|
|
|
|
|
|
|
|
|
|
|
|
提示：本项目未提供 CLI 形式的 dev/build 脚本，推荐优先通过 HBuilderX 进行运行与打包。
|
|
|
|
|
|
|
|
|
|
|
|
## 打包发布（微信小程序）
|
|
|
|
|
|
1. HBuilderX 菜单：发行 -> 小程序-微信。
|
|
|
|
|
|
2. 产物目录：unpackage/dist/build（首次运行/打包后生成）。
|
|
|
|
|
|
3. 使用微信开发者工具导入构建后的目录进行预览/上传。
|
|
|
|
|
|
|
|
|
|
|
|
## 目录结构（节选）
|
|
|
|
|
|
- pages/：业务页面
|
|
|
|
|
|
- components/：项目业务组件
|
|
|
|
|
|
- http/：请求封装与接口定义
|
|
|
|
|
|
- static/：静态资源
|
|
|
|
|
|
- uni_modules/：uni 官方组件与第三方 uni-module
|
|
|
|
|
|
- uview-ui/：uView 组件库源码
|
|
|
|
|
|
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
- 无法识别「微信开发者工具」：请在 HBuilderX 偏好设置中正确配置开发者工具路径。
|
|
|
|
|
|
- 运行白屏或资源异常：可尝试清理 unpackage 目录后重新运行；检查 manifest 中的 AppID、权限与条件编译配置。
|
|
|
|
|
|
|
|
|
|
|
|
## 依赖说明（节选）
|
|
|
|
|
|
- 运行前确保已安装依赖：`npm i`
|
|
|
|
|
|
- 项目使用部分常用依赖（如 dayjs、lodash、sass 等），由 package.json 管理。
|
