# SkyLink Android App - 构建和运行指南

## 📋 前置要求

- Android Studio 最新版本
- Android SDK 34 (Android 14) 已安装
- Android Build Tools 34.x
- Gradle 8.0 或更高版本
- Java 8 或更高版本

## 🔨 构建步骤

### 1. 打开项目

```bash
cd d:\code\skyLink\skylink_android_app
```

或在 Android Studio 中打开此文件夹

### 2. 同步 Gradle

```bash
./gradlew.bat sync  # Windows
./gradlew sync       # Linux/Mac
```

### 3. 构建应用

```bash
# 构建 Debug 版本（推荐开发使用）
./gradlew.bat assembleDebug

# 构建 Release 版本
./gradlew.bat assembleRelease
```

### 4. 安装到设备或模拟器

```bash
# 安装 Debug 版本
./gradlew.bat installDebug

# 或使用 adb 直接安装
adb install -r app/build/outputs/apk/debug/app-debug.apk
```

## 📱 运行应用

### 方式 1：使用 Android Studio

1. 连接 Android 设备或启动模拟器
2. 点击 `Run` -> `Run 'app'` (或按 Shift + F10)
3. 选择目标设备

### 方式 2：使用命令行

```bash
# 直接运行（自动编译和安装）
./gradlew.bat installDebug
adb shell am start -n com.skylink.app/.MainActivity
```

## ✅ 验证功能

### 首页功能检查
- [ ] UDP 接收器成功启动
- [ ] 显示视频流（如果有数据源）
- [ ] GPS 信息正确显示
- [ ] 统计信息正常更新
- [ ] 保存帧按钮可用
- [ ] 录制按钮工作正常

### Navigation 检查
- [ ] 底部导航栏显示两个选项：首页、设置
- [ ] 点击导航项可以切换页面
- [ ] 返回按钮工作正常
- [ ] ActionBar 标题正确更新

### 设置界面检查
- [ ] 页面正确加载
- [ ] UDP 端口输入框可编辑
- [ ] 主机地址输入框可编辑
- [ ] Ping 参数下拉框可选择

### Ping 功能检查
- [ ] 单个 Ping 按钮可点击
- [ ] 多个 Ping 按钮可点击
- [ ] 显示进度条
- [ ] 成功 Ping 显示详细数据
- [ ] 失败 Ping 显示错误信息
- [ ] 清空结果按钮可用

## 🔍 调试技巧

### 查看日志

```bash
# 启用详细日志
adb logcat -s HomeFragment SettingsFragment PingUtil

# 实时监控
adb logcat -v brief | grep "SkyLink\|HomeFragment\|SettingsFragment\|PingUtil"
```

### 常见问题

**问题 1: Gradle 同步失败**
```bash
# 清理并重试
./gradlew.bat clean
./gradlew.bat sync
```

**问题 2: 编译错误 - 找不到 R 资源**
```bash
# 重建项目
./gradlew.bat clean build
```

**问题 3: Ping 不工作**
- 检查网络权限是否授予
- 检查目标主机是否可达
- 查看 logcat 中的错误信息
- 确保设备已连接网络

**问题 4: Navigation 不显示**
- 检查 nav_graph.xml 是否正确
- 确保 NavHostFragment ID 正确
- 检查菜单 ID 是否与导航目的地匹配

## 📊 性能监控

### 使用 Android Profiler

1. 点击 `View` -> `Tool Windows` -> `Profiler`
2. 选择要监控的应用
3. 监控以下指标：
   - CPU 使用率
   - 内存占用
   - 网络流量

### 常见性能指标

- **首页帧率**: 应维持在 60 FPS
- **内存占用**: 启动时应 < 100 MB
- **UDP 接收**: 不应导致 CPU 持续高占用

## 🚀 发布流程

### 生成签名 APK

```bash
./gradlew.bat bundleRelease
```

### 使用密钥存储

1. 在 `local.properties` 中配置密钥信息
2. 或在 Build Variants 中选择 Release 并配置签名

## 📝 版本号管理

编辑 `build.gradle.kts`：

```kotlin
android {
    defaultConfig {
        versionCode = 1        // 每次发布递增
        versionName = "1.1.0"  // 语义化版本
    }
}
```

## 🔗 相关资源

- [Android 开发者文档](https://developer.android.com)
- [Gradle 官方文档](https://gradle.org/documentation/)
- [Android Studio 用户指南](https://developer.android.com/studio/intro)

---

**最后更新**: 2026-01-19