gradle安装与配置(gradle配置文件详解)

一、Gradle安装

1、Gradle安装 (1)先安装JDK/JRE (2)Gradle下载官网 Gradle官网 (3)解压安装包到想安装到的目录。如D:\java\gradle-5.2.1 (4)配置环境变量。 ??变量名:GRADLE_HOME ??变量值:解压到的目录 ??

gradle安装与配置(gradle配置文件详解)

(5)添加到path ??变量名:Path ??变量值:%GRADLE_HOME%\bin; ??

gradle安装与配置(gradle配置文件详解)

2、Gradle配置 (1)配置本地仓库 ??变量名:GRADLE_USER_HOME ??变量值:自定义Gradle仓库目录或者Maven的仓库目录 ??

gradle安装与配置(gradle配置文件详解)

(2)配置仓库源 ??在Gradle安装目录下的 init.d 文件夹下,新建一个 init.gradle 文件,里面填写以下配置。

allprojects {
    repositories {
        maven { url 'file:///C:/Java/maven_repository'}
        mavenLocal()
        maven { name "Alibaba" ; url "https://maven.aliyun.com/repository/public" }
        maven { name "Bstek" ; url "http://nexus.bsdn.org/content/groups/public/" }
        mavenCentral()
    }
    buildscript { 
        repositories { 
            maven { name "Alibaba" ; url 'https://maven.aliyun.com/repository/public' }
            maven { name "Bstek" ; url 'http://nexus.bsdn.org/content/groups/public/' }
            maven { name "M2" ; url 'https://plugins.gradle.org/m2/' }
        }
    }
}

repositories中写的是获取jar包的顺序。先是本地的Maven仓库路径;接着的mavenLocal()是获取Maven本地仓库的路径,应该是和第一条一样,但是不冲突;第三条和第四条是从国内和国外的网络上仓库获取;最后的 mavenCentral() 是从Apache提供的中央仓库获取jar包。 (3)配置到IDEA ??在IDEA的Setting里打开"Build, Execution, Deployment"-"Build Tools"-"Gradle"。 ??勾选 Use local Gradle distribution,在 Gradle home中选择安装的Gradle的路径。 ??如果在变量和配置文件中设置了Gradle的仓库路径,在Service directory path中就会自动填写地址,如果想改的话可以手动修改。 ??

gradle安装与配置(gradle配置文件详解)

二、Gradle仓库配置

1、本地仓库配置 配置环境变量GRADLE_USER_HOME,并指向你的一个本地目录,用来保存Gradle下载的依赖包。

gradle安装与配置(gradle配置文件详解)

