Gradle介紹
Gradle是一個先進的build toolkit,可以方便的管理依賴包和定義自己的build邏輯。到底有多先進,Android Studio官方集成Gradle,Google還專門寫了Android Plugin for Gradle,你們感受一下。
基礎配置
Android Studio中有一個頂級的build.gradle文件,每一個module還有一個自己的build.gradle。這個文件是使用Groovy語法和Android Plugin for Gradle元素的配置文件。通常我們只需要修改module的build文件就可以了。
下面是一個簡單的例子
apply plugin: 'com.android.application'
android {
compileSdkVersion 19
buildToolsVersion "19.0.0"
defaultConfig {
applicationId "com.example.my.app"
minSdkVersion 8
targetSdkVersion 19
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
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'])
}
第一句apply plugin: ‘com.android.application’說明在這個build文件中使用Android plugin for Gradle,有了這一句後,那些針對Android的元素纔有意義。比如android {…}這個就是配置所有針對Android項目build時的選項。
- compileSdkVersion: 編譯時用的sdk版本
- buildToolsVersion: build工具的版本
- defaultConfig: 動態的在build時配置AndroidManifest.xml裏的項目,defaultConfig裏的配置可以覆蓋manifest裏的配置。
- buildTypes: 配置如何構建和打包你的App,默認有debug和release兩個類型。debug類型包含調試時的信息,並且有debug key簽名。release默認是不含簽名的。本例中release版本用了ProGuard。
- dependencies: 在android {…}這個元素之外,配置此模塊的依賴。
依賴
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 project(“:lib”),表明本模塊依賴於lib模塊,編譯的時候系統會把lib模塊包含進來
- 遠程的二進制依賴: compile ‘com.android.support:appcompat-v7:19.0.1’,當本地沒有此依賴時會默認從Maven Central Repository下載相應的依賴。從哪裏下載可以在頂級的build文件中配置。
- *本地二進制依賴:**compile fileTree(dir: ‘libs’, include: [‘.jar’]),把jar包拷貝到/libs文件夾下,compile fileTree(dir: ‘libs’, include: [‘*.jar’])意思是,app/libs下的所有jar包都包含進來
ProGuard
ProGuard的作用是在byte級別對你的app進行分析優化,使得你的App變得更小,更快。值得一提的是,當你使用某些開源項目時,他們會提醒你把一些包排除在ProGuard裏,防止出錯。
android {
...
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
getDefaultProguardFile(‘proguard-android.txt’)獲得默認的ProGuard配置。每個模塊也都有模塊級別的ProGuard規則,在proguard-rules.pro這個文件裏,當然你也可以自己配置ProGuard規則。關於ProGuard的詳細配置,請參考ProGuard Manual
Application ID
Application ID是用來唯一標識要發行的應用的。在build.gradle裏設置。
defaultConfig {
applicationId "com.example.my.app"
minSdkVersion 15
targetSdkVersion 19
versionCode 1
versionName "1.0"
}
系統允許你對不同的產品類型設定不同的id,比如免費版和高級版。
productFlavors {
pro {
applicationId = "com.example.my.pkg.pro"
}
free {
applicationId = "com.example.my.pkg.free"
}
}
buildTypes {
debug {
applicationIdSuffix ".debug"
}
}
配置簽名
debug版本與release版本的區別在於是否可以在一個安全的設備上debug和APK如何被簽名的。在debug版本中,系統會提供一個默認的key來簽名和已知的證書來授權App,避免在構建的時候出現密碼提示。但是在release版本中,除非你主動提供一個key,不然系統是不會構建此項目的。
Release簽名步驟
- 創建keystore。keystore是一個包含一系列私鑰的二進制文件,這個文件必須妥善保管。
- 創建一個私鑰。一個私鑰代表着一個app實體。
- 在build文件中配置
android {
...
defaultConfig { ... }
signingConfigs {
release {
storeFile file("myreleasekey.keystore")
storePassword "password"
keyAlias "MyReleaseKey"
keyPassword "password"
}
}
buildTypes {
release {
...
signingConfig signingConfigs.release
}
}
}
4.在Android Studio中啓動assembleRelease。app/build/apk/app-release.apk這個文件就是包含你release key的apk了。
注:一般不會直接在build文件中寫入密碼的,密碼信息可以寫在環境變量中
storePassword System.getenv("KSTOREPWD")
keyPassword System.getenv("KEYPWD")
或者用命令行輸入
storePassword System.console().readLine("\nKeystore password: ")
keyPassword System.console().readLine("\nKey password: ")
在Android Studio中配置簽名
- 菜單欄裏,點擊Build > Generate Signed APK.
- 在彈出的窗口裏點擊Create new
- 填寫相關信息
- Build Type 選擇release
到此爲止,你就可以去應用市場發佈你的應用啦 ^_^
Build變量
定義productFlavors
有時你需要對同一個App發行不同的版本,如免費版、付費版之類的。這時你就需要用到productFlavors了。
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"
}
}
}
productFlavors裏的配置會覆蓋defaultConfig裏的配置,如上配置後,系統會爲每一個不同版本使用一個不同的id。
給每一個版本添加對應的資源
當你有不同的版本的時候,不同版本之間肯定有不同,所以需要添加不同的資源。以demo版爲例,在src目錄下新建以下目錄
把需要的Activity,String.xml等資源加入到對應文件夾下。
在IDE左側的Build Variants窗口裏就可以看到如下四個Build變量
這樣你需要哪個版本,直接選擇就可以了。