Android Studio Gradle命令和配置

轉載(未找到原始鏈接)
Gradle是一種構建工具,它拋棄了基于XML的構建腳本,取而代之的是采用一種基于Groovy的內部領域特定語言,建議可以先熟悉一下Groovy腳本。
在線文檔

Gradle命令:

常用命令:

gradle明明一般是./gradlew +參數gradlew 代表gradle wrapper,意思是gradle的一層包裝,大家可以理解為在這個項目本地就封裝了gradle,即gradle wrapper, 在gradle/wrapper/gralde-wrapper.properties 文件中聲明了它指向的目錄和版本。只要下載成功即可用grdlew wrapper的命令代替全局的gradle命令。

  • ./gradlew -v 版本號
  • ./gradlew clean 清除app目錄下的build文件夾
  • ./gradlew build 檢查依賴并編譯打包

這里注意的是 ./gradlew build 命令把debugrelease環境的包都打出來,如果正式發布只需要打Release的包,該怎么辦呢,下面介紹一個很有用的命令 assemble, 如:

  • ./gradlew assembleDebug 編譯并打Debug包
  • ./gradlew assembleRelease 編譯并打Release的包

除此之外,assemble還可以和productFlavors結合使用:

  • ./gradlew installReleaseRelease模式打包并安裝
  • ./gradlew uninstallRelease 卸載Release模式包

加入自定義參數:

比如我們想根據不同的參數來進行不用的編譯配置,可以在./gradlew中加入自定義參數。
./gradlew assembleDebug -Pcustom=true

就可以在build.gradle中使用下面代碼來判斷:

if (project.hasProperty('custom')){

}

assemble結合Build Variants來創建task

assemble 還能和Product Flavor 結合創建新的任務,其實 assemble 是和 Build Variants 一起結合使用的,而 Build Variants = Build Type + Product Flavor,舉個例子大家就明白了: 如果我們想打包 wandoujia 渠道的release版本,執行如下命令就好了:

  • ./gradlew assembleWandoujiaRelease

如果我們只打wandoujia渠道版本,則:

  • ./gradlew assembleWandoujia

此命令會生成wandoujia渠道的ReleaseDebug版本 同理我想打全部Release版本:

  • ./gradlew assembleRelease

這條命令會把Product Flavor下的所有渠道的Release版本都打出來。 總之,assemble
命令創建task有如下用法:

  • assemble<Variant Name>: 允許直接構建一個Variant版本,例如assembleFlavor1Debug。
  • assemble<Build Type Name>: 允許構建指定Build Type的所有APK,例如assembleDebug將會構建Flavor1Debug和Flavor2Debug兩個Variant版本。
  • assemble<Product Flavor Name>: 允許構建指定flavor的所有APK,例如assembleFlavor1將會構建Flavor1Debug和Flavor1Release兩個Variant版本。

Gradle配置:

  • Gradle構建腳本 build.gradle
  • Gradle屬性文件 gradle.properties
  • Gradle設置文件 settings.gradle

build.gradle

先看整個項目的gradle配置文件:

