zhibo/环境配置汇总.md

# 环境配置汇总

## 一、Android APP 配置

### 1. 主配置文件：`android-app/local.properties`

```properties
# ============ API 服务器地址配置 ============
# 主API地址 - 模拟器使用
api.base_url_emulator=http://1.15.149.240:8083/
# 主API地址 - 真机使用
api.base_url_device=http://1.15.149.240:8083/

# ============ 直播/通话服务地址配置 ============
# 直播/通话 WebSocket 服务地址
live.server_host=1.15.149.240
live.server_port=8083
# TURN 服务器地址（视频通话中继）
turn.server_host=1.15.149.240
turn.server_port=3478
```

**说明**：
- `api.base_url_emulator` - 模拟器运行时使用的API地址
- `api.base_url_device` - 真机运行时使用的API地址
- `live.server_host/port` - 直播和通话WebSocket服务地址
- `turn.server_host/port` - WebRTC TURN中继服务器地址

### 2. 相关代码文件（无需修改，自动读取local.properties）

| 文件 | 作用 |
|------|------|
| `app/build.gradle.kts` | 读取local.properties生成BuildConfig |
| `ApiConfig.java` | 提供统一的API地址获取方法 |
| `ApiClient.java` | 网络请求客户端，自动选择模拟器/真机地址 |
| `WebRTCConfig.java` | WebRTC/TURN服务器配置 |

---

## 二、前端 Admin 配置

### 1. 开发环境：`Zhibo/admin/.env.development`

```properties
ENV = 'development'
# 本地开发时连接本地后端
VUE_APP_BASE_API = 'http://127.0.0.1:30001'
```

### 2. 生产环境：`Zhibo/admin/.env.production`

```properties
ENV = 'production'
# 生产环境使用相对路径，由Nginx代理
VUE_APP_BASE_API = ''
```

### 3. 预发布环境：`Zhibo/admin/.env.staging`

```properties
ENV = 'production'
VUE_APP_BASE_API = 'http://192.168.31.35:2500'
```

**说明**：
- 开发环境：`npm run dev` 使用 `.env.development`
- 生产打包：`npm run build:prod` 使用 `.env.production`
- 预发布打包：`npm run build:stage` 使用 `.env.staging`

---

## 三、环境切换指南

### 切换到生产环境（服务器 1.15.149.240）

**Android APP**：
```properties
# android-app/local.properties
api.base_url_emulator=http://1.15.149.240:8083/
api.base_url_device=http://1.15.149.240:8083/
live.server_host=1.15.149.240
live.server_port=8083
turn.server_host=1.15.149.240
turn.server_port=3478
```

**前端 Admin**：
```properties
# Zhibo/admin/.env.production
VUE_APP_BASE_API = ''
```
然后执行 `npm run build:prod`

---

### 切换到本地开发环境

**Android APP**：
```properties
# android-app/local.properties
api.base_url_emulator=http://10.0.2.2:8081/
api.base_url_device=http://192.168.x.x:8081/
live.server_host=1.15.149.240
live.server_port=8083
turn.server_host=1.15.149.240
turn.server_port=3478
```
> 注意：直播/通话服务建议始终使用远程服务器

**前端 Admin**：
```properties
# Zhibo/admin/.env.development
VUE_APP_BASE_API = 'http://127.0.0.1:30001'
```
然后执行 `npm run dev`

---

## 四、服务端口说明

| 服务 | 端口 | 说明 |
|------|------|------|
| Admin API | 30003 | 管理后台API |
| Front API | 8083 | 前端/APP API |
| Admin 前端 | 30002 | 管理后台网页 |
| TURN 服务 | 3478 | WebRTC中继 |
| SRS RTMP | 25002 | 直播推流 |
| SRS HTTP | 25003 | 直播拉流 |

---

## 五、修改后需要的操作

### Android APP
1. 修改 `local.properties`
2. 重新编译：`./gradlew assembleRelease`

### 前端 Admin
1. 修改对应的 `.env.*` 文件
2. 重新打包：`npm run build:prod`
3. 上传 `dist` 目录到服务器