Android新环境中SDK、Gradle、依赖下载慢、镜像、JDK版本、构建慢问题

发表于 | 分类于
Android SDK、Gradle、依赖下载慢、镜像、JDK版本、构建慢问题

SDK下载慢

启动 Android SDK Manager ，打开主界面，依次选择「Tools」、「Options...」，弹出『Android SDK Manager - Settings』窗口；

在『Android SDK Manager - Settings』窗口中，在「HTTP Proxy Server」和「HTTP Proxy Port」输入框内填入mirrors.neusoft.edu.cn和80，并且选中「Force https://... sources to be fetched using http://...」复选框。设置完成后单击「Close」按钮关闭『Android SDK Manager - Settings』窗口返回到主界面；

依次选择「Packages」、「Reload」。

由于某些网络接入商进行了劫持，会弹出用户认证界面无法使用，和本镜像服务器配置无关。

Gradle下载慢

比如我用的是8.4版本

官方自动下载的地址是：

https://services.gradle.org/distributions/gradle-8.4-bin.zip

更改地址

gradle/wrapper/gradle-wrapper.properties

1
2
3
4
5
6
#Wed Mar 20 15:45:42 HKT 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

替换为

1
2
3
4
5
6
#Wed Mar 20 15:45:42 HKT 2024
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.4-all.zip
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists

注意:

更改地址，保存的路径也会变化，如果已经手动下载过，就不要更改地址，会重新下载

位置

1
start %userprofile%\.gradle\wrapper\dists\gradle-8.4-all\8bq4mb83wz2dwo2fvpnuek2vl

这里之所以不用

1
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.4-bin.zip

是因为在新版本Android Studio中每次都会下载源码gradle-8.4-src.zip

https://services.gradle.org/distributions/gradle-8.4-src.zip

目前不知道是新版本Android Studio的问题，还是gradle-8.4的问题

手动下载

我们可以通过上面的地址下载，如果慢可以使用镜像地址：

https://mirrors.cloud.tencent.com/gradle/

搜索gradle-8.4-bin.zip

https://mirrors.cloud.tencent.com/gradle/gradle-8.4-bin.zip

下载后，把zip文件放在类似这样的路径下，重新启动Android Studio即可。

1
C:\Users\18351\.gradle\wrapper\dists\gradle-8.4-bin\1w5dpkrfk8irigvoxmyhowfim

可以通过这个命令打开

1
start %userprofile%\.gradle\wrapper\dists\gradle-8.4-bin\1w5dpkrfk8irigvoxmyhowfim

依赖下载慢

Groovy

找到项目下的build.gradle文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
pluginManagement {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
        google()
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven { url 'https://maven.aliyun.com/repository/central' }
        maven { url 'https://maven.aliyun.com/repository/public' }
        maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
        maven { url 'https://maven.aliyun.com/repository/apache-snapshots' }
        maven { url "https://jitpack.io" }
        maven { url 'http://download.flutter.io' }
        google()
        mavenCentral()
    }
}

KTS

settings.gradle.kts

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
pluginManagement {
    repositories {
        maven("https://maven.aliyun.com/repository/central")
        maven("https://maven.aliyun.com/repository/public")
        maven ("https://maven.aliyun.com/repository/gradle-plugin")
        maven ("https://maven.aliyun.com/repository/apache-snapshots")
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }
        mavenCentral()
        gradlePluginPortal()
    }
}
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        maven("https://maven.aliyun.com/repository/central");
        maven("https://maven.aliyun.com/repository/public");
        maven("https://maven.aliyun.com/repository/gradle-plugin")
        maven("https://maven.aliyun.com/repository/apache-snapshots")
        google()
        mavenCentral()
    }
}

支持Flutter

1
2
3
4
maven("http://download.flutter.io") {
    // 信任http协议
    isAllowInsecureProtocol = true
}

或者华为的镜像地址

1
maven("https://mirrors.huaweicloud.com/repository/maven/")

更换JDK版本

报错信息

Your build is currently configured to use incompatible Java 21.0.6 and Gradle 6.7.1. Cannot sync the project.

设置中配置

image-20250924100237470

JDK与Gradle版本关系

JDK 版本 支持的 Gradle 最低版本
JDK 8 Gradle 3.x
JDK 9-10 Gradle 4.x
JDK 11 Gradle 5.0
JDK 12 Gradle 5.4.1
JDK 13-14 Gradle 5.x
JDK 15-16 Gradle 6.x
JDK 17 Gradle 7.2
JDK 21 Gradle 8.x

NDK设置

如果项目报错

Caused by: org.gradle.api.InvalidUserDataException: NDK not configured

NDK not configured. Download it with SDK manager. Preferred NDK version is ‘21.0.6113669’.

这是因为没有安装NDK

让 Android Studio 自动装

  1. 打开 Android Studio
  2. 菜单：Tools → SDK Manager → SDK Tools 标签页
  3. 勾选 NDK (Side by side) 和 CMake（如下图）
  4. 点击 Apply/OK，它会自动下载并配置好
  5. 下载完后重新 Sync Project with Gradle Files（工具栏小象图标）

我这里安装的版本

  • NDK (Side by side) → 版本 21.0.6113669
  • CMake → 版本 3.10.2

一直卡构建

查看构建日志

1
./gradlew build --stacktrace --debug > build.log

查看日志中有没有报错

如果有，按照错误提示处理，如果没有往下看。

看看android节点下有没有cmake

1
2
3
4
5
externalNativeBuild {
    cmake {
        path 'src/main/cpp/CMakeLists.txt'
    }
}

如果有，先注释掉，如果能运行，就是cmake导致的。

尝试命令行构建

1
./gradlew assembleDebug --info

看是否能正常构建 native 代码。

如果这里卡住，说明问题出在 CMake 构建阶段。

有时候是缓存问题：

1
2
./gradlew clean
./gradlew --stop

后文

经过一系列尝试，最终找到原因，新版本的Android Studio和老版本的Gradle不兼容，这里升级到7.5就可以了，升级到8.x也不行也不兼容。