Flutter混合开发二-FlutterBoost使用介绍(1)

void initState() {
super.initState();

FlutterBoost.singleton.registerPageBuilders({
‘flutterbus://flutterFirstPage’: (pageName, params, _) {
print(“first flutterPage params:KaTeX parse error: Expected 'EOF', got '}' at position 35: …n FirstPage(); }̲, 'flutterbus:/…params”);

return SecondPage();
},
});

FlutterBoost.handleOnStartPage();
}

@override
Widget build(BuildContext context) {
return MaterialApp(
title: ‘Flutter Boost example’,
builder: FlutterBoost.init(),
home: Container());
}

安卓原生项目中使用FlutterBoost

Flutter引擎加载及FlutterBoostPlugin初始化

首先,根据FlutterBoost给的例子我们原生项目的Application需要继承FlutterApplication,其实这个不是必须的,FlutterApplication中主要是在onCreate方法中初始化加载flutter.so库,该操作我们可以在适当的地方自己来加即可。

其次,FlutterBoost的example中在自定义的Application的onCreate方法中初始化FlutterBoostPlugin,这个我们可以提取出来放到一个单独的类里。

基于以上两点我实现了一个工具类用来执行FlutterBoost的初始化

public class FlutterMediator {
public static void init(final Application app) {
//此处必须启动初始化,主要是载入Flutter引擎文件
FlutterMain.startInitialization(app);

FlutterBoostPlugin.init(new IPlatform() {
@Override
public Application getApplication() {
return app;
}

@Override
public Activity getMainActivity() {
return MainActivity.sRef.get();
}

@Override
public boolean isDebug() {
return true;
}

@Override
public boolean startActivity(Context context, String url, int requestCode) {
Debuger.log(“startActivity url=”+url);

return PageRouter.openPageByUrl(context,url,requestCode);
}

@Override
public Map getSettings() {
return null;
}
});
}
}

这样,我们在原生项目中的自定义Application的onCreate方法中只需要调用FlutterMediator.init(this);方法即可完成FlutterBoost的初始化了。其中MainActivity应该是一直存在栈底的Activity,一般是我们的首页。

Flutter页面对应Native容器

FlutterBoost初始化完成之后,针对Flutter中的FirstPageSecondPage页面我们需要在原生中创建对应的Native容器,即FlutterBoost中定义的Container,可以是Activity也可以是Fragment,这里我们使用Activity实现,

// Flutter中FirstPage对应的Native container

public class FlutterFirstPageActivity extends BoostFlutterActivity {
private int id = 0;
private String name;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent intent = getIntent();
if(intent != null) {
String url = intent.getStringExtra(“url”);
Map map = UrlUtil.parseParams(url);
id = Integer.parseInt(map.get(“id”).toString());
name = map.get(“name”).toString();
}
}

@Override
public String getContainerName() {
return PageRouter.FLUTTER_FIRST_PAGE_URL;
}

@Override
public Map getContainerParams() {
Map map = new HashMap();
map.put(“id”, id);
map.put(“name”, name);
return map;
}

@Override
public void onRegisterPlugins(PluginRegistry registry) {
GeneratedPluginRegistrant.registerWith(registry);
}
}

FlutterBoost已经为我们实现好了Activity类型的容器BoostFlutterActivity,该类实现了IFlutterViewContainer接口,我们自定义容器时只需要继承该Activity并实现三个方法即可,其中

  • getContainerName即是容器的名称,和Flutter层注册PageBuilder相对应;
  • getContainerParams为该容器需要传递给Flutter层对应Widget的参数,页面跳转接收的参数传递给Flutter页面就是在这里处理,需要将数据包装到Map中;
  • onRegisterPlugins是为该页面注册插件;
页面跳转路由

我们在上面FlutterBoostPlugin初始化的代码中看到了一行PageRouter.openPageByUrl(context,url,requestCode);代码,这句代码是用来处理Flutter页面根据url打开另一个页面的操作。PageRouter是我们原生层定义的一个页面路由类

