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
复制代码

免费获取安卓开发架构的资料（包括Fultter、高级UI、性能优化、架构师课程、 NDK、Kotlin、混合式开发（ReactNative+Weex）和一线互联网公司关于android面试的题目汇总能够加：936332305 / 连接：点击连接加入【安卓开发架构】

更多使用方式

官方文档还提到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