buildscript {
        buildscript {
    repositories {
        jcenter()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.0'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        jcenter()
    }
}

內容主要包含了兩個方面:一個是聲明倉庫的源,這里可以看到是指明的jcenter(), 之前版本則是mavenCentral(),jcenter可以理解成是一個新的中央遠程倉庫,兼容maven中心倉庫,而且性能更優。
另一個是聲明了android gradle plugin的版本,android studio 1.0 正式版必須要求支持gradle plugin 1.0的版本某個Moudle的gradle配置文件:

buildscript

buildscript {
    repositories {
        maven { url 'http://*********' }
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:1.3.1'
    }
}
  • buildscript{}設置腳本的運行環境。
    *repositories{}支持java依賴庫管理,用于項目依賴。
  • dependencies{}依賴包的定義。支持maven/ivy,遠程,本地庫,也支持單文件。如果前面定義了repositories{}maven 庫,則使用maven的依賴庫,使用時只需要按照用類似于com.android.tools.build:gradle:0.4,gradle 就會自動的往遠程庫下載相應的依賴。

apply

//聲明是Android程序
apply plugin: 'com.android.application'

*apply plugin:聲明構建的項目類型。如果是庫的話就加

apply plugin: 'com.android.library'

android

android {
    // 編譯SDK的版本
    compileSdkVersion 22
    // build tools的版本
    buildToolsVersion "23.0.1"

    //aapt配置
    aaptOptions {
        //不用壓縮的文件
        noCompress 'pak', 'dat', 'bin', 'notice'
        //打包時候要忽略的文件
        ignoreAssetsPattern "!.svn:!.git"
        //分包
        multiDexEnabled true
        //--extra-packages是為資源文件設置別名:意思是通過該應用包名+R,com.android.test1.R和com.android.test2.R都可以訪問到資源
        additionalParameters '--extra-packages', 'com.android.test1','--extra-packages','com.android.test2'
    }

    //默認配置
    defaultConfig {
        //應用的包名
        applicationId "com.example.heqiang.androiddemo"
        minSdkVersion 21
        targetSdkVersion 22
        versionCode 1
        versionName "1.0"
    }

    //編譯配置
    compileOptions {
        // java版本
        sourceCompatibility JavaVersion.VERSION_1_7
        targetCompatibility JavaVersion.VERSION_1_7
    }

    //源文件目錄設置
    sourceSets {
        main {
             //jni lib的位置
             jniLibs.srcDirs = jniLibs.srcDirs << 'src/jniLibs'
             //定義多個資源文件夾,這種情況下,兩個資源文件夾具有相同優先級,即如果一個資源在兩個文件夾都聲明了,合并會報錯。
             res.srcDirs = ['src/main/res', 'src/main/res2']
        }
    }

    //簽名配置
    signingConfigs {
        debug {
            keyAlias 'androiddebugkey'
            keyPassword 'android'
            storeFile file('keystore/debug.keystore')
            storePassword 'android'
        }
    }

    buildTypes {
        //release版本配置
        release {
            debuggable false
            // 是否進行混淆
            minifyEnabled true
            //去除沒有用到的資源文件,要求minifyEnabled為true才生效
            shrinkResources true
            // 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
            signingConfig signingConfigs.debug
            //ndk的一些相關配置,也可以放到defaultConfig里面。
            //指定要ndk需要兼容的架構(這樣其他依賴包里mips,x86,arm-v8之類的so會被過濾掉)
            ndk {
                abiFilter "armeabi"
            }
        }
        //debug版本配置
        debug {
            debuggable true
            // 是否進行混淆
            minifyEnabled false
            //去除沒有用到的資源文件,要求minifyEnabled為true才生效
            shrinkResources true
            // 混淆文件的位置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt'
            signingConfig signingConfigs.debug
            //ndk的一些相關配置,也可以放到defaultConfig里面。
            //指定要ndk需要兼容的架構(這樣其他依賴包里mips,x86,arm-v8之類的so會被過濾掉)
            ndk {
                abiFilter "armeabi"
            }
        }
    }
    // lint配置 
    lintOptions {
      //移除lint檢查的error
      abortOnError false
      //禁止掉某些lint檢查
      disable 'NewApi'
    }
}

android{}設置編譯android項目的參數,構建android項目的所有配置都寫在這里。 除了上面寫的,在android{}塊中可以包含以下直接配置項:
*productFlavors{ }產品風格配置,ProductFlavor類型

  • testOptions{ }測試配置,TestOptions類型
  • dexOptions{ }dex配置,DexOptions類型
  • packagingOptions{ }PackagingOptions類型
    *jacoco{ }JacocoExtension類型。 用于設定 jacoco版本
  • splits{ }Splits類型。
幾點說明:
  • 文件開頭apply plugin是最新gradle版本的寫法,以前的寫法是apply plugin: 'android', 如果還是以前的寫法,請改正過來。
    *minifyEnabled也是最新的語法,很早之前是runProguard,這個也需要更新下。
  • proguardFiles這部分有兩段,前一部分代表系統默認的android程序的混淆文件,該文件已經包含了基本的混淆聲明,免去了我們很多事,這個文件的目錄在 sdk目錄/tools/proguard/proguard-android.txt , 后一部分是我們項目里的自定義的混淆文件,目錄就在 app/proguard-rules.txt
    , 如果你用Studio 1.0創建的新項目默認生成的文件名是proguard-rules.pro , 這個名字沒關系,在這個文件里你可以聲明一些第三方依賴的一些混淆規則。最終混淆的結果是這兩部分文件共同作用的。
  • aaptOptions更多介紹 http://blog.csdn.net/heqiangflytosky/article/details/51009123

repositories

repositories {
    flatDir {
        //本地jar依賴包路徑
        dirs '../../../../main/libs'
    }
}

dependencies

dependencies {
        compile files('libs/android-support-v4.jar')
        //在flatDir.dirs下面找依賴的aar
        compile (name:'ui', ext:'aar')
        // 編譯extras目錄下的ShimmerAndroid模塊
        compile project(':extras:ShimmerAndroid')
        // 編譯CommonSDK模塊,但是去掉此模塊中對com.android.support的依賴,防止重復依賴報錯
        compile (project(':CommonSDK')) { exclude group: "com.android.support" }
        provided fileTree(dir: 'src/android5/libs', include: ['*.jar'])
        provided 'com.android.support:support-v4:21.0.3'
        provided project(':main-host')
}

  • compile和provided
    compile表示編譯時提供并打包進apk。
    provided表示只在編譯時提供,不打包進apk。
  • exclude防止重復依賴
  • include

CommonSDK模塊的定義可以參考settings.gradle其他的介紹可以參考 依賴庫管理。

幾點說明

  • 看到上面的兩個一模一樣的repositories和dependencies了嗎?他們的作用是不一樣的,在buildscript里面的那個是插件初始化環境用的,用于設定插件的下載倉庫,而外面的這個是設定工程依賴的一些模塊和遠程library的下載倉庫的。

settings.gradle

這個文件是全局的項目配置文件,里面主要聲明一些需要加入gradle的module。 一般在setting.gradle中主要是調用include方法,導入工程下的各個子模塊。 那我們在setting.gradle
里面還能寫什么呢?因為setting.gradle對應的是gradle中的Settings
對象,那查下Settings的文檔(https://docs.gradle.org/current/dsl/org.gradle.api.initialization.Settings.html),看下它都有哪些方法,哪些屬性,就知道在setting.gradle能寫什么了;

include ':AndroidDemo'

include ':CommonSDK'
project(':CommonSDK').projectDir = new File(settingsDir, '../../CommonSDK/')

include調用后,生成了一個名為:CommonSDK的Project對象,project(':CommonSDK')
取出這個對象,設置Project的 projectDir屬性。projectDir哪里來的?請看Project
類的文檔。

依賴庫管理

本地依賴

dependencies {
    //單文件依賴
        compile files('libs/android-support-v4.jar')
    //某個文件夾下面全部依賴
        compile fileTree(dir: 'src/android6/libs', include: ['*.jar'])
        compile (name:'ui', ext:'aar')
    compile (project(':CommonSDK')) { exclude group: "com.android.support" }
        provided fileTree(dir: 'src/android5/libs', include: ['*.jar'])
        provided 'com.android.support:support-v4:21.0.3'
        provided project(':main-host')
}

遠程依賴

gradle同時支持maven,ivy,以maven作為例子:

repositories { 
 //從中央庫里面獲取依賴
 mavenCentral() 
 //或者使用指定的本地maven 庫
 maven{ 
  url "file://F:/githubrepo/releases" 
 }
 //或者使用指定的遠程maven庫
 maven{ 
  url "https://github.com/youxiachai/youxiachai-mvn-repo/raw/master/releases" 
 } 
} 

dependencies { 
 //應用格式: packageName:artifactId:version 
 compile 'com.google.android:support-v4:r13' 
}

項目依賴

對于項目依賴android library的話,在這里需要使用gradle mulit project機制。Mulit project設置是gradle約定的一種格式,如果需要編譯某個項目之前,要先編譯另外一個項目的時候,就需要用到。結構如下(來自于官方文檔):

MyProject/ 
| settings.gradle 
 + app/ 
| build.gradle 
 + libraries/ 
  + lib1/ 
   | build.gradle 
  + lib2/ 
   | build.gradle

需要在workplace目錄下面創建settings.gradle 的文件,然后在里面寫上:
include ':app', ':libraries:lib1', ':libraries:lib2'

例如:

include ':AndroidDemo'

include ':CommonSDK'
project(':CommonSDK').projectDir = new File(settingsDir, '../../CommonSDK/')

如此,gradle mutil project就設置完畢。
對于app project如果需要應用libraries目錄下的lib1,只需要在app project的build.gradle文件里的依賴中這么寫:
compile project(':libraries:lib1')

類似前面的
provided project(':main-host')

即可完成,寫完以后可以用gradle AndroidDependencies
可以檢查依賴狀況

多渠道打包:

主要借助

android {
    productFlavors{
    ……
    }
}

來實現。
網上多是類似友盟的配置,copy過來:
http://blog.csdn.net/maosidiaoxian/article/details/42000913
https://segmentfault.com/a/1190000004050697
在AndroidManifest.xml里面寫上:

<meta-data
    android:name="UMENG_CHANNEL"
    android:value="Channel_ID" />

里面的Channel_ID就是渠道標示。我們的目標就是在編譯的時候這個值能夠自動變化。

android {  
    productFlavors {
        xiaomi {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
        }
        _360 {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "_360"]
        }
        baidu {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "baidu"]
        }
        wandoujia {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
        }
    }  
}

