📚 课程目录第2章开发环境搭建

2. 开发环境搭建

本章核心目标是搭建《ContentProvider与Room跨进程集成》案例所需的全套开发环境，确保Android Studio、Gradle、Room库、ContentProvider相关库及调试设备协同工作。通过本环节，你将完成从IDE配置到依赖声明、库版本锁定、模拟器/真机验证的全流程，为后续编码和跨进程通信调试打好根基。

2.1 Android Studio 配置

推荐使用Android Studio Hedgehog（2023.1.1）或更高稳定版本。安装后需完成以下核心配置：

SDK Manager：安装API 33（Android 13）及API 34（Android 14）系统映像，确保覆盖目标版本。
NDK & CMake：若计划使用C++组件（此课程暂不需要），可选装NDK；默认CMake 3.22.1+即可。
虚拟设备加速：在AVD Manager中创建x86_64或arm64-v8a设备，开启硬件加速（HAXM或Hyper-V）。
Gradle JDK：设置为Embedded JDK（Java 17+），避免兼容性问题。

💡 建议：首次启动AS后执行一次“File → Invalidate Caches / Restart”，清理缓存防止依赖解析异常。

2.2 Gradle 依赖添加

在项目级 build.gradle.kts（或 build.gradle）中配置Kotlin和AGP版本；在app模块 build.gradle.kts 中添加Room、ContentProvider及相关库依赖。以下为Kotlin DSL示例：

// 项目级 build.gradle.kts
plugins {
    id("com.android.application") version "8.2.0" apply false
    id("org.jetbrains.kotlin.android") version "1.9.22" apply false
    id("com.google.devtools.ksp") version "1.9.22-1.0.17" apply false
}

// app模块 build.gradle.kts
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("com.google.devtools.ksp")
}

android {
    namespace = "com.example.contentproviderroom"
    compileSdk = 34
    defaultConfig {
        applicationId = "com.example.contentproviderroom"
        minSdk = 24
        targetSdk = 34
        versionCode = 1
        versionName = "1.0"
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
}

dependencies {
    // Room
    val roomVersion = "2.6.1"
    implementation("androidx.room:room-runtime:$roomVersion")
    implementation("androidx.room:room-ktx:$roomVersion")
    ksp("androidx.room:room-compiler:$roomVersion")

    // ContentProvider 基础依赖（AndroidX已内置，无需单独库）
    // 但为了跨进程可测试，添加Jetpack Navigation（可选）
    implementation("androidx.navigation:navigation-fragment-ktx:2.7.6")
    implementation("androidx.navigation:navigation-ui-ktx:2.7.6")

    // Lifecycle 用于观察数据变化
    implementation("androidx.lifecycle:lifecycle-runtime-ktx:2.7.0")
    implementation("androidx.lifecycle:lifecycle-viewmodel-ktx:2.7.0")
}

2.3 Room 与 ContentProvider 库版本选择

库名称	推荐版本（稳定）	强制兼容要求	备注
Room Runtime	2.6.1	compileSdk ≥ 34	支持KSP编译，增删改查效率提升
Room KTX	2.6.1	Kotlin 1.9+	提供Flow、Coroutines扩展
Room Compiler (KSP)	2.6.1	KSP 1.9.22-1.0.17+	替代kapt，编译速度更快
AndroidX Core	1.12.0	minSdk ≤ 24	ContentProvider基础支持
Lifecycle Runtime	2.7.0	无强制	用于跨进程数据观察

⚠️ 版本陷阱：Room 2.6.x 要求 compileSdk ≥ 34；若使用KSP插件，Kotlin版本与KSP版本必须严格对应（如Kotlin 1.9.22 + KSP 1.9.22-1.0.17）。使用kapt时可能遇到Java编译降级警告，建议全面迁移至KSP。

2.4 模拟器与真机调试准备

模拟器（Android Virtual Device）
- 创建Pixel 6或类似设备，选择API 33或34系统映像，分辨率1080×1920。
- 启用“Store snapshot for faster startup”加速启动。
- 验证adb连接：adb devices 应列出模拟器设备。
真机调试
- 开启“开发者选项”和“USB调试”。
- 安装设备驱动（Windows）或使用macOS/Linux原生支持。
- 确保Android Studio检测到设备：Run配置中Target选择“USB Device”。
跨进程测试环境
- 准备两个应用：一个提供ContentProvider（数据提供方），一个消费数据（客户端）。
- 真机上需同时安装两个APK，或使用同一模拟器的多实例。

  🔍 调试技巧：跨进程ContentProvider访问时，务必检查权限声明（android:exported="true"）和URI权限授权。模拟器上可通过 adb shell am start -a android.intent.action.MAIN -n com.example.contentprovider/.MainActivity 快速启动目标应用。

2.5 常见错误与修正

错误：KSP: Kotlin version mismatch
解决：在 build.gradle.kts 中指定一致版本：

id("org.jetbrains.kotlin.android") version "1.9.22"
id("com.google.devtools.ksp") version "1.9.22-1.0.17"

错误：Cannot find symbol class AppDatabase_Impl
解决：确保Room编译器已引入（ksp或kapt），并且 build.gradle.kts 中声明了 ksp("androidx.room:room-compiler:2.6.1")。
错误：INSTALL_FAILED_UPDATE_INCOMPATIBLE
解决：真机调试时，若之前安装过不同签名的版本，需先卸载原APK。模拟器上建议使用“Wipe Data”重新启动。
错误：模拟器无法启动
解决：检查HAXM状态（macOS/Linux）或Hyper-V（Windows），必要时关闭Docker、VirtualBox等冲突虚拟化软件。