Google 推薦使用的 Android studio 是采用 Gradle 來構建項目。Gradle 是一個非常先進的項目構建工具紊扬。
Gradle 是用了一種基于 Groovy 的領域特定語言(DSL昌执,Demain Specific Language)來聲明項目設置奈梳,摒棄了 XML(如 ANT 和 Maven)的各種繁瑣配置。注意矢门,ANT、Maven是Java開發(fā)中兩個大名鼎鼎的項目構建工具灰蛙。
Gradle 是用了一種基于 Groovy 的領域特定語言(DSL,Demain Specific Language)來聲明項目設置,摒棄了 XML(如 ANT 和 Maven)的各種繁瑣配置浮驳。
項目中一般會出現2個或者多個 build.gradle 文件卖漫,一個在根目錄下,一個在 app 目錄下障本。
那我們先來看根目錄下的build.gradle:
1,repositories 閉包教届,聲明了 jcenter() 的配置响鹃;
2,dependencies 閉包,聲明了一個 Gradle 插件案训。
buildscript {
? ? repositories {? //repositories閉包
? ? ? ? google()
? ? ? ? jcenter() //代碼托管庫:設置之后可以在項目中輕松引用jcenter上的開源項目
? ? }
? ? dependencies {? //dependencies閉包
? ? ? ? classpath 'com.android.tools.build:gradle:3.0.0' ////聲明gradle插件买置,插件版本號為3.0.0
? ? ? ? //gradle是一個強大的項目構建工具,不僅可以構建Android强霎,還可以構建java忿项,C++等
? ? ? ? //此處引用android的插件
? ? ? ? // NOTE: Do not place your application dependencies here; they belong
? ? ? ? // in the individual module build.gradle files
? ? }
}
allprojects {
? ? repositories {
? ? ? ? google()
? ? ? ? jcenter() //代碼托管庫:設置之后可以在項目中輕松引用jcenter上的開源項目
? ? }
}
task clean(type: Delete) {
? ? delete rootProject.buildDir
}
接下來看一下app目錄下的build.gradle:
1)?apply plugin,聲明是 Android 應用程序還是庫模塊城舞;
2)?android 閉包轩触,配置項目構建的各種屬性,compileSDKVersion 用于指定項目的變異 SDK? 版本家夺, buildToolsVersion 用戶指定項目構建工具的版本脱柱。
◆?defaultConfig 閉包:默認配置、應用程序包名拉馋、最小sdk版本榨为、目標sdk版本、版本號煌茴、版本名稱随闺;
◆?buildTypes 閉包:指定生成安裝文件的配置,是否對代碼進行混淆蔓腐;
◆?signingConfigs 閉包:簽名信息配置矩乐;
◆?sourceSets? 閉包:源文件路徑配置;
◆?lintOptions 閉包:lint 配置回论;
3)?dependencies 閉包散罕,指定當前項目的所有以來關系,本地以來透葛,庫依賴以及遠程依賴笨使;
4)?repositories 閉包,倉庫配置僚害。
// 聲明是Android程序硫椰,
// com.android.application 表示這是一個應用程序模塊,可直接運行
// com.android.library 標識這是一個庫模塊,是依附別的應用程序運行
apply plugin: 'com.android.application'
android {
? ? // 程序在編譯的時候會檢查lint萨蚕,有任何錯誤提示會停止build靶草,我們可以關閉這個開關
? ? lintOptions {
? ? ? ? // 即使報錯也不會停止打包
? ? ? ? abortOnError false
? ? ? ? // 打包release版本的時候是否進行檢測
? ? ? ? checkReleaseBuilds false
? ? }
? ? // 編譯sdk的版本,也就是API Level岳遥,例如API-19奕翔、API-20、API-21等等浩蓉。
? ? compileSdkVersion 27
? ? // build tools的版本派继,其中包括了打包工具aapt宾袜、dx等等。
? ? // 這個工具的目錄位于你的sdk目錄/build-tools/下
? ? buildToolsVersion '27.0.3'
? ? //關閉Android Studio的PNG合法性檢查
? ? aaptOptions.cruncherEnabled = false
? ? aaptOptions.useNewCruncher = false
? ? defaultConfig {? // 默認配置
? ? ? ? applicationId "com.demo.test" // 應用程序的包名
? ? ? ? minSdkVersion 22? / 最小sdk版本驾窟,如果設備小于這個版本或者大于maxSdkVersion將無法安裝這個應用
? ? ? ? targetSdkVersion 27 // 目標sdk版本庆猫,充分測試過的版本(建議版本)
? ? ? ? versionCode 1? // 版本號,第一版是1绅络,之后每更新一次加1
? ? ? ? versionName "1.0" // 版本名月培,顯示給用戶看到的版本號
? ? ? ? archivesBaseName = "demo-$versionName" // 指定打包成Jar文件時候的文件名稱
? ? ? ? ndk {
? ? ? ? ? ? moduleName "testwifisafe"? ? ? ? ? ? ? ? ? // 設置庫(so)文件名稱
? ? ? ? ? ? ldLibs "log", "z", "m", "jnigraphics", "android"
? ? ? ? ? ? // 引入庫,比如要用到的__android_log_print
? ? ? ? ? ? abiFilters "armeabi", "x86", "armeabi-v7a"? ? ? // "x86"? 顯示指定支持的ABIs
? ? ? ? ? ? cFlags "-std=c++11 -fexceptions"? ? ? ? ? ? ? ? // C++11
? ? ? ? ? ? stl "gnustl_static"
? ? ? ? }
? ? ? ? // 當方法數超過65535(方法的索引使用的是一個short值恩急,
? ? ? ? // 而short最大值是65535)的時候允許打包成多個dex文件杉畜,動態(tài)加載dex。這里面坑很深啊
? ? ? ? multiDexEnabled true
? ? ? ? // Instrumentation單元測試
? ? ? ? testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
? ? }
? ? // 默認的一些文件路徑的配置
? ? sourceSets {
? ? ? ? main {
? ? ? ? ? ? manifest.srcFile 'AndroidManifest.xml' // 指定清單文件
? ? ? ? ? ? res.srcDirs = ['res'] // 指定res資源目錄
? ? ? ? ? ? assets.srcDirs = ['assets']? ? // asset資源目錄
? ? ? ? ? ? jni.srcDirs 'src/main/jni'? ? // jni代碼目錄
? ? ? ? ? ? jniLibs.srcDir 'src/main/jniLibs' // jni庫目錄
? ? ? ? ? ? java.srcDirs = ['src'] // 指定java源代碼目錄
? ? ? ? ? ? resources.srcDirs = ['src'] // 指定resource目錄
? ? ? ? ? ? aidl.srcDirs = ['src'] // 指定aidl目錄
? ? ? ? ? ? renderscript.srcDirs = ['src'] // 指定source目錄
? ? ? ? }
? ? ? ? debug.setRoot('build-types/debug') // 指定debug模式的路徑
? ? ? ? release.setRoot('build-types/release') // 指定release模式的路徑
? ? }
? ? // multiDex的一些相關配置衷恭,這樣配置可以讓你的編譯速度更快
? ? dexOptions {
? ? ? ? // 讓它不要對Lib做preDexing
? ? ? ? preDexLibraries = false
? ? ? ? // 開啟incremental dexing,優(yōu)化編譯效率此叠,這個功能android studio默認是關閉的。
? ? ? ? incremental true
? ? ? ? javaMaxHeapSize "4g" // 增加java堆內存大小
? ? }
? ? signingConfigs {// 簽名配置
? ? ? ? release {// 發(fā)布版簽名配置
? ? ? ? ? ? storeFile file("fk.keystore") // 密鑰文件路徑
? ? ? ? ? ? storePassword "123456" // 密鑰文件密碼
? ? ? ? ? ? keyAlias "fk" // key別名
? ? ? ? ? ? keyPassword "123456" // key密碼
? ? ? ? }
? ? ? ? debug {// debug版簽名配置
? ? ? ? ? ? storeFile file("fk.keystore")
? ? ? ? ? ? storePassword "123456"
? ? ? ? ? ? keyAlias "fk"
? ? ? ? ? ? keyPassword "123456"
? ? ? ? }
? ? }
? ? // 指定生成安裝文件的配置随珠,常有兩個子包:release,debug拌蜘,注:直接運行的都是debug安裝文件
? ? buildTypes {
? ? ? ? // release版本的配置,即生成正式版安裝文件的配置
? ? ? ? release {
? ? ? ? ? ? zipAlignEnabled true? // 是否支持zip
? ? ? ? ? ? shrinkResources true? // 移除無用的resource文件
? ? ? ? ? ? minifyEnabled false // 是否對代碼進行混淆牙丽,true表示混淆
? ? ? ? ? ? // 指定混淆時使用的規(guī)則文件;
? ? ? ? ? ? // proguard-android.txt指所有項目通用的混淆規(guī)則兔魂,proguard-rules.pro當前項目特有的混淆規(guī)則
? ? ? ? ? ? // release的Proguard默認為Module下的proguard-rules.pro文件
? ? ? ? ? ? proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
? ? ? ? ? ? debuggable false? //是否支持調試
? ? ? ? ? ? //ndk的一些配置
? ? ? ? ? ? ndk {
? ? ? ? ? ? ? ? // cFlags "-std=c++11 -fexceptions -O3 -D__RELEASE__" // C++11
? ? ? ? ? ? ? ? // platformVersion = "19"
? ? ? ? ? ? ? ? moduleName "hebbewifisafe" // 設置庫(so)文件名稱
? ? ? ? ? ? ? ? ldLibs "log", "z", "m", "jnigraphics", "android"
? ? ? ? ? ? ? ? // 引入庫烤芦,比如要用到的__android_log_print
? ? ? ? ? ? ? ? abiFilters "armeabi", "x86", "armeabi-v7a"http:// "x86"
? ? ? ? ? ? ? ? cFlags "-std=c++11 -fexceptions" // C++11
? ? ? ? ? ? ? ? stl "gnustl_static"
? ? ? ? ? ? }
? ? ? ? ? ? // 采用動態(tài)替換字符串的方式生成不同的 release.apk (3.0之后版本的修改方式)
? ? ? ? ? ? applicationVariants.all { variant ->
? ? ? ? ? ? ? ? variant.outputs.all { output ->
? ? ? ? ? ? ? ? ? ? if (!variant.buildType.isDebuggable()) {
? ? ? ? ? ? ? ? ? ? ? ? // 獲取簽名的名字 variant.signingConfig.name
? ? ? ? ? ? ? ? ? ? ? ? // 要被替換的源字符串
? ? ? ? ? ? ? ? ? ? ? ? def sourceFile = "app-release";
? ? ? ? ? ? ? ? ? ? ? ? // 替換的字符串
def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"
outputFileName = output.outputFile.name.replace(sourceFile, replaceFile)
? ? ? ? ? ? ? ? ? ? }
? ? ? ? ? ? ? ? }
? ? ? ? ? ? }
? ? ? ? ? ? jniDebuggable false? // 關閉jni調試
? ? ? ? }
? ? ? ? debug { // debug版本的配置
? ? ? ? ? ? minifyEnabled false
? ? ? ? ? ? zipAlignEnabled true
? ? ? ? ? ? shrinkResources true // 移除無用的resource文件
? ? ? ? ? ? proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
? ? ? ? ? ? debuggable true
//? ? ? ? ? jniDebuggable true
? ? ? ? ? ? ndk {
? ? ? ? ? ? ? ? cFlags "-std=c++11 -fexceptions -g -D __DEBUG__" // C++11
? ? ? ? ? ? }
? ? ? ? ? ? jniDebuggable true
? ? ? ? }
? ? }
? ? packagingOptions {
? ? ? ? exclude 'META-INF/ASL2.0'
? ? ? ? exclude 'META-INF/LICENSE'
? ? ? ? exclude 'META-INF/NOTICE'
? ? ? ? exclude 'META-INF/MANIFEST.MF'
? ? }
? ? compileOptions {
? ? ? ? // 在這里你可以進行 Java 的版本配置,
? ? ? ? // 以便使用對應版本的一些新特性
? ? }
? ? productFlavors {
? ? ? ? // 在這里你可以設置你的產品發(fā)布的一些東西析校,
? ? ? ? // 比如你現在一共軟件需要發(fā)布到不同渠道构罗,
? ? ? ? // 且不同渠道中的包名不同,那么可以在此進行配置智玻;
? ? ? ? // 甚至可以設置不同的 AndroidManifest.xml 文件遂唧。
? ? ? ? hebbe {
? ? ? ? }
? ? ? ? googlePlay {
? ? ? ? }
? ? ? ? solo {
? ? ? ? }
? ? }
? ? productFlavors.all {
? ? ? ? flavor -> flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]
? ? }
? ? // 所謂ProductFlavors其實就是可定義的產品特性,
? ? // 配合 manifest merger 使用的時候就可以達成在一次編譯
? ? // 過程中產生多個具有自己特性配置的版本吊奢。
? ? // 上面這個配置的作用就是盖彭,為每個渠道包產生不同的 UMENG_CHANNEL_VALUE 的值。
}
// 指定當前項目的所有依賴關系:本地依賴页滚、庫依賴召边、遠程依賴
// 本地依賴:可以對本地 Jar 包或目錄添加依賴關系
// 庫依賴:可以對項目中的庫模塊添加依賴關系
// 遠程依賴:可以對 jcenter 庫上的開源項目添加依賴
// 標準的遠程依賴格式是 域名:組織名:版本號
dependencies {
? ? implementation fileTree(dir: 'libs', include: ['*.jar']) // 本地依賴
? ? // 遠程依賴,com.android.support是域名部分裹驰,appcompat-v7是組名稱隧熙,26.1.0是版本號
? ? implementation 'com.android.support:appcompat-v7:26.1.0'
? ? implementation 'com.android.support.constraint:constraint-layout:1.0.2'
? ? implementation project(':hello') // 庫依賴
? ? testImplementation 'junit:junit:4.12' // 聲明測試用列庫
? ? androidTestImplementation 'com.android.support.test:runner:1.0.1'
? ? androidTestImplementation 'com.android.support.test.espresso:espresso-core:3.0.1'
}
// 聲明是要使用谷歌服務框架
apply plugin: 'com.google.gms.google-services'
// 第三方依賴庫的本地緩存路徑
task showMeCache << {
? ? configurations.compile.each { println it }
}
// 使用maven倉庫。android有兩個標準的library文件服務器幻林,一個jcenter一個maven贞盯。兩者毫無關系音念。
// jcenter有的maven可能沒有,反之亦然躏敢。
// 如果要使用jcenter的話就把mavenCentral()替換成jcenter()
repositories {
? ? mavenCentral()
}
205 // 獲取日期方法
def releaseTime() {
? return new Date().format("MMdd.HHmm")
}