1. 程式人生 > >二)Android配置構建詳解

二)Android配置構建詳解

1) 說明

Android 構建系統編譯應用資源和原始碼,然後將它們打包成可供您測試、部署、簽署和分發的 APK。Android Studio 使用 Gradle 這一高階構建工具包來自動化執行和管理構建流程,同時也允許您定義靈活的自定義構建配置。每個構建配置均可自行定義一組程式碼和資源,同時對所有應用版本共有的部分加以重複利用。Android Plugin for Gradle 與這個構建工具包協作,共同提供專用於構建和測試 Android 應用的流程和可配置設定。

2) 構建流程
典型 Android 應用模組的構建流程圖
在這裡插入圖片描述

流程說明:

1: 編譯器將原始碼(包含資原始檔等)轉換成 DEX(Dalvik Executable) 檔案(其中包括執行在 Android 裝置上的位元組碼),將所有其他內容轉換成已編譯資源。
2: APK 打包器將 DEX 檔案和已編譯資源合併成單個 APK。不過,必須先簽署 APK,才能將應用安裝並部署到 Android 裝置上。
3: APK 打包器使用除錯或釋出金鑰庫簽署您的 APK
4: 在生成最終 APK 之前,打包器會使用 zipalign 工具對應用進行優化,減少其在裝置上執行時的記憶體佔用
   構建流程結束時,您將獲得可用來進行部署、測試的除錯 APK,或者可用來發布給外部使用者的釋出 APK

3) 構建配置檔案

	建立自定義構建配置需要您對一個或多個構建配置檔案(或 build.gradle 檔案)進行更改。這些純文字檔案使用域特定語言 (DSL) 以 Groovy 語言描述和操作構建邏輯,後者是一種適用於 Java 虛擬機器 (JVM) 的動態語言。您無需瞭解 Groovy 便可開始配置構建,因為 Android Plugin for Gradle 引入了您需要的大多數 DSL 元素。如需瞭解有關 Android 外掛 DSL 的更多資訊,
	開始新專案時,Android Studio 會自動為您建立其中的部分檔案(如圖 2 所示),併為它們填充合理的預設值

4Android 預設應用結構圖。
在這裡插入圖片描述


Gradle 設定檔案
settings.gradle 檔案位於專案根目錄,用於指示 Gradle 在構建應用時應將哪些模組包括在內。對大多數專案而言,該檔案很簡單,只包括以下內容:
include ‘:app’
不過,多模組專案需要指定應包括在最終構建之中的每個模組。
在這裡插入圖片描述

頂級構建檔案
頂級 build.gradle 檔案位於專案根目錄,用於定義適用於專案中所有模組的構建配置。預設情況下,這個頂級構建檔案使用 buildscript {} 程式碼塊來定義專案中所有模組共用的 Gradle 儲存區和依賴項。以下程式碼示例描述的預設設定和 DSL 元素可在新建專案後的頂級 build.gradle 檔案中找到。該檔案包含了一些全域性配置,例如maven的路徑
在這裡插入圖片描述

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上的開源專案
          maven{ url 'http://maven.aliyun.com/nexus/content/groups/public/'} //maven中央倉庫路徑
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

模組級構建檔案
在這裡插入圖片描述
檔案內容說明

// 宣告是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檔案,動態載入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,優化編譯效率,這個功能android studio預設是關閉的。
        incremental true
        javaMaxHeapSize "4g" // 增加java堆記憶體大小
    }

    signingConfigs {// 簽名配置
        release {// 釋出版簽名配置
            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表示混淆
            // 指定混淆時使用的規則檔案;
            // proguard-android.txt指所有專案通用的混淆規則,proguard-rules.pro當前專案特有的混淆規則
            // 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"// "x86"
                cFlags "-std=c++11 -fexceptions" // C++11
                stl "gnustl_static"
            }
            // 採用動態替換字串的方式生成不同的 release.apk (3.0之後版本的修改方式)
            applicationVariants.all { variant ->
                variant.outputs.all { output ->
                    if (!variant.buildType.isDebuggable()) {118                         // 獲取簽名的名字 variant.signingConfig.name119                         // 要被替換的源字串120                         def sourceFile = "app-release";
                        // 替換的字串122               def replaceFile = "Demo-V${variant.versionName}.${releaseTime()}"123               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 {
        // 在這裡你可以設定你的產品釋出的一些東西,
        // 比如你現在一共軟體需要釋出到不同渠道,
        // 且不同渠道中的包名不同,那麼可以在此進行配置;
        // 甚至可以設定不同的 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()
}204205 // 獲取日期方法206 def releaseTime() {207    return new Date().format("MMdd.HHmm")208 }
//預設檔案