[轉] build.gradle 淺析

簡述:

  1) Java 開發中有兩個大名鼎鼎的項目構建 ANT、Maven。

  2) Google 推薦使用的 Android studio 是採用 Gradle 來構建項目。Gradle 是一個非常先進的項目構建工具。

  Gradle 是用了一種基於 Groovy 的領域特定語言(DSL,Demain Specific Language)來聲明項目設置,摒棄了 XML(如 ANT 和 Maven)的各種繁瑣配置。

  3) 項目中一般會出現2個或者多個 build.gradle 文件,一個在根目錄下,一個在 app 目錄下。

  如果切換到 Android 模式下則全部在 Gradle Scripts。

 

1. 根目錄下的 build.gradle

  1) repositories 閉包,聲明瞭 jcenter() 的配置;

  2) dependencies 閉包,聲明瞭一個 Gradle 插件。

複製代碼
 1 buildscript {
 2     
 3     repositories {  //repositories閉包
 4         google()
 5         jcenter() //代碼託管庫:設置之後可以在項目中輕鬆引用jcenter上的開源項目
 6     }
 7     dependencies {  //dependencies閉包
 8         classpath 'com.android.tools.build:gradle:3.0.0' ////聲明gradle插件,插件版本號爲3.0.0
 9         //gradle是一個強大的項目構建工具,不僅可以構建Android,還可以構建java,C++等
10         //此處引用android的插件
11         // NOTE: Do not place your application dependencies here; they belong
12         // in the individual module build.gradle files
13     }
14 }
15 
16 allprojects {
17     repositories {
18         google()
19         jcenter() //代碼託管庫:設置之後可以在項目中輕鬆引用jcenter上的開源項目
20     }
21 }
22 
23 task clean(type: Delete) {
24     delete rootProject.buildDir
25 }
複製代碼

 

2. app 目錄下的build.gradle

  1) apply plugin,聲明是 Android 應用程序還是庫模塊;

  2) android 閉包,配置項目構建的各種屬性,compileSDKVersion 用於指定項目的變異 SDK  版本, buildToolsVersion 用戶指定項目構建工具的版本。

    ◆ defaultConfig 閉包:默認配置、應用程序包名、最小sdk版本、目標sdk版本、版本號、版本名稱;

    ◆ buildTypes 閉包:指定生成安裝文件的配置,是否對代碼進行混淆;

    ◆ signingConfigs 閉包:簽名信息配置;

    ◆ sourceSets  閉包:源文件路徑配置;

    ◆ lintOptions 閉包:lint 配置;

  3) dependencies 閉包,指定當前項目的所有以來關係,本地以來,庫依賴以及遠程依賴;

  4) repositories 閉包,倉庫配置。

