529 words
3 minutes
Android开发第一课

这是一个系列文章,内容是关于Android的日常开发,记录Android开发的日常遇到的坑以及处理方式,囊括Android Studio的配置和使用,常用库的使用,Android基础和进阶,Kotlin,Flutter相关的内容

Android 开发第一课#

相信很多刚入Android开发的小伙伴都遇到过一个问题,跟这教程新建了一个Hello World项目,底下红红的failed日志,项目根本跑不起来,要么就是等半天Android工程目录也没有加载成功,还没开始就想放弃了,今天我们就来解决这个问题,让你的Hello World运行起来

Gradle 环境配置#

众所周知,Gradle和git在国内的速度堪忧,你的Hello World之所以运行不起来,就是卡在了这一步,项目依赖下载不下来,想要解决这个问题只需要做两件事:

  1. 加速Gradle本体的下载: 将项目目录中<项目文件夹>/gradle/wrapper/gradle-wrapper.properties中的下载地址替换成腾讯云的gradle镜像地址即可

原地址:

Terminal window
distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip

替换成:

Terminal window
distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-9.6.0-bin.zip
  1. 加速maven依赖下载 在项目文件夹目录下的settings.gradle.kts文件中添加阿里云的maven地址,加速依赖下载

原settings.gradle.kts的内容:

pluginManagement {
repositories {
google {
content {
includeGroupByRegex("com\\.android.*")
includeGroupByRegex("com\\.google.*")
includeGroupByRegex("androidx.*")
}
}
mavenCentral()
gradlePluginPortal()
}
}
plugins {
id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
}
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
google()
mavenCentral()
}
}
rootProject.name = "Hello World"
include(":app")

修改后的settings.gradle.kts内容:

// 第1处修改
pluginManagement {
repositories {
// 阿里云镜像替代 google,保持原有content过滤规则
maven {
url = uri("https://maven.aliyun.com/repository/google")
content {
includeGroupByRegex("com\\.android.*")
includeGroupByRegex("com\\.google.*")
includeGroupByRegex("androidx.*")
}
}
// 阿里云公共仓库,替代 mavenCentral
maven { url = uri("https://maven.aliyun.com/repository/public") }
// gradle插件镜像
maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin") }
gradlePluginPortal() // 兜底,放最后
}
}
plugins {
id("org.gradle.toolchains.foojay-resolver-convention") version "1.0.0"
}
// 第2处修改
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
repositories {
maven {
url = uri("https://maven.aliyun.com/repository/google")
content {
includeGroupByRegex("com\\.android.*")
includeGroupByRegex("com\\.google.*")
includeGroupByRegex("androidx.*")
}
}
maven { url = uri("https://maven.aliyun.com/repository/public") }
}
}
rootProject.name = "Hello World"
include(":app")

最后,点击底部build栏左上角的Sync Gradle Project按钮,等待同步完成就可以开始你的安卓之旅了

Tips: 内容在不断更新中…

Android开发第一课
https://www.gmi91.top/en/posts/androidfirstlesson/
Author
gmi91
Published at
2026-10-10