安装Mapbox后Android Studio每次构建Gradle自动开启离线模式如何解决
2026-10-1
永久禁用Gradle离线模式的解决方案
1. 修改全局Gradle配置文件
全局配置优先级最高，修改后不会被项目或IDE临时配置覆盖，路径对应如下：
- Windows：
C:\Users\<你的用户名>\.gradle\gradle.properties - Mac/Linux：
~/.gradle/gradle.properties
打开文件后查找org.gradle.offline配置项，存在的话将值修改为false，不存在直接新增一行：
org.gradle.offline=false
保存后重启Android Studio即可生效。
2. 检查项目本地Gradle配置
打开当前项目根目录下的gradle.properties文件，确认是否存在org.gradle.offline=true配置，如有则删除或修改值为false。
注意：部分Mapbox集成方案会自动写入离线模式配置，手动修改后将该文件提交到版本仓库，后续拉取代码不会再被自动覆盖。
3. 锁定Android Studio的Gradle配置
打开IDE设置页：
- Windows/Linux：
File > Settings > Build, Execution, Deployment > Build Tools > Gradle - Mac：
Android Studio > Settings > Build, Execution, Deployment > Build Tools > Gradle
取消勾选「Offline work」选项后点击Apply保存。再打开右侧Gradle工具窗口，确认顶部带斜杠wifi图标的「Toggle Offline Mode」按钮处于未选中状态。
4. 清理运行配置的离线参数
点击顶部运行按钮旁的配置下拉框，选择「Edit Configurations」，找到你的应用运行配置，检查「Gradle」分类下的「Arguments」输入框，删除其中的--offline参数后保存。
内容的提问来源于stack exchange，提问作者Cruces
相关产品推荐
相关产品推荐
