在配置gradle构建配置时,通常需要告知gradle代码构建所需的依赖包从哪里下载,或者发布到什么地方去,那么就需要配置代码的repository,在build.gradle中,通常有三个地方需要配置。
repositories{}、
buildScripts.repositories{} 以及
publishing.repositories{}
gradle编译构建时所需的repositories支持很多种选择,比如我们选择使用本地文件,本地仓库,远程仓库,自定义仓库等,本地文件方式使用较少,在此不展开说明。
仓库地址配置
- 申明maven本地仓库 mavenLocal()
配置脚本如下:
repositories {
mavenLocal()
}
Gradle使用与Maven相同的策略去定位本地Maven缓存的位置。
如果在settings.xml中定义了本地Maven仓库的地址,则使用该地址。
在USER_HOME/.m2/settings.xml文件中的配置会覆盖M2_HOME/conf/settings.xml,
如果没有settings.xml配置文件,Gradle会使用默认的USER_HOME/.m2/repository地址。
注意:
- 我们配环境时很多时候都是使用MAVEN_HOME或者直接在path中输入bin路径了,导致mavenLocal 无法生效;
- 必须配置环境变量M2_HOME`
- 申明远程可用的制品仓库
配置脚本如下:
repositories {
jcenter()
}
- 通过URL申明自定义仓库
repositories {
maven {
url 'http://repo.mycompany.com/maven2'
}
}
gradle除了支持一个仓库外,还支持配置多个仓库,可以是不同类型的仓库
- 申明多个仓库
repositories {
jcenter()
maven {
url "https://maven.springframework.org/release"
}
maven {
url "https://maven.restlet.com"
}
}
- 申明仓库过滤器
repositories {
maven {
url "http://repo.mycompany.com/maven2"
content {
//这个制品库只包含组名以 "my.company"的工件
includeGroup "my.company"
}
}
jcenter {
content {
// 这个制品库包含所有的除了组名以 "my.company"开始的工件
excludeGroupByRegex "my\\.company.*"
}
}
}
- maven 仓库过滤器配置
repositories {
maven {
url "http://repo.mycompany.com/releases"
mavenContent {
releasesOnly()
}
}
maven {
url "http://repo.mycompany.com/snapshots"
mavenContent {
snapshotsOnly()
}
}
}
通常,为了安全起见,很多的制品库库需要认证,在配置时需要怎么操作呢?
下面列出了不同类型对应的认证方式
类型 | 认证方式 |
---|---|
file | none |
http | username/password |
https | username/password |
sftp | username/password |
s3 | access key/secret key/session token 或 环境变量 |
配置脚本如下:
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"
}
}
}
参考文档
gradle dsl链接: link.
gradle userguide