public class PageRouter {
public static final String NATIVE_FIRST_PAGE_URL = “flutterbus://nativeFirstPage”;
public static final String NATIVE_SECOND_PAGE_URL = “flutterbus://nativeSecondPage”;
public static final String FLUTTER_FIRST_PAGE_URL = “flutterbus://flutterFirstPage”;
public static final String FLUTTER_SECOND_PAGE_URL = “flutterbus://flutterSecondPage”;

public static boolean openPageByUrl(Context context, String url) {
return openPageByUrl(context, url, 0);
}

public static boolean openPageByUrl(Context context, String url, int requestCode) {
try {
Intent intent;
if (url.startsWith(NATIVE_FIRST_PAGE_URL)) {
intent = new Intent(context, FirstNativeActivity.class);
intent.putExtra(“url”, url);
context.startActivity(intent);
return true;
} else if (url.startsWith(NATIVE_SECOND_PAGE_URL)) {
intent = new Intent(context, SecondNativeActivity.class);
intent.putExtra(“url”, url);
if(context instanceof Activity) {
((Activity)context).startActivityForResult(intent, requestCode);
}
return true;
} else if(url.startsWith(FLUTTER_FIRST_PAGE_URL)) {
intent = new Intent(context, FlutterFirstPageActivity.class);
intent.putExtra(“url”, url);
context.startActivity(intent);
return true;
} else if (url.startsWith(FLUTTER_SECOND_PAGE_URL)) {
intent = new Intent(context, FlutterSecondPageActivity.class);
intent.putExtra(“url”, url);
if(context instanceof Activity) {
((Activity)context).startActivityForResult(intent, requestCode);
}
return true;
} else {
return false;
}
} catch (Throwable t) {
return false;
}
}

}

Flutter页面和Native页面跳转

以上准备工作及页面路由类定义好之后,我们就可以在Flutter层和Native层调用相应的方法根据要跳转页面的url执行页面跳转操作了,你既可以Native页面跳转Native页面,也可以Native页面跳转Flutter页面,既可以在Flutter页面跳转Native页面,也可以Flutter页面跳转Flutter页面,具体例子如下

Native页面跳转Flutter页面

Native页面跳转Flutter页面其实就是打开一个Flutter页面对应的Native容器,我们可以根据路由来进行跳转操作,比如从MainActivity跳转到Flutter的FirstWidget页面,一句代码搞定

PageRouter.openPageByUrl(this, PageRouter.FLUTTER_FIRST_PAGE_URL+“?id=123&name=bruce”);

以上代码中对应的url中带有参数,很多时候你是不需要传参数的,这里只是举个传参数给Flutter页面的例子,即是将id和name值传到Flutter页面来使用,具体是如何使用的呢,我们需要在Flutter对应的Native容器FlutterFirstPageActivity中解析出url参数,然后在以下覆盖方法中包装到Map中通过PlatformChannel传递给Flutter端

@Override
public Map getContainerParams() {
Map map = new HashMap();
map.put(“id”, id);
map.put(“name”, name);
return map;
}

Flutter页面跳转Native页面

我们只需要在Flutter端使用FlutterBoost提供的方法进行跳转即可,比如我需要从FirstWidget跳转到FirstNativeActivity页面,该页面对应的url为“flutterbus://nativeFirstPage”,我们可以执行以下代码

FlutterBoost.singleton.openPage(“flutterbus://nativeFirstPage”, {
“query”: {“description”: “大家好,我来自First Flutter页面!!!”}
});

其中query对应的值是要传递给下一个页面的参数,不需要也可以不传。

Flutter页面跳转Flutter页面

这个其实有两种方式,如果采用FlutterBoost定义的页面跳转,那么就需要使用以下方法

