You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Android Studio Gradle同步构建耗时10-15分钟,无法找到Offline Work设置

Gradle同步构建耗时过长的问题解决

10-15分钟的Gradle同步与构建耗时完全不正常,正常情况下模板项目的首次构建通常在5分钟以内(视网络和硬件配置而定),后续构建会更快。以下是具体的优化方案:

一、找到并启用离线模式(Offline Work)

Android Studio新版本(Arctic Fox及以后)调整了离线模式的位置,你可以通过两种方式找到:

  • 方式1:点击右上角侧边栏的Gradle面板(若未显示,通过View > Tool Windows > Gradle调出),面板顶部有个闪电图标,点击即可切换离线模式(hover时显示"Toggle Offline Mode")。
  • 方式2:打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle,在右侧找到Offline mode勾选框并启用。

二、配置国内镜像源提速依赖下载

Gradle默认依赖仓库在国外,国内网络下速度极慢,替换为国内镜像能大幅缩短同步时间:

  1. 项目级配置:打开项目根目录的build.gradle文件,修改repositories块:
repositories {
    maven { url 'https://maven.aliyun.com/repository/public/' }
    maven { url 'https://maven.aliyun.com/repository/google/' }
    maven { url 'https://maven.aliyun.com/repository/jcenter/' }
    google()
    mavenCentral()
}
  1. 全局配置(所有项目通用):在用户目录下找到.gradle/init.gradle文件(没有则新建),添加:
allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/public/' }
        maven { url 'https://maven.aliyun.com/repository/google/' }
        maven { url 'https://maven.aliyun.com/repository/jcenter/' }
        google()
        mavenCentral()
    }
}

三、升级Gradle与Android Gradle Plugin(AGP)版本

新版本的Gradle和AGP对构建性能做了大量优化,建议使用官方稳定版的最新版本:

  • 在项目根目录的build.gradle中,更新com.android.tools.build:gradle的版本到当前稳定版(如8.4.x);
  • 在gradle/wrapper/gradle-wrapper.properties中,更新distributionUrl对应的Gradle版本,确保与AGP版本兼容(可参考Android Studio官方版本对应关系)。

四、启用Gradle构建缓存

Gradle构建缓存会复用之前的构建结果,大幅缩短后续构建时间:
打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle,勾选Build cache选项,选择Local即可(本地缓存足够日常开发使用)。

五、优化硬件与Studio配置

  • 分配更多内存给Android Studio:打开Help > Edit Custom VM Options,修改-Xmx参数,比如改为-Xmx4096m(根据电脑总内存调整,建议至少分配4GB);
  • 使用固态硬盘(SSD):SSD的读写速度远快于机械硬盘,能显著提升项目加载和构建速度。

内容的提问来源于stack exchange,提问作者Shourya Rajput

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.17 18:22:42