2、环境搭建与依赖引入：在build.gradle中配置KTX依赖，版本选择与兼容性

好，咱们正式开始动手了。这一章我带你搞定环境搭建，说白了就是怎么把KTX依赖请进项目里。别小看这一步，我见过太多人因为版本没选对，编译报错一整天，最后发现只是某个依赖版本号写错了。

2.1 先确认你的Kotlin版本

KTX是Kotlin的扩展库，所以Kotlin版本是地基。我个人习惯先看一眼项目的Kotlin版本，再决定用哪个KTX版本。

在项目根目录的build.gradle（或者build.gradle.kts）里，你会看到类似这样的配置：

// 传统Groovy写法
buildscript {
    ext.kotlin_version = '1.9.0'
    dependencies {
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

// 或者Kotlin DSL写法
plugins {
    id("org.jetbrains.kotlin.android") version "1.9.0" apply false
}

嗯，这里要注意：KTX库的版本和Kotlin版本是绑定的。比如Kotlin 1.9.0对应的KTX版本是1.9.x。你如果强行用Kotlin 1.8.x去配KTX 1.10.x，编译时就会给你脸色看。

2.2 在build.gradle中引入KTX依赖

好了，确认完Kotlin版本，咱们开始加依赖。以AndroidX为例，KTX的依赖通常放在模块级别的build.gradle里。

你想想看，Android官方把API分成了很多包，每个包都有对应的KTX扩展。最常用的几个我列在下面：

具体怎么加？看代码：

dependencies {
    // 核心KTX —— 这个基本是必加的
    implementation "androidx.core:core-ktx:1.12.0"

    // Fragment KTX —— 如果你用Fragment
    implementation "androidx.fragment:fragment-ktx:1.6.2"

    // Lifecycle KTX —— 协程和生命周期绑定
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.7.0"

    // Activity KTX —— 简化Activity操作
    implementation "androidx.activity:activity-ktx:1.8.2"

    // Collection KTX —— 集合操作更优雅
    implementation "androidx.collection:collection-ktx:1.4.0"
}

说白了，core-ktx是必选项，其他的按需添加。我一般新建项目时，先把core-ktx和lifecycle-runtime-ktx加上，后面用到Fragment或Activity时再补。

2.3 版本选择与兼容性

版本选择是个技术活。你可能会问：「我该用最新版还是稳定版？」我的建议是：用稳定版，别追新。

为什么会这样？因为AndroidX的版本号遵循语义化版本规范。比如1.12.0，主版本号1表示大版本，次版本号12表示功能更新，修订号0表示补丁。一般来说，次版本号相差不超过2个版本，兼容性都还好。

我整理了一个版本对照表，方便你参考：

2.4 避坑指南：版本冲突怎么办？

嗯，这里要重点说一下。项目大了之后，不同库可能依赖不同版本的KTX，这时候就会报版本冲突。比如你依赖了fragment-ktx:1.6.2，它内部又依赖了core-ktx:1.12.0，但你手动指定了core-ktx:1.11.0，编译时就会警告。

解决办法有两种：

1. 统一版本号：在build.gradle里用force强制指定版本。
2. 使用BOM（Bill of Materials）：Google提供了AndroidX的BOM，可以自动管理版本。

BOM的用法很简单：

dependencies {
    // 引入BOM，统一管理所有AndroidX版本
    implementation platform("androidx.compose:compose-bom:2024.01.00")

    // 然后直接写依赖，不用写版本号
    implementation "androidx.core:core-ktx"
    implementation "androidx.fragment:fragment-ktx"
    implementation "androidx.lifecycle:lifecycle-runtime-ktx"
}

这样所有AndroidX库的版本都由BOM统一管理，再也不用担心版本冲突了。我在公司的一个大型项目里就是这么干的，省心不少。

2.5 知识体系总览

为了让你更直观地理解这一章的内容，我画了一张图：

2.6 实战：从零开始配置一个项目

最后，我带你走一遍完整的配置流程。假设你新建了一个Android项目，Kotlin版本是1.9.0，目标SDK是34。

第一步，打开项目根目录的build.gradle，确认Kotlin插件版本：

plugins {
    id 'com.android.application' version '8.2.0' apply false
    id 'org.jetbrains.kotlin.android' version '1.9.0' apply false
}

第二步，打开模块级别的build.gradle，添加KTX依赖：

android {
    compileSdk 34
    defaultConfig {
        minSdk 21
        targetSdk 34
    }
}

dependencies {
    implementation "androidx.core:core-ktx:1.12.0"
    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.7.0"
    implementation "androidx.activity:activity-ktx:1.8.2"
    // 其他依赖按需添加
}

第三步，同步Gradle。如果一切顺利，你就可以在代码里使用KTX的扩展函数了。比如：

// 使用core-ktx的扩展
val sharedPref = context.getSharedPreferences("prefs", Context.MODE_PRIVATE)
sharedPref.edit {
    putString("key", "value")
    apply()
}

// 使用lifecycle-ktx的协程扩展
lifecycleScope.launch {
    repeatOnLifecycle(Lifecycle.State.STARTED) {
        // 在这里执行协程任务
    }
}

你看，代码是不是简洁了很多？这就是KTX的魅力。但前提是——你得先把环境搭对。

公众号:蓝海资料掘金营，微信deep3321