或者批量修改

android {  
    productFlavors {
        xiaomi {}
        _360 {}
        baidu {}
        wandoujia {}
    }  

    productFlavors.all { 
        flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] 
    }
}

然后用 ./gradlew assembleRelease 這條命令會把Product Flavor下的所有渠道的Release版本都打出來。 assemble<Product Flavor Name>: 允許構建指定flavor的所有APK,例如assembleFlavor1將會構建Flavor1Debug和Flavor1Release兩個Variant版本。
在上面當中,我們也可以指定一個默認的渠道名,如果需要的話。指定默認的值是在defaultConfig
節點當中添加如下內容:
manifestPlaceholders = [ CHANNEL_NAME:"Unspecified"]

這里的 Unspecified換成你實際上的默認的渠道名。 使用manifestPlaceholders的這種配置,同樣適用于manifest的其他配置。比如你需要在不同渠道發布的apk里面,指定不同的啟動Activity
。比如在豌豆莢里面發布的,啟動的Activity顯示的是豌豆莢首發的界面,應用寶里面啟動的是應用寶首發的界面(哈哈,有點壞),你就可以對你的activity的值使用 {activity_name}的方式,然后在productFlavors里面配置這個{activity_name}的值。

Gradle依賴的統一管理

我們可以在項目的根目錄創建一個gradle配置文件config.gradle,內容如下:

