一、基本概念介绍
1.PlaceHolder
AndroidManifest文件中的变量标识,通过${PlaceHolder}标识PlaceHodler是可以被赋值的变量,如友盟统计中的渠道:
<meta-data
android:name="UMENG_CHANEL"
android:value="${UMENG_CHANGE_VAULE}">
</meta-data>
2.BuildTypes
用于生成不同编译类型 的包,如debug和release包。debug和release是gradle默认自带的两个编译类型,其中也可以自定义build type
buildTypes {
debug {
}
release {
}
beta {
}
}
3.productFlavors
可以区分不同的产品,用于生成不同渠道的包,结合buildTypes和productFlavor生成不同的Build Variants,即类型与渠道不同的组合
我的Mac环境下,Terminal终端无法识别./gradlew命令,之前在系统环境添加环境变量也无法识别。目前只能在Terminal里先敲入export PATH=/usr/bin:/usr/sbin:/bin:/sbin:/usr/X11R6/bin
productFlavors {
baidu {}
xiaomi {}
_360 {} //或"360"{},数字需下划线开头或加上双引号
}
执行./gradlew assembleRlease将会打出所有渠道的release包
执行./gradlew assembleXiaomi将会打出小米渠道的release和debug版的包
执行./gradlew assembleBaiduRlease将会打出百度渠道的release包
4.signingConfigs
签名配置,配置如下:
signingConfigs {
release {
storeFile file('key.jks')
storePassword "your password"
keyAlias "your alias"
keyPassword "your password"
}
}
二、多渠道打包配置
1.一般打包方案
apply plugin: 'com.android.application'
apply plugin: 'com.jakewharton.butterknife'
def releaseTime() {
return new Date().format("yyyy-MM-dd", TimeZone.getTimeZone("UTC"))
}
android {
compileSdkVersion 25
buildToolsVersion "25.0.3"
defaultConfig {
applicationId "com.yxkhealth.physiotherapy"
minSdkVersion 15
targetSdkVersion 25
versionCode 22
versionName "1.1.22"
testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"
multiDexEnabled true
ndk {
abiFilters "armeabi-v7a", "arm64-v8a"
}//设置支持的SO库架构(开发者可以根据需要,选择一个或多个平台的so
//默认渠道
manifestPlaceholders = [UMENG_CHANNEL_VALUE: "official"]
}
signingConfigs {
debug {
storeFile file('key.jks')
storePassword "liliao"
keyAlias "key"
keyPassword "liliao"
}
release {
storeFile file('key.jks')
storePassword "liliao"
keyAlias "key"
keyPassword "liliao"
}
}
buildTypes {
release {
minifyEnabled true
shrinkResources true
zipAlignEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
//通过编译类型配置日志开关
buildConfigField("boolean", "LOG_ON", "false")
//多渠道打包配置,build生成会生成对应的渠道包
applicationVariants.all { variant ->
variant.outputs.each { output ->
def outputFile = output.outputFile
if (outputFile != null && outputFile.name.endsWith("apk")) {
def fileName = "test_v${defaultConfig.versionName}_${releaseTime()}_${variant.productFlavors[0].name}.apk"
output.outputFile = new File(outputFile.parent, fileName)
}
}
}
}
debug {
versionNameSuffix "-debug" //包名后缀为"-debug"
signingConfig signingConfigs.debug
}
}
//渠道配置
productFlavors {
baidu {}
xiaomi {}
}
productFlavors.all { flavor ->
flavor.manifestPlaceholders = [UMENG_CHANNEL_VALUE: name]//动态修改AndroidManifest中的渠道名
}
sourceSets {
main {
jniLibs.srcDirs = ['libs']
}
}
}
我们可以看到productFlavors配置,会遍历渠道配置,例如我们使用到友盟统计的话,会动态修改友盟统计的值。虽然这种打包方式操作方便,但是这种打包速度慢。接下来介绍一种META-INF实现多渠道打包。
2.META-INF
解压apk安装包会发现在根目录有一个META-INF目录。如果在META-INF目录内添加空文件,可以不用重新签名应用。因此,通过为不同渠道的应用添加不同的空文件,可以唯一标识一个渠道。 采用这种方式,每打一个渠道包只需复制一个apk,在META-INF中添加一个使用渠道号命名的空文件即可。若统计后台使用第三方后台如友盟,那么需要提取获取渠道参数的方法,然后在初始化友盟统计接口,传入channel渠道值。
APK signature scheme v2
Android7.0引入了新的应用签名方案APK Signature Scheme v2,它能提供更快的应用安装时间和更多针对未授权APK文件更改的保护。需要注意一点,如果使用这种方案签署您的应用,并对应进行了进一步更改,则应用的签名将无效。出于这个原因,若要对齐应用,需要在签名操作之前。
android {
...
defaultConfig { ... }
signingConfigs {
release {
storeFile file("myreleasekey.keystore")
storePassword "password"
keyAlias "MyReleaseKey"
keyPassword "password"
v2SigningEnabled false //禁用v2方式签名
}
}
}
使用V2签名后,往META-INF文件夹里添加空渠道文件这种方案将无效,会导致签名失效。
实现步骤
- 创建渠道文件
在渠道文件里添加需要的渠道,通过脚本实现遍历打包注入 - 编写python脚本
实现解压缩apk文件,为META-INF目录添加文件,重新压缩apk文件逻辑
#!/usr/bin/python
# coding=utf-8
import zipfile
import shutil
import os
# 空文件 便于写入此空文件到apk包中作为channel文件
src_empty_file = 'info/czt.txt'
# 创建一个空文件(不存在则创建)
f = open(src_empty_file, 'w')
f.close()
# 获取当前目录中所有的apk源包
src_apks = []
# python3 : os.listdir()即可,这里使用兼容Python2的os.listdir('.')
for file in os.listdir('.'):
if os.path.isfile(file):
extension = os.path.splitext(file)[1][1:]
if extension in 'apk':
src_apks.append(file)
# 获取渠道列表
channel_file = 'info/channel.txt'
f = open(channel_file)
lines = f.readlines()
f.close()
for src_apk in src_apks:
# file name (with extension)
src_apk_file_name = os.path.basename(src_apk)
# 分割文件名与后缀
temp_list = os.path.splitext(src_apk_file_name)
# name without extension
src_apk_name = temp_list[0]
# 后缀名,包含. 例如: ".apk "
src_apk_extension = temp_list[1]
# 创建生成目录,与文件名相关
output_dir = 'output_' + src_apk_name + '/'
# 目录不存在则创建
if not os.path.exists(output_dir):
os.mkdir(output_dir)
# 遍历渠道号并创建对应渠道号的apk文件
for line in lines:
# 获取当前渠道号,因为从渠道文件中获得带有\n,所有strip一下
target_channel = line.strip()
# 拼接对应渠道号的apk
target_apk = output_dir + src_apk_name + "-" + target_channel + src_apk_extension
# 拷贝建立新apk
shutil.copy(src_apk, target_apk)
# zip获取新建立的apk文件
zipped = zipfile.ZipFile(target_apk, 'a', zipfile.ZIP_DEFLATED)
# 初始化渠道信息
empty_channel_file = "META-INF/cztchannel_{channel}".format(channel = target_channel)
# 写入渠道信息
zipped.write(src_empty_file, empty_channel_file)
# 关闭zip流
zipped.close()
- 执行脚本即可
代码获取渠道值
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 e) {
e.printStackTrace();
} finally {
if (zipfile != null) {
try {
zipfile.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
String[] split = ret.split("_");
if (split != null && split.length >= 2) {
return ret.substring(split[0].length() + 1);
} else {
return "";
}
}
github代码https://github.com/GavinCT/AndroidMultiChannelBuildTool
3.Walle多渠道打包
对新的应用签名方案生成的APK包中的ID-value进行扩展,提供自定义ID-value(渠道信息),并保存在APK中
而APK在安装过程中进行的签名校验,是忽略我们添加的这个ID-value的,这样就能正常安装了
在App运行阶段,可以通过ZIP的EOCD(End of central directory)、Central directory等结构中的信息(会涉及ZIP格式的相关知识,这里不做展开描述)找到我们自己添加的ID-value,从而实现获取渠道信息的功能
新一代渠道包生成工具完全是基于ZIP文件格式和APK Signing Block存储格式而构建,基于文件的二进制流进行处理,有着良好的处理速度和兼容性,能够满足不同的语言编写的要求,目前笔者采用的是Java+Groovy开发, 该工具主要有四部分组成:
用于写入ID-value信息的Java类库
Gradle构建插件用来和Android的打包流程进行结合
用于读取ID-value信息的Java类库
用于供com.android.application使用的读取渠道信息的AAR
具体详看美团分享的文章
https://tech.meituan.com/android-apk-v2-signature-scheme.html
下面有篇文章,介绍美团处理多渠道适配方案。随着渠道越来越多,不同渠道对应用的要求也不尽相同。例如,有的渠道要求客户端的应用名为A,有的渠道要求应用名为B。又比如,有些渠道要求应用不能使用第三方统计工具(如flurry)。总之,每次打包都需要对这些渠道进行适配。
https://tech.meituan.com/mt-apk-adaptation.html
网友评论