背景
在原生开发中经常要根据不同的渠道打不同的包,主要有以下场景:
- 开发环境、测试环境、生产环境等
不同的环境对应的要求也不一样,这样就要求根据需求打出不同的包以便于开发、测试方便的使用。
- 各个应用市场等
由于国内存在着有众多的应用市场,在不同的应用市场可能有不同的统计需求,为此开发人员需要为每个应用市场发布一个安装包,在安装包中添加不同的标识,以此区分各个渠道,方便统计app在应用市场的各种效果。
因此,每当发新版本时,运营会提供一个渠道列表,开发同学会根据这些渠道相应地生成等量的渠道包。随着渠道越来越多,为了提高渠道打包的效率,因此催生了对多渠道打包的方式的研究。
同样在 Flutter的项目开发中也涉及到这个问题,在这里主要讲怎么配置开发包与生产包,并快速打出并运行相应的渠道包。
在这里我将分别从Android 端、IOS 端、Flutter 端进行讲解配置。
Android 配置
对于android,我们只要在app gradle模块中配置productFlavors即可,这里我们在build.gradle 中 android 下面定义了dev、production两种flavors。
[...]
android {
[...]
flavorDimensions "app"
productFlavors {
dev {//development
dimension "app"
resValue "string", "app_name", "多渠道打包${defaultConfig.versionCode}" // 设置默认的app_name
applicationId "${defaultConfig.applicationId}.dev"
manifestPlaceholders = [
QQ_APP_ID: "xxx",
CHANNEL_NAME: "dev",
LOCATION_APP_KEY : "xxx", /// 高德地图key
]
}
production{
dimension "app"
}
}
}
[...]
配置非常简单,这里可以设置不同的应用程序applicationId后缀,
同样也可以设置不同flavors 的app_name,CHANNEL_NAME。
IOS 配置
对于 ios,我们只需要在ios / Flutter文件夹中为每一个flavor创建相应的配置文件,就像Flutter中默认预定义Debug.xcconfig和Release.xcconfig一样,因为production正式包不用变包名与应用名,所以这里就只创建 dev_debug.xcconfig、dev_release.xcconfig两个文件,
并在dev flavor对应的xcconfig中配置bundle_suffix,name_suffix。
#include "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig"
#include "Generated.xcconfig"
bundle_suffix=.dev
name_suffix=${FLUTTER_BUILD_NUMBER}
并在Info.plist文件添加您定义的变量
然后针对每个 flavor 创建对应的scheme
记得在对话框中勾选上 shared
现在选择Runner项目并添加您需要选择的配置作为之前创建的配置文件作为配置文件。
注意,对于每个以Release- [flavorName]和Debug- [flavorName]命名的falvor都有两个配置。这里注意名字不要重复。
为了使在打包、发布时iOS应用使用正确的配置,这里需要编辑scheme,将构建配置设置为所需的配置:
Flutter 配置
将main.dart重命名为main_common.dart,把公共配置、运行部分定义在这里,然后创建 main_dev.dart和main_production.dart文件,引入main_common,根据需要在main_dev.dart和main_production.dart文件设置不同的配置参数。
可在 main_dev.dart 中设置网络代理、以及第三方库等的测试key。
import 'dart:io';
import 'package:dio/adapter.dart';
import 'package:flutter_common_utils/http/http_manager.dart';
import 'main_common.dart';
/// @desc 开发、测试环境入口
/// @time 2019-07-17 15:08
/// @author Cheney
Future main() async {
await initConfig();
//debug 抓包
(HttpManager().client.httpClientAdapter as DefaultHttpClientAdapter)
.onHttpClientCreate = (client) {
client.findProxy = (uri) {
return "PROXY http://10.1.10.111:8080";
};
client.badCertificateCallback =
(X509Certificate cert, String host, int port) {
return true;
};
};
///第三方库 测试 key
}
在main_production.dar配置正式的第三方库 key等。
import 'main_common.dart';
/// @desc 正式环境入口
/// @time 2019-07-17 15:08
/// @author Cheney
Future main() async {
await initConfig();
///第三方库 正式 key todo
initMaterialApp();
}
在main_common 中初始公共配置:
import 'dart:async';
import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart';
import 'package:flutter_common_utils/http/http_manager.dart';
import 'package:flutter_common_utils/log_util.dart';
import 'package:flutter_common_utils/sp_util.dart';
import 'package:oktoast/oktoast.dart';
import 'main.dart';
/// @desc 入口公共部分
/// @time 2019-07-17 15:08
/// @author Cheney
Future initConfig() async {
await SpUtil().init();
//日志输出
LogUtil.init(isDebug: true);
//初始化存储管理
// await StorageUtil.getInstance();
}
///初始化 App
void initMaterialApp() {
HttpManager().init(
baseUrl: "xxx",
interceptors: [],
);
runApp(OKToast(child: HomeApp()));
}
这样在命令行就可以分渠道运行了:
flutter build --flavor dev -t lib/main-dev.dart
flutter build --flavor production -t lib/main-production.dart
如果你想直接大 IDE中直接分渠道包运行,则要编辑配置创建两个对应的运行配置:
这里创建了两个 flutter 运行配置项,main_dev、main_production。
在Dart entrypoint 中选择上面创建的对应的 main_dev.dart、dart_production.dart。
在Build flavor 中选择对应的 flavor(dev、production)。
此时在运行对应的main_dev、main_production就可以了。
最后
如果在使用过程遇到问题,欢迎下方留言交流。
参考资料:
- https://cogitas.net/creating-flavors-of-a-flutter-app/
学习资料
- Flutter Github
- Flutter 中文网
- Flutter Packages
- Flutter 电子书
- Flutter 社区中文资源网