ext{
    android=[
            compileSdkVersion: 22,
            buildToolsVersion: "23.0.1",
            minSdkVersion: 21,
            targetSdkVersion: 22,
            versionCode: 1,
            versionName: "1.0"
    ]
    dependencies=[
            compile:'com.android.support:support-v4:21.0.3',
            compile: (project(':CommonSDK')) { exclude group: "com.android.support" },
            provided: fileTree(dir: 'src/android5/libs', include: ['*.jar']),
            provided: project(':main-host')
    ]
}

targetSdkVersion的版本還有依賴庫的版本升級都在這里進行統一管理,所有的 module 以及主項目都從這里同意讀取就可以了。 在build.gradle文件中加入:
apply from:"config.gradle"
意思是所有的子項目或者所有的modules都可以從這個配置文件中讀取內容。 android節點讀取ext中android對應項,dependencies讀取dependencies對應項,如果配置有變化就可以只在config.gradle中修改,是不是很方便進行配置的管理的。

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發布,文章內容僅代表作者本人觀點,簡書系信息發布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 173,532評論 25 708
  • 轉至:http://blog.csdn.net/heqiangflytosky/article/details/5...
    kkgo閱讀 2,933評論 0 1
  • 1.介紹 如果你正在查閱build.gradle文件的所有可選項,請點擊這里進行查閱:DSL參考 1.1新構建系統...
    Chuckiefan閱讀 12,189評論 8 72
  • 轉載注明出處:http://www.lxweimin.com/p/5255b100930e 0. 前言 完全由個人翻...
    王三的貓阿德閱讀 2,575評論 0 4
  • 伴隨著他的成長,越來越感覺到身上有一種神圣的責任感。從男孩到男人,一步步蛻變的過程不就是越來越有責任和擔當嗎。我的...
    孤山老人閱讀 238評論 0 3