您现在的位置是：首页 > 文章详情

Android 多渠道打包总结

日期：2020-09-23点击：460收藏

为什么要多渠道

App一般会上传多个应用商店，例如应用宝、小米、华为、OPPO等。

现在的手机都自带应用商店，用户一般会在自带应用商店上搜索。
产品、运营可统计使用不同手机品牌的用户的消费情况，App日活、月活、UV、PV等。

传统方式打包的痛点

如果App不是很出名，一般都需要自己打包上传，除非像微信这种，商店自动抓包进行上传。曾经参加过一个技术沙龙，微信的工程师说到，他们的热更新技术，如果使用了360加固进行，就是失效，但是360应用商店必须加固后才能上传，所以他们就不上传了，最后360应用商店也还是抓包上传了（可见有实力就是不一样）。

不同的渠道，可能App名字不同，App图标Icon不同，如果手动替换的话，体力劳动特别累人，笔者就曾经做过一个app，需要给不同的景区生成app，每个景区的图标和app名字都不一样，传统方式就是打包完一个，手动替换再进行打包，10个还好，慢慢后面景区越来越多，上升了50个，工作量可想而知，而且还容易错，每个都需要手动检查一遍（曾经花2个小时，对着屏幕一个个替换，眼睛都花了，自然容易出错！），这样进行几次后，意识到这种重复劳动不应该由我们来做，应该交给机器呀！

Gradle配置多渠道打包

后面我们搜索了一下资料，决定使用Gradle配置的方式进行打包，但他也有优缺点。

优点：就是每个包都只需要配置好要替换的文件和占位，即可开始打包。
缺点：每次打包一个渠道包，都需要编译一次，项目非常大的时候，可谓非常耗时！

Manifest占位，动态替换meta标签值，动态标识渠道

实现步骤

配置App模块的build.gradle文件。
- 使用productFlavors，添加2个渠道，例如360和应用宝。
- 注意如果是3.0版本的Gradle，必须要添加上flavorDimensions纬度。
- 使用manifestPlaceholders，增加清单文件占位，格式：[占位名:值, 占位名:值]。

