每當發新版本時,美團團購Android客戶端會被分發到各個應用市場,比如豌豆莢,360手機助手等。為了統計這些市場的效果(活躍數,下單數等),需要有一種方法來唯一標識它們。
團購客戶端目前通過渠道號(channel)來區分不同的市場,代碼中使用Config.channel變量記錄該渠道號。比如,豌豆莢市場中美團應用的渠道號是wandoujia,360手機助手中美團應用的渠道號為qihu360。客戶端訪問API時會在請求參數中帶上渠道號,以便后臺接下來計算不同渠道的效果。
每次發版時,市場部會提供一個渠道列表,Android RD會根據這些渠道相應地生成等量的渠道包。隨著渠道越來越多(截止本文寫作時已有900多個渠道),客戶端打渠道包的方式也一直在演進,本文接下來就詳細介紹美團應用的打包之旅。
Maven
Maven是一個軟件項目管理和自動構建工具,配合使用android-maven-plugin插件,以及maven-resources-plugin插件可以很方便的生成渠道包,下面簡要介紹下打包過程,更多Maven以及插件的使用方法請參考相關文檔。
首先,在AndroidManifest.xml的節點中添加如下元素,用來定義渠道的來源:
? ? ? ?android:name="channel"
? ? ? ?android:value="${channel}" />
定義好渠道來源后,接下來就可以在程序啟動時讀取渠道號了:
private String getChannel(Context context) {
? ? ? ?try {
? ? ? ? ? ?PackageManager pm = context.getPackageManager();
? ? ? ? ? ?ApplicationInfo appInfo = pm.getApplicationInfo(context.getPackageName(), PackageManager.GET_META_DATA);
? ? ? ? ? ?return appInfo.metaData.getString("channel");
? ? ? ?} catch (PackageManager.NameNotFoundException ignored) {
? ? ? ?}
? ? ? ?return "";
? ?}
要替換AndroidManifest.xml文件定義的渠道號,還需要在pom.xml文件中配置Resources插件:
? ? ? ?${project.basedir}
? ? ? ?true
? ? ? ?${project.build.directory}/filtered-manifest
? ? ? ? ? ?AndroidManifest.xml
準備工作已經完成,現在需要的就是實際的渠道號了。下面的腳本會遍歷渠道列表,逐個替換并打包:
#!/bin/bash
package(){
? ?while read line
? ?do
? ? ? ?mvn clean
? ? ? ?mvn ?-Dchannel=$line package
? ?done < $1
}
package $1
在前期渠道很少時這種方法還可以接受,但只要渠道稍微增多該方法就不再適用了,原因是每打一個包都要執行一遍構建過程,效率太低。
apktool
apktool是一個逆向工程工具,可以用它解碼(decode)并修改apk中的資源。接下來詳細介紹如何使用apktool生成渠道包。
前期工作和用Maven打包一樣,也需要在AndroidManifest.xml文件中定義元素,并在應用啟動的時候讀取清單文件中的渠道號。具體請參考上面的代碼。
和Maven不一樣的是,每次打包時不再需要重新構建項目。打包時,只需生成一個apk,然后在該apk的基礎上生成其他渠道包即可。
首先,使用apktool decode應用程序,在終端中輸入如下命令:
apktool d your_original_apk build
上面的命令會在build目錄中decode應用文件,decode完成后的目錄如下:
接下來,替換AndroidManifest.xml文件中定義的渠道號,下面是一段python腳本:
import re
def replace_channel(channel, manifest):
? ?pattern = r'()'
? ?replacement = r"\g<1>{channel}\g<3>".format(channel=channel)
? ?return re.sub(pattern, replacement, manifest)
然后,使用apktool構建未簽名的apk:
apktool b build your_unsigned_apk
最后,使用jarsigner重新簽名apk:
jarsigner -sigalg MD5withRSA -digestalg SHA1 -keystore your_keystore_path -storepass your_storepass -signedjar your_signed_apk, your_unsigned_apk, your_alias
上面就是使用apktool打包的方法,通過使用腳本可以批量地生成渠道包。不像Maven,每打一個包都需要執行一次構建過程,該方法只需構建一次,大大節省了時間。
但是好景不長,我們的渠道包越來越多,目前已有近900個渠道,打完所有的渠道包需要近3個小時。有沒有更快的打包方式呢?且看下節。
META-INF
如果能直接修改apk的渠道號,而不需要再重新簽名能節省不少打包的時間。幸運的是我們找到了這種方法。直接解壓apk,解壓后的根目錄會有一個META-INF目錄,如下圖所示:
如果在META-INF目錄內添加空文件,可以不用重新簽名應用。因此,通過為不同渠道的應用添加不同的空文件,可以唯一標識一個渠道。
下面的python代碼用來給apk添加空的渠道文件,渠道名的前綴為mtchannel_:
import zipfile
zipped = zipfile.ZipFile(your_apk, 'a', zipfile.ZIP_DEFLATED)
empty_channel_file = "META-INF/mtchannel_{channel}".format(channel=your_channel)
zipped.write(your_empty_file, empty_channel_file)
添加完空渠道文件后的目錄,META-INFO目錄多了一個名為mtchannel_meituan的空文件:
接下來就可以在Java代碼中讀取空渠道文件名了:
public static String getChannel(Context context) {
? ? ? ?ApplicationInfo appinfo = context.getApplicationInfo();
? ? ? ?String sourceDir = appinfo.sourceDir;
? ? ? ?String ret = "";
? ? ? ?ZipFile zipfile = null;
? ? ? ?try {
? ? ? ? ? ?zipfile = new ZipFile(sourceDir);
? ? ? ? ? ?Enumeration entries = zipfile.entries();
? ? ? ? ? ?while (entries.hasMoreElements()) {
? ? ? ? ? ? ? ?ZipEntry entry = ((ZipEntry) entries.nextElement());
? ? ? ? ? ? ? ?String entryName = entry.getName();
? ? ? ? ? ? ? ?if (entryName.startsWith("mtchannel")) {
? ? ? ? ? ? ? ? ? ?ret = entryName;
? ? ? ? ? ? ? ? ? ?break;
? ? ? ? ? ? ? ?}
? ? ? ? ? ?}
? ? ? ?} catch (IOException