前言
首页要了解 Gradle配置多渠道打包,APP马甲包大部分是将应用ICON
(应用图标)、Name
(名称)、applicationId
(应用标识)、Splash
(启动图)、Guide
(引导页)、Style Color
(主题颜色)、JKS
更换还有代码逻辑区分处理。而Gradle多渠道
就可以轻松可以实现动态替换这些东西。接下来我们看看微信支付/分享回调是如何产生问题的。
现有场景微信(支付/分享)回调产生的问题
既然是马甲包,那么applicationId(应用Id)
肯定是不一样的。如果按常规方法applicationId
和packageName(包名)
一致,那么如果我们app里有微信分享/支付 这就很麻烦了,因为微信(分享/支付)成功/失败后会使用到我们在微信开放平台配置的packageName
. 干什么呢?用于将结果回调给我们的app内. 怎么回调呢?微信使用 packageName.wxapi.WXEntryActivity
或者packageName.wxapi.WXPayEntryActivity
在系统中找到这个类回调结果。
小提示:(分享/支付)调起微信会检查应用的
packageName(包名)
这里的packageName(包名)
并不是Manifests
中的packageName
而是applicationId
。因此在多渠道打包时候,applicationId
修改成多个不同的值,为了不影响微信将结果正常回调到我们的应用,都必须建立相应文件路径和配置
Test Result:
applicationId
配置和微信开放平台的packageName
一致,但是微信回调类的位置不在packageName.wxapi
下也不会提示(包名/签名错误) 而会调用起微信并(分享/支付),但是无法将结果回调
这样就知道我们在项目中的两个文件(WXEntryActivity
和WXPayEntryActivity
)存放位置就至关重要了,常规app只要将这两个文件放置当前packageName.wxapi
下就可以了。可是马甲包的applicationId
是不一样的,那怎么办呢?
解决方案
一、之前我的常规做法把微信 APP_ID
和 APP_SECRET
通过productFlavors
的buildConfigField
配置,每次发布多应用都需要改packageName(包名)
发布,如果同时发布10个应用,那么就要改10次packageName(包名)
及资源等,然后进行打包。 o( ̄︶ ̄)o 非常痛苦
二、在项目(app工程)
里src
下新建以渠道名称命名的文件夹,名字一定要跟渠道名一样,级别跟main
文件夹是一样的,里面独有文件独有资源的文件结构要跟main
一致。
如图:
这里有三种文件
- 一种是需要用到的资源文件,如各种
xml
文件或图片等 - 一种是
java
代码。这里要注意一下,xml
文件和图片等资源会自动替换掉main
文件夹里的相应文件;在java
文件时,各个渠道文件夹里有这个文件,在main
里也有这个文件,但在编译时就会提示类重复,编译不通过,则需要将main
中相对于文件删除。各个渠道文件夹和main
文件夹之间的关系不是单纯的替换,而是优先使用渠道的东西,编译时相当于是合并,xml
等文件相当于直接替换。 - 还有一种就是
manifests
文件,编译时也是合并。
我们可以将资源放入不同的渠道文件中,保证几个渠道中的资源名称一致 main
引用不报错就可以,Android Studio
通过切换渠道(Build Variants)
会引用不同的资源文件。
要解决微信回调的问题,就要利用渠道 manifests
文件和java
文件来实现 如上图(1)
再来看一下Android
状态下的目录结构
再来看看Manifests
文件里是什么样的
Gradle
部分代码如下
因公司代码不便贴出来,模拟 channel1
、 channel2
、 channel3
三个渠道,只要保证productFlavors
里的名称和上面介绍的渠道文件夹名称一致就好了
android {
signingConfigs {
//配置多渠道需要的JKS
channel1 {
//channel1 jks info
}
channel2 {
//channel2 jks info
}
channel3 {
//channel3 jks info
}
}
//省略部分代码.........
productFlavors {
channel1 {
applicationId "com.test.channel1"
}
channel2 {
applicationId "com.test.channel2"
}
channel3 {
applicationId "com.test.channel3"
}
}
buildTypes {
release {
zipAlignEnabled true
//多个 flavor(渠道) ,指定 flavor 使用指定 签名
productFlavors.channel1.signingConfig signingConfigs.channel1
productFlavors.channel2.signingConfig signingConfigs.channel2
productFlavors.channel3.signingConfig signingConfigs.channel3
}
//如果 debug 包需要测试诸如微信、地图等第三方 sdk ,则可以指定 debug 包使用 release 包的签名
//debug 并不能设置多个签名
debug {
zipAlignEnabled true
}
}
productFlavors.all { flavor ->
flavor.manifestPlaceholders = [CHANNEL_VALUE: name]
}
}
好了,这样配置过后,在打包生成APK
时,渠道配置的Manifests
文件会和main
的Manifests
文件会自动合并,这样的话就将渠道Manifests
配置的activity
注册到了我们app
里,继而实现了这篇文章的核心功能 <不用每次都手动更换packageName(包名)
> ,只需要按上面 图(1)
中的结构配置渠道文件即可
配置渠道资源注意事项
- 保证不同渠道之间 同作用的文件 存放位置及名称要一致(例如
ICON
在多个渠道文件夹中都存放至drawable-xxgdpi
文件夹 并命名为ic_launcher.png
)