配置Gradle構建

時間 2019-12-08

標籤配置 gradle 構建欄目 Gradle 简体版

原文原文鏈接

構建基礎配置

Android Studio包含一個頂級的構建文件和每一個模塊的構建文件。構建文件被稱爲 build.gradle，它是一個純文本文件，它使用Groovy語法來配置由Android Gradle插件提供的元素。在大多數狀況下，你只須要編輯模塊級別的構建文件。例如，BuildSystemExample項目的app模塊的構建文件是像這樣的：html

apply plugin:'com.android.application'

android {
compileSdkVersion 19
buildToolsVersion "19.0.0"

defaultConfig {
minSdkVersion 8
targetSdkVersion 19
versionCode 1
versionName "1.0"
  }
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'
  }
  }
}

dependencies {
compile project(":lib")
compile 'com.android.support:appcompat-v7:19.0.1'
compile fileTree(dir:'libs', include:['*.jar'])
}java

apply plugin:'com.android.application' 是應用Android Gradle插件來構建。這樣添加Android特定的構建任務到頂級構建任務中，而且使用 android{…}中的元素來指定Android特定的構建項。android

android{….} 配置全部的Android特定構建項：安全

compileSdkVersion 項指定編譯的目標。app

buildToolsVersion 項指定使用什麼版本的構建工具。使用SDK管理器來安裝多個版本的構建工具。ide

注意：請始終使用其主要版本號高於或等於您的編譯目標SDK的版本。工具

defaultConfig 元素動態的配置在AndroidManifest.xml中的設置。在defaultConfig的值將覆蓋manifest文件中的值。配置在defaultConfig的值將應用於全部的構建變種(build variants),除非構建變種的配置覆蓋了這些值。佈局

buildType元素控制如何構建和打包你的應用。默認的構建系統定義了兩個構建類型：debug和release。debug構建類型包含debugging符號，而且使用了debug key簽名。release構建類型默認沒有被簽名。在這個例子中構建文件配置了release版本，使用了ProGuard。gradle

dependencies元素是在android元素外面的，而且在android元素後面。這個元素聲明瞭這個模塊的依賴。在一下的章節中都有依賴的內容。ui

注：當你在你的項目中改變了構建文件，Android Studio爲了導入改變了構建配置而要求項目同步。點擊黃色通知欄中的」Sync Now」按鈕來同步改變的內容。

圖一. 同步 Android Studio中的項目。

聲明依賴

這個例子的應用模塊聲明瞭3個依賴：

...
  dependencies {
      // Module dependency
      compile project(":lib")
  
      // Remote binary dependency
      compile 'com.android.support:appcompat-v7:19.0.1'
  
      // Local binary dependency
      compile fileTree(dir:'libs', include:['*.jar'])
  }

每一個依賴在下面給出描述。構建系統添加全部類型爲」compile」的依賴到編譯路徑中，而且最終將他們打到最終的包中。

Module dependencies

app模塊依賴於lib模塊。由於像在」Open an Activity from a Library Module」中描述的，MainActivity登陸LibActivity1.

compile project(":lib") 聲明瞭依賴lib模塊。當你構建app模塊的時候，構建系統將會集合lib模塊。

運程二進制依賴

app和lib模塊都使用了來自Android支持庫的ActionBarActivity類，全部這些模塊都依賴它。

compile 'com.android.support:appcompat-v7:19.0.1' 經過指定Maven座標來聲明瞭對Android支持庫19.0.1版本的依賴。在Android SDK的倉庫包中Android的支持庫是可用的。若是你安裝的SDK沒有這個包，經過使用SDK管理工具下載安裝它。

Android Studio默認使用了Maven的中央倉庫來配置項目。(這個配置在項目的頂級構建文件中)。

本地二進制依賴

一些模塊不使用任何的本地系統二進制依賴。若是你有依賴本地二進制依賴的模塊，拷貝JAR文件到<moduleName>/libs目錄下。

compile fileTree(dir: 'libs', include: ['*.jar']) 告訴構建系統將 app/libs目錄下面的JAR文件依賴包含到編譯路徑，而且最終在最終的包中。

有關在Gradle更多的依賴信息，請查看Gradle的用戶指南(Dependency Management Basics )。

運行ProGuard

