在 Android 开发过程中,为了提高依赖库下载速度并确保稳定性,我们可以选择配置阿里云的 Maven 镜像。本文将指导您如何在顶级 settings.gradle.kts
和 build.gradle
文件中添加阿里云的 Maven 仓库地址。
settings.gradle.kts 中的配置
在 settings.gradle.kts
文件中,我们通过 pluginManagement 和 dependencyResolutionManagement 部分为所有子模块统一配置 Maven 仓库:
pluginManagement {
repositories {
maven {
url = uri("https://maven.aliyun.com/nexus/content/groups/public/")
}
maven {
url = uri("https://maven.aliyun.com/nexus/content/repositories/jcenter")
}
google()
mavenCentral()
gradlePluginPortal()
}
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven {
url = uri("https://maven.aliyun.com/nexus/content/groups/public/")
}
maven {
url = uri("https://maven.aliyun.com/nexus/content/repositories/jcenter")
}
google()
mavenCentral()
}
}
这将全局管理 Gradle 插件和依赖解析时使用的仓库列表,并优先使用阿里云镜像来获取资源。
build.gradle 或 build.gradle.kts 中的配置
对于旧版本的 Android 项目(使用 Groovy DSL),通常会在顶级 build.gradle
文件中进行如下配置:
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
// 添加阿里云 Maven 地址
maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
google()
// jcenter() // 如果需要也可以保留,但阿里云镜像已包含 JCenter 的大部分内容
}
dependencies {
classpath 'com.android.tools.build:gradle:3.2.1'
// 其他应用级别的插件或工具类库请勿放在此处,应放置于各模块的 build.gradle 文件中
}
}
allprojects {
repositories {
// 添加阿里云 Maven 地址
maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }
maven { url 'https://maven.aliyun.com/nexus/content/repositories/jcenter' }
google()
// jcenter() // 同样可选保留
}
}
通过上述配置,您可以在 Android 项目的整个构建过程中利用阿里云提供的 Maven 镜像,从而提高依赖下载速度,优化构建体验。需要注意的是,由于 JCenter 已不再维护,大多数开源库已迁移至 MavenCentral,因此,在实际使用中,可能只需配置 MavenCentral 和阿里云公共仓库即可满足大部分需求。