monisuo/app/PACKAGING.md

模拟所APP - 打包发布指南

📋 完整流程

第一步：部署后端到服务器

1. 打包后端项目

cd d:/workspace/project/com-rattan-spccloud
mvn clean package -DskipTests

2. 上传JAR包到服务器

# 生成的JAR包位置
target/com-rattan-spccloud-1.0.jar

# 使用scp上传到服务器
scp target/com-rattan-spccloud-1.0.jar root@8.155.172.147:/opt/monisuo/

3. 在服务器上启动后端

# SSH连接服务器
ssh root@8.155.172.147

# 启动服务
cd /opt/monisuo
nohup java -jar com-rattan-spccloud-1.0.jar --spring.profiles.active=dev > app.log 2>&1 &

# 查看日志
tail -f app.log

4. 确保服务器防火墙开放9010端口

# 检查端口
netstat -tlnp | grep 9010

# 如果使用firewalld
firewall-cmd --zone=public --add-port=9010/tcp --permanent
firewall-cmd --reload

---

第二步：初始化数据库

在服务器上执行SQL脚本：

mysql -u monisuo -pJPJ8wYicSGC8aRnk monisuo < /opt/monisuo/init.sql

或者使用Navicat等工具连接数据库执行 sql/init.sql

---

第三步：打包前端APP

方式一：使用HBuilderX（推荐）

1. 下载安装 HBuilderX Alpha版

   • 下载地址：https://www.dcloud.io/hbuilderx.html
   • 选择 Alpha版（uni-app x需要Alpha版）

2. 导入项目

   • 打开HBuilderX
   • 文件 → 导入 → 从本地目录导入
   • 选择 d:\workspace\project\com-rattan-spccloud\app 目录

3. 配置manifest.json

   • 在HBuilderX中打开 manifest.json
   • 填写应用信息：
     • App名称：模拟所
     • App描述：虚拟货币模拟交易平台
     • 版本号：1.0.0

4. 运行调试（可选）

   • 连接Android手机（开启USB调试）
   • 运行 → 运行到手机或模拟器 → 运行到Android App基座

5. 云端打包

   • 发行 → 原生App-云打包
   • 选择平台：Android
   • 勾选"使用DCloud公用证书"（测试用）
   • 点击"打包"
   • 等待打包完成，下载APK

方式二：本地打包

1. 生成本地打包资源

   • 发行 → 原生App-本地打包 → 生成本地打包App资源

2. 使用Android Studio打包

   • 打开Android Studio
   • 导入生成的项目
   • Build → Build Bundle(s) / APK(s) → Build APK(s)

---

第四步：安装APK到手机

方式一：直接安装

1. 将APK文件传到手机
2. 点击APK文件安装
3. 允许安装未知来源应用

方式二：通过HBuilderX安装

1. 手机连接电脑
2. 运行 → 运行到手机或模拟器 → 运行到Android App基座
3. 选择已连接的设备

---

🔧 常见问题

1. 网络请求失败

• 检查服务器防火墙是否开放9010端口
• 检查API地址是否正确（app/api/request.uts中的BASE_URL）
• 确保手机和服务器网络连通

2. 安装失败

• 开启手机"允许安装未知来源应用"
• 卸载旧版本后再安装新版本

3. 登录失败

• 检查数据库是否初始化成功
• 检查后端服务是否正常运行
• 查看后端日志：tail -f /opt/monisuo/app.log

---

📱 API地址配置

修改 app/api/request.uts 文件：

// 开发环境（本地测试）
const BASE_URL: string = 'http://localhost:9010'

// 生产环境（服务器部署）
const BASE_URL: string = 'http://8.155.172.147:9010'

---

🚀 快速测试

如果暂时没有服务器，可以使用内网穿透工具：

1. 使用ngrok

ngrok http 9010

2. 修改API地址为ngrok提供的地址

const BASE_URL: string = 'https://xxxx.ngrok.io'

---

📦 预置账号

类型	账号	密码
管理员	admin	admin123
管理员	superadmin	admin123

---

🔗 相关链接

• uni-app x 文档
• HBuilderX 下载
• 云打包说明