App 多渠道打包及重签名方案 - 个人文章 - SegmentFault 思否

411 阅读3分钟
原文链接: segmentfault.com
我的博客原文地址

众所周知,渠道包是国内 Android 应用市场中常用的分发方式。渠道包中会包含不同的渠道信息,方便我们后续统计 App 在各分发渠道的下载量、用户量、留存率等,有针对地调整应用内容或是推广方案等。随着国内 iOS 应用上架越来越难,衍生出了很多企业包,为了方便采集数据,也会用多渠道的方案。

另外,项目进展过程中,可能会出现一些临时新增渠道的需求,这时回到工程中重新打包是比较费时的,有没有办法加快打包速度呢?下文中分享了一些方案。

iOS 多渠道打包方案

iOS 打渠道包目前想到的就只有两种方式,一种是通过多 target 方式,另一种是修改 plist 文件方式。

多 target 方式

点击项目中的 target,右键选择 Duplicate。可以修改下图标红框的三处:target 名称、plist 名称和 scheme 名称。

判断当前是哪个 target,可以通过添加宏定义实现,方式就是在 Build Settings 找到 Preprocessor Macros,填入宏定义名。

代码中这样判断:

#ifdef  TARGET1MACROS
    // target1
#elif defined TARGET2MACROS
    // target2
#endif

具体打包脚本就不介绍了,读者可以自行网上搜索,这种方式的缺点是一个渠道打一次,效率较低。下面着重分享修改 plist 的批量打包方式。

修改 plist 方式

下面用一个简单的 Demo 演示一下:

第一步:创建工程名为 MultiChannelDemo 的项目,并在项目中新建一个 Channel.plist 文件,plist 中设置 Channel 字段,值为 channel01。然后在页面上设置一个 label 标签用于显示当前的渠道名称,渠道名可以通过下面的代码获取到:

NSDictionary *channelDic = [NSDictionary dictionaryWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"Channel" ofType:@"plist"]];
NSString *channel = channelDic[@"Channel"];

第二步:把这个项目用可用的证书正常打一个母包,解压这个 ipa 包可以获得一个名为 Payload 的文件夹,里面是一个 .app 文件,右键显示其包内容,内容如下:

├── Base.lproj
├── Channel.plist
├── Info.plist
├── MultiChannelDemo
├── PkgInfo
├── _CodeSignature
└── embedded.mobileprovision

可以看到,里面的 Channel.plist 也就是在前面工程中新建的存储渠道信息的 plist,我们会修改里面的 Channel 再生成新的渠道包。

第三步:提取描述文件用于重签名,上一步中 Payload 的文件夹里有一个 embedded.mobileprovision 文件,这就是我们需要的文件。

第四步:新建一个纯文本,里面输入你要新增的渠道号,如:

第五步:写一个脚本文件 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.plist

echo "------------------------开始打包程序------------------------"

# 渠道列表文件开始打包

for line in $(cat ChannelList.txt)

# 循环数组,修改渠道信息

do

# 修改 plist 中的 Channel 值

$plistBuddy -c "Set :Channel $line" ${configName}

# app 重签名

rm -rf Payload/${appName}/_CodeSignature

cp embedded.mobileprovision "Payload/${appName}/embedded.mobileprovision"

# 填入可用的证书 ID

codesign -f -s "iPhone Distribution: XXXXXX." Payload/${appName}  --entitlements ${entitlementsDir}

# 若输出 Payload/MultiChannelDemo.app: replacing existing signature 说明重签名完成

# 压缩 -r:递归处理,将指定目录下的所有文件和子目录一并处理 -q:不显示处理过程

zip -rq "${outUpdateAppDir}/$line.ipa" Payload

echo "........渠道${line}打包已完成"

done

脚本里的信息请根据你实际情况修改。到这里准备工作都完成了,需要的文件如下:

├── ChannelList.txt
├── ChannelPackage.sh
├── MultiChannelDemo.ipa
└── embedded.mobileprovision

第六步:在当前目录下执行脚本文件:

sh ChannelPackage.sh

打包完成后生成的 ChannelPackages 文件夹下,就是我们需要的渠道包:

├── 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 插件依赖:

buildscript {
    dependencies {
        classpath 'com.meituan.android.walle:plugin:1.1.6'
    }
}

在 app 目录下的 build.gradle 文件中 apply 插件:

apply plugin: 'walle'

dependencies {
    compile 'com.meituan.android.walle:library:1.1.6'
}

配置插件

在 app 目录下的 build.gradle 文件中进行渠道配置:

walle {
    // 指定渠道包的输出路径
    apkOutputFolder = new File("${project.buildDir}/outputs/channels");
    // 定制渠道包的APK的文件名称
    apkFileNameFormat = '${appName}_v${versionName}_${channel}.apk';
    // 渠道配置文件
    channelFile = new File("${project.getProjectDir()}/channel")
}

渠道配置文件里的内容格式详见:渠道配置文件示例

如何获取渠道信息

在需要填写渠道信息的地方引用这段代码:

String channel = WalleChannelReader.getChannel(this.getApplicationContext());

如何生成渠道包

assemble${variantName}Channels 指令,导出 apk 包。

命令行方式

通过命令行方式,可以不打开 IDE,直接导出新渠道的 apk。步骤如下:

首先,新建一个文件夹,取用一个上面步骤导出的 apk 包,再下载 walle-cli-all.jar,两者都放置在这个文件夹目录下。

然后,在文件夹目录下执行命令:

java -jar walle-cli-all.jar put -c ${channelName} ${apkName}.apk

若上面的命令执行成功,会在当前目录下生成新的渠道包,名称为 ${apkName}_${channelName}.apk

如果要批量写入渠道,可以这样,渠道之间用逗号隔开:

java -jar walle-cli-all.jar batch -c ${channelName0},${channelName1},${channelName2} ${apkName}.apk

或者指定渠道配置文件:

java -jar walle-cli-all.jar batch -c ${channelFile} ${apkName}.apk
如果要写入额外信息,参考官方文档

如果要检查/显示渠道,命令为:

java -jar walle-cli-all.jar show ${apkName}.apk

Walle 现在既能满足新应用签名方案对安全性的要求,也能满足对渠道包打包时间的要求,有需要的可以尝试。