android多渠道打包插件,Walle —— Android多渠道打包神器

最新推荐文章于 2025-03-20 17:56:15 发布

Henri Sun

最新推荐文章于 2025-03-20 17:56:15 发布

阅读量588

点赞数

文章标签： android多渠道打包插件

在项目的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互斥