Gradle多版本/多環(huán)境打包

本文開(kāi)發(fā)環(huán)境:

  • Android Studio 3.1.4 Build #AI-173.4907809, built on July 24, 2018
  • JRE: 1.8.0_152-release-1024-b02 amd64
  • JVM: OpenJDK 64-Bit Server VM by JetBrains s.r.o
  • Windows 10 10.0

一、概述

App開(kāi)發(fā)過(guò)程中，基本都需要多個(gè)環(huán)境，比如開(kāi)發(fā)環(huán)境develop，測(cè)試環(huán)境check，生產(chǎn)環(huán)境product。各個(gè)環(huán)境下，網(wǎng)絡(luò)請(qǐng)求的url會(huì)有所區(qū)別，一般我們通過(guò)baseUrl進(jìn)行切換。

  • 開(kāi)發(fā)環(huán)境用于程序員開(kāi)發(fā)和自測(cè)；
  • 測(cè)試環(huán)境用于測(cè)試人員測(cè)試使用，環(huán)境配置和生產(chǎn)環(huán)境完全相同；
  • 生產(chǎn)環(huán)境即正式環(huán)境，也就是用戶所使用的環(huán)境。

每個(gè)環(huán)境下，app還可以分為debug版本和release版本。

  • debug版本下，apk無(wú)需混淆，可以多一些打印日志的操作。
  • release版本下，文件混淆，隱藏日志打印。

Android Studio中，多版本/多環(huán)境等需求都可以通過(guò)配置gradle文件來(lái)解決。

二、實(shí)踐

debug和release版本的區(qū)分通過(guò)buildTypes

1. 新建一個(gè)demo工程，AS默認(rèn)生成的gradle只有release版本。
defaultConfig {
    applicationId "com.allsunny.packagedemo"
    minSdkVersion 15
    targetSdkVersion 28
    versionCode 1
    versionName "1.0"
    testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
}
buildTypes {
    release {
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
    }
}

demo中的默認(rèn)applicationId 為com.allsunny.packagedemo，我們知道，在Android系統(tǒng)中，同一個(gè)app只能安裝一個(gè)，系統(tǒng)就是根據(jù)applicationId來(lái)判斷是否為同一個(gè)apk。我們要想在一臺(tái)手機(jī)中同時(shí)安裝debug和release版本，就要修改applicationId 。

2.我們將其略加修改，添加混淆和debug版本。debug版本下增加字段applicationIdSuffix用來(lái)修改applicationId
    buildTypes {
        //調(diào)試版本，無(wú)混淆
        debug {
            //為debug版本的包名添加.debug后綴
            applicationIdSuffix ".debug"
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
        release {
            minifyEnabled true
            zipAlignEnabled true
            shrinkResources true
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
            signingConfig signingConfigs.config
        }
    }

修改完成后，我們可以通過(guò)選擇Build Variant來(lái)選擇不同的打包環(huán)境和打包版本，目前只有兩個(gè)版本debug和release。如圖所示：

1.png

我們選擇release后編譯打包。
因?yàn)槲覀儸F(xiàn)在有debug和release兩個(gè)版本，release無(wú)法再使用默認(rèn)的簽名文件，所以我們要自己生成一個(gè)jks簽名文件，release包使用新生成的正式簽名文件來(lái)簽名。否則會(huì)報(bào)錯(cuò)：

the apk for your currently selected variant(app-release-unsigned.apk)is not signed.
Please specity a signing configuration for this variant(release)

配置簽名文件方案：https://blog.csdn.net/l_lhc/article/details/77963683
配置完成后，AS會(huì)自動(dòng)在release{...}中生成 signingConfig signingConfigs.config。然后就可以正常編譯打包了。至此，多版本的配置就完成了。接下來(lái)我們來(lái)看多環(huán)境的gradle配置。

環(huán)境的區(qū)分通過(guò)productFlavors

productFlavors {
    //開(kāi)發(fā)環(huán)境
    develop {
        applicationIdSuffix ".dev"       //applicationId "com.allsunny.packagedemo.dev"
        buildConfigField("int", "ENV_TYPE", "1")
        manifestPlaceholders = ["app_name": "開(kāi)發(fā)環(huán)境", "app_launcher_icon": "@mipmap/ic_launcher_dev"]
    }

    //生產(chǎn)環(huán)境
    product {
        buildConfigField("int", "ENV_TYPE", "2")
        manifestPlaceholders = ["app_name": "生產(chǎn)環(huán)境", "app_launcher_icon": "@mipmap/ic_launcher"]
    }
}

