ruoyi-uniapp

### RuoYi-uniapp 项目介绍 RuoYi-uniapp 是基于 RuoYi 框架的跨平台移动应用开发项目，结合了 uni-app 和 RuoYi 后端框架的优点。它支持多端运行（如微信小程序、H5、App 等），旨在为开发者提供一个高效、统一的开发解决方案[^1]。 #### 项目结构 RuoYi-uniapp 的项目结构与传统的 RuoYi 项目类似，但前端部分使用了 uni-app 技术栈，后端部分仍然基于 Spring Boot 和 MyBatis-Plus。以下是其主要目录结构： ```plaintext ruoyi-uniapp/ ├── ruoyi-admin/ # 后端模块 │ ├── src/main/java/com.ruoyi/ # 后端 Java 源代码 │ ├── src/main/resources/ # 配置文件 │ └── pom.xml # Maven 配置文件 ├── ruoyi-uniapp-front/ # 前端 uni-app 模块 │ ├── components/ # 自定义组件 │ ├── pages/ # 页面视图 │ ├── static/ # 静态资源 │ ├── App.vue # 主应用入口 │ └── main.js # 入口文件 └── README.md # 项目说明文档 ``` #### 使用教程 ##### 1. 环境准备 在开始开发之前，请确保已安装以下工具和环境： - Node.js（建议版本 >= 14.x） - npm 或 pnpm - JDK（建议版本 >= 1.8） - Maven（建议版本 >= 3.5） - 数据库（MySQL） ##### 2. 下载源码 可以通过以下方式获取 RuoYI-uniapp 源码： - GitHub 地址：[https://github.com/your-repo/ruoyi-uniapp](https://github.com/your-repo/ruoyi-uniapp)（请替换为实际地址）[^1]。 - 如果需要国内镜像，可以参考 Gitee 地址：[https://gitee.com/your-repo/ruoyi-uniapp](https://gitee.com/your-repo/ruoyi-uniapp)。 ##### 3. 安装依赖 进入项目根目录后，分别安装前后端依赖： ```bash # 安装后端依赖 cd ruoyi-admin mvn clean install -Dmaven.test.skip=true # 安装前端依赖 cd ../ruoyi-uniapp-front pnpm install ``` 注意：如果网络较慢，可参考御道源码中的优化方法，通过更换 npm 源加速依赖安装[^3]。 ##### 4. 启动服务 启动后端服务： ```bash cd ruoyi-admin mvn spring-boot:run ``` 启动前端服务： ```bash cd ruoyi-uniapp-front pnpm run dev ``` ##### 5. 配置接口 在 `ruoyi-uniapp-front` 目录下的 `config/dev.env.js` 文件中配置后端接口地址： ```javascript module.exports = { API_BASE_URL: 'http://localhost:8080' }; ``` #### 注意事项 - 初次加载 Maven 依赖时可能会比较慢，具体取决于网络情况[^2]。 - 如果需要连接到 RuoYi Cloud 后端，请参考 Uni-App 连接 RuoYi-Cloud 的相关文档[^4]。 --- ### 示例代码 以下是一个简单的示例代码，展示如何在 uni-app 中调用后端接口： ```javascript export default { methods: { async fetchProductList() { const res = await this.$http.get('/api/product/list'); if (res.code === 200) { this.products = res.data; } else { console.error('获取商品列表失败', res.msg); } } } }; ```