前面我們?cè)?jīng)講過(guò)兩種Android的渠道打包方式,包括其中的原理都有所涉及。今天給大家講解的是packer-ng-plugin簡(jiǎn)稱(chēng)packer,號(hào)稱(chēng)是下一代的Android渠道打包工具。估計(jì)應(yīng)該有人在使用了,會(huì)的同學(xué)可以略過(guò)今天的這篇推送,去學(xué)習(xí)其他內(nèi)容吧,沒(méi)有使用過(guò)的就往下看。
在講這個(gè)號(hào)稱(chēng):下一代Android渠道打包工具之前,我們先來(lái)回顧一下原來(lái)基礎(chǔ)的打包原理和美團(tuán)的多渠道打包原理。這里我就不過(guò)多介紹了,沒(méi)看過(guò)之前文章的,點(diǎn)擊下方鏈接進(jìn)行復(fù)習(xí)即可。
Android Studio 使用Gradle多渠道打包
美團(tuán)多渠道打包方案詳解,速度快到白駒過(guò)隙
回顧完之前的打包方式原理的講解,現(xiàn)在我們正式開(kāi)始講解這個(gè)packer-ng-plugin的講解。
項(xiàng)目介紹
packer-ng-plugin 是下一代Android渠道打包工具Gradle插件,支持極速打包,100個(gè)渠道包只需要10秒鐘,速度是 gradle-packer-plugin 的300倍以上,可方便的用于CI系統(tǒng)集成,支持自定義輸出目錄和最終APK文件名,依賴包: com.mcxiaoke.gradle:packer-ng:1.0.5 簡(jiǎn)短名:packer,可以在項(xiàng)目的 build.gradle 中指定使用,還提供了命令行獨(dú)立使用的Java和Python腳本。
實(shí)現(xiàn)原理
Android應(yīng)用使用的APK文件就是一個(gè)帶簽名信息的ZIP文件,根據(jù) ZIP文件格式規(guī)范,每個(gè)ZIP文件的最后都必須有一個(gè)叫 Central Directory Record 的部分,這個(gè)CDR的最后部分叫"end of central directory record",這一部分包含一些元數(shù)據(jù),它的末尾是ZIP文件的注釋。注釋包含Comment Length和File Comment兩個(gè)字段,前者表示注釋內(nèi)容的長(zhǎng)度,后者是注釋的內(nèi)容,正確修改這一部分不會(huì)對(duì)ZIP文件造成破壞,利用這個(gè)字段,我們可以添加一些自定義的數(shù)據(jù),PackerNg項(xiàng)目就是在這里添加和讀取渠道信息。
優(yōu)勢(shì)和缺點(diǎn)
優(yōu)點(diǎn)
- 使用APK注釋字段保存渠道信息和MAGIC字節(jié),從文件末尾讀取渠道信息,速度快
- 實(shí)現(xiàn)為一個(gè)Gradle Plugin,支持定制輸出APK的文件名等信息,方便CI集成
- 提供Java版和Python的獨(dú)立命令行腳本,不依賴Gradle插件,支持獨(dú)立使用
- 由于打包速度極快,單個(gè)包只需要5毫秒左右,可用于網(wǎng)站后臺(tái)動(dòng)態(tài)生成渠道包
缺點(diǎn)
- 沒(méi)有使用Android的productFlavors,無(wú)法利用flavors條件編譯的功能
使用方式
配置項(xiàng)目根目錄的 build.gradle
buildscript {
......
dependencies{
// add packer-ng
classpath 'com.mcxiaoke.gradle:packer-ng:1.0.5'
}
}
配置moudle級(jí)別gradle
apply plugin: 'packer'
dependencies {
// add packer-helper
compile 'com.mcxiaoke.gradle:packer-helper:1.0.5'
}
特別注意:packer-ng 和 packer-helper 的版本號(hào)需要保持一致
動(dòng)態(tài)設(shè)置渠道號(hào)
// 如果沒(méi)有使用PackerNg打包添加渠道,默認(rèn)返回的是""
// com.mcxiaoke.packer.helper.PackerNg
final String market = PackerNg.getMarket(Context)
// 或者使用 PackerNg.getMarket(Context,defaultValue)
// 之后就可以使用了,比如友盟可以這樣設(shè)置
AnalyticsConfig.setChannel(market)
提示:PackerNg.getMarket(Context)內(nèi)部緩存了結(jié)果,不會(huì)重復(fù)解析APK文件
打包方式
可以通過(guò)兩種方式指定 market 屬性,根據(jù)需要選用:
- 打包時(shí)命令行使用 -Pmarket= yourMarketFilePath 指定屬性
- 在 gradle.properties 里加入 market=yourMarketFilePath
market是你的渠道名列表文件,market文件是基于項(xiàng)目根目錄的 相對(duì)路徑 ,假設(shè)你的項(xiàng)目位于 ~/github/myapp 你的market文件位于 ~/github/myapp/config/markets.txt 那么參數(shù)應(yīng)該是 -Pmarket=config/markets.txt,一般建議直接放在項(xiàng)目根目錄,如果market文件參數(shù)錯(cuò)誤或者文件不存在會(huì)拋出異常。
關(guān)于渠道文本的配置,就是純文本文件,每行一個(gè)渠道號(hào),也可以添加注釋?zhuān)褪乔捞?hào)后面加#再加注釋即可。
例如:
xiaomi#小米渠道
google#谷歌渠道
qq#應(yīng)用寶渠道
命令行執(zhí)行:
./gradlew -Pmarket=markets.txt clean apkRelease
打完包之后,就可以在${項(xiàng)目根目錄}/build/archives/ 目錄找到最終的渠道包了。
packer-ng-plugin也提供了一些自定義配置,比如輸入的apk的命名方式,具體參考原文,同時(shí)提供了java和python的命令行腳本,供集成到持續(xù)集成環(huán)境中,具體參考命令行打包腳本。
詳情使用方式的講解和源碼插件地址:https://github.com/mcxiaoke/packer-ng-plugin
就是這么簡(jiǎn)單。會(huì)了吧,趕緊去試試吧。