众所周知,渠道包是国内 Android 应用市场中常用的分发方式。渠道包中会包含不同的渠道信息,方便我们后续统计 App 在各分发渠道的下载量、用户量、留存率等,有针对地调整应用内容或是推广方案等。随着国内 iOS 应用上架越来越难,衍生出了很多企业包,为了方便采集数据,也会用多渠道的方案。
另外,项目进展过程中,可能会出现一些临时新增渠道的需求,这时回到工程中重新打包是比较费时的,有没有办法加快打包速度呢?下文中分享了一些方案。
iOS 多渠道打包方案
iOS 打渠道包目前想到的就只有两种方式,一种是通过多 target 方式,另一种是修改 plist 文件方式。
多 target 方式
点击项目中的 target,右键选择 Duplicate。可以修改下图标红框的三处:target 名称、plist 名称和 scheme 名称。
判断当前是哪个 target,可以通过添加宏定义实现,方式就是在 Build Settings 找到 Preprocessor Macros,填入宏定义名。
代码中这样判断:
[code]#ifdef TARGET1MACROS// target1#elif defined TARGET2MACROS// target2#endif
具体打包脚本就不介绍了,读者可以自行网上搜索,这种方式的缺点是一个渠道打一次,效率较低。下面着重分享修改 plist 的批量打包方式。
修改 plist 方式
下面用一个简单的 Demo 演示一下:
第一步:创建工程名为 MultiChannelDemo 的项目,并在项目中新建一个 Channel.plist 文件,plist 中设置 Channel 字段,值为 channel01。然后在页面上设置一个 label 标签用于显示当前的渠道名称,渠道名可以通过下面的代码获取到:
[code]NSDictionary *channelDic = [NSDictionary dictionaryWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@\"Channel\" ofType:@\"plist\"]];NSString *channel = channelDic[@\"Channel\"];
第二步:把这个项目用可用的证书正常打一个母包,解压这个 ipa 包可以获得一个名为 Payload 的文件夹,里面是一个 .app 文件,右键显示其包内容,内容如下:
[code]├── Base.lproj├── Channel.plist├── Info.plist├── MultiChannelDemo├── PkgInfo├── _CodeSignature└── embedded.mobileprovision
可以看到,里面的 Channel.plist 也就是在前面工程中新建的存储渠道信息的 plist,我们会修改里面的 Channel 再生成新的渠道包。
第三步:提取描述文件用于重签名,上一步中 Payload 的文件夹里有一个 embedded.mobileprovision 文件,这就是我们需要的文件。
第四步:新建一个纯文本,里面输入你要新增的渠道号,如:
第五步:写一个脚本文件,内容如下:
[code]ChannelPackage.sh#!/bin/bash# 输入的包名name=\"MultiChannelDemo\"echo \"----------SDK 渠道包----------\"appName=\"${name}.app\"plistBuddy=\"/usr/libexec/PlistBuddy\"configName=\"Payload/${appName}/Channel.plist\"ipa=\"${name}.ipa\"# 输出的新包所在的文件夹名outUpdateAppDir=\"ChannelPackages\"# entitlements.plist 路径entitlementsDir=\"entitlements.plist\"# 切换到当前目录currDir=${PWD}cd ${currDir}echo \"-----${currDir}\"rm -rf Payload# 解压缩-o:覆盖文件 -q:不显示解压过程unzip -o -q ${ipa}# 删除旧的文件夹,重新生成rm -rf ${outUpdateAppDir}mkdir ${outUpdateAppDir}# 删除旧的 entitlements.plist,重新生成rm -rf ${entitlementsDir}/usr/libexec/PlistBuddy -x -c \"print :Entitlements \" /dev/stdin <<< $(security cms -D -i Payload/${appName}/embedded.mobileprovision) > entitlements.plistecho \"------------------------开始打包程序------------------------\"# 渠道列表文件开始打包for line in $(cat ChannelList.txt)# 循环数组,修改渠道信息do# 修改 plist 中的 Channel 值$plistBuddy -c \"Set :Channel $line\" ${configName}# app 重签名rm -rf Payload/${appName}/_CodeSignaturecp embedded.mobileprovision \"Payload/${appName}/embedded.mobileprovision\"# 填入可用的证书 IDcodesign -f -s \"iPhone Distribution: XXXXXX.\" Payload/${appName} --entitlements ${entitlementsDir}# 若输出 Payload/MultiChannelDemo.app: replacing existing signature 说明重签名完成# 压缩 -r:递归处理,将指定目录下的所有文件和子目录一并处理 -q:不显示处理过程zip -rq \"${outUpdateAppDir}/$line.ipa\" Payloadecho \"----------渠道${line}打包已完成----------\"done
脚本里的信息请根据你实际情况修改。到这里准备工作都完成了,需要的文件如下:
[code]├── ChannelList.txt├── ChannelPackage.sh├── MultiChannelDemo.ipa└── embedded.mobileprovision
第六步:在当前目录下执行脚本文件:
[code]sh ChannelPackage.sh
打包完成后生成的 ChannelPackages 文件夹下,就是我们需要的渠道包:
[code]├── ChannelList.txt├── ChannelPackage.sh├── ChannelPackages│ ├── channel02.ipa│ ├── channel03.ipa│ └── channel04.ipa├── MultiChannelDemo.ipa├── Payload│ └── MultiChannelDemo.app├── embedded.mobileprovision└── entitlements.plist
这种自动化打包的方式,可以规避掉 Xcode 本身打包编译的部分时间,快速出包。
Android 多渠道打包方案
下文介绍的是美团技术团队开源的 Walle,它有 Gradle 插件和命令行两种使用方式,前者快速集成,后者满足自定义需求。
Gladle 插件方式
配置 build.gradle
在项目根目录下的 build.gradle 文件中添加 Walle 插件依赖:
[code]buildscript {dependencies {classpath \'com.meituan.android.walle:plugin:1.1.6\'}}
在 app 目录下的 build.gradle 文件中 apply 插件:
[code]apply plugin: \'walle\'dependencies {compile \'com.meituan.android.walle:library:1.1.6\'}
配置插件
在 app 目录下的 build.gradle 文件中进行渠道配置:
[code]walle {// 指定渠道包的输出路径apkOutputFolder = new File(\"${project.buildDir}/outputs/channels\");// 定制渠道包的APK的文件名称apkFileNameFormat = \'${appName}_v${versionName}_${channel}.apk\';// 渠道配置文件channelFile = new File(\"${project.getProjectDir()}/channel\")}
渠道配置文件里的内容格式详见:渠道配置文件示例。
如何获取渠道信息
在需要填写渠道信息的地方引用这段代码:
[code]String channel = WalleChannelReader.getChannel(this.getApplicationContext());
如何生成渠道包
用 assemble${variantName}Channels 指令,导出 apk 包。
命令行方式
通过命令行方式,可以不打开 IDE,直接导出新渠道的 apk。步骤如下:
首先,新建一个文件夹,取用一个上面步骤导出的 apk 包,再下载 walle-cli-all.jar,两者都放置在这个文件夹目录下。
然后,在文件夹目录下执行命令:
[code]java -jar walle-cli-all.jar put -c ${channelName} ${apkName}.apk
若上面的命令执行成功,会在当前目录下生成新的渠道包,名称为
${apkName}_${channelName}.apk
如果要批量写入渠道,可以这样,渠道之间用逗号隔开:
[code]java -jar walle-cli-all.jar batch -c ${channelName0},${channelName1},${channelName2} ${apkName}.apk
或者指定渠道配置文件:
[code]java -jar walle-cli-all.jar batch -c ${channelFile} ${apkName}.apk
如果要写入额外信息,参考官方文档。
如果要检查/显示渠道,命令为:
[code]java -jar walle-cli-all.jar show ${apkName}.apk
Walle 现在既能满足新应用签名方案对安全性的要求,也能满足对渠道包打包时间的要求,有需要的可以尝试。
– end –