文章目录
- 一、工程根目录下 build.gradle 配置文件
- 1、基本作用
- 2、远程仓库配置
- 3、依赖配置
- 3、所有子模块配置
- 4、task clean 任务
Android Plugin DSL Reference 参考文档 : https://google.github.io/android-gradle-dsl/2.3/
一、工程根目录下 build.gradle 配置文件
1、基本作用
根目录下的 build.gradle 是 Android 工程的默认的顶层 Gradle 构建脚本 , 注意是根目录下 , 与 Module 目录下的 build.gradle 进行区分 ;
该脚本中的配置应用于所有子工程 , 配置如下类型的信息 :
- 代码仓库配置 :
repositories {
google()
mavenCentral()
jcenter() // Warning: this repository is going to shut down soon
}
- Android Gradle 插件版本依赖 : 配置的依赖会从上面的 google() , mavenCentral() , jcenter() 仓库中查找 ; 一般是从 jcenter() 中查找 ;
dependencies {
classpath "com.android.tools.build:gradle:4.2.1"
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
- 其它指令 :
task clean(type: Delete) {
delete rootProject.buildDir
}
2、远程仓库配置
可配置的仓库都定义在 RepositoryHandler
接口中 , 可以指定 jcenter , ivy , flatDir , google , mavenCentral , mavenLocal , maven 等类型的仓库 ;
public interface RepositoryHandler extends ArtifactRepositoryContainer {
FlatDirectoryArtifactRepository flatDir(Map<String, ?> var1);
FlatDirectoryArtifactRepository flatDir(Closure var1);
FlatDirectoryArtifactRepository flatDir(Action<? super FlatDirectoryArtifactRepository> var1);
ArtifactRepository gradlePluginPortal();
ArtifactRepository gradlePluginPortal(Action<? super ArtifactRepository> var1);
MavenArtifactRepository jcenter(Action<? super MavenArtifactRepository> var1);
MavenArtifactRepository jcenter();
MavenArtifactRepository mavenCentral(Map<String, ?> var1);
MavenArtifactRepository mavenCentral();
MavenArtifactRepository mavenCentral(Action<? super MavenArtifactRepository> var1);
MavenArtifactRepository mavenLocal();
MavenArtifactRepository mavenLocal(Action<? super MavenArtifactRepository> var1);
MavenArtifactRepository google();
MavenArtifactRepository google(Action<? super MavenArtifactRepository> var1);
MavenArtifactRepository maven(Closure var1);
MavenArtifactRepository maven(Action<? super MavenArtifactRepository> var1);
IvyArtifactRepository ivy(Closure var1);
IvyArtifactRepository ivy(Action<? super IvyArtifactRepository> var1);
@Incubating
void exclusiveContent(Action<? super ExclusiveContentRepository> var1);
}
3、依赖配置
在依赖配置中 , 最常见的就是配置 Android Gradle 插件版本 ;
依赖配置如下 :
代码语言:javascript复制buildscript {
dependencies {
classpath "com.android.tools.build:gradle:4.2.1"
}
}
在 dependencies 下的 classpath 是依赖分组 , 常用的 implementation 依赖方式表示编译并打包 ;
3、所有子模块配置
所有子模块配置 , 最常见的是为所有子模块配置远程仓库 ;
代码语言:javascript复制allprojects {
repositories {
google()
mavenCentral()
jcenter() // Warning: this repository is going to shut down soon
}
}
4、task clean 任务
最后定义了一个 task 任务 , type 表示任务类型 , 该任务是在 Delete 任务的基础上 , 执行额外附加的任务 ;
代码语言:javascript复制task clean(type: Delete) {
delete rootProject.buildDir
}
该任务的作用是 , 删除根目录下的 build 目录 ;