Android Kotlin 项目代理配置【详细步骤（可选）】

一、简介

通过 AS 创建好项目后，需要更换一下代理方便后续安装会效率点。
这里的代理选择使用阿里开源镜像站，如果网络没问题，可以不更换的，你懂的！！！不好的话就需要进行更换会比较好，或者按需更换也行。
如果啥都不加不改，对项目没有任何影响，只是单纯的安装下载速度慢，或者安装下载失败，下载失败会导致项目运行不起来。

二、`gradle` 更换国内镜像地址

确认当前项目的 gradle 版本 8.7：

sh 复制代码

distributionUrl=https://services.gradle.org/distributions/gradle-8.7-bin.zip

打开阿里开源镜像站搜索 gradle：

1、点击打开

2、再点击下载地址

3、点击 distributions

4、搜索对应的版本号 8.7，带 RC 的可以理解为之前的预发布版本，没有带 RC 的 8.7 才是最终的正式版本。

5、点击 8.7 版本进入，根据项目中的 distributionUrl 链接后缀选择对应的文件名，右键复制链接。

6、贴入项目中，注意看下之前的旧链接 https 后面是有个 \ 的，所以新链接需要自己补上，跟之前的保持一样，保持 https\:// 开头。

7、配置好后需要进行同步，AS 工具右上角一个小象样子的图标就是同步按钮，也可以走命令行，自行搜索。

8、这样就算更换好了 gradle 国内下载地址。

二、`maven` 更换国内镜像地址

不要盲目的去进行 maven 添加，最好了解清楚它的源有什么作用，加常用的就行
- public → 开源库（Retrofit、Gson等）
- google → AndroidX组件（Material Design、Lifecycle等）
- gradle-plugin → 构建工具（Android Gradle插件等）
- jcenter → 备用（老版本库）
总结：前三个是必加的，第四个按需添加。 这样配置既能保证下载速度，又不会添加不必要的镜像。
首先还是一样，先找到 maven 的镜像地址，打开阿里开源镜像站搜索 maven，点击打开，在点击下载地址进入 maven 仓库页面，选择仓库文件：maven.aliyun.com/mvn/view

在这里找到自己需要的镜像地址即可。

然后根据 Kotlin DSL（build.gradle.kts） 与 Groovy DSL（build.gradle） 不同的文件格式完成对应的配置。

1、如何判断项目使用哪种 DSL？看文件扩展名：

.kts = Kotlin DSL
.gradle = Groovy DSL

2、推荐配置顺序：

首选 → settings.gradle.kts 或 settings.gradle ✅
次选 → 项目级 build.gradle.kts 或 build.gradle
最后 → 模块级 build.gradle.kts 或 build.gradle

3、不是全部都要配置，而是选择其中一个文件配置就行，配置位置的影响：

配置位置	作用范围	推荐度	特点
settings.gradle	✅ 全局生效（所有模块）	⭐⭐⭐⭐⭐ 首选	一次配置，所有模块共享
项目级 build.gradle	🔄 项目级生效	⭐⭐⭐⭐ 次选	影响项目级配置
模块级 build.gradle	🔴 仅当前模块生效	⭐⭐ 最后选择	需要每个模块单独配置

4、settings.gradle.kts 或 settings.gradle 文件中的 pluginManagement 与 dependencyResolutionManagement 是有用途区分的，

pluginManagement
- 用途：管理 Gradle 插件的下载和解析
- 作用范围：只影响插件的下载，不影响项目依赖
- 配置内容：主要用于 Gradle 插件相关的仓库
dependencyResolutionManagement
- 用途：管理项目依赖的下载和解析
- 作用范围：影响所有项目依赖的下载
- 配置内容：用于项目代码中使用的所有依赖库

5、不能在 repositories 块外面直接写 maven，要写在 repositories 里面

kotlin 复制代码

// ❌ 错误写法：编译失败
pluginManagement {
    maven { url = uri("https://...") } // 不允许！
    repositories {
        // ...
    }
}

// ❌ 错误写法：编译失败  
dependencyResolutionManagement {
    maven { url = uri("https://...") } // 不允许！
    repositories {
        // ...
    }
}

6、注意：不要在多个地方重复配置，这样会配置冗余，难以维护，产生冲突。

书写格式，其他自行根据需要调整

settings.gradle.kts

kotlin 复制代码

// settings.gradle.kts
pluginManagement {
    repositories {
        // 1. Gradle 插件镜像（必须）
        maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
        // 2. 公共仓库镜像（必须）
        maven { url = uri("https://maven.aliyun.com/repository/public") }

        // 原始仓库作为备份（保证可靠性）
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 1. 公共仓库镜像（必须）- 用于大多数开源库
        maven { url = uri("https://maven.aliyun.com/repository/public") }
        // 2. Google 仓库镜像（必须）- 用于AndroidX和Google库
        maven { url = uri("https://maven.aliyun.com/repository/google") }

        // 原始仓库作为备份（保证可靠性）
        google()
        mavenCentral()
    }
}

rootProject.name = "MyApp"
include(":app")

settings.gradle

kotlin 复制代码

// 
pluginManagement {
    repositories {
        // 1. Gradle 插件镜像（必须）
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        // 2. 公共仓库镜像（必须）
        maven { url 'https://maven.aliyun.com/repository/public' }

        // 原始仓库作为备份（保证可靠性）
        gradlePluginPortal()
        google()
        mavenCentral()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // 1. 公共仓库镜像（必须）- 用于大多数开源库
        maven { url 'https://maven.aliyun.com/repository/public' }
        // 2. Google 仓库镜像（必须）- 用于AndroidX和Google库
        maven { url 'https://maven.aliyun.com/repository/google' }

        // 原始仓库作为备份（保证可靠性）
        google()
        mavenCentral()
    }
}

rootProject.name = "MyApp"
include ':app'

Android Kotlin 项目代理配置【详细步骤（可选）】

一、简介

二、gradle 更换国内镜像地址

二、maven 更换国内镜像地址

二、`gradle` 更换国内镜像地址

二、`maven` 更换国内镜像地址