2026-01-12 03:00:39
Gradle 是一款基于 Groovy 编写的 JVM 构建工具,其核心优势在于采用 DSL 替代 XML 描述构建逻辑,且被 Google 指定为 Android 官方构建工具。但国内开发者常因网络问题导致下载依赖缓慢,需通过手动配置优化构建流程。
一、Gradle 项目基础结构一个标准的 Gradle 项目需包含以下 6 个核心文件:
从
将文件放入自动生成的缓存目录:
Windows:C:/Users/[用户名]/.gradle/wrapper/dists/gradle-[版本]-bin/[随机字符串]/
Linux/macOS:/home/[用户名]/.gradle/wrapper/dists/gradle-[版本]-bin/[随机字符串]/
重新执行 gradlew build,系统将直接解压本地文件而非下载。
在 build.gradle 或 settings.gradle 中添加 JitPack 或阿里云镜像,加速依赖下载:
allprojects { repositories { maven { url '若项目目录不符合 Gradle 默认规范(如代码分散在 src/、demo/、test/ 等目录),需通过 sourceSets 自定义路径:
sourceSets { main.java.srcDirs += 'src' // 主代码目录 main.kotlin.srcDirs += 'src' // Kotlin 代码目录 test.java.srcDirs += ['test', 'demo'] // 测试代码目录 test.kotlin.srcDirs += ['test', 'demo']}四、Kotlin 项目配置示例若项目使用 Kotlin,需额外配置插件及标准库依赖:
buildscript { ext.kotlin_version = '1.1.1' repositories { mavenCentral() } dependencies { classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" }}apply plugin: 'kotlin' // 应用 Kotlin 插件dependencies { compile "org.jetbrains.kotlin:kotlin-stdlib-jre8:$kotlin_version" // Kotlin 标准库 testCompile "org.jetbrains.kotlin:kotlin-test-junit:$kotlin_version" // 测试库}五、完整 build.gradle 配置模板结合 Java 与 Kotlin 的混合项目配置示例:
group 'org.frice'version '1.0'allprojects { repositories { maven { url '通过以上配置,开发者可在国内网络环境下高效使用 Gradle,兼顾构建灵活性与执行效率。