Gradle for Android第二篇( Build.gradle入門 )
在這一章，我們將學習以下內容：
- 理解Gradle文件
- 編寫簡單的構建任務
- 自制構建腳本
理解Gradle腳本
當然我們現在討論的所有內容都是基于Android studio的，所以請先行下載相關工具。當我們創建一個新的工程，Android studio會默認為我們創建三個gradle文件，兩個build.gradle，一個settings.gradle，build.gradle分別放在了根目錄和moudle目錄下，下面是gradle文件的構成圖：
- MyApp
- ├── build.gradle
- ├── settings.gradle
- └── app
- └── build.gradle
setting.gradle解析
當你的app只有一個模塊的時候，你的setting.gradle將會是這樣子的：
- include ':app'
setting.gradle文件將會在初始化時期執行，關于初始化時期，可以查看上一篇博客，并且定義了哪一個模塊將會被構建。舉個例子，上述setting.gradle包含了app模塊，setting.gradle是針對多模塊操作的，所以單獨的模塊工程完全可以刪除掉該文件。在這之后，Gradle會為我們創建一個Setting對象，并為其包含必要的方法，你不必知道Settings類的詳細細節，但是你***能夠知道這個概念。
根目錄的build.gradle
該gradle文件是定義在這個工程下的所有模塊的公共屬性，它默認包含二個方法：
- buildscript {
- repositories {
- jcenter()
- }
- dependencies {
- classpath 'com.android.tools.build:gradle:1.2.3'
- }
- }
- allprojects {
- repositories {
- jcenter()
- }
- }
buildscript方法是定義了全局的相關屬性，repositories定義了jcenter作為倉庫。一個倉庫代表著你的依賴包的來源，例如maven倉庫。dependencies用來定義構建過程。這意味著你不應該在該方法體內定義子模塊的依賴包，你僅僅需要定義默認的Android插件就可以了，因為該插件可以讓你執行相關Android的tasks。
allprojects方法可以用來定義各個模塊的默認屬性，你可以不僅僅局限于默認的配置，未來你可以自己創造tasks在allprojects方法體內，這些tasks將會在所有模塊中可見。
模塊內的build.gradle
模塊內的gradle文件只對該模塊起作用，而且其可以重寫任何的參數來自于根目錄下的gradle文件。該模塊文件應該是這樣：
- apply plugin: 'com.android.application'
- android {
- compileSdkVersion 22
- buildToolsVersion "22.0.1"
- defaultConfig {
- applicationId "com.gradleforandroid.gettingstarted"
- minSdkVersion 14
- targetSdkVersion 22
- versionCode 1
- versionName "1.0"
- }
- buildTypes {
- release {
- minifyEnabled false
- proguardFiles getDefaultProguardFile
- ('proguard-android.txt'), 'proguard-rules.pro'
- }
- }
- }
- dependencies {
- compile fileTree(dir: 'libs', include: ['*.jar'])
- compile 'com.android.support:appcompat-v7:22.2.0'
- }
插件
該文件的***行是Android應用插件，該插件我們在上一篇博客已經介紹過，其是google的Android開發團隊編寫的插件，能夠提供所有關于Android應用和依賴庫的構建，打包和測試。
Android
該方法包含了所有的Android屬性，而唯一必須得屬性為compileSdkVersion和buildToolsVersion：
- compileSdkVersion：編譯該app時候，你想使用到的api版本。
- buildToolsVersion：構建工具的版本號。
構建工具包含了很多實用的命令行命令，例如aapt,zipalign,dx等，這些命令能夠被用來產生多種多樣的應用程序。你可以通過sdk manager來下載這些構建工具。
defaultConfig方法包含了該app的核心屬性，該屬性會重寫在AndroidManifest.xml中的對應屬性。
- defaultConfig {
- applicationId "com.gradleforandroid.gettingstarted"
- minSdkVersion 14
- targetSdkVersion 22
- versionCode 1
- versionName "1.0"
- }
***個屬性是applicationId，該屬性復寫了AndroidManifest文件中的包名package
name，但是關于applicationId和package
name有一些不同。在gradle被用來作為Android構建工具之前，package
name在AndroidManifest.xml有兩個作用：其作為一個app的唯一標示，并且其被用在了R資源文件的包名。
Gradle能夠很輕松的構建不同版本的app,使用構建變種。舉個例子，其能夠很輕松的創建一個免費版本和付費版本的app。這兩個版本需要分隔的標示碼，所以他們能夠以不同的app出現在各大應用商店，當然他們也能夠同時安裝在一個手機中。資源代碼和R文件必須擁有相同的包名，否則你的資源代碼將需要改變，這就是為什么Android開發團隊要將package name的兩大功能拆分開。在AndroidManifest文件中定義的package name依然被用來作為包名和R文件的包名。而applicationid將被用在設備和各大應用商店中作為唯一的標示。
接下來將是minSdkVersion和targetSdkVersion。這兩個和AndroidManifest中的<uses-sdk>很像。minSdkVersion定義為最小支持api。
versionCode將會作為版本號標示，而versionName毫無作用。
所有的屬性都是重寫了AndroidManifest文件中的屬性，所以你沒必要在AndroidManifest中定義這些屬性了。
buildTypes方法定義了如何構建不同版本的app，我們將在下一篇博客中有所介紹。
依賴包
依賴模塊作為gradle默認的屬性之一(這也是為什么其放在了Android的外面)，為你的app定義了所有的依賴包。默認情況下，我們依賴了所有在libs文件下的jar文件，同時包含了AppCompat這個aar文件。我們將會在下一篇博客中討論依賴的問題。
讓我們開始tasks吧
如果你想知道你多少tasks可以用，直接運行gradlew tasks，其會為你展示所有可用的tasks。當你創建了一個Android工程，那么將包含Android tasks，build tasks，build setup tasks，help tasks，install tasks，verification tasks等。
基本的tasks
android插件依賴于Java插件，而Java插件依賴于base插件。
base插件有基本的tasks生命周期和一些通用的屬性。
base插件定義了例如assemble和clean任務，Java插件定義了check和build任務，這兩個任務不在base插件中定義。
這些tasks的約定含義：
- assemble: 集合所有的output
- clean: 清除所有的output
- check: 執行所有的checks檢查，通常是unit測試和instrumentation測試
- build: 執行所有的assemble和check
Java插件同時也添加了source sets的概念。
Android tasks
android插件繼承了這些基本tasks,并且實現了他們自己的行為：
- assemble 針對每個版本創建一個apk
- clean 刪除所有的構建任務，包含apk文件
- check 執行Lint檢查并且能夠在Lint檢測到錯誤后停止執行腳本
- build 執行assemble和check
默認情況下assemble tasks定義了assembleDebug和assembleRelease，當然你還可以定義更多構建版本。除了這些tasks,android 插件也提供了一些新的tasks:
- connectedCheck 在測試機上執行所有測試任務
- deviceCheck 執行所有的測試在遠程設備上
- installDebug和installRelease 在設備上安裝一個特殊的版本
- 所有的install task對應有uninstall 任務
build task依賴于check任務，但是不依賴于connectedCheck或者deviceCheck，執行check任務的使用Lint會產生一些相關文件，這些報告可以在app/build/outputs中查看：
android studio的tasks
你根本不必要去執行gradle腳本在命令行中，Android studio有其對應的工具：
在這個界面，你要做的就是雙擊了。當然你也可以在Android studio中打開命令行，執行相關命令，具體操作就不介紹了。
自定義構建
當你在Android studio中自定義了gradle文件，需要更新project:
其實該按鈕，執行了generateDebugSources tasks，該任務會生成所有必要的classes文件。
BuildConfig和resources
- android {
- buildTypes {
- debug {
- buildConfigField "String", "API_URL",
- "\"http://test.example.com/api\""
- buildConfigField "boolean", "LOG_HTTP_CALLS", "true"
- }
- release {
- buildConfigField "String", "API_URL",
- "\"http://example.com/api\""
- buildConfigField "boolean", "LOG_HTTP_CALLS","false"
- }
- }
類似這些定義的常量，當定義了這些屬性后，你完全可以在代碼中使用：BuildConfig.API_URL和BuildConfig.LOG_HTTP
最近，Android tools team也讓其里面定義string變為可能：
- android {
- buildTypes {
- debug {
- resValue "string", "app_name", "Example DEBUG"
- }
- release {
- resValue "string", "app_name", "Example"
- }
- }
- }
你可以在代碼中使用這些string。其中“”不是必須得。
全局設置
如果你有很多模塊在一個工程下，你可以這么定義你的project文件。
- allprojects {
- apply plugin: 'com.android.application'
- android {
- compileSdkVersion 22
- buildToolsVersion "22.0.1"
- }
- }
這只會在你的所有模塊都是Android app應用的時候有效。你需要添加Android 插件才能訪問Android的tasks。更好的做法是你在全局的gradle文件中定義一些屬性，然后再模塊中運用它們。比如你可以在根目錄下這么定義：
- ext {
- compileSdkVersion = 22
- buildToolsVersion = "22.0.1"
那么你在子模塊中就可以使用這些屬性了：
- android {
- compileSdkVersion rootProject.ext.compileSdkVersion
- buildToolsVersion rootProject.ext.buildToolsVersion
- }
Project properties文件
上述方法是一種辦法，當然還有很多辦法：
- ext方法
- gradle.properties文件
- -p參數
- ext {
- local = 'Hello from build.gradle'
- }
- task printProperties << {
- println local // Local extra property
- println propertiesFile // Property from file
- if (project.hasProperty('cmd')) {
- println cmd // Command line property
- }
- }
當然你可以在gradle.properties中定義：
- propertiesFile = Hello from gradle.properties
你也可以輸入命令行：
- $ gradlew printProperties -Pcmd='Hello from the command line'
- :printProperties
- Hello from build.gradle
- Hello from gradle.properties
- Hello from the command line
總結
在這篇博客中，我們細致的查看了Android studio生成的三個gradle文件，現在你應該能夠自己去創建自己的gradle文件，我們還學習了最基本的構建任務，學習了Android 插件以及其tasks。
在接下來的幾年里，Android開發生態將會爆炸性增長，很多有趣的依賴庫將會讓每個人去使用，在下一篇博客里面，我們將看看我們能有幾種方式添加我們的依賴庫，這樣我們才能夠避免造輪子。
