chore(config): 更新 gitignore 和 README

- 添加 Docker、Android、Web 相关忽略项
- 更新 README 项目结构和构建说明
- 添加 Android TV 文档
This commit is contained in:
李岩岩 2026-02-05 12:42:12 +08:00
parent 4f47258b17
commit c8bb8537c8
2 changed files with 195 additions and 5 deletions

129
.gitignore vendored
View File

@ -1,6 +1,125 @@
# ================================================
# System files
# ================================================
.DS_Store .DS_Store
dist-web Thumbs.db
node_modules
package-lock.json # ================================================
pnpm-lock.yaml # IDE
desktop/src-tauri/target # ================================================
.idea/
.vscode/settings.json
*.swp
*.swo
*~
# ================================================
# Dependencies
# ================================================
node_modules/
.pnpm-store/
# ================================================
# Build outputs
# ================================================
# UI
ui/dist-web/
ui/dist/
# Web
web/public/
web/dist/
# Desktop
desktop/src-tauri/target/
desktop/dist/
desktop/*.log
# ================================================
# Android
# ================================================
android/.gradle/
android/.idea/
android/local.properties
android/*.iml
android/app/build/
android/app/release/
android/captures/
android/*.hprof
android/.cxx/
android/app/src/main/assets/www/
!android/app/src/main/assets/error.html
!android/app/src/main/assets/test.html
# ================================================
# Android TV
# ================================================
android-tv/.gradle/
android-tv/.idea/
android-tv/local.properties
android-tv/*.iml
android-tv/app/build/
android-tv/app/release/
android-tv/captures/
android-tv/*.hprof
android-tv/.cxx/
android-tv/app/src/main/assets/www/
!android-tv/app/src/main/assets/error.html
!android-tv/app/src/main/assets/test.html
# ================================================
# HarmonyOS
# ================================================
harmonyos/.idea/
harmonyos/build/
harmonyos/entry/build/
# ================================================
# Docker
# ================================================
docker-compose.override.yml
.env.docker
.env.production
*.pem
*.key
# ================================================
# Logs
# ================================================
*.log
npm-debug.log*
yarn-debug.log*
yarn-error.log*
pnpm-debug.log*
lerna-debug.log*
# ================================================
# Environment
# ================================================
.env
.env.local
.env.*.local
.env.development
.env.test
# ================================================
# Testing
# ================================================
coverage/
.nyc_output/
# ================================================
# Temporary files
# ================================================
*.tmp
*.temp
.cache/
*.pid
*.seed
*.pid.lock
# ================================================
# Misc
# ================================================
*.tgz
*.tar.gz

71
README.md Normal file
View File

@ -0,0 +1,71 @@
# 📺 IPTV 跨平台应用
基于 Web 技术的跨平台 IPTV 播放器,一套代码支持 Windows、Mac、Android、Android TV、HarmonyOS。
## 项目结构
```
iptv-app/
├── ui/ # 🌐 Web 核心代码 (Vue 3)
│ ├── src/
│ │ ├── components/ # 播放器组件
│ │ ├── utils/ # M3U 解析等工具
│ │ └── App.vue # 主应用
│ ├── public/ # 静态资源
│ └── dist-web/ # 📦 Web 构建输出(各平台共用)
├── web/ # 网页端nodejs中间层+docker封装
├── desktop/ # 🖥️ Tauri 桌面端 (Win/Mac)
├── android/ # 📱 Android WebView 壳
├── android-tv/ # 📺 Android TV WebView 壳
└── harmonyos/ # 🔶 HarmonyOS WebView 壳
```
## 技术栈
| 平台 | 技术 | 说明 |
|------|------|------|
| UI 核心 | Vue 3 + Vite + hls.js | 一套代码,所有平台共用 |
| Web | Nodejs | 中间层代理,解决跨域问题 |
| Desktop | Tauri (Rust) | 轻量 (~5MB),高性能 |
| Android | WebView + ExoPlayer | 手机/平板 Web 壳 |
| Android TV | WebView + Leanback | TV 专用,支持遥控器导航 |
| HarmonyOS | Web 组件 + Video 组件 | Web 壳 + 原生播放器 |
## 快速开始
### Docker Web推荐
```bash
# 1. 构建 Web UI
cd ui && npm run build
# 2. 启动 Docker 服务
cd ../web
docker-compose up -d
# 访问 http://localhost:3000
```
### Android 构建
```bash
# 1. 构建 Web UI
cd ui
npm install
npm run build
# 2. 构建 Android APK
cd ../android
./build.sh
```
APK 输出位置: `android/app/build/outputs/apk/debug/app-debug.apk`
### Android TV 构建
```bash
cd android-tv
./build.sh
```
---