flutter_boost 3.0接入踩坑
本文未提供 iOS 端集成与使用示例
背景:
自从flutter2.0发布后,我总算是摆脱了观望的态度,哈哈!但是手上的原生实在不想重新写一遍~,看了一圈各种混合开发方式,准备使用闲鱼大佬们的FlutterBoost。
准备工作:
这里默认大家已经安装好了flutter环境和android studio。
首先我们创建一个原生android项目AndroidDemo,创建成功后打开它,然后在当前项目窗口创建一个module,File->New->New Module
找到下面的Flutter Module,创建一个名为flutter_module的module,
大家查看下,这个module是不是跟自己的项目同级,同级就对了
正式踩坑:
1 官方文档需要自己去setting.gradle下配置,但是我们上面这样创建,android studio 已经帮我们完成了引用flutter工程的引用。只有app的build.gradle,还需要我们去添加一个
dependencies{...
implementation project(':flutter_boost')
}
注意,检查下build.gradle里,android studio是否已经帮我们自动引入了implementation project(path:':flutter'),没有的话,请添加上。
2 然后,我们在清单文件中添加以下内容直接粘贴到<application>标签包裹的内部即可,也就是和其他<activity>标签同级
<activity
android:name="com.idlefish.flutterboost.containers.FlutterBoostActivity"
android:theme="@style/Theme.AppCompat"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density"
android:hardwareAccelerated="true"
android:windowSoftInputMode="adjustResize" >
</activity>
<meta-data android:name="flutterEmbedding"
android:value="2">
</meta-data>
然后点击右上角的sync同步一下,就会开始一些下载和同步的进程,等待完成
3 在Application中添加FlutterBoost的启动流程,并设置代理,这里自己建一个YourTargetAcitvity,后面要用到
public class App extends Application {
@Override
public void onCreate() {
super.onCreate();
FlutterBoost.instance().setup(this, new FlutterBoostDelegate() {
@Override
public void pushNativeRoute(FlutterBoostRouteOptions options) {
//这里根据options.pageName来判断你想跳转哪个页面,这里简单给一个
Intent intent = new Intent(FlutterBoost.instance().currentActivity(), YourTargetAcitvity.class);
FlutterBoost.instance().currentActivity().startActivityForResult(intent, options.requestCode());
}
@Override
public void pushFlutterRoute(FlutterBoostRouteOptions options) {
Intent intent = new FlutterBoostActivity.CachedEngineIntentBuilder(FlutterBoostActivity.class)
.backgroundMode(FlutterActivityLaunchConfigs.BackgroundMode.transparent)
.destroyEngineWithActivity(false)
.uniqueId(options.uniqueId())
.url(options.pageName())
.urlParams(options.arguments())
.build(FlutterBoost.instance().currentActivity());
FlutterBoost.instance().currentActivity().startActivity(intent);
}
}, engine -> {
});
}
}
官方文档上这里已经结束了,但是,我们一定要自己去manifest里把application给换成我们自己写的App,不然你的demo是跑不起来的,作者就是这里踩得第一个坑,o(╥﹏╥)o
4 dart部分,我接入的时候,版本是v3.0-release.1(这个flutter版本有要求,这是非空安全版本,哎)
首先,需要添加FlutterBoost依赖到yaml文件,(这里建议去官方文档下拷贝,yaml对空格有严格要求)
flutter_boost:
git:
url: 'https://github.com/alibaba/flutter_boost.git'
ref: 'v3.0-release.1'
put.get一下。然后,把官网写的main.dart替换系统自动生成的main.dart。OK,我们运行下main.dart
第二个坑来了,我的flutter版本是2.8.0,Dart是2.15.0,编译器会出现一个
这个错误,看来是我们的版本太高,按照百度出来的方法改了下,再一次编译
然后我们再一次运行main.dart,又报错了
按照提示,我们发现是routeFactory这个方法报了个空,为此,我不得不去把官方的demo下载下来看看,嗯,demo是这样
文档是这样
我按照demo改了下,再一次运行main.dart,这次总算是好了。。。
随便在MainPage里,添加一个ElevatedButton,在点击事件里,我们把官方跳转到android的方法抄过来。(建议设置下AppBar,不要太懒了)
BoostNavigator.instance.push(
"yourPage", //required
withContainer:false, //optional
arguments: {"key":"value"}, //optional
opaque:true, //optional,default value is true
);
好了,那我们在android里试试呢,这里就要用到YourTargetAcitvity了,等会我们会在flutter的MainPage跳转过来。运行app(注意这里是运行app了,上面都是运行的dart),嗯,没问题,打开了系统默认创建的界面,我们在这里添加个点击事件,跳转到MainPage去
Intent intent =new FlutterBoostActivity.CachedEngineIntentBuilder(FlutterBoostActivity.class)
.backgroundMode(FlutterActivityLaunchConfigs.BackgroundMode.opaque)
.destroyEngineWithActivity(false)
.url("mainPage")
.urlParams(new HashMap<>())
.build(MainActivity.this);
startActivityForResult(intent, 111);
大功告成!