Walle —— Android多渠道打包神器
Walle为了android多渠道打包而生的工具,废话不多说直接上用法
配置build.gradle
在项目的build.gradle文件中添加walle插件依赖
dependencies { classpath 'com.meituan.android.walle:plugin:1.1.6' }然后,在app的build.gradle文件中apply插件,同时添加一个用于读取渠道名的依赖库 apply plugin: 'walle' dependencies { //walle implementation 'com.meituan.android.walle:library:1.1.6' }
按照以上配置,基本上这里就可以使用了,还有一个小问题,build的时候会出现这样的错误
Plugin requires 'APK Signature Scheme v2 Enabled' for release.
这是因为release变体的构建没有开启v2签名的原因,在build.gradle文件的android代码块中添加signingConfigs签名配置信息,然后在buildTypes中对应的变体中配置signingConfig。
v1SigningEnabled和v2SigningEnabled的代码会注视掉,是因为默认为true
同时signingConfigs还可以配置打包时签名的keystore相关信息
android{ //... signingConfigs { debug { //... } release { //v1SigningEnabled true //v2SigningEnabled true keyAlias 'alias名字' keyPassword '对应alias密码' storeFile file('keystore的文件路径') storePassword 'keystore的密码' } } buildTypes { debug { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' signingConfig signingConfigs.debug } release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro' signingConfig signingConfigs.release } } }
配置walle
walle { // 指定渠道包的输出路径 apkOutputFolder = new File("${project.rootDir}/output/channels/") // 定制渠道包的APK的文件名称 apkFileNameFormat = '${appName}-${packageName}-${channel}-${buildType}-v${versionName}-${versionCode}-${buildTime}.apk' // 渠道配置文件 channelFile = new File("${project.getProjectDir()}/channel") }
配置项具体解释:
apkOutputFolder:指定渠道包的输出路径, 默认值为new File("
{appName}-{channel}.apk’
可使用以下变量:
projectName - 项目名字 appName - App模块名字 packageName - applicationId (App包名packageName) buildType - buildType (release/debug等) channel - channel名称 (对应渠道打包中的渠道名字) versionName - versionName (显示用的版本号) versionCode - versionCode (内部版本号) buildTime - buildTime (编译构建日期时间) fileSHA1 - fileSHA1 (最终APK文件的SHA1哈希值) flavorName - 编译构建 productFlavors 名
channelFile:包含渠道配置信息的文件路径。
其中channelFile文件,每行是一个渠道名,支持使用#注释,具体的格式如下:
360 #百度 baidu develoer.huawei #华为
获取渠道信息
在需要渠道等信息时可以通过下面代码进行获取
public class ChannelUtil { public static String getChannelName(Context context){ if(context == null){ return ""; } return WalleChannelReader.getChannel(context,""); } }
如何生成渠道包
生成渠道包的方式是和 assemble${variantName}Channels指令结合,渠道包的生成目录默认存放在build/outputs/apk/,也可以通过walle代码块中的apkOutputFolder参数来指定输出目录,在AndroidStudio的终端中执行构建指令即可。具体指令:
生成渠道包 gradle clean assembleReleaseChannels
支持 productFlavors gradle clean assemblevariantNameChannels指令结合,渠道包的生成目录默认存放在build/outputs/apk/,也可以通过walle代码块中的apkOutputFolder参数来指定输出目录,在AndroidStudio的终端中执行构建指令即可。
Window环境可能需要使用gradlew才能执行
以上指令都是在walle配置好的基础上进行打包,也可以通过指令临时生成某个或某个渠道文件对应的渠道包
//单个渠道 gradle clean assembleReleaseChannels -PchannelList=baidu //多个渠道 gradle clean assembleReleaseChannels -PchannelList=baidu,360 gradle clean assembleReleaseChannels -PchannelFile=/user/mrtrying/AS_WorkSpace/ReleaseExample/channel
更多使用方式
官方文档还提到configFile的使用,configFile是包含渠道信息和额外信息的配置文件路径。配置文件采用json格式,支持为每个channel单独配置额外的写入信息。具体内容格式详见:渠道&额外信息配置文件示例。
walle { // 渠道&额外信息配置文件,与channelFile互斥 configFile = new File("${project.getProjectDir()}/config.json") }
此配置项与channelFile功能互斥,开发者在使用时选择其一即可,两者都存在时configFile优先执行。
extraInfo不要出现以channel为key的情况
可以通过如下方法获取对应key的信息:
public static String getExtraInfo(Context context,String key){ if(context == null){ return ""; } ChannelInfo channelInfo= WalleChannelReader.getChannelInfo(context.getApplicationContext()); if (channelInfo != null) { //如果要获取渠道 //String channel = channelInfo.getChannel(); Map<String, String> extraInfo = channelInfo.getExtraInfo(); return extraInfo.get(key); }else { return ""; } // 或者也可以直接根据key获取 //return WalleChannelReader.get(context, key); }
指令也还有其他的用法:
生成渠道包&写入额外信息:gradle clean assembleReleaseChannels -PchannelList=baidu -PextraInfo=buildtime:20161212,hash:xxxxxxx
使用临时configFile生成渠道包:gradlew clean assembleReleaseChannels -PconfigFile=/user/mrtrying/AS_WorkSpace/ReleaseExample/config.json
使用上述-P参数后,本次打包channelFile/configFile配置将会失效,其他配置仍然有效。-PchannelList,-PchannelFile,-PconfigFile三者不可同时使用。
注意: 上述的extraInfo以key:value形式提供,多个以,分隔。
命令行工具使用方式
可以使用命令行工具来支持各类自定义的需求,具体使用方式详见:Walle CLI 使用说明
其他使用方式
为了更好的满足大家的各类自定义需求,我们把对APK Signing Block区块进行读写操作的模块进行了封装。
读写模块的使用说明详见:
APK Signing Block读取模块: payload_reader
APK Signing Block写入模块: payload_writer
关于360加固失效问题
https://github.com/Meituan-Dianping/walle/wiki/360加固失效?
免费获取安卓开发架构的资料(包括Fultter、高级UI、性能优化、架构师课程、 NDK、Kotlin、混合式开发(ReactNative+Weex)和一线互联网公司关于android面试的题目汇总可以加:936332305 / 链接:点击链接加入【安卓开发架构】
更多相关文章
- 如何让手机横竖屏切换不重走Activity生命周期
- android版本7.0以上无法抓取https
- Android(安卓)混淆 以及 java代码方式实现混淆配置
- Android(安卓)SDK和模拟器配置
- Android(安卓)开发中配置Eclipse以提高效率
- android启动过程配置文件的解析与语法 .
- 分享一个 Android(安卓)全局获取 Context 的类(无需配置 Applicat
- 从android studio安装配置,到写出第一个小程序
- Android开发之PreferenceActivity的使用