本文首发于微信公众号「Android开发之旅」，欢迎关注 ，获取更多技术干货

混合开发应用场景

目前在国内开发纯Flutter的应用还是比较少的，绝大部分使用Flutter来开发的公司也都是使用混合开发。那么混合开发的主要使用场景有哪些呢？

  • 作为独立的页面进行加入，可以从原生页面跳转到Flutter页面，也可以从Flutter页面跳转到原生页面。

Flutter混合开发(一)：Android项目集成Flutter模块详细指南 - 图1

  • 作为页面的一部分嵌入。

Flutter混合开发(一)：Android项目集成Flutter模块详细指南 - 图2

创建Flutter module

既然是做混合开发，那么我们肯定是由Android原生项目的。假如native项目的路径是这样的：flutter/flutter_hybrid/native,那么我们需要在native上一层目录flutter_hybrid中创建Flutter module。

  1. cd flutter/flutter_hybrid/
  2. //创建支持AndroidX的flutter_module
  3. flutter create --androidx -t module flutter_module 
  4. //创建不支持AndroidX的flutter_module
  5. flutter create -t module flutter_module

所以我们在创建模块的时候首先要确定native项目是不是已经支持AndroidX，如果支持就需要加上 —androidx 参数。

输入后控制台打印如下：

  1. $ flutter create -t module flutter_module
  2. Creating project flutter_module...
  3.   flutter_module/test/widget_test.dart (created)
  4.   flutter_module/flutter_module.iml (created)
  5.   flutter_module/.gitignore (created)
  6.   flutter_module/.metadata (created)
  7.   flutter_module/pubspec.yaml (created)
  8.   flutter_module/README.md (created)
  9.   flutter_module/lib/main.dart (created)
  10.   flutter_module/flutter_module_android.iml (created)
  11.   flutter_module/.idea/libraries/Flutter_for_Android.xml (created)
  12.   flutter_module/.idea/libraries/Dart_SDK.xml (created)
  13.   flutter_module/.idea/modules.xml (created)
  14.   flutter_module/.idea/workspace.xml (created)
  15. Running "flutter pub get" in flutter_module...                      1.2s
  16. Wrote 12 files.
  18. All done!
  19. Your module code is in flutter_module/lib/main.dart.

看到All done就表示我们项目创建好了。整个module目录和原生Flutter基本一样，主要就是Android、iOS的宿主工程和lib目录以及pubspec.yaml文件。

添加Flutter module依赖

module项目创建好后就需要添加到Android项目中了。我们打开Android项目的setting.gradle文件，添加如下代码：

  1. setBinding(new Binding([gradle: this]))
  2. evaluate(new File(
  3.         settingsDir.parentFile,
  4.         //flutter_module即为创建的模块名称
  5.         'flutter_module/.android/include_flutter.groovy'
  6. ))

setBinding与evaluate允许Flutter模块包括它自己在内的任何Flutter插件，在settings.gradle中以类似 :flutter、package_info、:video_player的方式存在。

然后打开app/build.gradle在dependencies标签中添加依赖：

  1. implementation project(':flutter')

这样两步就完成了依赖的添加，这里为什么添加的叫“flutter” 而不是 “flutter_module”呢？因为项目编译完成后会在Android项目的目录下生成叫Flutter的目录，这就是需要我们依赖的。还有个需要注意是gradle中的minSdkVersion必须要大于等于16，因为这个flutter支持的最低版本。同时添加使用java8来编译。在app/build.gradle中的android标签中添加：

  1. compileOptions {
  2.     sourceCompatibility JavaVersion.VERSION_1_8
  3.     targetCompatibility JavaVersion.VERSION_1_8
  4. }

调用Flutter module

依赖完成后我们就可以调用flutter模块来创建UI了。Flutter为我们提供了两种方式调用，一种是createView，以view的形式加载。另一种是createFragment，以Android中的fragment的形式加载。

createView方式：

  1. public class MainActivity extends AppCompatActivity {
  3.     @Override
  4.     protected void onCreate(@Nullable Bundle savedInstanceState) {
  5.         super.onCreate(savedInstanceState);
  6. //        setContentView(R.layout.activity_main);
  8.         FlutterView flutterView = Flutter.createView(this, getLifecycle(), "initialRoute");
  9.         setContentView(flutterView);
  11.     }
  12. }

createFragment方式：

  1. public class MainActivity extends AppCompatActivity {
  3.     @Override
  4.     protected void onCreate(@Nullable Bundle savedInstanceState) {
  5.         super.onCreate(savedInstanceState);
  6.         setContentView(R.layout.activity_main);
  8.         FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
  9.         //container为activity_main布局中的占位符FrameLayout
  10.         transaction.replace(R.id.container, Flutter.createFragment("initialRoute"));
  11.         transaction.commit();
  13.     }
  14. }

这样就将Flutter默认的首页加载到应用上了。

Flutter混合开发(一)：Android项目集成Flutter模块详细指南 - 图3

从上面两部分代码中我们可以看到都有一个 “initialRoute” 参数，这个参数是用来告诉Dart代码在Flutter视图中显示哪个小部件。下面我们就来修改module中的main.dart代码来加载我们自己的页面。

