132 lines
3.2 KiB
Markdown
132 lines
3.2 KiB
Markdown
|
# FunConnect Mobile
|
|||
|
|
|
|||
|
|
Minecraft 联机移动客户端，基于 **React Native + Expo** 构建，支持 **iOS** 和 **Android**。
|
|||
|
|
|
|||
|
|
## 功能
|
|||
|
|
|
|||
|
|
- **连接服务器** - 输入中继服务器地址连接
|
|||
|
|
- **浏览房间** - 实时查看在线联机房间（自动刷新）
|
|||
|
|
- **搜索筛选** - 按名称、房间号、房主搜索，按版本类型筛选
|
|||
|
|
- **创建房间** - 创建联机房间并分享房间号
|
|||
|
|
- **加入房间** - 输入房间号加入，支持密码验证
|
|||
|
|
- **设置持久化** - 记住服务器地址、玩家名
|
|||
|
|
- **深色主题** - Minecraft 风格暗色 UI
|
|||
|
|
|
|||
|
|
## 快速开始
|
|||
|
|
|
|||
|
|
### 前置要求
|
|||
|
|
|
|||
|
|
- Node.js 18+
|
|||
|
|
- Expo CLI: `npm install -g expo-cli`
|
|||
|
|
- iOS: Xcode 15+（仅 macOS）
|
|||
|
|
- Android: Android Studio + SDK
|
|||
|
|
|
|||
|
|
### 安装依赖
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
cd mobile
|
|||
|
|
npm install
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 开发模式
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 启动 Expo 开发服务器
|
|||
|
|
npm start
|
|||
|
|
|
|||
|
|
# 在 iOS 模拟器中运行
|
|||
|
|
npm run ios
|
|||
|
|
|
|||
|
|
# 在 Android 模拟器中运行
|
|||
|
|
npm run android
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
> 也可以用 **Expo Go** 手机 App 扫描二维码直接在真机上运行。
|
|||
|
|
|
|||
|
|
## 编译发布
|
|||
|
|
|
|||
|
|
### 方式一：EAS Build（推荐，云端构建）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 安装 EAS CLI
|
|||
|
|
npm install -g eas-cli
|
|||
|
|
|
|||
|
|
# 登录 Expo 账号
|
|||
|
|
eas login
|
|||
|
|
|
|||
|
|
# 构建 Android APK（预览版）
|
|||
|
|
eas build --platform android --profile preview
|
|||
|
|
|
|||
|
|
# 构建 Android AAB（生产版，用于上架 Google Play）
|
|||
|
|
eas build --platform android --profile production
|
|||
|
|
|
|||
|
|
# 构建 iOS（需要 Apple Developer 账号）
|
|||
|
|
eas build --platform ios --profile production
|
|||
|
|
|
|||
|
|
# 同时构建两个平台
|
|||
|
|
eas build --platform all --profile production
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 方式二：本地构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
# 生成原生项目
|
|||
|
|
npx expo prebuild
|
|||
|
|
|
|||
|
|
# Android
|
|||
|
|
cd android && ./gradlew assembleRelease
|
|||
|
|
# 输出: android/app/build/outputs/apk/release/app-release.apk
|
|||
|
|
|
|||
|
|
# iOS（需要 macOS + Xcode）
|
|||
|
|
cd ios && xcodebuild -workspace FunConnect.xcworkspace -scheme FunConnect archive
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 项目结构
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
mobile/
|
|||
|
|
├── App.tsx # 入口 + Tab 导航
|
|||
|
|
├── index.js # 注册根组件
|
|||
|
|
├── src/
|
|||
|
|
│ ├── screens/
|
|||
|
|
│ │ ├── ConnectScreen.tsx # 连接服务器
|
|||
|
|
│ │ ├── RoomsScreen.tsx # 房间列表
|
|||
|
|
│ │ ├── CreateScreen.tsx # 创建房间
|
|||
|
|
│ │ ├── JoinScreen.tsx # 加入房间
|
|||
|
|
│ │ └── SettingsScreen.tsx # 设置
|
|||
|
|
│ ├── lib/
|
|||
|
|
│ │ ├── api.ts # API 客户端 + 存储
|
|||
|
|
│ │ └── theme.ts # 主题色彩
|
|||
|
|
│ └── components/ # 共享组件
|
|||
|
|
├── app.json # Expo 配置
|
|||
|
|
├── eas.json # EAS Build 配置
|
|||
|
|
├── package.json
|
|||
|
|
└── tsconfig.json
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 联机流程
|
|||
|
|
|
|||
|
|
### 房主
|
|||
|
|
|
|||
|
|
1. 在「连接」页连接中继服务器
|
|||
|
|
2. 在「创建」页创建房间，复制房间号
|
|||
|
|
3. 将房间号分享给好友
|
|||
|
|
4. 启动本地 Minecraft 服务器
|
|||
|
|
|
|||
|
|
### 玩家
|
|||
|
|
|
|||
|
|
1. 在「连接」页连接同一个中继服务器
|
|||
|
|
2. 在「加入」页输入房间号
|
|||
|
|
3. 验证通过后获取服务器地址
|
|||
|
|
4. 在 Minecraft 中添加该服务器地址
|
|||
|
|
5. 开始联机！
|
|||
|
|
|
|||
|
|
## 技术栈
|
|||
|
|
|
|||
|
|
- **React Native 0.73** + **Expo 50**
|
|||
|
|
- **TypeScript**
|
|||
|
|
- **React Navigation** - Tab 导航
|
|||
|
|
- **AsyncStorage** - 本地持久化
|
|||
|
|
- **Axios** - HTTP 请求
|
|||
|
|
- **EAS Build** - 云端编译发布
|