關于Walle
Walle(瓦力):Android Signature V2 Scheme
簽名下的新一代渠道包打包神器
瓦力通過在Apk中的APK Signature Block
區(qū)塊添加自定義的渠道信息來生成渠道包,從而提高了渠道包生成效率傻咖,可以作為單機工具來使用电媳,也可以部署在HTTP服務器上來實時處理渠道包Apk的升級網絡請求。
關于新簽名方案和舊簽名方案的區(qū)別执隧,用一張圖概括如下:
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")
}
步驟三:配置簽名
接著我們需要創(chuàng)建一個Signing config
來配置我們的簽名jks送滞,如圖所示:
配置完畢之后會在我們的build.gradle(QQLiveTV_BASE_LINE)
中自動生成配置信息:
步驟三:踩坑1
在配置完簽名信息之后直接sync now
,則會報異常:ERROR: A problem occurred configuring project ':app'.
產生原因:在buildTypes
中沒有配置我們剛剛創(chuàng)建的簽名信息。
解決方法: 在buildTypes
中添加我們的簽名信息:
在這里需要注意迹炼,我們在配置signingConfig signingConfigs.xxx
時,xxx必須和我們之前創(chuàng)建的簽名信息的名字以及buildTypes
中的名稱對應知染,如果配置了多個簽名信息則需要創(chuàng)建多個小閉包:
步驟三:踩坑2
當我們執(zhí)行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]
目錄下創(chuàng)建一個名為channel
的file营搅,并在channel
里面設置我們的渠道信息:
步驟四:踩坑1
在創(chuàng)建channel
時不能添加后綴.txt云挟,否則執(zhí)行打包的時候不能讀取到渠道信息,即只能打出一個包转质。
步驟五:執(zhí)行打包
生成渠道包的方式是和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
正常情況下我們直接執(zhí)行指令gradlew clean assembleReleaseChannels
即可打出所有渠道包休蟹。
步驟五:踩坑1
在執(zhí)行打包指令時報出錯誤:Task 'assembleReleaseChannels' not found in root project TvTrunkProject ''.
產生原因: 項目之前的打包方式是采用productFlavors
進行多渠道打包沸枯。
錯誤解決方法: 在網上查看相關blog,說是直接將productFlavors
中相關配置直接注釋掉即可鸡挠,但是經過實測辉饱,光注釋掉productFlavors
相關配置只是治標不治本,后續(xù)產生的錯誤會更多拣展。
正確解決方法: 查看Walle倉庫的issue
彭沼,發(fā)現Walle本身是支持在配置productFlavors
時一鍵生成多個渠道包,所以根本原因并不是productFlavors
备埃。解決方法描述如下:
可以檢查有沒有配置
productFlavors
姓惑,如果有褐奴,需要在assemble{$flavor.name}ReleaseChannels.
另外還可以在AndroidStudio,Gradle->Project->{your app module name} -> package
下面找到你可以使用的命令集合。
所以于毙,我們執(zhí)行這個assembleSNMAPP__10009DebugChannels
敦冬,就會打包成功。