Android 多渠道打包总结

为何要多渠道

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

如今的手机都自带应用商店，用户通常会在自带应用商店上搜索。android
产品、运营可统计使用不一样手机品牌的用户的消费状况，App日活、月活、UV、PV等。api

传统方式打包的痛点

若是App不是很出名，通常都须要本身打包上传，除非像微信这种，商店自动抓包进行上传。曾经参加过一个技术沙龙，微信的工程师说到，他们的热更新技术，若是使用了360加固进行，就是失效，可是360应用商店必须加固后才能上传，因此他们就不上传了，最后360应用商店也仍是抓包上传了（可见有实力就是不同）。微信

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

Gradle配置多渠道打包

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

优势：就是每一个包都只须要配置好要替换的文件和占位，便可开始打包。函数
缺点：每次打包一个渠道包，都须要编译一次，项目很是大的时候，可谓很是耗时！工具

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);
    }
}

不一样渠道替换资源文件

能替换包名和App名字了，原觉得完毕，结果运营说，360商店咱们要出首发！图标和启动图要加上360的标识！这时候就须要用到同结构、同名文件夹来替换了。

在和main文件夹下，创建同名渠道的文件夹，例如app_360渠道，创建的文件夹名为app_360。
assets文件夹、res文件夹、以及AndroidManifest.xml清单文件结构都要和main中的一致。
AppIcon同名便可替换。清单文件同名便可，内部特定不一样的内容便可。

多渠道配置1.png

多渠道配置2.png

关于Java代码多渠道

上面说到资源文件，创建同目录进行替换，那么Java代码能够同级目录下，同名Java文件替换吗？很遗憾的是不能够，须要不一样渠道，进行不一样的逻辑时，只能经过刚才ChannelUtil获取渠道信息，进行逻辑判断了。

总结

使用Gradle来进行配置，大大减小了咱们的工做量，妈妈不再用担忧我打渠道包须要2小时啦，至于gradle每构建一个渠道包都编译一次问题，能够单独给assets设置一个配置文件，后续使用zip修改配置文件，达到只打一个包，其余包都使用打包工具进行打包，时间能够节省很是多。

做者：h2coder 连接：https://www.jianshu.com/p/600cd4af6e44 来源：简书著做权归做者全部。商业转载请联系做者得到受权，非商业转载请注明出处。