init

skylink_android_app/BUILD_AND_RUN.md

@@ -0,0 +1,183 @@
+# 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