Gradle for Android（一）基本配置、依赖管理

收藏吴小龙公众号
http://url.cn/4E50y3b
http://url.cn/4E1zrsF
http://url.cn/4EyQY8P

Gradle是一种基于Groovy的动态DSL，而Groovy语言是一种基于jvm的动态语言。这里只分享实际开发中会用到的场景，您不需要去学习Groovy语言，知道Java的您是很容易阅读Groovy语言的。

新建项目，目录结构如下：

app/build.gradle

初始化的Gradle配置：

//表示该module是一个app module，应用了com.android.application插件，如果是一个android library，那么这里写apply plugin: ‘com.android.library’
apply plugin: 'com.android.application'

android {
    compileSdkVersion 23//基于哪个SDK编译，这里是API LEVEL
    buildToolsVersion "23.0.2"//基于哪个构建工具版本进行构建的。

    defaultConfig {/默认配置，如果没有其他的配置覆盖，就会使用这里的。
        applicationId "com.wuxiaolong.gradle4android" //配置包名的
        minSdkVersion 15
        targetSdkVersion 23
        versionCode 1//版本号
        versionName "1.0"//版本名称
    }
    buildTypes {//是构建类型，常用的有release和debug两种，可以在这里面启用混淆，启用zipAlign以及配置签名信息等。


        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {//不属于Android专有的配置了，它定义了该module需要依赖的jar，aar，jcenter库信息。
    compile fileTree(dir: 'libs', include: ['*.jar'])
    testCompile 'junit:junit:4.12'
    compile 'com.android.support:appcompat-v7:23.2.1'
    compile 'com.android.support:design:23.2.1'
}

gradle-wrapper.properties

声明了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

根目录的build.gradle

定义在这个工程下的所有模块的公共属性

buildscript {
    repositories {
        jcenter()//使用jcenter库
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.5.0'// 依赖android提供的1.5.0的gradle build

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}
//为所有的工程的repositories配置为jcenters
allprojects {
    repositories {
        jcenter()
    }
}

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

setting.gradle

包含哪些模块，比如有app和library：

include ':app', ':googleLibrary', ':pickerview'

依赖管理

本地依赖
jar

默认情况下，新建的Android项目会有一个lib文件夹

dependencies {
       compile fileTree(dir: 'libs', include: ['*.jar'])//即添加所有在libs文件夹中的jar
       //compile files('libs/WuXiaolong.jar')//不需要这样一个个去写了
}

so包

用c或者c++写的library会被叫做so包，Android插件默认情况下支持native包，你需要把.so文件放在对应的文件夹中

图片.png

library工程

直接依赖library库：

dependencies {
      compile project(':library名字')
      //多个library，libraries是文件夹名字
      compile project(':libraries:library名字')
 }

aar文件

library库输出文件是.aar文件，包含了Android资源文件，在library工程build/output/aar/下，然后app目录下创建一个aars文件夹，然后把.aar文件拷贝到该文件夹里面，然后添加该文件夹作为依赖库：app/bulid.gradle

ndroid {
    //...
}
repositories {
    flatDir {
        dirs 'aars' 
    }
}
dependencies {
       compile(name:'libraryname', ext:'aar')
}

如何生成.aar文件：执行 ./gradlew assembleRelease，然后就可以在 build/outputs/aar 文件夹里生成aar文件

.jar和.aar区别：*.jar：只包含了class文件与清单文件，不包含资源文件，如图片等所有res中的文件；

*.aar：包含所有资源，class以及res资源文件全部包含。

注意：如果你的library依赖了第三方库aar，须app再次依赖。比如lib1依赖了lib2 的aar，app依赖lib1，需要：

dependencies {
    compile(name: 'library1-release', ext: 'aar')
    compile(name: 'library2-release', ext: 'aar')
}

远程仓库

dependencies {
    compile 'com.wuxiaolong.pullloadmorerecyclerview:library:1.0.4'
}

完整配置

https://github.com/WuXiaolong/Gradle4Android