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

一、简介

• 通过 AS 创建好项目后，需要更换一下代理方便后续安装会效率点。

• 这里的代理选择使用 阿里开源镜像站，如果网络没问题，可以不更换的，你懂的！！！不好的话就需要进行更换会比较好，或者按需更换也行。

• 如果啥都不加不改，对项目没有任何影响，只是单纯的安装下载速度慢，或者安装下载失败，下载失败会导致项目运行不起来。

二、gradle 更换国内镜像地址

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

  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 里面

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

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

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

  • settings.gradle.kts

    // 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

    // 
    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'