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)
添加其他 URL 以查找组件文件,例如 jar 文件。
void
artifactUrls
(Object
...
urls)
Object
...添加一些附加 URL 以用于查找组件文件。请注意,这些 URL 不用于查找 POM 文件。
提供的数值按照 Project.uri(java.lang.Object)
进行评估。这意味着,例如,您可以传入一个 File
对象,或相对于项目目录评估的相对路径。
void
authentication
(Action
<? super AuthenticationContainer
>
action)
Action
<? super AuthenticationContainer
>配置此仓库的身份验证方案。
此方法针对此项目的 AuthenticationContainer
执行给定的 action。AuthenticationContainer
作为 closure 的委托传递给 closure。
如果未为此仓库分配任何身份验证方案,则会根据仓库的传输方案使用默认的身份验证方案集。
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 配置此仓库的凭据。
如果未为此仓库分配凭据,则指定类型的空凭据集将分配给此仓库并提供给配置 action。如果已为此仓库指定凭据,则会将它们传递给给定的配置 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
>配置此仓库的元数据源。此方法将替换任何先前配置的元数据源。