在 settings.gradle 里配置插件仓库
pluginManagement {
repositories {
google()
mavenCentral()
gradlePluginPortal()
}
}👉 这里就像 Maven 的 <pluginRepositories>，告诉 Gradle 去哪里下载插件本身。
没有这一段，Gradle 可能找不到插件。
在 root build.gradle 定义插件及版本
有两种方式：
✅ 推荐方式：libs.versions.toml
[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }然后在 root build.gradle 中：
plugins {
alias(libs.plugins.android.application) apply false
alias(libs.plugins.kotlin.android) apply false
}⚡ 这里 apply false 的意思是：我声明插件和版本，但不在 root 工程里用，只提供给子 module 去复用，避免每个 module 重复写版本号。
等价于 Maven 里的 <dependencyManagement> → 定义版本，不直接依赖。
另一种方式：直接写死版本
plugins {
id("com.android.application") version "8.1.0" apply false
}在 module build.gradle 中真正使用
plugins {
id("com.android.library") // 或 com.android.application
alias(libs.plugins.kotlin.android)
id("kotlin-kapt")
}👉 这里就是 真正启用插件，让模块具备对应的功能（比如变成 Android 应用/库、支持 Kotlin 编译、支持 Hilt 注入等）。
等价于 Maven 子 POM 里 <dependencies> → 真正用到的依赖。
引入 OkHttp 的步骤
1. 检查和配置版本
首先，你需要确定要使用的 OkHttp 版本。通常，推荐使用最新的稳定版本。你可以在项目的libs.versions.toml文件中找到或添加 OkHttp 的版本号，以实现集中管理。
在 [versions] 部分添加一行：
[versions]
okhttp = "4.12.0"然后在 [libraries] 部分，定义 OkHttp 依赖：
[libraries]
okhttp = { group = "com.squareup.okhttp3", name = "okhttp", version.ref = "okhttp" }
okhttp-logging-interceptor = { group = "com.squareup.okhttp3", name = "logging-interceptor", version.ref = "okhttp" }如果你也需要日志拦截器（用于调试），可以一并添加。
2. 在模块中添加依赖
接下来，打开你需要使用 OkHttp 的模块级build.gradle 文件（通常是 app 模块的 build.gradle）。在 dependencies 代码块中，添加以下依赖：
dependencies {
// ... 其他依赖
// 引入 OkHttp
implementation libs.okhttp
// 如果需要日志拦截器，也一并引入
implementation libs.okhttp.logging.interceptor
}如果你没有使用 libs.versions.toml 集中管理依赖，可以直接在 dependencies 中添加完整的依赖字符串：
dependencies {
// ... 其他依赖
// 引入 OkHttp
implementation "com.squareup.okhttp3:okhttp:4.12.0"
implementation "com.squareup.okhttp3:logging-interceptor:4.12.0"
}3. 同步项目
完成修改后，点击 Android Studio 工具栏上的“Sync Now”或 Gradle 同步按钮，让 Gradle 同步你的项目，下载新的依赖库。
引用
更新: 2026-03-10 10:25:54
原文: https://www.yuque.com/dongpozhouzi-mshe3/zhm85g/ydl7loerbuq5prgo