我们设置两个route，分别展示route1Widget，和route2Widget，当没有匹配的时候展示提醒文字。

  1. import 'package:flutter/material.dart';
  2. import 'dart:ui';
  4. void main() => runApp(MyApp(
  5.       //通过window.defaultRouteName获取从native传递过来的参数,需要导入dart:ui包
  6.       initParams: window.defaultRouteName,
  7.     ));
  9. class MyApp extends StatelessWidget {
  10.   final String initParams;
  12.   MyApp({Key key, this.initParams}) : super(key: key);
  14.   @override
  15.   Widget build(BuildContext context) {
  16.     return MaterialApp(
  17.       title: 'Flutter_Android混合开发',
  18.       theme: ThemeData(
  19.         primarySwatch: Colors.blue,
  20.       ),
  21.       home: HomePage(initParams: initParams),
  22.     );
  23.   }
  24. }
  26. class HomePage extends StatefulWidget {
  27.   final String initParams;
  29.   const HomePage({Key key, this.initParams}) : super(key: key);
  31.   @override
  32.   _HomePageState createState() => _HomePageState();
  33. }
  35. class _HomePageState extends State<HomePage> {
  36.   @override
  37.   Widget build(BuildContext context) {
  38.     return Scaffold(
  39.       body: Center(
  40.         child: _widgetRoute(widget.initParams),
  41.       ),
  42.     );
  43.   }
  44. }
  46. ///路由转发
  47. Widget _widgetRoute(String route) {
  48.   switch (route) {
  49.     case "route1":
  50.       return route1Widget();
  51.     case "route2":
  52.       return route2Widget();
  53.     default:
  54.       return notFoundWidget();
  55.   }
  56. }
  58. Widget route1Widget() {
  59.   return Center(
  60.     child: Text(
  61.       "this is route1Widget",
  62.       style: TextStyle(color: Colors.red, fontSize: 20),
  63.     ),
  64.   );
  65. }
  67. Widget route2Widget() {
  68.   return Center(
  69.     child: Text(
  70.       "this is route2Widget",
  71.       style: TextStyle(color: Colors.blue, fontSize: 20),
  72.     ),
  73.   );
  74. }
  76. Widget notFoundWidget() {
  77.   return Center(
  78.     child: Text(
  79.       "未匹配到路由111",
  80.       style: TextStyle(fontSize: 40),
  81.     ),
  82.   );
  83. }

我们现在将加载Flutter时的initialRoute参数替换为 “route1”，那页面将加载route1Widget，替换为 “route2”，将加载route2Widget。否则将展示notFoundWidget。当然我们可以直接传路由参数，但是因为这个参数本身是一个字符串，所以我们可以来搞事情。比如传递一个json串，那么是不是可以做很多事呢？这里我就不贴demo了，因为和上面的逻辑基本一样，大家可以去试试看。

热重启/重新加载

大家在写纯Flutter应用的时候，知道是有热重启/重新加载功能的，但是在做混合开发的过程中，你会发现热重启/重新加载功能失效了。那么如何在混合开发中开启热重启/重新加载功能呢？

  • 首先接入我们的设备或者模拟器
  • 将我们的App关闭，退出后台，在terminal中运行 flutter attach命令
  1. $ flutter attach
  2. Waiting for a connection from Flutter on Android SDK built for x86...

此时就在等待设备的连接。这里要注意的是，如果电脑连接了多台设备需要使用 -d 命令来指定一台设备，参数为设备的id。

  1. flutter attach -d '你的设备id'
  • 然后启动我们的应用会看到控制台输出：
  1. Done.
  2. Syncing files to device Android SDK built for x86...             1,393ms
  4. 🔥  To hot reload changes while running, press "r". To hot restart (and rebuild state), press "R".
  5. An Observatory debugger and profiler on Android SDK built for x86 is available at: http://127.0.0.1:59354/zRsDBfpesrk=/
  6. For a more detailed help message, press "h". To detach, press "d"; to quit, press "q".

这样就表示我们连接成功了。在输出的日志中也告诉了我们如何使用热重启/重新加载功能。

在Terminal中输入以下命令：

  1. r : 热加载；
  2. R : 热重启；
  3. h : 获取帮助；
  4. d : 断开连接；
  5. q : 退出；

这里的的 d 和 q 的命令都有退出调试，区别在于 d 命令只是单纯的断开而 q 命令会将应用退到后台。

调试Dart代码

同样在混合开发过程中我们如何调试dart代码呢？

  • 关闭我们的应用
  • 点击Android Studio工具栏上的Flutter Attach按钮(需要安装Flutter与Dart插件)

Flutter混合开发(一)：Android项目集成Flutter模块详细指南 - 图4

  • 启动我们的应用

接下来就可以像调试普通Flutter项目一样来调试混合开发模式下的Dart代码了。

总结

以上就是如何在Android原生项目中接入Flutter模块的基础讲解，主要就是模块的创建、依赖、调用以及调试等等。其它的像iOS接入Flutter模块，Android项目和Flutter项目之间的通信以及iOS项目和Flutter之间的通信都将在之后的文章中进行讲解。因为写在一篇中篇幅太长，朋友们读起来也累。所以后续还会有至少三篇相关的文章和大家见面。动动手关注公众号，即时获取相关文章的推送