Android Studio ：Android Studio 与 Gradle 深入【二】

转载：http://www.apkbus.com/forum.php?mod=viewthread&tid=255063&extra=page%3D2%26filter%3Dauthor%26orderby%3Ddateline&_dsign=55ac1be3

Android Studio 相关功能介绍文件夹组织视图

最常用的有 Project 和 Android 视图，前者按照项目文件树进行组织，后者是以 Gradle 构建文件作为核心进行组织：

 

Project 视图与 Android 视图

 

Gradle 相关文件结构

让我们来观察一下Android Studio 中 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

. ├── gradle │   └── wrapper                                //所使用的 Gradle 包装器配置 ├── .gradle                                        //所使用 Gradle 版本 │   └── 2.8 ├── AsInDepth.iml ├── app                                                //app module │   ├── app.iml │   ├── build │   ├── build.gradle                //app module 的 build.gradle │   ├── libs │   ├── proguard-rules.pro │   └── src ├── build.gradle                        //项目 build.gradle，通常配置项目全局配置，如 repositories 和 dependencies ├── gradle.properties                //项目属性文件，通常可以放置一些常量 ├── gradlew                                        //Gradle 包装器可执行文件 ├── gradlew.bat                                //Gradle 包装器可执行文件(Windows) ├── lib                                                //lib module │   ├── build │   ├── build.gradle                //lib module 的 build.gradle │   ├── lib.iml │   ├── libs │   ├── proguard-rules.pro │   └── src ├── local.properties                //项目的本地属性，通常是 sdk 所在位置 └── settings.gradle                        //项目总体设置，通常是配置项目中所有的 module

Invalidate Cache

Android Studio 会出现索引的问题，那可以从删除 cache 重建索引，File->Invalidate Caches/Restart

 

Multiple Language Editor

多语言文字可以通过右击文件 Open Translation Editor，可以同时进行编辑，但是我发现如果把 strings.xml 改了别的名字，这个功能就不 work 了。

 

Gradle 相关功能介绍Gradle View

点击红色三角运行按钮，其实是执行了 Gradle 的 一些列任务，如果你想分别执行一些任务，则可以从 Gradle View 里面查看：

 

gradle view

 

命令行

工作区下方，有一个叫做 Terminal 的 tab，点击之后，会自动 cd 到当前 project 根目录下，可以输入如下命令来尝试下：

 

1	./gradlew build

Windows 下应该是 gradlew.bat build，下面均以 Mac 为例，不再赘述

 

可使用 help 参数来查看有哪些选项：

 

1	./gradlew --help

下面介绍一些重要的选项：

 

• 查看运行 log

有些时候，一个任务运行失败，只给出一个错误，没有给具体原因，你就需要查看更多信息，可以使用参数 –info 或者 –stacktrace：

 

1	./gradlew build --info

• 指定 module 或者 build.gradle

Gradle 默认是当前目录下寻找 build.gradle 文件执行任务，这样执行 build 会使得整个 project 所有的 module 的 build 任务都会运行，浪费不必要的时间，可以指定 module (-p) 或者 build.gradle (-b)文件以缩小作用范围：

 

1	./gradlew -p app build

Sync

正常情况下，修改了 build.gradle 文件，文件上方就会有一个 sync 的按钮，点击之后会重新构建整个 build.gradle。但是某些特殊情况，这个同步可能会失败。那就需要一个额外的触发。

方法有四：

 

• 再修改一下文件，便会再次出现 sync 按钮
• 点击上方工作区的按钮

sync button top

 

• 点击 Gradle View 中的同步按钮

sync button top

 

• 命令行执行一次 build

Build Variant

首先要了解两个概念:

 

Build Type

分为 debug 和 release，这个概念容易懂

 

Product Flavor

这个概念主要是为了满足如下需求：同一份代码要打多个包，例如收费 pay 和免费 free，逻辑上有一些小区别，又不想通过逻辑判断这种丑陋的方式。或者你要实现所谓多渠道打包。

Build Variant = Build Type x Product Flavor

配置好了Build Type 和 Product Flavor 之后，Gradle 会生成若干个包，分别为：

 

1 2 3 4

payDebug payRelease freeDebug freeRelease

配置实例

build variant

 

假设这两个版本的 app，有一个类 DiffBean 需要做大量的逻辑判断，则可以通过在 build.gradle 中配置 product flavor，在代码中添加两个与 main 平齐的文件夹，
把 DiffBean 从 main 中抽出来，分别放在两个文件夹中，只关注对应的逻辑即可。

 

关于 Product Flavor 中都能定义哪些属性，请参考 Android Gradle DSL。

 

Gradle 使用的仓库

要使用远程依赖，就得有个库的仓库，Gradle 支持 maven 仓库。这些库可以是公用的，例如 mavenCentral 或者 jcenter，也可以使用私有库。

