gradle 基本配置介绍

最新推荐文章于 2025-09-09 19:57:20 发布

原创最新推荐文章于 2025-09-09 19:57:20 发布 · 9.2k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#android #java #gradle

android 专栏收录该内容

1 篇文章

订阅专栏

本文介绍了Gradle这一基于Apache Ant和Maven概念的自动化构建工具。它采用Groovy DSL进行项目配置，支持Java、Groovy和Scala等语言。文中详细讲解了Gradle的基本结构及其在Android Studio中的应用。

gradle

https://gradle.org

Gradle是一个基于Apache Ant和Apache Maven概念的项目自动化建构工具。它使用一种基于Groovy的特定领域语言(DSL)来声明项目设置，抛弃了基于XML的各种繁琐配置。
面向Java应用为主。当前其支持的语言限于Java、Groovy和Scala，计划未来将支持更多的语言。

Android Studio下载与安装中新建项目成功后会下载Gradle

Mac上会默认下载到 /Users/<用户名>/.gradle/wrapper/dists 目录
Win平台会默认下载到 C:\Documents and Settings\<用户名>.gradle\wrapper\dists 目录

文件介绍

模块/build.gradle

//声明是Android 程序
apply plugin: 'com.android.application'

//配置了用于 android 构建的所有参数。这是Android DSL的入口。
//默认情况下，只需要配置编译目标，以及build-tools的版本。
//它通过compileSdkVersion和buildtoolsVersion属性来完成。
//提示：你应该只配置使用这个android插件。如果同时配置使用了java插件也会导致构建错误。
android {
    //编译SDK的版本
    compileSdkVersion 19
    //build tools 的版本
    // 构建工具的版本，其中包括了打包工具aapt、dx等等。
    // 这个工具的目录位于..sdk_path/build-tools/XX.XX.XX
    buildToolsVersion "19.1.0"

    //在android元素的内部的defaultConfig元素是定义所有这些配置的地方。
    defaultConfig {
        // 应用的包名
        applicationId "com.example.lidecheng.myapplication"
        minSdkVersion 14
        targetSdkVersion 19
        versionCode 1
        versionName "1.0"
    }

    // java版本
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }

    buildTypes {
        release {
            // 是否进行混淆
            minifyEnabled false
            // 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }


    // 移除lint检查的error
    lintOptions {
        abortOnError false
    }
}

dependencies {
    //编译libs目录下的所有jar包
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:19.+'
}

// 这个文件是app文件夹下这个Module的gradle配置文件，也可以算是整个项目最主要的gradle配置文件

项目/build.gradle

// Top-level build file where you can add configuration options common to all sub-projects/modules.
//整个项目的gradle基础配置文件
//buildscript { ... }配置了驱动构建的代码。
// 声明了使用jcenter 中央库，并且对一个Maven 文件有一个类路径依赖。
// 这个文件是包含 Gradle Android 插件的 1.5.0版本的库
buildscript {
    repositories {
        jcenter()
    }

    dependencies {
        //声明了android gradle plugin的版本
        classpath 'com.android.tools.build:gradle:1.5.0'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

// 内容主要包含了两个方面：一个是声明仓库的源，这里可以看到是指明的jcenter(), 之前版本则是mavenCentral(), jcenter可以理解成是一个新的中央远程仓库，兼容maven中心仓库，而且性能更优。另一个是声明了android gradle plugin的版本，android studio 1.0正式版必须要求支持gradle plugin 1.0的版本。

settings.gradle

//全局的项目配置文件
include ':app'

gradle-wrapper.properties

#声明了gradle的目录与下载路径以及当前项目使用的gradle版本，
#这些默认的路径我们一般不会更改的，这个文件里指明的gradle版本不对也是很多导包不成功的原因之一。

distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.8-all.zip

local.properties

## This file is automatically generated by Android Studio.
# Do not modify this file -- YOUR CHANGES WILL BE ERASED!
//通过sdk.dir属性来设置 SDK 的位置，并且所设置的这个SDK要求存在。 
//或者，您也可以设置一个ANDROID_HOME环境变量。这两种方法之间没什么差别
ndk.dir=/Users/lidecheng/Documents/android/android-sdk-macosx-2/ndk-bundle
sdk.dir=/Users/lidecheng/Documents/android/android-sdk-macosx-2