flowzl/flyLink

Fork 0

Files

flowerstonezl 056289625c init

2026-01-19 17:08:49 +08:00

3.7 KiB

Raw Blame History

SkyLink Android App - 构建和运行指南

📋 前置要求

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

🔨 构建步骤

1. 打开项目

cd d:\code\skyLink\skylink_android_app

或在 Android Studio 中打开此文件夹

2. 同步 Gradle

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

3. 构建应用

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

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

4. 安装到设备或模拟器

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

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

📱 运行应用

方式 1：使用 Android Studio

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

方式 2：使用命令行

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

✅ 验证功能

首页功能检查

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

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

设置界面检查

页面正确加载
UDP 端口输入框可编辑
主机地址输入框可编辑
Ping 参数下拉框可选择

Ping 功能检查

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

🔍 调试技巧

查看日志

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

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

常见问题

问题 1: Gradle 同步失败

# 清理并重试
./gradlew.bat clean
./gradlew.bat sync

问题 2: 编译错误 - 找不到 R 资源

# 重建项目
./gradlew.bat clean build

问题 3: Ping 不工作

检查网络权限是否授予
检查目标主机是否可达
查看 logcat 中的错误信息
确保设备已连接网络

问题 4: Navigation 不显示

检查 nav_graph.xml 是否正确
确保 NavHostFragment ID 正确
检查菜单 ID 是否与导航目的地匹配

📊 性能监控

使用 Android Profiler

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

常见性能指标

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

🚀 发布流程

生成签名 APK

./gradlew.bat bundleRelease

使用密钥存储

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

📝 版本号管理

编辑 build.gradle.kts：

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

🔗 相关资源

最后更新: 2026-01-19

3.7 KiB Raw Blame History Unescape Escape