FlutterBoost.singleton.openPage(“flutterbus://flutterSecondPage”, {});

建议集成FlutterBoost后采用FlutterBoost定义的页面来使用openPage的方式跳转。

其实也可以使用Flutter中的Navigator跳转,方法如下

Navigator.of(context).push(MaterialPageRoute(builder: (context){
return SecondPage(enterType: 1,);
}));

如果两种跳转方式混合使用会在页面返回时出现一定的问题,因为FlutterBoost提供了关闭当前页面的方法FlutterBoost.singleton.closePageForContext(context);,而使用Navigator跳转的话该方法是不起作用的,所以我们在Widget页面中定义了enterType来区分,默认使用FlutterBoost的跳转方式,如果使用Navigator跳转Flutter Widget页面,则需要传入enterType=1,这样在返回当前页面时使用如下方法进行处理

void exitPage(BuildContext context) {
if (enterType == 0) {
FlutterBoost.singleton.closePageForContext(context);
} else {
Navigator.pop(context);
}
}

页面跳转的返回值问题

FlutterBoost中实现了Flutter页面跳转Native页面并接收返回值的功能,具体方法为

FlutterBoost.singleton.openPage(
“flutterbus://nativeSecondPage”,
{
“query”: {“requestCode”:1000, “type”: “second”}
},
resultHandler: (String key, Map<dynamic, dynamic> result) {
print(“==============> key: $key, result: $result”);
});

openPage方法中的resultHandler参数就是接收返回值的回调函数,但是经测试目前该方法存在bug,主要有两种修复方案

修复方案一

该方案采用Activity传统的跳转并返回结果的方法,即Flutter跳转指定Native页面在原生PageRouter的openPageByUrl方法中使用如下跳转方式

if(context instanceof Activity) {
((Activity)context).startActivityForResult(new Intent(context, NativePageActivity.class), requestCode);
}

该跳转方式FlutterBoost已经实现返回结果处理的整个流程,但是需要修改以下两处bug才能正常使用。

1、类型转换错误

flutter_boost.dart中的方法onPageResult中的resultData参数是Map<String, dynamic> 类型,而通过PlatformChannel传过来解析的数据类型为Map<dynamic, dynamic>,所以会报类型转换错误,控制台会打印这样一句话

… E/FlutterBoost#: onNativePageResult call error

解决这个问题只需要将onPageResult方法中的resultData参数类型Map<String, dynamic>改为Map<dynamic, dynamic>即可;

2、回调方法对应的key错误

针对1问题,修改Flutter_Boost源码后就不会报以上错误了,但是接收结果的回调方法还是走不到,经查发现还存在另一个bug,在我们通过openPage方法打开页面时,最终会将回调函数通过PageResultMediator类的setPageResultHandler方法保存到一个Map<String,PageResultHandler>对象_handlers中,PageResultMediator类实现如下

typedef void PageResultHandler(String key , Map<dynamic,dynamic> result);
typedef VoidCallback = void Function();

class PageResultMediator{

Map<String,PageResultHandler> _handlers = Map();
void onPageResult(String key , Map<dynamic,dynamic> resultData){

if(key == null) return;

Logger.log(“did receive page result $resultData for page key $key”);

if(_handlers.containsKey(key)){
_handlerskey;
_handlers.remove(key);
}
}

VoidCallback setPageResultHandler(String key, PageResultHandler handler){
if(key == null || handler == null) return (){};
_handlers[key] = handler;
return (){
_handlers.remove(key);
};
}

}

Map中的key即是我们跳转页面对应的url,即上文代码中的flutterbus://nativeSecondPage,而在原生页面中处理完返回数据后通过PlatformChannel方法传入的key是Native容器对应的uniqueId,具体代码如下

外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传

所以,最后Flutter中根据这个uniqueId是找不到之前的回调方法的,因此回调函数没有走到。于是对Flutter_Boost源代码简单做了修改,将前一个页面的url放置到onResult方法的Result参数里,然后取出即可,修改后的代码如下

该代码块位于ContainerRecord.java类中

@Override
public void onResult(Map Result) {
Map result = (Map) Result.get(“result”);
String key = result.get(“currentUrl”).toString();
NavigationService.onNativePageResult(
genResult(“onNativePageResult”),
mUniqueId,
key,
Result,
mContainer.getContainerParams()
);
}

写在最后

对程序员来说,很多技术的学习都是“防御性”的。也就是说,我们是在为未来学习。我们学习新技术的目的,或是为了在新项目中应用,或仅仅是为了将来的面试。但不管怎样,一定不能“止步不前”,不能荒废掉。

![
[]


文章以下内容会给出阿里与美团的面试题(答案+解析)、面试题库、Java核心知识点梳理等

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可获取!
😕/upload-images.jianshu.io/upload_images/22459598-3e1bbd9b84cc0ef9.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

[外链图片转存中…(img-E0iWPu2x-1715618974888)]
[外链图片转存中…(img-kXvjkknu-1715618974889)]

文章以下内容会给出阿里与美团的面试题(答案+解析)、面试题库、Java核心知识点梳理等

《Android学习笔记总结+移动架构视频+大厂面试真题+项目实战源码》点击传送门,即可获取!

  • 27
    点赞
  • 29
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值