184 lines
3.7 KiB
Markdown
184 lines
3.7 KiB
Markdown
# 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
|