Android Gradle 插件BuildType 编译类型配置 ⑧ ( versionNameSuffix 配置 | zipAlignEnabled 配置 | initWith 方法 )

Posted 2022-05-07 韩曙亮

文章目录

• 一、BuildType#versionNameSuffix 配置
• 二、BuildType#zipAlignEnabled 配置
• 三、BuildType#initWith 方法

Android Plugin DSL Reference 参考文档 :

• 文档主页 : https://google.github.io/android-gradle-dsl/2.3/

• AppExtension ( build.gradle#android 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.AppExtension.html

• build.gradle#android 模块配置文档 : android-gradle-dsl/2.3/com.android.build.gradle.AppExtension.html

• ProductFlavor ( build.gradle#android#defaultConfig 配置 ) 文档 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.ProductFlavor.html

• ProductFlavor#externalNativeBuild 配置 ( build.gradle#android#defaultConfig#externalNativeBuild 配置 ) : com.android.build.gradle.internal.dsl.ProductFlavor:externalNativeBuild

• ExternalNativeBuildOptions ( build.gradle#android#defaultConfig#externalNativeBuild 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.ExternalNativeBuildOptions.html

• NdkBuildOptions ( build.gradle#android#defaultConfig#externalNativeBuild#ndkBuild 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.NdkBuildOptions.html

• CmakeOptions ( build.gradle#android#defaultConfig#externalNativeBuild#cmake 配置 ) 文档位置 : android-gradle-dsl-gh-pages/2.3/com.android.build.gradle.internal.dsl.CmakeOptions.html

• JackOptions ( build.gradle#android#defaultConfig#jackOptions 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.JackOptions.html

• AnnotationProcessorOptions ( 注解处理器配置 ) ( build.gradle#android#defaultConfig#javaCompileOptions配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.AnnotationProcessorOptions.html

• NdkOptions ( build.gradle#android#defaultConfig#ndk 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.NdkOptions.html

• VectorDrawablesOptions ( build.gradle#android#defaultConfig#vectorDrawables 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.VectorDrawablesOptions.html

• BuildType ( build.gradle#android#buildTypes 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.BuildType.html

• SigningConfig ( build.gradle#android#signingConfigs 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.SigningConfig.html

• NDK 参考文档 : Add C and C++ Code to Your Project.

一、BuildType#versionNameSuffix 配置

---

BuildType ( build.gradle#android#buildTypes 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.BuildType.html

BuildType#versionNameSuffix 配置 用于 配置 该编译类型的 版本号名称的后缀 ;

在计算 变体 ( debug 或 release ) 的最终版本名时，这会附加到 “基本” 版本名之后 , 基本版本名称就是 defaultConfig 中的 versionName "1.0" 配置 ;

版本名称后缀 ; 
在计算 变体 ( debug 或 release ) 的最终版本名时，这会附加到 “基本” 版本名之后。

BuildType#versionNameSuffix 配置原型 :

String versionNameSuffix
Version name suffix.

This is appended to the "base" version name when calculating the final version name for a variant.

二、BuildType#zipAlignEnabled 配置

---

BuildType ( build.gradle#android#buildTypes 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.BuildType.html

BuildType#zipAlignEnabled 配置 作用是 配置该编译类型 ( debug / release ) 是否进行优化对齐操作 ;

BuildType#zipAlignEnabled 配置原型 :

boolean zipAlignEnabled
Whether zipalign is enabled for this build type.

三、BuildType#initWith 方法

---

BuildType ( build.gradle#android#buildTypes 配置 ) 文档位置 : android-gradle-dsl/2.3/com.android.build.gradle.internal.dsl.BuildType.html

BuildType#initWith 方法 作用是 拷贝一个 " 给定的 编译类型 " 的 " 所有属性 " ;

BuildType#initWith 方法原型 :

DefaultBuildType initWith(BuildType that)
Copies all properties from the given build type.

It can be used like this:

android.buildTypes 
    customBuildType 
        initWith debug
            // customize...
        

使用示例 : 在 " android # buildTypes " 下定义 tom 编译类型 , 在 tom 编译类型中 , 使用 initWith 方法 ; 此时 如果不配置 tom 编译类型的其它选项 , 则 tom 编译类型 与 debug 是一模一样的 ;

android 

    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig 
        applicationId "kim.hsl.svg"
        minSdkVersion 18
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    

    signingConfigs 
        mySigningConfig 
            storeFile file("debug.keystore")
            storePassword "android"
            keyAlias "androiddebugkey"
            keyPassword "android"
        
    

    buildTypes 
        release 
            // 是否开启优化混淆
            minifyEnabled true
            // 是否启用资源压缩 , 未使用的资源会被优化
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        
        debug 
            //applicationIdSuffix ".jerry"
            signingConfig signingConfigs.mySigningConfig
            testCoverageEnabled true
        
        tom 
            initWith debug