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

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

混合开发应用场景

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

• 做为独立的页面进行加入，能够从原生页面跳转到Flutter页面，也能够从Flutter页面跳转到原生页面。

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

建立Flutter module

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

cd flutter/flutter_hybrid/
//建立支持AndroidX的flutter_module
flutter create --androidx -t module flutter_module 
//建立不支持AndroidX的flutter_module
flutter create -t module flutter_module

因此咱们在建立模块的时候首先要肯定native项目是否是已经支持AndroidX，若是支持就须要加上 --androidx 参数。

输入后控制台打印以下：

$ flutter create -t module flutter_module
Creating project flutter_module...
  flutter_module/test/widget_test.dart (created)
  flutter_module/flutter_module.iml (created)
  flutter_module/.gitignore (created)
  flutter_module/.metadata (created)
  flutter_module/pubspec.yaml (created)
  flutter_module/README.md (created)
  flutter_module/lib/main.dart (created)
  flutter_module/flutter_module_android.iml (created)
  flutter_module/.idea/libraries/Flutter_for_Android.xml (created)
  flutter_module/.idea/libraries/Dart_SDK.xml (created)
  flutter_module/.idea/modules.xml (created)
  flutter_module/.idea/workspace.xml (created)
Running "flutter pub get" in flutter_module...                      1.2s
Wrote 12 files.

All done!
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文件，添加以下代码：

setBinding(new Binding([gradle: this]))
evaluate(new File(
        settingsDir.parentFile,
        //flutter_module即为建立的模块名称
        'flutter_module/.android/include_flutter.groovy'
))

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

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

implementation project(':flutter')

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

compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
}

调用Flutter module

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

createView方式：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
//        setContentView(R.layout.activity_main);

        FlutterView flutterView = Flutter.createView(this, getLifecycle(), "initialRoute");
        setContentView(flutterView);

    }
}

createFragment方式：

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        
        FragmentTransaction transaction = getSupportFragmentManager().beginTransaction();
        //container为activity_main布局中的占位符FrameLayout
        transaction.replace(R.id.container, Flutter.createFragment("initialRoute"));
        transaction.commit();

    }
}

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

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

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

import 'package:flutter/material.dart';
import 'dart:ui';

void main() => runApp(MyApp(
      //经过window.defaultRouteName获取从native传递过来的参数,须要导入dart:ui包
      initParams: window.defaultRouteName,
    ));

class MyApp extends StatelessWidget {
  final String initParams;

  MyApp({Key key, this.initParams}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter_Android混合开发',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: HomePage(initParams: initParams),
    );
  }
}

class HomePage extends StatefulWidget {
  final String initParams;

  const HomePage({Key key, this.initParams}) : super(key: key);

  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<HomePage> {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: _widgetRoute(widget.initParams),
      ),
    );
  }
}

///路由转发
Widget _widgetRoute(String route) {
  switch (route) {
    case "route1":
      return route1Widget();
    case "route2":
      return route2Widget();
    default:
      return notFoundWidget();
  }
}

Widget route1Widget() {
  return Center(
    child: Text(
      "this is route1Widget",
      style: TextStyle(color: Colors.red, fontSize: 20),
    ),
  );
}

Widget route2Widget() {
  return Center(
    child: Text(
      "this is route2Widget",
      style: TextStyle(color: Colors.blue, fontSize: 20),
    ),
  );
}

Widget notFoundWidget() {
  return Center(
    child: Text(
      "未匹配到路由111",
      style: TextStyle(fontSize: 40),
    ),
  );
}

咱们如今将加载Flutter时的initialRoute参数替换为 “route1”，那页面将加载route1Widget，替换为 “route2”，将加载route2Widget。不然将展现notFoundWidget。固然咱们能够直接传路由参数，可是由于这个参数自己是一个字符串，因此咱们能够来搞事情。好比传递一个json串，那么是否是能够作不少事呢？这里我就不贴demo了，由于和上面的逻辑基本同样，你们能够去试试看。

热重启/从新加载

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

• 首先接入咱们的设备或者模拟器
• 将咱们的App关闭，退出后台，在terminal中运行 flutter attach命令

$ flutter attach
Waiting for a connection from Flutter on Android SDK built for x86...

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

flutter attach -d '你的设备id'

• 而后启动咱们的应用会看到控制台输出：

Done.
Syncing files to device Android SDK built for x86...             1,393ms

🔥  To hot reload changes while running, press "r". To hot restart (and rebuild state), press "R".
An Observatory debugger and profiler on Android SDK built for x86 is available at: http://127.0.0.1:59354/zRsDBfpesrk=/
For a more detailed help message, press "h". To detach, press "d"; to quit, press "q".

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

在Terminal中输入如下命令​：​

r : 热加载；
R : 热重启；
h : 获取帮助；
d : 断开链接；
q : 退出；

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

调试Dart代码

一样在混合开发过程当中咱们如何调试dart代码呢？

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

• 启动咱们的应用

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

总结

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

所有Demo源码已经上传到后台，关注公众号回复「Android混合开发」便可得到下载连接。

若是你以为文章还不错，请你们点赞分享下，你的确定是对我最大的鼓励和支持。

推荐阅读

Flutter开发必备Dart基础：Dart快速入门

Flutter混合开发(二)：iOS项目集成Flutter模块详细指南

Flutter混合开发(三)：Android与Flutter之间通讯详细指南

扫描下方二维码关注公众号，获取更多技术干货。