原文鏈接:http://stormzhang.com/devtools/2014/12/18/android-studio-tutorial4/
其實(shí)很早之前也寫了一篇Gradle的基礎(chǔ)博客,但是時(shí)間很久了,現(xiàn)在Gradle已經(jīng)更新了很多,所以暫且結(jié)合Stduio 1.0正式版與最新的Gradle語(yǔ)法來(lái)詳細(xì)講解下,小伙伴們直接跟我一步步來(lái)學(xué)習(xí)吧。
Gradle是一種依賴管理工具,基于Groovy語(yǔ)言,面向Java應(yīng)用為主,它拋棄了基于XML的各種繁瑣配置,取而代之的是一種基于Groovy的內(nèi)部領(lǐng)域特定(DSL)語(yǔ)言。
在Android Studio系列教程一--下載與安裝中新建項(xiàng)目成功后會(huì)下載Gradle,貌似這個(gè)過(guò)程不翻墻也是可以下載,但是訪問特別慢,建議翻墻下載。那么下載的Gradle到什么地方呢?
Mac上會(huì)默認(rèn)下載到 /Users/<用戶名>/.gradle/wrapper/dists 目錄
Win平臺(tái)會(huì)默認(rèn)下載到 C:\Documents and Settings\<用戶名>.gradle\wrapper\dists 目錄
你會(huì)看到這個(gè)目錄下有個(gè) gradle-x.xx-all 的文件夾, 如果下載實(shí)在太慢,但是又不想翻墻的話,可以自己手動(dòng)到Gradle官網(wǎng)下載對(duì)應(yīng)的版本,然后將下載的.zip文件(也可以解壓)復(fù)制到上述的gradle-x.xx-all 文件夾下,不過(guò)還是建議讓它直接下載的好。
下面就以我的開源項(xiàng)目 9GAG 來(lái)詳細(xì)講解下和Gradle相關(guān)的知識(shí), 和Gradle相關(guān)的幾個(gè)文件一般有如下幾個(gè):
紅色標(biāo)記部分從上到下咱們來(lái)一步步分析:
這個(gè)文件是app文件夾下這個(gè)Module的gradle配置文件,也可以算是整個(gè)項(xiàng)目最主要的gradle配置文件,我們來(lái)看下這個(gè)文件的內(nèi)容:
// 聲明是Android程序apply plugin: 'com.android.application'android { // 編譯SDK的版本 compileSdkVersion 21 // build tools的版本 buildToolsVersion "21.1.1" defaultConfig { // 應(yīng)用的包名 applicationId "me.storm.ninegag" minSdkVersion 14 targetSdkVersion 21 versionCode 1 versionName "1.0.0" } // java版本 compileOptions { sourceCompatibility JavaVersion.VERSION_1_7 targetCompatibility JavaVersion.VERSION_1_7 } buildTypes { release { // 是否進(jìn)行混淆 minifyEnabled false // 混淆文件的位置 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt' } } // 移除lint檢查的error lintOptions { abortOnError false }}dependencies { // 編譯libs目錄下的所有jar包 compile fileTree(dir: 'libs', include: ['*.jar']) compile 'com.android.support:support-v4:21.0.2' compile 'com.etsy.android.grid:library:1.0.5' compile 'com.alexvasilkov:foldable-layout:1.0.1' // 編譯extras目錄下的ShimmerAndroid模塊 compile project(':extras:ShimmerAndroid')}
這里需要說(shuō)明幾點(diǎn):
文件開頭apply plugin是最新gradle版本的寫法,以前的寫法是apply plugin: 'android', 如果還是以前的寫法,請(qǐng)改正過(guò)來(lái)。
buildToolsVersion這個(gè)需要你本地安裝該版本才行,很多人導(dǎo)入新的第三方庫(kù),失敗的原因之一是build version的版本不對(duì),這個(gè)可以手動(dòng)更改成你本地已有的版本或者打開 SDK Manager 去下載對(duì)應(yīng)版本。
applicationId代表應(yīng)用的包名,也是最新的寫法,這里就不在多說(shuō)了。
android 5.0開始默認(rèn)安裝jdk1.7才能編譯,但是由于mac系統(tǒng)自帶jdk的版本是1.6,所以需要手動(dòng)下載jdk1.7并配置下,具體可以見我這篇博客Mac下安裝和管理Java
minifyEnabled也是最新的語(yǔ)法,很早之前是runProguard,這個(gè)也需要更新下。
proguardFiles這部分有兩段,前一部分代表系統(tǒng)默認(rèn)的android程序的混淆文件,該文件已經(jīng)包含了基本的混淆聲明,免去了我們很多事,這個(gè)文件的目錄在 <sdk目錄>/tools/proguard/proguard-android.txt , 后一部分是我們項(xiàng)目里的自定義的混淆文件,目錄就在 app/proguard-rules.txt , 如果你用Studio 1.0創(chuàng)建的新項(xiàng)目默認(rèn)生成的文件名是 proguard-rules.pro , 這個(gè)名字沒關(guān)系,在這個(gè)文件里你可以聲明一些第三方依賴的一些混淆規(guī)則,由于是開源項(xiàng)目,9GAG里并未進(jìn)行混淆,具體混淆的語(yǔ)法也不是本篇博客討論的范圍。最終混淆的結(jié)果是這兩部分文件共同作用的。
compile project(':extras:ShimmerAndroid')這一行是因?yàn)?GAG中存在其他Module,不知道Module的概念可以看下這篇博客Android Studio系列教程二--基本設(shè)置與運(yùn)行, 總之你可以理解成Android Library,由于Gradle的普及以及遠(yuǎn)程倉(cāng)庫(kù)的完善,這種依賴漸漸的會(huì)變得非常不常見,但是你需要知道有這種依賴的。
以上文件里的內(nèi)容只是基本配置,其實(shí)還有很多自定義部分,如自動(dòng)打包debug,release,beta等環(huán)境,簽名,多渠道打包等,后續(xù)會(huì)單獨(dú)拿出來(lái)講解。
每一個(gè)Module都需要有一個(gè)gradle配置文件,語(yǔ)法都是一樣,唯一不同的是開頭聲明的是 apply plugin: 'com.android.library'
這個(gè)目錄下有個(gè) wrapper 文件夾,里面可以看到有兩個(gè)文件,我們主要看下 gradle-wrapper.properties 這個(gè)文件的內(nèi)容:
#Thu Dec 18 16:02:24 CST 2014distributionBase=GRADLE_USER_HOMEdistributionPath=wrapper/distszipStoreBase=GRADLE_USER_HOMEzipStorePath=wrapper/distsdistributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip
可以看到里面聲明了gradle的目錄與下載路徑以及當(dāng)前項(xiàng)目使用的gradle版本,這些默認(rèn)的路徑我們一般不會(huì)更改的,這個(gè)文件里指明的gradle版本不對(duì)也是很多導(dǎo)包不成功的原因之一。
這個(gè)文件是整個(gè)項(xiàng)目的gradle基礎(chǔ)配置文件,我們來(lái)看看這里面的內(nèi)容
// Top-level build file where you can add configuration options common to all sub-projects/modules.buildscript { repositories { jcenter() } dependencies { classpath 'com.android.tools.build:gradle:1.0.0' }}allprojects { repositories { jcenter() }}
內(nèi)容主要包含了兩個(gè)方面:一個(gè)是聲明倉(cāng)庫(kù)的源,這里可以看到是指明的jcenter(), 之前版本則是mavenCentral(), jcenter可以理解成是一個(gè)新的中央遠(yuǎn)程倉(cāng)庫(kù),兼容maven中心倉(cāng)庫(kù),而且性能更優(yōu)。另一個(gè)是聲明了android gradle plugin的版本,android studio 1.0正式版必須要求支持gradle plugin 1.0的版本。
這個(gè)文件是全局的項(xiàng)目配置文件,里面主要聲明一些需要加入gradle的module,我們來(lái)看看9GAG該文件的內(nèi)容:
include ':app', ':extras:ShimmerAndroid'
文件中的 app, extras:ShimmerAndroid 都是module,如果還有其他module都需要按照如上格式加進(jìn)去。
關(guān)于gradle的基礎(chǔ)知識(shí)就介紹到這里,接下來(lái)會(huì)介紹一種我常用的快速方便的編譯查看第三方開源項(xiàng)目的方法,如何導(dǎo)入Android Studio,Gradle常用基本命令,多渠道打包配置等。有疑問或者發(fā)現(xiàn)錯(cuò)誤歡迎大家直接博客留言。
聯(lián)系客服