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

时间 2019-11-12

标签 android studio gradle 深刻栏目 Android 繁體版

原文原文链接

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

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

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

Project 视图与 Android 视图

Gradle 相关文件结构java

让咱们来观察一下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 Cacheandroid

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

Multiple Language Editorgit

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

Gradle 相关功能介绍Gradle Viewgithub

点击红色三角运行按钮，实际上是执行了 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 Flavorapp

这个概念主要是为了知足以下需求：同一份代码要打多个包，例如收费 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 有说明。

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