monisuo/app/PACKAGING.md

# 模拟所APP - 打包发布指南

## 📋 完整流程

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

1. **打包后端项目**
```bash
cd d:/workspace/project/com-rattan-spccloud
mvn clean package -DskipTests
```

2. **上传JAR包到服务器**
```bash
# 生成的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. **在服务器上启动后端**
```bash
# 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端口**
```bash
# 检查端口
netstat -tlnp | grep 9010

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

---

### 第二步：初始化数据库

在服务器上执行SQL脚本：
```bash
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` 文件：

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

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

---

## 🚀 快速测试

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

1. **使用ngrok**
```bash
ngrok http 9010
```

2. **修改API地址为ngrok提供的地址**
```typescript
const BASE_URL: string = 'https://xxxx.ngrok.io'
```

---

## 📦 预置账号

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

---

## 🔗 相关链接

- [uni-app x 文档](https://doc.dcloud.net.cn/uni-app-x/)
- [HBuilderX 下载](https://www.dcloud.io/hbuilderx.html)
- [云打包说明](https://ask.dcloud.net.cn/article/37979)