flyLink/ANDROID_BUILD_GUIDE.md

Android 项目编译配置指南

✅ 已修复的问题

1. AndroidX 依赖配置

文件: gradle.properties

android.useAndroidX=true

这个配置告诉 Gradle 使用 AndroidX 库而不是旧的支持库。

2. Gradle 任务语法

文件: build.gradle.kts (项目根目录)

修改前（错误）:

task clean(type: Delete) {
    delete rootProject.buildDir
}

修改后（正确）:

tasks.register<Delete>("clean") {
    delete(rootProject.buildDir)
}

3. AndroidManifest.xml

文件: app/src/main/AndroidManifest.xml

添加 xmlns:tools="http://schemas.android.com/tools" 声明，用于处理存储权限兼容性。

4. ProGuard 规则

文件: app/proguard-rules.pro

创建了完整的混淆规则，保护 AndroidX、Kotlin 和 SkyLink 相关的类。

🛠️ 常见问题解决

问题 1: "Configuration contains AndroidX dependencies, but android.useAndroidX is not enabled"

解决方案: 在 gradle.properties 中添加：

android.useAndroidX=true
android.nonTransitiveRClass=true

问题 2: "Android resource linking failed"

解决方案:

• 确保 compileSdk 和 targetSdk 一致（现在都是 34）
• 清理项目：Build > Clean Project
• 刷新 Gradle：File > Sync Now

问题 3: "Cannot find symbol R"

解决方案:

• 确保 activity_main.xml 中的所有 ID 定义正确
• 检查 R.layout.activity_main 是否存在
• 重建项目：Build > Rebuild Project

问题 4: Gradle 编译错误

解决方案:

# 清理 Gradle 缓存
./gradlew clean

# 重新下载依赖
./gradlew assemble

# 或在 Android Studio 中
Build > Clean Project
Build > Rebuild Project

📱 编译和运行

方法 1: 使用 Android Studio

1. 打开 Android Studio
2. File > Open → 选择 skylink_android_app
3. 等待 Gradle 同步完成
4. Build > Build Bundle(s) / APK(s) > Build APK
5. Run > Run 'app' 安装到设备

方法 2: 使用命令行

cd skylink_android_app

# 编译 Debug APK
./gradlew assembleDebug

# 编译 Release APK
./gradlew assembleRelease

# 运行测试
./gradlew test

# 安装到设备
./gradlew installDebug

✨ 最终配置清单

• ✅ gradle.properties - AndroidX 配置
• ✅ build.gradle.kts (root) - 项目级 Gradle 配置
• ✅ app/build.gradle.kts - 应用级 Gradle 配置
• ✅ app/proguard-rules.pro - 混淆规则
• ✅ app/src/main/AndroidManifest.xml - 清单文件
• ✅ local.properties - SDK 路径配置

🔍 验证配置

在 Android Studio 中运行以下检查：

1. 检查依赖:

   Build > Analyze > Run Inspection by Name > Dependency Issues
   

2. 检查 Gradle:

   File > Project Structure > 检查各个模块配置
   

3. 检查 Manifest:

   在 Manifest 编辑器中查看是否有红色下划线
   

📚 相关文件位置

skylink_android_app/
├── gradle.properties          # ← AndroidX 配置在这里
├── build.gradle.kts           # ← 项目级 Gradle
├── settings.gradle.kts        # ← 项目设置
├── local.properties           # ← SDK 路径
└── app/
    ├── build.gradle.kts       # ← 应用级 Gradle
    ├── proguard-rules.pro     # ← 混淆规则
    └── src/
        └── main/
            └── AndroidManifest.xml

---

如果仍有编译错误，请执行:

1. Build > Clean Project
2. File > Sync Now
3. Build > Rebuild Project