/flutter_thrio

flutter_thrio makes it easy and fast to add flutter to existing mobile applications, and provide a simple and consistent navigator APIs.

Primary LanguageDartMIT LicenseMIT

thrio logo

pub package license

中文文档 英文文档 问题集 原仓库不再维护,代码已经很老了

最近版本更新会很快,主要是增加新特性,涉及到混合栈的稳定性的问题应该不多,可放心升级,发现问题加 QQ 群号码:1014085473,我会尽快解决。

不打算好好看看源码的使用者可以放弃这个库了,因为很多设定是比较死的,而我本人不打算花时间写太多文档

优势

  1. 稳定性、通用性在部分项目中得到验证,有用户反馈,将整个 app 的路由方案全部切换到后,崩溃率降低显著
  2. 内存占用方面,thrio 在连续打开 Flutter 页面的内存占用方面从一开始就碾压主流的 Flutter 混合栈,更进一步的,避开原理层面带来的内存优势,这里有个对比,也说明 thrio 在内存占用上的优异表现,传送门
  3. 支持 FlutterEngine 的复用,还支持 FlutterViewControllerFlutterActivity 的复用,这保证了 Flutter 混合栈框架在内存占用上是最优解
  4. 在 3 情形下,支持 跨栈路由 的能力,这是目前唯一能做到的 Flutter混合栈开源框架
  5. 在 3 情形下,除了提供 pushpop,也提供了 removepopTo 的能力,目前唯一能做到的 Flutter混合栈开源框架
  6. 在 3 情形下,提供页面通知的能力,组合 pushpop 的路由传参能力,可以让状态参数在页面间传递,省去很多 channel 通讯的必要
  7. 在 3 情形下,页面传参支持Json对象类型,单引擎下纯 Flutter 开发支持直接传递对象类型
  8. 在 3 情形下,支持完整的页面生命周期
  9. 在 3 情形下,支持完整的路由周期,兼容使用 FlutterNavigator 来打开对话框等弹窗
  10. 在 3 情形下,支持多引擎模式,可以在一个原生 App 中运行多份 Flutter 代码,目前唯一能做到的 Flutter 混合栈开源框架
  11. 在 3 情形下,解决 iOS 和 Android 上的侧滑返回手势冲突
  12. iOS 上自动隐藏 Flutter 页面的导航栏
  13. 额外的支持三端统一的模块化方式,更好的与路由API配合

劣势

  1. 在 iOS 上不支持 present,技术上完全可以实现,甚至使用者可以通过传参的方式在 builder 中自己 present,但为了 API 设计上统一,作者选择不支持 present,demo 中其实是有 present 的示例的,建议 present 的时候外套一个 UINavigationController,可以保证不管何时 push 时 API 都是有效的,flutter_thrio 是支持多 UINavigationController 的,有一点需要注意的是,如果多个 UINavigationController 内嵌于 UITabBar 中时,要注意无法同时将多个 FlutterViewController 呈现,不支持是因为支持的话无法进行引擎复用。
  2. 在 Android 上不支持 Fragment,原因是复杂性无法解决,作者目前不能够保证提供一个通用稳定的版本。

入门

  1. clone thrio 的源码,查看 demo,并运行起来
  2. 通过 pub 引入 thrio,建议采用 1.0.0 之后的版本,之前的版本支持1.22.x之前的Flutter SDK,但不建议继续采用这些老版本的 SDK,还是尽快升级到新版
  3. 模仿 thrio demo 中的源码,在现有工程上加入相关代码
  4. 不要继承 Flutter SDK 中的一些类,比如 FlutterViewControllerFlutterActivityFlutterAppDelegate
  5. 不要调用 GeneratedPluginRegistrantregisterWithRegistry 方法了,因为框架会自动调用
  6. url 至少保持两段

最后

  1. 技术没有好与不好,使用在适合的场景才是最好的。

  2. Flutter 在 客户端的适用场景会越来越广,个人比较看好。

  3. 目前在移动端,一个好的 Flutter 混合栈框架是必须的,让你可以在大多数的页面上采用 Flutter 来开发从而达到提效的目的,少数涉及到 Flutter 不能很好支持的页面上继续使用原生开发,从而规避的 Flutter 的坑。

  4. 如果所开发的是一个全新的 App,以后也不会涉及到老的代码的复用,或者不会涉及到 Flutter 支持不够良好的一些技术上的坑,确实可以考虑纯 Flutter。

  5. 但4的情形极少,所以大部分的 Flutter 在引入的时候,都应该考虑以 Flutter 混合栈的方式进行,坑不是用来踩的,而是绕道而过。