複製代碼
  1 // 聲明是Android程序,
  2 // com.android.application 表示這是一個應用程序模塊,可直接運行
  3 // com.android.library 標識這是一個庫模塊,是依附別的應用程序運行
  4 apply plugin: 'com.android.application'
  5 
  6 android {
  7     // 程序在編譯的時候會檢查lint,有任何錯誤提示會停止build,我們可以關閉這個開關
  8     lintOptions {
  9         // 即使報錯也不會停止打包
 10         abortOnError false
 11         // 打包release版本的時候是否進行檢測
 12         checkReleaseBuilds false
 13     }
 14 
 15     // 編譯sdk的版本,也就是API Level,例如API-19、API-20、API-21等等。
 16     compileSdkVersion 27
 17     // build tools的版本,其中包括了打包工具aapt、dx等等。
 18     // 這個工具的目錄位於你的sdk目錄/build-tools/下
 19     buildToolsVersion '27.0.3'
 20 
 21     //關閉Android Studio的PNG合法性檢查
 22     aaptOptions.cruncherEnabled = false
 23     aaptOptions.useNewCruncher = false
 24 
 25     defaultConfig {  // 默認配置
 26         applicationId "com.demo.test" // 應用程序的包名
 27         minSdkVersion 22  / 最小sdk版本,如果設備小於這個版本或者大於maxSdkVersion將無法安裝這個應用
 28         targetSdkVersion 27 // 目標sdk版本,充分測試過的版本(建議版本)
 29         versionCode 1  // 版本號,第一版是1,之後每更新一次加1
 30         versionName "1.0" // 版本名,顯示給用戶看到的版本號
 31 
 32         archivesBaseName = "demo-$versionName" // 指定打包成Jar文件時候的文件名稱
 33         ndk {
 34             moduleName "testwifisafe"                   // 設置庫(so)文件名稱
 35             ldLibs "log", "z", "m", "jnigraphics", "android"
 36             // 引入庫,比如要用到的__android_log_print
 37             abiFilters "armeabi", "x86", "armeabi-v7a"      // "x86"  顯示指定支持的ABIs
 38             cFlags "-std=c++11 -fexceptions"                // C++11
 39             stl "gnustl_static"
 40         }
 41 
 42         // 當方法數超過65535(方法的索引使用的是一個short值,
 43         // 而short最大值是65535)的時候允許打包成多個dex文件,動態加載dex。這裏面坑很深啊
 44         multiDexEnabled true
 45 
 46         // Instrumentation單元測試
 47         testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
 48     }
 49 
 50     // 默認的一些文件路徑的配置
 51     sourceSets {
 52         main {
 53             manifest.srcFile 'AndroidManifest.xml' // 指定清單文件
 54             res.srcDirs = ['res'] // 指定res資源目錄
 55             assets.srcDirs = ['assets']    // asset資源目錄
 56             jni.srcDirs 'src/main/jni'     // jni代碼目錄
 57             jniLibs.srcDir 'src/main/jniLibs' // jni庫目錄
 58             java.srcDirs = ['src'] // 指定java源代碼目錄
 59             resources.srcDirs = ['src'] // 指定resource目錄
 60             aidl.srcDirs = ['src'] // 指定aidl目錄
 61             renderscript.srcDirs = ['src'] // 指定source目錄
 62         }
 63         debug.setRoot('build-types/debug') // 指定debug模式的路徑
 64         release.setRoot('build-types/release') // 指定release模式的路徑
 65     }
 66 
 67     // multiDex的一些相關配置,這樣配置可以讓你的編譯速度更快
 68     dexOptions {
 69         // 讓它不要對Lib做preDexing
 70         preDexLibraries = false
 71         // 開啓incremental dexing,優化編譯效率,這個功能android studio默認是關閉的。
 72         incremental true
 73         javaMaxHeapSize "4g" // 增加java堆內存大小
 74     }
 75 
 76     signingConfigs {// 簽名配置
 77         release {// 發佈版簽名配置
 78             storeFile file("fk.keystore") // 密鑰文件路徑
 79             storePassword "123456" // 密鑰文件密碼
 80             keyAlias "fk" // key別名
 81             keyPassword "123456" // key密碼
 82         }
 83         debug {// debug版簽名配置
 84             storeFile file("fk.keystore")
 85             storePassword "123456"
 86             keyAlias "fk"
 87             keyPassword "123456"
 88         }
 89     }
 90 
 91     // 指定生成安裝文件的配置,常有兩個子包:release,debug,注:直接運行的都是debug安裝文件
 92     buildTypes {
 93         // release版本的配置,即生成正式版安裝文件的配置
 94         release {
 95             zipAlignEnabled true  // 是否支持zip
 96             shrinkResources true  // 移除無用的resource文件
 97             minifyEnabled false // 是否對代碼進行混淆,true表示混淆
 98             // 指定混淆時使用的規則文件;
 99             // proguard-android.txt指所有項目通用的混淆規則,proguard-rules.pro當前項目特有的混淆規則
100             // release的Proguard默認爲Module下的proguard-rules.pro文件
101             proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
102             debuggable false  //是否支持調試
103             //ndk的一些配置
104             ndk {
105                 // cFlags "-std=c++11 -fexceptions -O3 -D__RELEASE__" // C++11
106                 // platformVersion = "19"
107                 moduleName "hebbewifisafe" // 設置庫(so)文件名稱
108                 ldLibs "log", "z", "m", "jnigraphics", "android"
109                 // 引入庫,比如要用到的__android_log_print
110                 abiFilters "armeabi", "x86", "armeabi-v7a"// "x86"
111                 cFlags "-std=c++11 -fexceptions" // C++11
112                 stl "gnustl_static"
113             }
114             // 採用動態替換字符串的方式生成不同的 release.apk (3.0之後版本的修改方式)
115             applicationVariants.all { variant ->
116                 variant.outputs.all { output ->
117                     if (!variant.buildType.isDebuggable()) {
118 // 獲取簽名的名字 variant.signingConfig.name
119 // 要被替換的源字符串
120 def sourceFile = "app-release"; 121 // 替換的字符串
122               def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"
123               outputFileName = output.outputFile.name.replace(sourceFile, replaceFile) 124 } 125 } 126 } 127 jniDebuggable false // 關閉jni調試 128 } 129 debug { // debug版本的配置 130 minifyEnabled false 131 zipAlignEnabled true 132 shrinkResources true // 移除無用的resource文件 133 proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' 134 debuggable true 135 // jniDebuggable true 136 ndk { 137 cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11 138 } 139 jniDebuggable true 140 } 141 } 142 143 packagingOptions { 144 exclude 'META-INF/ASL2.0' 145 exclude 'META-INF/LICENSE' 146 exclude 'META-INF/NOTICE' 147 exclude 'META-INF/MANIFEST.MF' 148 } 149 150 compileOptions { 151 // 在這裏你可以進行 Java 的版本配置, 152 // 以便使用對應版本的一些新特性 153 } 154 productFlavors { 155 // 在這裏你可以設置你的產品發佈的一些東西, 156 // 比如你現在一共軟件需要發佈到不同渠道, 157 // 且不同渠道中的包名不同,那麼可以在此進行配置; 158 // 甚至可以設置不同的 AndroidManifest.xml 文件。 159 hebbe { 160 } 161 googlePlay { 162 } 163 solo { 164 } 165 } 166 productFlavors.all { 167 flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name] 168 } 169 // 所謂ProductFlavors其實就是可定義的產品特性, 170 // 配合 manifest merger 使用的時候就可以達成在一次編譯 171 // 過程中產生多個具有自己特性配置的版本。 172 // 上面這個配置的作用就是,爲每個渠道包產生不同的 UMENG_CHANNEL_VALUE 的值。 173 } 174 175 // 指定當前項目的所有依賴關係:本地依賴、庫依賴、遠程依賴 176 // 本地依賴:可以對本地 Jar 包或目錄添加依賴關係 177 // 庫依賴:可以對項目中的庫模塊添加依賴關係 178 // 遠程依賴:可以對 jcenter 庫上的開源項目添加依賴 179 // 標準的遠程依賴格式是 域名:組織名:版本號 180 dependencies { 181 implementation fileTree(dir: 'libs', include: ['*.jar']) // 本地依賴 182 // 遠程依賴,com.android.support是域名部分,appcompat-v7是組名稱,26.1.0是版本號 183 implementation 'com.android.support:appcompat-v7:26.1.0' 184 implementation 'com.android.support.constraint:constraint-layout:1.0.2' 185 implementation project(':hello') // 庫依賴 186 testImplementation 'junit:junit:4.12' // 聲明測試用列庫 187 androidTestImplementation 'com.android.support.test:runner:1.0.1' 188 androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1' 189 } 190 191 // 聲明是要使用谷歌服務框架 192 apply plugin: 'com.google.gms.google-services' 193 194 // 第三方依賴庫的本地緩存路徑 195 task showMeCache << { 196 configurations.compile.each { println it } 197 } 198 // 使用maven倉庫。android有兩個標準的library文件服務器,一個jcenter一個maven。兩者毫無關係。 199 // jcenter有的maven可能沒有,反之亦然。 200 // 如果要使用jcenter的話就把mavenCentral()替換成jcenter() 201 repositories { 202 mavenCentral() 203 }
204
205 // 獲取日期方法
206 def releaseTime() {
207 return new Date().format("MMdd.HHmm")
208 }

複製代碼

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章