flyLink/ANDROID_BUILD_GUIDE.md

# Android 项目编译配置指南

## ✅ 已修复的问题

### 1. AndroidX 依赖配置
**文件**: `gradle.properties`

```properties
android.useAndroidX=true
```

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

### 2. Gradle 任务语法
**文件**: `build.gradle.kts` (项目根目录)

修改前（错误）:
```gradle
task clean(type: Delete) {
    delete rootProject.buildDir
}
```

修改后（正确）:
```kotlin
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` 中添加：
```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 编译错误
**解决方案**:
```bash
# 清理 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: 使用命令行

```bash
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`