JPWise-app

基于 uni-app 开发的移动办公应用，主要用于 H5 网页部署。

环境要求

• HBuilderX： 3.8.0+ 版本（推荐最新版本）
• Node.js： v16.17.1 版本（推荐使用此版本以确保兼容性）
• Chrome 浏览器： 用于开发调试

必需插件

安装方法： 打开 HBuilderX → 工具 → 插件安装 → 搜索并安装

1. uni-app 编译器 - uni-app 项目编译支持
2. 内置终端 - 运行终端命令行
3. 内置浏览器 - H5 页面预览
4. scss/sass 编译 - 样式预处理器支持 5

   安装完成后重启 HBuilderX 使插件生效

快速开始

1. 安装 Node.js v16.17.1
2. 导入项目 - HBuilderX 中：文件 → 导入 → 从本地目录导入
3. 安装依赖 - 在终端执行：npm install
4. 配置 API - 修改 utils/define.js 中的 baseUrl 地址

运行项目

1. 选择项目根目录
2. 点击 运行 → 运行到浏览器 → Chrome
3. 等待编译完成，Chrome 浏览器自动打开
4. 默认地址：http://localhost:8080

开发调试：

• 按 F12 打开开发者工具
• Ctrl + Shift + M 切换移动设备模式

H5 打包部署

1. 点击 发行 → 网站-PC或-手机H5，等待编译完成
2. 上传 unpackage/dist/build/web 目录下的所有文件到服务器

常见问题

编译失败：

1. 检查 Node.js 版本是否正确
2. 重新安装依赖：npm install
3. 清除 HBuilderX 缓存：工具 → 清除缓存
4. 重启 HBuilderX

页面空白：

1. 检查浏览器控制台错误信息
2. 确认 API 接口地址配置正确

---