編譯后如果報(bào)如下錯(cuò)誤：

All flavors must now belong to a named flavor dimension. Learn more at https://d.android.com/r/tools/flavorDimensions-missing-error-message.html

則在android{...}中添加 flavorDimensions "default"

android {
    flavorDimensions "default"
    ......
    }

目前demo中只添加了開(kāi)發(fā)環(huán)境和生產(chǎn)環(huán)境，開(kāi)發(fā)者可以自主添加測(cè)試環(huán)境。我們?cè)赿evelop環(huán)境中增加了applicationIdSuffix ".dev" ，這樣就可以在同一臺(tái)手機(jī)中同時(shí)安裝4個(gè)apk包了。分別是：

  • 開(kāi)發(fā)環(huán)境debug版本，包名com.allsunny.packagedemo.dev.debug
  • 開(kāi)發(fā)環(huán)境release版本，包名com.allsunny.packagedemo.dev
  • 生產(chǎn)環(huán)境debug版本，包名com.allsunny.packagedemo.debug
  • 生產(chǎn)環(huán)境debug版本，包名com.allsunny.packagedemo

buildConfigField表示在編譯生成的BuildConfig文件當(dāng)中添加字段屬性“ENV_TYPE”，我們可以在代碼當(dāng)中根據(jù)BuildConfig.ENV_TYPE的值來(lái)判斷apk是處于開(kāi)發(fā)環(huán)境（1== BuildConfig.ENV_TYPE）還是生產(chǎn)環(huán)境（2==BuildConfig.ENV_TYPE）。

manifestPlaceholders中定義的屬性字段會(huì)替換AndroidManifest當(dāng)中的相關(guān)屬性，我們目前替換了app名稱和icon。在manifest文件中需做對(duì)應(yīng)修改：

    <application
        android:allowBackup="true"
        android:icon="${app_launcher_icon}"
        android:label="${app_name}"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity"
            android:screenOrientation="portrait">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />

                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>

編譯后在Build Variant中可以看到可以生成4個(gè)apk版本了：

2.png

我們?cè)陧?yè)面中將包名和ENV_TYPE打印出來(lái)：

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        tvPackageName = findViewById(R.id.tv_package_name);
        tvPackageName.setText("packageName = " + getApplication().getPackageName() + "\n\n"
                + "ENV_TYPE = " + BuildConfig.ENV_TYPE);
    }

顯示頁(yè)面如圖所示：


3.jpg
4.jpg
5.jpg

至此，我們就完成了多版本和多環(huán)境的gradle文件配置。

三、注意：

  1. 網(wǎng)上的第三方推送一般以按包名唯一區(qū)分，已上線的app有集成推送模塊的，要根據(jù)不同包名申請(qǐng)多個(gè)賬號(hào)。防止把測(cè)試的推送信息推送給正式用戶。
  2. 微信的分享也是根據(jù)包名來(lái)進(jìn)行驗(yàn)證的，所以測(cè)試分享模塊時(shí)候，要將環(huán)境改為生產(chǎn)環(huán)境的release版本。
  3. 在代碼中使用到provider的地方，也需要根據(jù)包名做對(duì)應(yīng)的修改，比如：
        <provider
            android:name="android.support.v4.content.FileProvider"
            android:authorities="${applicationId}.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/file_paths"/>

        </provider>

 Matisse.from(this)
     .choose(MimeType.ofImage())
     .showSingleMediaType(true)
     .countable(false)
     .capture(true)
     .captureStrategy(new CaptureStrategy(true, mContext.getPackageName() + ".fileprovider"))
     .maxSelectable(1)
     .thumbnailScale(0.85f)
     .imageEngine(new GlideEngine())
     .forResult(REQUEST_CODE_CHOOSE);

四、demo下載地址：

https://download.csdn.net/download/akirah/10610665

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡(jiǎn)書(shū)系信息發(fā)布平臺(tái)，僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容