構建系統運行ProGuard，以達到在構建過程當中混淆你的代碼的目的。在BuildSystemExample中，爲了release構建運行ProGuard修改app模塊的構建文件:

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

getDefaultProguardFile('proguard-android.txt') 從安裝的Android SDK中獲取默認的ProGuard設置。你可自定義ProGuard規則，Android Studio 將會加模塊根部的proguard-rules.pro文件添加到模塊特定的規則中。

包的標識:Application ID

在Android構建系統中，applicationId屬性是惟一標示發行應用包。Application ID在build.gradle文件的android節點中設置。

apply plugin:'com.android.application'
  
      android {
          compileSdkVersion 19
          buildToolsVersion "19.1"
  
      defaultConfig {
          applicationId "com.example.my.app"
          minSdkVersion 15
          targetSdkVersion 19
          versionCode 1
          versionName "1.0"
      }

注： applicationID只能在build.gradle文件中被指定，不能再AndroidManifest.xml文件中。

當使用build variants，構建系統可讓你爲每一個product flavors和build types指定包的惟一標示。在build type中的Application ID被添加到product flavors做爲後綴。

 productFlavors {
          pro {
              applicationId ="com.example.my.pkg.pro"
          }
          free {
              applicationId ="com.example.my.pkg.free"
          }
      }
  
      buildTypes {
          debug {
              applicationIdSuffix ".debug"
          }
      }
      ....

包名依然須要在manifest文件中指定。它在你的源碼中用來涉及你的R class和解決相關activity/service註冊問題。

package="com.example.app">

注：若是你有多個manifests(好比，一個product flavor指定的manifest和一個build type的manifest)，包名在這些manifests中是可選的。若是它再這些manifests中被指定，那報名必須和src/main目錄下的manifest的包名一致。

有關更多的關於構建文件和構建過程信息，請看 Build System Overview。

配置簽名設置

debug和release版本的app在是否能在安全設備調試和如何進行簽名是有區別的。構建系統使用一個默認的key來簽名debug版本，而且爲了在構建過程當中不出現密碼提示，使用了已知的證書。構建系統不會簽名release版本，除非你明肯定義了簽名配置。若是你沒有一個release的key，你能夠安裝」Signing your Applications」中描述的進行生成。

使用build variants工做

這個章節描述構建系統如何幫助你在一個項目中的同一個應用建立不一樣的版本。當時有一個demo和paid版本的時候，這是有用的，或者是你想在Google Play上爲不一樣配置的設備發佈多個APK。

構建系統使用 product flavors爲你的應用建立不一樣的版本。每一個版本有可能有不一樣的特性和設備要求。構建系統也應用 build types到不一樣的構建中，而且打包配置到每一個版本中。每一個product flavor和build type的組合造成了一個build variant。構建系統爲每一個build variant生成了不一樣的APK。

Build variants

這個項目例子包含了兩個默認的build types(debug 和release),還有兩個product flavors(demo和full)。更多關於使用build variants的高級信息，查看」Build System Overview」。

Product flavors

爲你的應用建立不一樣的版本:

一、在構建文件中定義product flavors

二、爲每一個flavor建立附加的源碼路徑

三、添加flavor特定的源碼到你的項目中

接下來的章節帶你瞭解 BuildSystemExample項目中的每一個細節。在BuildSystemExample應用中建立兩個Flavor。一個demo flavor和一個full flavor。兩個flavors共享 MainActivity,MainActivity中有一個按鈕跳轉到一個新的activity—SecondActivity.對於兩個flavor來講SecondActivity是不一樣的，所以你應該模擬這樣的狀況：full flavor中的Activity的特性要比demo flavor中的Activity多。在練習的最後，你將獲得不一樣flavor的不一樣APK。

在構建文件中定義product flavors

爲app模塊中的構建文件定義兩個product flavors:

...
  android {
      ...
      defaultConfig {...}
      signingConfigs {...}
      buildTypes {...}
      productFlavors {
          demo {
              applicationId "com.buildsystemexample.app.demo"
              versionName "1.0-demo"
          }
          full {
              applicationId "com.buildsystemexample.app.full"
              versionName "1.0-full"
          }
      }
  }
  ...

這個項目的flavor定義支持使用defualtConfig相同的配置。全部flavors相同都配置都定義在defaultConfig中，每一個flavor能夠覆蓋任何默認的值。上面的構建文件使用了 applicationId屬性來分配給每一個flavor：自從每一個flavor建立了不一樣的app,他們應該須要不一樣的包名。

注：在Google Play中，爲使你的應用能夠擁有多APK支持。給你的所用variants分配相同的包名，而且給每一個viant不一樣的versionCode. 爲了再Google Play中區分不一樣的variants,你應該分配不一樣的包名給每一個variant。

爲每一個flavor添加額外的源碼目錄

如今你應該建立源碼目錄，而且將SecondActivity添加到不一樣的flavor中。爲demo flavor建立源碼目錄結構：

一、在Project模板中，展開BuildSystemExample，而且展開app目錄

二、右鍵src目錄，選擇New>Directory

三、使用」demo」做爲目錄的名字

四、一樣的建立以下目錄：

app/src/demo/java

app/src/demo/res

app/src/demo/res/layout

app/src/demo/res/values

目錄的結構看起來像圖1：

圖一：demo flavor的目錄

添加不一樣的activity到不一樣的flavor中：

添加SecondActivity到demo flavor中：

一、在Project模板中，右鍵app模塊，選擇New>Activity。

二、選擇 Blank Activity,點擊Next

三、輸入activity名字: SecondActivity

四、輸入包名」com.buildsystemexample.app」

五、在app/src/demo目錄中右鍵java目錄選擇New>Package。

六、輸入com.buildsystemexample.xapp

七、將SecondActivity拖拽到app/src/demo/java中

八、接受默認的Refactor

爲demo flavor添加SecondActivity的佈局文件和資源文件

一、從ap/src/main/res/layout中將activity_second.xml文件拖拽到app/src/demo/res/layout中

二、接受默認的提示

三、將strings.xml從app/src/main/res中拷貝到app/src/demo/res中

四、替換string.xml文件中的內容，以下：

<!--[if !supportLists]-->五、<!--[endif]--><?xml version="1.0" encoding="utf-8"?>
  <resources>
      <stringname="hello_world">This is the full version!</string>
  </resources>

注：從如今開始，你能夠爲每一個flavor單獨開發SecondActivity. 好比，你能夠爲full flavor的activity添加更多的屬性。

爲了讓指定的flavor文件工做，點擊IDE窗口郵編的Build Variants，而且選擇你想使用的flavor，就像圖2. Android Studio可能會展現其餘flavor的錯誤，可是這並不影響輸出內容的構建。

圖2

從MainActivity登入到指定flavor的activity

SecondActivity在全部的flavors中都有相同的包名，你能夠同main activity中登入。編輯mainActivity:

一、編輯 activity_main.xml,添加一個按鈕：

<LinearLayout ...>
      ...
      <Button
          android:id="@+id/button2"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="@string/button2"
          android:onClick="onButton2Clicked"/>
  </LinearLayout>

二、爲按鈕添加text標題，和按鈕事件onButton2Clicked

三、在MainActivity中添加以下代碼：

publicvoid onButton2Clicked(View view){
      Intent intent =newIntent(this,SecondActivity.class);
      startActivity(intent);
  }

四、編輯manifest文件

<manifest ...>
      <application ...>
          ...
          <activity
              android:name="com.buildsystemexample.app.SecondActivity"
              android:label="@string/title_activity_second">
          </activity>
      </application>
  </manifest>

Build types

Build types表現爲爲每一個app包構建包版本。默認的debug和release被提供：

...
  android {
      ...
      defaultConfig {...}
      signingConfigs {...}
      buildTypes {...}
      productFlavors {...}
      buildTypes {
          release {
              minifyEnabled false
              proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'
          }
           debug {
              debuggable true
          }
      }
  }
  ...

注：儘管在build.gradle文件中默認只有release構建類型，當時release和debug構建類型都被應用的每一個構建中。

在這個例子中，product flavors和build types建立了一下的build variants:

demoDebug

demoRelease

fullDebug

fullRelease

爲這個例子構建，能夠點擊Android Studio的Build菜單，或者在命令行中執行 assemble命令。

注：Build>Make Project會編譯項目中全部的源碼。Build>Rebuild Project選項從新編譯全部的源碼。

會爲不一樣的build variant建立不一樣的輸出目錄。

QQ技術交流羣290551701 http://cxy.liuzhihengseo.com/558.html