笔者曾经上传过公用库到 mavenCentral 和 jcenter，前者的繁琐与难以管理，让人深恶痛绝。Android Studio 在0.8.0版本以后，将 jcenter 作为默认的 maven 库公用库来源。

私有库可以托管在任何一个能访问到的地方，可以托管在 bintray 上的私有空间，也可以是内网服务器上，甚至可以是本机磁盘上。

下面是本人使用的仓库的一个例子：

 

1 2 3 4 5 6 7 8 9

allprojects {     repositories {         jcenter()         mavenCentral()         maven {             url 'file:///Users/myusername/repo/'         }     } }

关于库，会在本系列的四篇会有更详细的叙述。

 

使用 jni 预编译 .so 库

• 默认情况下，可以放在与 java 平级的 jniLibs 文件夹中

  1 2 3 4 5 6 7 8 9 10 11

  . ├── AndroidManifest.xml ├── java │   └── io │       └── kvh ├── jniLibs │   ├── armeabi │   │   └── libweibosdkcore.so │   └── armeabi-v7a │       └── libweibosdkcore.so └── res

• 很多人喜欢放在与 src 平级的 libs 文件夹中

  1 2 3 4 5 6 7 8

  ├── build.gradle ├── libs │   ├── armeabi │   │   └── libweibosdkcore.so │   └── armeabi-v7a │       └── libweibosdkcore.so ├── proguard-rules.pro └── src

  这样需要在 build.gradle 文件添加如下说明：

  1 2 3 4 5 6

  android {    sourceSets {        main {            jniLibs.srcDirs = ['libs']        }    }

升级 gradle 插件

• 在 bintray 上查找最新的版本
• 修改项目的 build.gradle 中插件的版本

  1 2 3 4 5 6 7 8

  buildscript {     repositories {         jcenter()     }     dependencies {         classpath 'com.android.tools.build:gradle:2.0.0-alpha5'//这里     } }

• 如果有提示错误，则可能需要 gradle 的运行环境版本，修改项目根目录下文件 gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl为最新，例如

  1	distributionUrl=https://services.gradle.org/distributions/gradle-2.10-all.zip

遇到的坑

所在的项目的包已经发布到了 mavenCentral 和 jcenter，很多用户的在集成的时候，遇到问题，其中最经典的问题，便是下面的三个。

 

下载依赖库失败，报 peer not found

连接 jcenter 库默认使用 https 协议，出现这个错，多数情况下都是因为连接失败了，原因嘛，你懂的。
可以尝试将 jcenter 改成默认使用 http 连接：

 

1 2 3

jcenter {             url "http://jcenter.bintray.com/"         }

下载不到特定的版本

Maven 和 Gradle 都会有一个缓存库，默认安装的情况下，是在用户根目录下的 .m2 或者 .gradle 文件夹中。
可以尝试删除里面的文件。例如将 Gradle 的 cache 文件删除：

 

1	rm -rf ~/.gradle/caches/

注意这个操作可能会导致所有的远程库都需要重新下载，要三思后行。

库重复冲突

笔者的包使用了 com.android.support:support-v4:19.0.0 包，可能用户的 app 也使用了这个包，就可能在编译进行代码合并到时候出类似的错：

 

1 2	UNEXPECTED TOP-LEVEL EXCEPTION multiple dex files define Landroid/support/annotation/AniRes

这个时候，在 module 的 build.gradle 的 dependency 添加依赖时，加入 exclude 规则：

 

1 2 3

compile ('com.bugtags.library:bugtags-lib:latest.integration') {         exclude group: 'com.android.support', module: 'support-v4' }

后续引言

讲到这里，有些读者可能会遇到跟我当时开始使用 Gradle 一样的问题：遇到问题就 stackoverflow，找到 workaround 了但不知道为什么，gradle 版本更新了，发现不 work 了，甚为惆怅。

究其原因，都是不理解基础。下面扼要勾勒个大概。

首先 Gradle 是一个构建平台，它使用的是 Groovy 语言。

Groovy是一种基于 Java 的语言，提供了更好的动态特性，可以使用闭包使得编程更灵活，很适合做脚本语言。

上面提到的 settings.gradle 和 build.gradle 在 Gradle 平台中，其实都是一个 Groovy 对象。

Gradle 通过插件（plugin）的方式来支持构建。插件是很多任务（task）的集合，task 中又包含了许多 action。

而例如 productFlavors 都是一个所谓的 DSL，插件都定义了很多的 DSL，我理解的所谓的 DSL 就是一个小语言规范用来处理一个特定的事情（大多情况下是配置）。Android 的插件的 DSL 文档在 Android Gradle DSL 有说明。

理解了以上基础之后，你就会知其然，知其所以然了。