iptv-app/android/README.md
李岩岩 327f03c562 feat(android): 创建 Android WebView 壳应用
- 添加 MainActivity 和 WebView 配置
- 添加 AssetReader JS 接口用于读取本地文件
- 支持全屏、横屏模式
- 添加错误页面和测试页面
- 添加 Gradle 构建配置和一键构建脚本
2026-02-05 12:41:33 +08:00

72 lines
1.5 KiB
Markdown

# Android WebView 壳
## 目录结构
```
android/
├── app/src/main/
│ ├── java/com/iptv/app/
│ │ └── MainActivity.java # WebView 主活动
│ ├── res/
│ │ ├── layout/activity_main.xml
│ │ ├── values/
│ │ │ ├── strings.xml
│ │ │ ├── styles.xml
│ │ │ └── colors.xml
│ │ └── mipmap-*/ # 图标资源
│ ├── assets/
│ │ └── www/ # 打包的 Web 资源 (从 ui/dist-web 复制)
│ └── AndroidManifest.xml
├── build.gradle # 项目级构建配置
├── settings.gradle
└── gradle.properties
```
## 构建步骤
### 1. 构建 Web UI
```bash
cd ../ui
npm install
npm run build:web
```
### 2. 复制资源到 Android
```bash
# 将构建好的 web 资源复制到 Android assets
cp -r ../ui/dist-web/* app/src/main/assets/www/
```
### 3. 构建 APK
```bash
./gradlew assembleDebug
```
APK 输出位置: `app/build/outputs/apk/debug/app-debug.apk`
## 开发模式
如需连接开发服务器测试,修改 `MainActivity.java`:
```java
private static final String LOAD_MODE = "remote";
private static final String REMOTE_URL = "http://你的IP:5173";
```
## 功能特性
- ✅ WebView 加载 Web UI
- ✅ 全屏无标题栏
- ✅ 下拉刷新
- ✅ 返回键支持页面后退
- ✅ 视频全屏自动横屏
- ✅ 暗色主题
## 权限
- `INTERNET` - 网络访问
- `ACCESS_NETWORK_STATE` - 网络状态检测