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

发表于 | 分类于 | 阅读次数：

Gradle是一种基于Groovy的动态DSL，而Groovy语言是一种基于jvm的动态语言。这里只分享实际开发中会用到的场景，您不需要去学习Groovy语言，知道Java的您是很容易阅读Groovy语言的。
系列博客涉及的知识点有：Gradle基本配置、依赖管理、全局设置、自定义BuildConfig、混淆、多渠道打包、配置签名信息、单元测试，是不是迫不及待了啊，快来学习学习。

基本配置

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

app/build.gradle

初始化的Gradle配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
apply plugin: 'com.android.application'
android {
    compileSdkVersion 23
    buildToolsVersion "23.0.2"
    defaultConfig {
        applicationId "com.wuxiaolong.gradle4android"
        minSdkVersion 15
        targetSdkVersion 23
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}
dependencies {
    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'
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
apply plugin: ‘com.android.application’，表示该module是一个app module，应用了com.android.application插件，如果是一个android library，那么这里写apply plugin: ‘com.android.library’
compileSdkVersion：基于哪个SDK编译，这里是API LEVEL
buildToolsVersion：基于哪个构建工具版本进行构建的。
defaultConfig：默认配置，如果没有其他的配置覆盖，就会使用这里的。
applicationId：配置包名的
versionCode：版本号
versionName：版本名称
buildTypes是构建类型，常用的有release和debug两种，可以在这里面启用混淆，启用zipAlign以及配置签名信息等。
dependencies：不属于Android专有的配置了，它定义了该module需要依赖的jar，aar，jcenter库信息。

gradle-wrapper.properties

声明了gradle的目录与下载路径以及当前项目使用的gradle版本，这些默认的路径我们一般不会更改的

1
2
3
4
5
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

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
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：

1
include ':app',':library'

依赖管理

本地依赖

jar

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

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

so包

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

1
2
3
4
5
6
7
8
9
10
11
app
   ├── AndroidManifest.xml
   └── jniLibs
       ├── armeabi
       │   └── WuXiaolong.so
       ├── armeabi-v7a
       │   └── WuXiaolong.so
       ├── mips
       │   └── WuXiaolong.so
       └── x86
           └── WuXiaolong.so

library工程

直接依赖library库：

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

aar文件

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

1
2
3
4
5
6
7
8
9
10
11
android {
    //...
}
repositories {
    flatDir {
        dirs 'aars' 
    }
}
dependencies {
       compile(name:'libraryname', ext:'aar')
}

如何生成.aar和.jar文件：
执行 ./gradlew assembleRelease，然后就可以在 build/outputs/aar 文件夹里生成aar文件，jar 包路径：build/intermediates/bundles/。

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

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

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

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

远程仓库

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

完整配置

https://github.com/WuXiaolong/Gradle4Android

系列博客

Gradle for Android（二）全局设置、自定义BuildConfig、混淆
Gradle for Android（三）多渠道打包、配置签名信息



联系作者

我的微信公众号：吴小龙同学，欢迎关注交流，公号回复关键字「1024」有惊喜哦。