2、远程仓库配置 一般Gradle、maven从中央仓库mavenCentral()(http://repo1.maven.org/maven2/)下载依赖包,但是在国内下载速度巨慢,我们只能使用国内的镜像。 所以每个Gradle构建的项目中,我们可以在build.gradle做如下配置

repositories {
    maven {
        url 'http://maven.aliyun.com/nexus/content/groups/public/'
    }
    mavenCentral()
}

3、全局仓库配置 每个项目都单独配置难免麻烦些,我们可以配置一个全局配置文件。gradle加载全局配置按优先级顺序有如下四种方式: (1)通过--I 或者--init-script参数在构建开始时指定路径,如

    gradle --init-script init.gradle clean
    gradle --I init.gradle clean

init.gradle文件示例:

allprojects{
    repositories {
        def ALIYUN_REPOSITORY_URL = 'http://maven.aliyun.com/nexus/content/groups/public'
        def ALIYUN_JCENTER_URL = 'http://maven.aliyun.com/nexus/content/repositories/jcenter'
        all { ArtifactRepository repo ->
            if(repo instanceof MavenArtifactRepository){
                def url = repo.url.toString()
                if (url.startsWith('https://repo1.maven.org/maven2')) {
                    project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_REPOSITORY_URL."
                    remove repo
                }
                if (url.startsWith('https://jcenter.bintray.com/')) {
                    project.logger.lifecycle "Repository ${repo.url} replaced by $ALIYUN_JCENTER_URL."
                    remove repo
                }
            }
        }
        maven {
            url ALIYUN_REPOSITORY_URL
            url ALIYUN_JCENTER_URL
        }
    }
}

(2)加载USER_HOME/.gradle/init.gradle文件

(3)加载USER_HOME/.gradle/init.d/目录下的以.gradle结尾的文件

(4)加载GRADLE_HOME/init.d/目录下的以.gradle结尾的文件

 

三、Gradle仓库配置详解

支持的类型有如下几种:

类型 说明
Maven central repository 这是Maven的中央仓库,无需配置,直接声明就可以使用。但不支持https协议访问
Maven JCenter repository JCenter中央仓库,实际也是是用的maven搭建的,但相比Maven仓库更友好,通过CDN分发,并且支持https访问。
Maven local repository Maven本地的仓库,可以通过本地配置文件进行配置
Maven repository 常规的第三方Maven仓库,可设置访问Url
Ivy repository Ivy仓库,可以是本地仓库,也可以是远程仓库
Flat directory repository 使用本地文件夹作为仓库

1、Maven central repository 在build.gradle中配置:

repositories {
    mavenCentral()
}

就可以直接使用了。 2、Maven JCenter repository 最常用也是Android Studio默认配置:

repositories {
    jcenter()
}

这时使用jcenter仓库是通过https访问的,如果想切换成http协议访问,需要修改配置:

repositories {
    jcenter {
        url "http://jcenter.bintray.com"
    }
}

3、Local Maven repository 可以使用Maven本地的仓库。默认情况下,本地仓库位于USER_HOME/.m2/repository(例如windows环境中,在C:\Users\NAME.m2.repository),同时可以通过USER_HOME/.m2/下的settings.xml配置文件修改默认路径位置。 若使用本地仓库在build.gradle中进行如下配置:

repositories {
    mavenLocal()
}

4、Maven repositories 第三方的配置也很简单,直接指明url即可:

repositories {
    maven {
        url "http://repo.mycompany.com/maven2"
    }
}

5、ivy repositories 配置如下:

repositories {
    ivy {
        url "http://repo.mycompany.com/repo"
    }
}

6、Flat directory repository 使用本地文件夹,这个也比较常用。直接在build.gradle中声明文件夹路径:

repositories {
    flatDir {
        dirs 'lib'
    }
    flatDir {
        dirs 'lib1', 'lib2'
    }
}

使用本地文件夹时,就不支持配置元数据格式的信息了(POM文件)。并且Gradle会优先使用服务器仓库中的库文件:例如同时声明了jcenter和flatDir,当flatDir中的库文件同样在jcenter中存在,gradle会优先使用jcenter的。 7、常用仓库

repositories {
    mavenCentral()
    maven { url "https://jitpack.io" }
    maven { url "http://maven.aliyun.com/nexus/content/groups/public/" }
    https://plugins.gradle.org/m2/
    maven { url 'http://maven.oschina.net/content/groups/public/' }
    maven { url 'https://oss.sonatype.org/content/repositories/snapshots/' }
    maven { url "http://maven.springframework.org/release" }
    maven { url "http://maven.restlet.org" }
    maven { url "http://mirrors.ibiblio.org/maven2" }
    maven {
        url "http://repo.baichuan-android.taobao.com/content/groups/BaichuanRepositories/"
    }
    maven { url 'https://maven.fabric.io/public' }
    jcenter()
    google()
}

四、Gradle Wrapper使用

对于所有Gradle项目来说,都推荐使用Gradle Wrapper,甚至应该将其当做创建代码库之后的第一件事来做。使用Gradle Wrapper有以下好处: (1)不用安装Gradle也能运行Gradle (2)所有人使用相同版本的Gradle 在build.gradle中加入以下配置:

task wrapper(type: Wrapper) {
    gradleVersion = '4.6'
}

然后再运行gradle wrapper,此时会生成gradlew、gradle.bat两个文件和gradle目录。这里的gradlew和gradle.bat是脚本文件,在使用gradle命令的地方替换为gradlew或gradle.bat,它们将自动下载指定版本的gradle,然后使用该版本进行项目构建。 请注意,这3个文件是要提交到代码库上的,当项目其他人拿到代码之后,由于gradlew和gradle.bat均在源代码中,他们本地即使没有安装gradle,也能通过./gradlew build命令进行项目构建。   参考[1]Gradle的安装与配置 [2]Gradle学习(一)gradle本地、远程仓库配置 [3]Gradle仓库配置 [4]一篇文章讲清楚Gradle与Gradle Wrapper的区别