111

docs/BUILD-CLIENT.md

@@ -99,13 +99,62 @@ mv /path/to/FunConnect-1.1.0-Mac-x64.dmg   /opt/funmc/downloads/FunMC-${VERSION}
 
 ---
 
-## 5. Android
+## 5. Android（mobile/，Expo + React Native）
 
-若项目中有 Android 构建（如 `mobile/` 或 Android 子工程），构建出 `.apk` 后，上传到服务器并命名为：
+Android 客户端在 **`mobile/`** 目录，使用 **Expo** 构建。任选其一即可。
+
+### 前置要求
+
+- Node.js 18+
+- **方式一（EAS 云端）**：Expo 账号（[expo.dev](https://expo.dev) 注册）
+- **方式二（本地）**：Android Studio + Android SDK，并配置好 `ANDROID_HOME`
+
+### 方式一：EAS Build（推荐，无需本机 Android 环境）
+
+在项目根或 `mobile/` 下执行：
+
+```bash
+cd mobile
+npm install
+
+# 安装 EAS CLI 并登录
+npm install -g eas-cli
+eas login
+
+# 构建 APK（预览/内部分发，直接得到 .apk）
+eas build --platform android --profile preview
+```
+
+构建完成后在 Expo 网页或邮件中下载 **APK**，上传到服务器后重命名并放入下载目录：
 
 ```bash
 VERSION=0.1.0
-cp /path/to/your.apk /opt/funmc/downloads/FunMC-${VERSION}-android.apk
+cp /path/to/下载的.apk /opt/funmc/downloads/FunMC-${VERSION}-android.apk
+```
+
+### 方式二：本地构建（需 Android Studio + SDK）
+
+```bash
+cd mobile
+npm install
+
+# 生成原生 android/ 目录
+npx expo prebuild
+
+# 构建 Release APK
+cd android && ./gradlew assembleRelease
+```
+
+APK 输出路径：
+
+- `mobile/android/app/build/outputs/apk/release/app-release.apk`
+
+复制到服务器下载目录并重命名：
+
+```bash
+VERSION=0.1.0
+cp mobile/android/app/build/outputs/apk/release/app-release.apk /opt/funmc/downloads/FunMC-${VERSION}-android.apk
+# 若在服务器上，可先 scp 上传再执行 cp/mv
 ```
 
 ---