一、插件(Plugins) vs 库(Libraries)
| 特征 | 插件 (Plugins) | 库 (Libraries) |
|---|---|---|
| 本质 | 构建逻辑扩展工具 | 运行时依赖的代码组件 |
| 作用 | 添加任务/配置/目录结构 | 提供可调用的具体代码实现 |
| 声明位置 | plugins {} 块 |
dependencies {} 块 |
| 影响范围 | 构建过程 | 运行时或编译时 |
| 典型示例 | java，android |
gson, junit |
1. 插件详解
核心作用：
- 添加新任务（如
compileJava,assemble） - 定义默认目录结构（如
src/main/java） - 引入预置配置（如
implementation依赖配置）
使用场景：
plugins {
id 'com.android.application' // Android APP插件
id 'org.jetbrains.kotlin.android' // Kotlin支持
}
2. 库详解
关键特征：
- 通过坐标声明：
group:name:version（如com.google.guava:guava:32.0-jre） - 传递依赖：库可能自带其他依赖（如 Retrofit 自动引入 OkHttp）
使用场景：
dependencies {
implementation 'androidx.core:core-ktx:1.12.0' // 主代码依赖
testImplementation 'junit:junit:4.13.2' // 测试代码专用
}
二、依赖配置详解
1. implementation（最常用）
特点:
- 依赖不传递给其他模块,
模块F → 模块D → 模块E（传导终止于D），模块F完全不知道模块E的存在 - 加快构建（减少重编译）
- 适用于绝大多数字依赖
implementation 'com.squareup.retrofit2:retrofit:2.9.0'
2. api（谨慎使用）
特点:
- 依赖传递给其他模块，建立依赖传递链：
模块C → 模块A → 模块B，模块C可以使用模块B公开的接口 - 用于 SDK 开发需暴露依赖的场景
- 会增加构建时间
api 'com.google.dagger:dagger:2.48' // 其他模块需使用Dagger
3. classpath
特点:
- 仅用于项目级构建脚本(
build.gradle) - 为 Gradle 自身引入插件包，然后在模块级plugins块中声明使用
- 不参与模块代码编译
// 项目级 build.gradle
buildscript {
dependencies {
classpath 'com.android.tools.build:gradle:8.1.0'
}
}
4. alias（版本目录）
特点：
- 在
gradle/libs.versions.toml中集中管理依赖 - 解决版本号硬编码问题
- 需 AGP 7.4+ 支持
# libs.versions.toml
[versions]
androidxCore = "1.12.0"
[libraries]
android-core = {
group = "androidx.core",
name = "core-ktx",
version.ref = "androidxCore"
}
dependencies {
implementation(libs.android.core) // 通过别名引用
}