Flutter桥梁通信插件bifrost的使用

Flutter桥梁通信插件bifrost的使用

Bifrost 是一个插件，它使您可以轻松地将您的 Flutter 应用程序嵌入到现有的原生应用程序中。

要求

• Flutter: 版本 2.0.0 或更高版本
• iOS: iOS 10.0 或更高版本，Xcode 12.0 或更高版本，Swift 5 或更高版本
• Android: 最低 SDK 版本 16，Kotlin 1.3.50 或更高版本

开始使用

Flutter

首先，在您的 Flutter 项目中添加依赖项：

dependencies:
  bifrost: ^0.1.0

然后在 MaterialApp 或 CupertinoApp 中初始化 Bifrost：

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

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: Bifrost.init(), // 初始化 Bifrost
      routes: routes,
      theme: theme,
    );
  }

  Map<String, WidgetBuilder> get routes => {
        '/first': (context) => FirstPage(),
        '/second': (context) => SecondPage(),
        '/greetings': (context) => GreetingsPage(),
      };

  ThemeData get theme => ThemeData(
        primaryColor: Colors.deepPurpleAccent,
        accentColor: Colors.deepPurpleAccent,
        appBarTheme: AppBarTheme(
          color: Colors.deepPurpleAccent,
        ),
      );
}

Android

在 Android 项目中，您需要在应用类中启动 Bifrost Flutter 引擎，并添加通用方法调用处理器：

import android.app.Application
import io.flutter.embedding.engine.FlutterEngine
import io.flutter.plugin.common.MethodChannel

class App : Application() {

  override fun onCreate() {
    super.onCreate()
    // 启动 Flutter 引擎
    Bifrost.startFlutterEngine(this, CommonHandler())
  }

  // 应用程序通用处理器
  private class CommonHandler : MethodChannel.MethodCallHandler {
    override fun onMethodCall(call: MethodCall, result: MethodChannel.Result) {
      when (call.method) {
        "getAppVersion" -> result.success(BuildConfig.VERSION_NAME)
      }
    }
  }
}

启动一个新的 Activity 并传递初始路由：

val intent = BifrostFlutterActivity.createIntent(this, "/greetings", arguments)
startActivity(intent)

创建一个新的 Fragment 实例并传递初始路由：

val fragment = BifrostFlutterFragment.newInstance("/first")

注册通知监听器：

Bifrost.registerNotification("doSomething") { arguments ->
  // 做一些事情
}

iOS

在 iOS 项目中，您需要在 AppDelegate 中启动 Bifrost Flutter 引擎，并添加通用方法调用处理器：

import UIKit
import bifrost

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    
    var window: UIWindow?
    
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
 
        // 启动 Bifrost Flutter 引擎
        Bifrost.startFlutterEngine(commonHandler: handle)
        
        return true
    }

    // 通用通道处理器
    private func handle(_ call: FlutterMethodCall, result: @escaping FlutterResult) {
        if (call.method == "getAppVersion") {
            let version = Bundle.main.infoDictionary?["CFBundleShortVersionString"]
            result(version)
        }
    }
}

启动一个新的 ViewController 并传递初始路由：

let vc = BifrostFlutterViewController.init("/greetings", arguments: arguments)

如果使用 Storyboard，可以使用自定义属性。

注册通知监听器：

Bifrost.registerNotification("doSomething") { arguments in
  // 做一些事情
}

示例代码

以下是完整的示例代码：

// example/lib/main.dart
import 'package:bifrost/bifrost.dart';
import 'package:flutter/material.dart';

import 'pages/first_page.dart';
import 'pages/greetings_page.dart';
import 'pages/second_page.dart';

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: Bifrost.init(), // 初始化 Bifrost
      routes: routes,
      theme: theme,
    );
  }

  Map<String, WidgetBuilder> get routes => {
        '/first': (context) => FirstPage(),
        '/second': (context) => SecondPage(),
        '/greetings': (context) => GreetingsPage(),
      };

  ThemeData get theme => ThemeData(
        primaryColor: Colors.deepPurpleAccent,
        accentColor: Colors.deepPurpleAccent,
        appBarTheme: AppBarTheme(
          color: Colors.deepPurpleAccent,
        ),
      );
}