uni-Identify-quality/README.md
2025-09-16 13:56:27 +08:00

2.0 KiB
Raw Blame History

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 管理。