API 文档 | MavenArtifactRepository |
---|
使用 Maven 格式存储工件和元数据的工件仓库。
此类仓库由 RepositoryHandler.maven(org.gradle.api.Action)
方法组创建。
属性 | 描述 |
allowInsecureProtocol | 指定是否允许通过不安全的 HTTP 连接与仓库通信。 |
artifactUrls | 用于查找工件文件的附加 URL。请注意,这些 URL 不用于查找 POM 文件。 |
authentication | 此仓库的认证方案。 |
credentials | 用于此仓库认证的指定类型的凭据。 |
name | 此仓库的名称。名称在仓库集中必须唯一。如果未提供名称,则会为仓库提供一个默认名称。 |
url | 此仓库的基础 URL。此 URL 用于查找 POM 和工件文件。您可以使用 |
方法 | 描述 |
artifactUrls(urls) | 添加一些用于查找工件文件的附加 URL。请注意,这些 URL 不用于查找 POM 文件。 |
authentication(action) | 配置此仓库的认证方案。 |
credentials(credentialsType) | 配置此仓库将由构建提供的凭据。 |
credentials(credentialsType, action) | 使用提供的action配置此仓库的凭据。 |
credentials(action) | 使用提供的action配置此仓库的用户名和密码凭据。 |
metadataSources(configureAction) | 配置此仓库的元数据源。此方法将替换任何先前配置的元数据源。 |
指定是否允许通过不安全的 HTTP 连接与仓库通信。
出于安全目的,这有意要求用户逐个案例选择使用不安全协议。
Gradle 有意不提供允许全局禁用此检查的系统/gradle 属性。
允许通过不安全协议进行通信,可能导致中间人冒充目标服务器,并让攻击者有机会向系统提供恶意可执行代码。
AuthenticationContainer
authentication
(只读)
此仓库的认证方案。
URI
url
此仓库的基础 URL。此 URL 用于查找 POM 和工件文件。您可以使用 MavenArtifactRepository.setArtifactUrls(java.lang.Iterable)
添加用于查找工件文件(例如 jar 包)的附加 URL。
void
artifactUrls
(Object
...
urls)
Object
...添加一些用于查找工件文件的附加 URL。请注意,这些 URL 不用于查找 POM 文件。
所提供的值根据 Project.uri(java.lang.Object)
进行评估。这意味着,例如,您可以传入一个 File
对象,或一个相对于项目目录的相对路径。
void
authentication
(Action
<? super AuthenticationContainer
>
action)
Action
<? super AuthenticationContainer
>配置此仓库的认证方案。
此方法针对此项目的 AuthenticationContainer
执行给定操作。 AuthenticationContainer
作为闭包的委托传递给闭包。
如果此仓库未分配认证方案,则会根据仓库的传输方案使用一组默认认证方案。
repositories {
maven {
url = "https://example.com/m2"
authentication {
basic(BasicAuthentication)
}
}
}
支持的认证方案类型扩展自Authentication
。
void
credentials
(Class
<? extends Credentials
>
credentialsType)
Class
<? extends Credentials
>配置此仓库将由构建提供的凭据。
凭证将根据仓库名称从 Gradle 属性中提供。如果此仓库的凭证无法解析,并且此仓库将在当前构建中使用,则构建将无法启动并指向缺失的配置。
repositories {
maven {
url = "https://example.com/m2"
credentials(PasswordCredentials)
}
}
credentialsType
参数目前支持以下凭据类型:
使用提供的action配置此仓库的凭据。
如果尚未为此仓库分配凭证,则将为空的指定类型凭证集分配给此仓库,并将其提供给配置操作。如果已为此仓库指定凭证,则它们将传递给给定的配置操作。
repositories { maven { url = "https://example.com/aws/proxy" credentials(AwsCredentials) { accessKey = "myAccessKey" secretKey = "mySecret" } } }
credentialsType
参数目前支持以下凭据类型:
void
credentials
(Action
<? super PasswordCredentials
>
action)
Action
<? super PasswordCredentials
>使用提供的action配置此仓库的用户名和密码凭据。
如果此仓库未分配凭据,则将一组空的用户名和密码凭据分配给此仓库并传递给action。
repositories { maven { url = "https://example.com/m2" credentials { username = 'joe' password = 'secret' } } }
void
metadataSources
(Action
<? super MetadataSources
>
configureAction)
Action
<? super MetadataSources
>配置此仓库的元数据源。此方法将替换任何先前配置的元数据源。