build.gradle之Repository配置_gradle repositories

在配置gradle构建配置时，通常需要告知gradle代码构建所需的依赖包从哪里下载，或者发布到什么地方去，那么就需要配置代码的repository，在build.gradle中，通常有三个地方需要配置。
repositories{}、
buildScripts.repositories{} 以及
publishing.repositories{}
gradle编译构建时所需的repositories支持很多种选择，比如我们选择使用本地文件，本地仓库，远程仓库，自定义仓库等，本地文件方式使用较少，在此不展开说明。

仓库地址配置

• 申明maven本地仓库 mavenLocal()
  配置脚本如下：

repositories {
    mavenLocal()
}
1
2
3

Gradle使用与Maven相同的策略去定位本地Maven缓存的位置。
如果在settings.xml中定义了本地Maven仓库的地址，则使用该地址。
在USER_HOME/.m2/settings.xml文件中的配置会覆盖M2_HOME/conf/settings.xml，
如果没有settings.xml配置文件，Gradle会使用默认的USER_HOME/.m2/repository地址。
1
2
3
4

注意：

1. 我们配环境时很多时候都是使用MAVEN_HOME或者直接在path中输入bin路径了，导致mavenLocal 无法生效;
2. 必须配置环境变量M2_HOME`

• 申明远程可用的制品仓库
  

配置脚本如下：

repositories {
    jcenter()
}
1
2
3

• 通过URL申明自定义仓库

repositories {
    maven {
      url 'http://repo.mycompany.com/maven2'
    }
}
1
2
3
4
5

gradle除了支持一个仓库外，还支持配置多个仓库，可以是不同类型的仓库

• 申明多个仓库

repositories {
    jcenter()
    maven {
        url "https://maven.springframework.org/release"
    }
    maven {
        url "https://maven.restlet.com"
    }
}
1
2
3
4
5
6
7
8
9

• 申明仓库过滤器

repositories {
    maven {
        url "http://repo.mycompany.com/maven2"
        content {
            //这个制品库只包含组名以 "my.company"的工件
            includeGroup "my.company"
        }
    }
    jcenter {
        content {
            // 这个制品库包含所有的除了组名以 "my.company"开始的工件
            excludeGroupByRegex "my\\.company.*"
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

• maven 仓库过滤器配置

repositories {
    maven {
        url "http://repo.mycompany.com/releases"
        mavenContent {
            releasesOnly()
        }
    }
    maven {
        url "http://repo.mycompany.com/snapshots"
        mavenContent {
            snapshotsOnly()
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

通常，为了安全起见，很多的制品库库需要认证，在配置时需要怎么操作呢？
下面列出了不同类型对应的认证方式

配置脚本如下：

repositories {
    maven {
        url "http://repo.mycompany.com/maven2"
        credentials {
            username 'user'
            password 'password'
        }
    }
    maven {
        url "sftp://repo.mycompany.com:22/maven2"
        credentials {
            username 'user'
            password 'password'
        }
    }
    ivy {
        url "s3://myCompanyBucket/ivyrepo"
        credentials(AwsCredentials) {
            accessKey "someKey"
            secretKey "someSecret"
            //可选项
            sessionToken "someSTSToken"
        }
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

参考文档
gradle dsl链接: link.
gradle userguide