项目集成与依赖配置：添加Gradle依赖、最小SDK版本要求、兼容性说明

App Startup 是 Android Jetpack 的一部分，旨在将多个 ContentProvider 的自动合并为一个 InitializationProvider，从而减少应用启动时的 ContentProvider 初始化开销。本章将聚焦项目集成阶段的核心操作：在 Gradle 中添加依赖、理解最低 API 级别约束、以及处理与 AndroidX / 第三方库的兼容性问题。

3.1 添加 Gradle 依赖

App Startup 提供两个核心 artifact：startup-runtime（自动初始化支持）和 startup-manual（仅手动初始化支持）。标准场景推荐使用 startup-runtime。

Groovy DSL (build.gradle)

dependencies {
    implementation "androidx.startup:startup-runtime:1.1.1"
    // 如果仅需手动初始化，替换为：
    // implementation "androidx.startup:startup-manual:1.1.1"
}

Kotlin DSL (build.gradle.kts)

dependencies {
    implementation("androidx.startup:startup-runtime:1.1.1")
    // 手动初始化：
    // implementation("androidx.startup:startup-manual:1.1.1")
}

3.2 最小 SDK 版本要求

实际项目推荐：虽然官方宣称最低 API 14，但现代 Android 项目通常设置 minSdk = 21（Android 5.0）。如果 minSdk 低于 21，App Startup 会自动降级为传统多 ContentProvider 模式，无法发挥性能优势。建议在 build.gradle 中明确设置：

android {
    defaultConfig {
        minSdk 21
        // ...
    }
}

3.3 兼容性说明

App Startup 本身基于 AndroidX，与以下框架无缝协作：

• AndroidX Core / AppCompat — 无需额外配置。
• Kotlin Coroutines — 初始化逻辑支持异步调用，但推荐将耗时操作放入 Application#onCreate 或协程作用域。
• Dagger / Hilt — 两者均使用 App Startup 作为组件初始化的底层机制（例如 Hilt 的 Hilt_Application 自动注册），版本应同步。
• ProGuard / R8 混淆 — 需要保留 InitializationProvider 及相关类的 ProGuard 规则：

-keepclassmembers class * extends androidx.startup.Initializer {
    public <init>();
}
-keep class * extends androidx.startup.Initializer { *; }

3.4 集成检查清单

1. 确认 minSdk ≥ 21（推荐）并同步 Gradle。
2. 在 build.gradle 中添加 startup-runtime 依赖。
3. 检查 AndroidManifest.xml 中无自行注册的 androidx.startup.InitializationProvider — 库会自动合并。
4. 运行 ./gradlew :app:dependencies 确认依赖树无冲突。
5. 如果使用混淆，添加上一部分的 ProGuard 保留规则。

3.5 常见错误与调试