關于Walle

Walle（瓦力）：Android Signature V2 Scheme簽名下的新一代渠道包打包神器

瓦力通過在Apk中的APK Signature Block區塊添加自定義的渠道信息來生成渠道包，從而提高了渠道包生成效率，可以作為單機工具來使用，也可以部署在HTTP服務器上來實時處理渠道包Apk的升級網絡請求。

關于新簽名方案和舊簽名方案的區別，用一張圖概括如下：

區別

github地址：https://github.com/Meituan-Dianping/walle
美團博客地址(Walle原理)：http://tech.meituan.com/android-apk-v2-signature-scheme.html

在現有項目中集成

步驟一：配置build.gradle

在位于Android項目的根目錄build.gradle(TvTrunkProject) 文件中添加Walle Gradle插件的依賴， 如下：

buildscript {
    dependencies {
        ...
        ...
        classpath 'com.meituan.android.walle:plugin:1.1.6'
    }
}

接著是在當前App的 build.gradle(QQLiveTV_BASE_LINE)文件中apply這個插件，并添加上用于讀取渠道號的AAR，如下：

apply plugin: 'walle'

dependencies {
    implementation 'com.meituan.android.walle:library:1.1.6'
}

步驟二：配置插件

在build.gradle(QQLiveTV_BASE_LINE) 文件中配置插件，這里的配置可以實現自定義，這里給出的默認值：

walle {
    // 指定渠道包的輸出路徑
    apkOutputFolder = new File("${project.buildDir}/outputs/channels")
    // 定制渠道包的APK的文件名稱
    apkFileNameFormat = '${appName}-${packageName}-${channel}-${buildType}-v${versionName}-${versionCode}-${buildTime}.apk'
    // 渠道配置文件
    channelFile = new File("${project.getProjectDir()}/channel")
}

步驟三：配置簽名

接著我們需要創建一個Signing config來配置我們的簽名jks，如圖所示：

配置簽名

配置完畢之后會在我們的build.gradle(QQLiveTV_BASE_LINE)中自動生成配置信息：

配置信息

步驟三：踩坑1

在配置完簽名信息之后直接sync now，則會報異常：ERROR: A problem occurred configuring project ':app'.

產生原因：在buildTypes中沒有配置我們剛剛創建的簽名信息。

解決方法： 在buildTypes中添加我們的簽名信息：

添加信息

在這里需要注意，我們在配置signingConfig signingConfigs.xxx時，xxx必須和我們之前創建的簽名信息的名字以及buildTypes中的名稱對應，如果配置了多個簽名信息則需要創建多個小閉包：

對應

步驟三：踩坑2

當我們執行gradle指令時，報出錯誤：Could not initialize class org.codehaus.groovy.runtime.InvokerHelper

產生原因： 是由于jdk版本和gradle版本不匹配。在使用Oracle JDK 14時，所有gradle（6.2.2）任務都會失敗。

解決方法： 降低jdk版本或者提高gradle版本到6.3及以上。

步驟四：設置渠道信息

我們在proj.android[QQLiveTV_BASE_LINE]目錄下創建一個名為channel的file，并在channel里面設置我們的渠道信息：

channel

步驟四：踩坑1

在創建channel時不能添加后綴.txt，否則執行打包的時候不能讀取到渠道信息，即只能打出一個包。

步驟五：執行打包

生成渠道包的方式是和assemble${variantName}Channels指令結合，渠道包的生成目錄默認存放在 build/outputs/apk/，也可以通過walle閉包中的apkOutputFolder參數來指定輸出目錄

用法示例：

生成渠道包 gradlew clean assembleReleaseChannels
支持productFlavors gradlew clean assembleMeituanReleaseChannels
生成單個渠道包 gradlew clean assembleReleaseChannels -PchannelList=anzhuo
生成多個渠道包 gradlew clean assembleReleaseChannels -PchannelList=wandoujia,baidu

正常情況下我們直接執行指令gradlew clean assembleReleaseChannels即可打出所有渠道包。

步驟五：踩坑1

在執行打包指令時報出錯誤：Task 'assembleReleaseChannels' not found in root project TvTrunkProject ''.

產生原因： 項目之前的打包方式是采用productFlavors進行多渠道打包。

錯誤解決方法： 在網上查看相關blog，說是直接將productFlavors中相關配置直接注釋掉即可，但是經過實測，光注釋掉productFlavors相關配置只是治標不治本，后續產生的錯誤會更多。

正確解決方法： 查看Walle倉庫的issue，發現Walle本身是支持在配置productFlavors時一鍵生成多個渠道包，所以根本原因并不是productFlavors。解決方法描述如下：

可以檢查有沒有配置productFlavors，如果有，需要在assemble{$flavor.name}ReleaseChannels.另外還可以在AndroidStudio, Gradle->Project->{your app module name} -> package下面找到你可以使用的命令集合。

gradle指令

所以，我們執行這個assembleSNMAPP__10009DebugChannels，就會打包成功。

執行指令

successful

打包成功