Flutter:platform channel

2019-05-31 10:15:12 浏览数 (1)

Flutter使用了一个灵活的系统,允许您调用特定平台的API,无论在Android上的Java或Kotlin代码中,还是iOS上的ObjectiveC或Swift代码中均可用。

参考文献:Writing custom platform-specific code

Flutter与原生之间的通信依赖灵活的消息传递方式:

  • 应用的Flutter部分通过平台通道(platform channel)将消息发送到其应用程序的所在的宿主(iOS或Android)应用(原生应用)。
  • 宿主监听平台通道,并接收该消息。然后它会调用该平台的API,并将响应发送回客户端,即应用程序的Flutter部分。

平台通道

使用平台通道在Flutter(client)和原生(host)之间传递消息,如下图所示:

image.png

当在Flutter中调用原生方法时,调用信息通过平台通道传递到原生,原生收到调用信息后方可执行指定的操作,如需返回数据,则原生会将数据再通过平台通道传递给Flutter。值得注意的是消息传递是异步的,这确保了用户界面在消息传递时不会被挂起。

在客户端,MethodChannel API 可以发送与方法调用相对应的消息。 在宿主平台上,MethodChannel 在Android API 和 FlutterMethodChannel在 iOS API可以接收方法调用并返回结果。这些类可以帮助我们用很少的代码就能开发平台插件。

注意: 如果需要,方法调用(消息传递)可以是反向的,即宿主作为客户端调用Dart中实现的API。 quick_actions插件就是一个具体的例子。

创建一个新的应用程序项目 首先创建一个新的应用程序:

在终端中运行:flutter create systemversion 默认情况下,模板支持使用Java编写Android代码,或使用Objective-C编写iOS代码。要使用Kotlin或Swift,请使用-i和/或-a标志:

在终端中运行: flutter create -i swift -a kotlin systemversion

Flutter端代码

首先,我们构建通道。我们使用MethodChannel调用一个方法来返回系统版本。

通道的客户端和宿主通过通道构造函数中传递的通道名称进行连接。单个应用中使用的所有通道名称必须是唯一的; 我们建议在通道名称前加一个唯一的“域名前缀”,例如samples.flutter.io/systemVersion。

代码语言:javascript复制
import 'dart:async';

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

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

class MyApp extends StatefulWidget {
  // This widget is the root of your application.
  @override
  State<StatefulWidget> createState() {
    // TODO: implement createState
    return MyAppState();
  }
}

class MyAppState extends State<MyApp> {

static const platform = const MethodChannel('samples.flutter.io/systemVersion');
 // Get battery level.
  String _systemVersion = 'Unknown system version.';

// 我们调用通道上的方法,指定通过字符串标识符调用方法getSystemVersion。 
// 该调用可能失败(平台不支持平台API,例如在模拟器中运行时),
// 所以我们将invokeMethod调用包装在try-catch语句中
  Future<Null> _getSystemVersion() async {
    String systemVersion;
    try {
      final String result = await platform.invokeMethod('systemVersion');
      systemVersion = 'iOS当前系统 $result.';
    } on PlatformException catch (e) {
      systemVersion = "Failed to get system version: '${e.message}'.";
    }
    // 在setState中来更新用户界面状态systemVersion
    setState(() {
      _systemVersion = systemVersion;
    });
  }

// 我们在build创建包含一个小字体显示当前系统systemVersion
// 和一个用于刷新值的按钮的用户界面。
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
        title: 'Flutter Demo',
        theme: ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: Scaffold(
          appBar: AppBar(title: Text("platform channel:与原生交互"),),
          body: Center(
              
              child: new Column(
                children: <Widget>[
                  RaisedButton(
                onPressed: (){_getSystemVersion();},
                child: Text('show current systemVersion'),
              ),
              Text(_systemVersion),
                ],
              )
          ),
        )
    );
  }
}

iOS端代码

我们接着之前"获取当前系统版本"插件的示例,来完成iOS端API的实现。以下步骤使用Objective-C

首先打开Xcode中Flutter应用程序的iOS部分:

  1. 启动 Xcode
  2. 选择 File > Open…
  3. 定位到您 Flutter app目录, 然后选择里面的 iOS文件夹,点击 OK
  4. 确保Xcode项目的构建没有错误。
  5. 选择 Runner > Runner ,打开AppDelegate.m

接下来,在application didFinishLaunchingWithOptions:方法内部创建一个FlutterMethodChannel,并添加一个处理方法。 确保与在Flutter客户端使用的通道名称相同。

代码语言:javascript复制
// ----------  AppDelegate.m  ----------
#include "AppDelegate.h"
#include "GeneratedPluginRegistrant.h"

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    [GeneratedPluginRegistrant registerWithRegistry:self];
    FlutterViewController* controller = (FlutterViewController*)self.window.rootViewController;
    FlutterMethodChannel* systemVersionChannel = [FlutterMethodChannel
                                            methodChannelWithName:@"samples.flutter.io/systemVersion"
                                            binaryMessenger:controller];
    
    [systemVersionChannel setMethodCallHandler:^(FlutterMethodCall* call, FlutterResult result) {
        if ([@"systemVersion" isEqualToString:call.method]) {
            result([self getSystemVersion]); // 回调数据
        } else {
            result(FlutterMethodNotImplemented);
        }
    }];
  // Override point for customization after application launch.
  return [super application:application didFinishLaunchingWithOptions:launchOptions];
}

- (NSString *)getSystemVersion {
    UIDevice* device = UIDevice.currentDevice;
    NSLog(@"systemVersion==%@", device.systemVersion);
     return device.systemVersion;
}

@end

效果如下:

image.png

  • 本文作者: Dwyane
  • 本文链接: http://nihao6.top/2019/05/18/platformchannel/
  • 版权声明:本博客所有文章除特别声明外,均采用 CC BY-NC-SA 3.0 许可协议。转载请注明出处!

0 人点赞