apply plugin: 'com.android.application' android { //省略其他配置... //3.0版本Gradle开始必须添加纬度 flavorDimensions "default" //多渠道打包配置 productFlavors { //渠道包 app_360 { manifestPlaceholders = [channel: "app_360"] } app_qq { manifestPlaceholders = [channel: "app_qq"] } } }

清单文件增加占位标识
- 例如我们使用友盟进行渠道记录，增加一个meta_data标签，标签名为UMENG_CHANNEL，值是占位符标识${channel}。

注意这个标识要和第一步的build.gradle文件中的productFlavors配置一致

例如build.gradle。

//占位名：channel，值：app_360 manifestPlaceholders = [app_name: "360渠道包", channel: "app_360"]

meta标签。

<!-- 占位名：channel，不包括${} --> <meta-data android:name="UMENG_CHANNEL" android:value="${channel}" />

完整配置

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="me.zh.makechannelpackage"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/AppTheme"> <!-- 省略其他配置... --> <!-- 多渠道配置 --> <meta-data android:name="UMENG_CHANNEL" android:value="${channel}" /> </application> </manifest>

在Java代码层读取meta标签，获取其值即可。

//渠道工具类 public class ChannelUtil { /** * 获取app包内的渠道标识 */ public static String getChannel(Context context) { try { PackageManager manager = context.getPackageManager(); ApplicationInfo appInfo = manager.getApplicationInfo(context.getPackageName(), PackageManager.GET_META_DATA); return appInfo.metaData.getString("UMENG_CHANNEL"); } catch (PackageManager.NameNotFoundException e) { e.printStackTrace(); return ""; } } } //调用 public class MainActivity extends AppCompatActivity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); String channel = ChannelUtil.getChannel(getApplicationContext()); Toast.makeText(getApplicationContext(), "当前渠道：" + channel, Toast.LENGTH_SHORT).show(); } }

给不同的编译环境配置清单Key

除了productFlavors中配置manifestPlaceholders生成渠道包外，在编译环境buildTypes下也可以使用，例如不同编译环境下，高德地图的key不同，就可以在buildTypes中使用。

修改build.gradle配置。

buildTypes { debug { manifestPlaceholders = [amap_key: "amp_debug_xxxxxkey"] //省略其他配置... } release { manifestPlaceholders = [amap_key: "amp_release_xxxxxkey"] //省略其他配置... } }

清单文件中添加高德Key配置。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="me.zh.makechannelpackage"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <!-- 配置高德key --> <meta-data android:name="com.amap.api.v2.apikey" android:value="${amap_key}" /> </application> </manifest>

Lib模块共享，App接入问题

一般我们都会使用多个Lib进行分模块开发，例如支付模块的Pay库中的微信回调Activity，7.0获取文件需要使用FileProvider等，都需要制定包名，但是我们的lib需要提供给其他App进行接入，清单文件的配置需要接入方配置，如果配置比较多，而且后续版本需要更换配置，都需要接入方重新配置会比较麻烦，那么可不可以将配置留在Lib库中，通过动态配置的方式动态配置呢。

例如微信支付的回调Activity配置，通过applicationId占位，可以动态获取到接入方的包名，只要按照约定，在包名下建立wxapi包下，建立WXEntryActivity文件即可。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="me.zh.makechannelpackage"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <!-- 动态配置微信回调Activity --> <activity android:name="${applicationId}.wxapi.WXEntryActivity" android:configChanges="keyboardHidden|orientation|screenSize" android:exported="true" android:theme="@android:style/Theme.Translucent.NoTitleBar" /> <!-- 省略其他配置... --> </application> </manifest>

再例如图片选择库，使用到了FileProvider，我们不希望接入方配置，则也可以使用applicationId进行占位。

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="me.zh.makechannelpackage"> <application android:allowBackup="true" android:icon="@mipmap/ic_launcher" android:label="@string/app_name" android:supportsRtl="true" android:theme="@style/AppTheme"> <activity android:name=".MainActivity"> <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> <!-- FileProvider配置 --> <provider android:name="android.support.v4.content.FileProvider" android:authorities="${applicationId}.fileprovider" android:exported="false" android:grantUriPermissions="true"> <meta-data android:name="android.support.FILE_PROVIDER_PATHS" android:resource="@xml/file_paths" /> </provider> <!-- 省略其他配置... --> </application> </manifest>

动态指定App名称

经过前面的配置已经足够配置出不同渠道标识的渠道包了，我们还可以继续拓展下，例如不同渠道的App名字不同。（一般因为有的应用商店会以App名称而被拒...）

修改build.gradle文件。

manifestPlaceholders中添加一个标识，app_name，值为对应的名称。例如360渠道为360渠道包，应用宝渠道为应用宝渠道。

//3.0Gradle开始必须添加纬度 flavorDimensions "default" //多渠道打包配置 productFlavors { //渠道包 app_360 { manifestPlaceholders = [app_name: "360渠道包", channel: "app_360"] } app_qq { manifestPlaceholders = [app_name: "应用宝渠道包", channel: "app_qq"] } }

动态指定App包名

例如我们debug环境下，希望测试包和正式包能够共存，那么共存就需要包名不同，所以可以对包名进行替换或者加后缀。

修改build.gradle文件。
- applicationIdSuffix，给包名添加后缀。例如测试版加上.internal后缀。
- applicationId，整个替换包名。（一般不会这么干，只是提一下）

//3.0Gradle开始必须添加纬度 flavorDimensions "default" //多渠道打包配置 productFlavors { //开发版 developer { //测试版加包名后缀，方便和正式版共存 applicationIdSuffix ".internal" manifestPlaceholders = [app_name: "开发版", channel : "app_internal"] } production { //也可以完全替换包名 applicationId "me.zh.demo" manifestPlaceholders = [app_name: "正式版", channel: "app_internal"] } }

动态生成变量

开发中，Log打印是必不可少的，但是我们在正式环境是需要将Log打印去掉的，常规做法就是打印函数前加一个LogEnable的变量，将打印调用去掉。而我们一般会在常量类中添加开关变量。

public class App extends Application { @Override public void onCreate() { super.onCreate(); Logger.setDelegate(new L()); Logger.setLogPrintEnable(true); } }

问题：而每次打包之前都需要将开关变量设置为false，很容易忘。
期望：我们希望不同buildType下的编译环境，打印Log是不一样的，例如buildType为debug时，Log开关为开，buildType为release时，Log开关为关。

Gradle为我们提供了buildConfigField，用于动态生成变量在BuildConfig，那么我们给不同的buildType进行添加即可。

//编译类型 buildTypes { debug { //打印开关变量 buildConfigField("boolean", "LOG_ENABLE", "true") //省略其他配置... } release { buildConfigField("boolean", "LOG_ENABLE", "false") //省略其他配置... } }

在Java代码中，设置BuildConfig中生成的变量即可。

public class App extends Application { @Override public void onCreate() { super.onCreate(); Logger.setDelegate(new L()); Logger.setLogPrintEnable(BuildConfig.LOG_ENABLE); } }