1. 前言

我们给 Android 接入 Flutter Boost 之后，现在我们来看看如何给 iOS 工程（OC）接入 Flutter Boost。

本文将简单梳理一下 iOS 工程接入的 Flutter Boost 的流程，以作为前文的补充。

参见前文：Flutter Boost 混合开发实践与源码解析（以 Android 为例），Flutter Module 也依旧用前文生成的，目录结构依旧如前文所述，不再赘述。

2. 接入

2.1 工程准备

准备一个配有 Cocoapods 的空白工程，在 Podfile 中配置我们之前准备好的 Flutter Module 作为依赖：

  1. flutter_application_path = '../flutter_module'
  2. load File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')
  4. target 'FlutterHybridiOS' do
  5.     install_all_flutter_pods(flutter_application_path)
  6. end

接着在工程根目录下运行 pod install ，即可集成上 Flutter Module。看到我们的 Pods 中多了以下几个模块，即说明集成成功。

image.png

如不了解 Cocoapods，请参见 CocoaPods 使用指南

2.2 实现路由类

这一块直接参照 Flutter Boost 官方提供的 example 就好了：https://github.com/alibaba/flutter_boost/blob/master/example/ios/Runner/PlatformRouterImp.h

PlatformRouterImp.h：

  1. #import <Foundation/Foundation.h>
  2. #import <UIKit/UIKit.h>
  3. #import <flutter_boost/FlutterBoost.h>
  5. NS_ASSUME_NONNULL_BEGIN
  7. @protocol FLBPlatform;
  9. /**
  10.  * 实现平台侧的页面打开和关闭，不建议直接使用用于页面打开，建议使用FlutterBoostPlugin中的open和close方法来打开或关闭页面；
  11.  * FlutterBoostPlugin带有页面返回数据的能力
  12.  */
  13. @interface PlatformRouterImp : NSObject<FLBPlatform>
  14. @property (nonatomic,strong) UINavigationController *navigationController;
  15. @end
  17. NS_ASSUME_NONNULL_END

PlatformRouterImp.m：

  1. #import "PlatformRouterImp.h"
  2. #import <flutter_boost/FlutterBoost.h>
  4. @interface PlatformRouterImp()
  5. @end
  7. @implementation PlatformRouterImp
  9. #pragma mark - Boost 1.5
  10. - (void)open:(NSString *)name
  11.    urlParams:(NSDictionary *)params
  12.         exts:(NSDictionary *)exts
  13.   completion:(void (^)(BOOL))completion
  14. {
  15.     BOOL animated = [exts[@"animated"] boolValue];
  16.     FLBFlutterViewContainer *vc = FLBFlutterViewContainer.new;
  17.     [vc setName:name params:params];
  18.     [self.navigationController pushViewController:vc animated:animated];
  19.     if(completion) completion(YES);
  20. }
  22. - (void)present:(NSString *)name
  23.    urlParams:(NSDictionary *)params
  24.         exts:(NSDictionary *)exts
  25.   completion:(void (^)(BOOL))completion
  26. {
  27.     BOOL animated = [exts[@"animated"] boolValue];
  28.     FLBFlutterViewContainer *vc = FLBFlutterViewContainer.new;
  29.     [vc setName:name params:params];
  30.     [self.navigationController presentViewController:vc animated:animated completion:^{
  31.         if(completion) completion(YES);
  32.     }];
  33. }
  35. - (void)close:(NSString *)uid
  36.        result:(NSDictionary *)result
  37.          exts:(NSDictionary *)exts
  38.    completion:(void (^)(BOOL))completion
  39. {
  40.     BOOL animated = [exts[@"animated"] boolValue];
  41.     animated = YES;
  42.     FLBFlutterViewContainer *vc = (id)self.navigationController.presentedViewController;
  43.     if([vc isKindOfClass:FLBFlutterViewContainer.class] && [vc.uniqueIDString isEqual: uid]){
  44.         [vc dismissViewControllerAnimated:animated completion:^{}];
  45.     }else{
  46.         [self.navigationController popViewControllerAnimated:animated];
  47.     }
  48. }
  49. @end

可以看到，Flutter Boost 支持常规 push，也支持打开模态弹窗，也支持手动 pop。

2.3 绑定路由管理

AppDelegate.h：

  1. #import <UIKit/UIKit.h>
  2. #import <flutter_boost/FlutterBoost.h>
  4. @interface AppDelegate : UIResponder <UIApplicationDelegate>
  5. @property (nullable, nonatomic, strong) UIWindow *window;
  6. @end

AppDelegate.m：

  1. #import "AppDelegate.h"
  2. #import "PlatformRouterImp.h"
  3. #import <flutter_boost/FlutterBoost.h>
  5. @interface AppDelegate ()
  7. @end
  9. @implementation AppDelegate
  11. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  13.     PlatformRouterImp *router = [PlatformRouterImp new];
  14.     [FlutterBoostPlugin.sharedInstance startFlutterWithPlatform:router
  15.                                                         onStart:^(FlutterEngine *engine) {
  17.                                                         }];
  18.     UITabBarController *tabVC = [[UITabBarController alloc] init];
  19.     UINavigationController *rvc = [[UINavigationController alloc] initWithRootViewController:tabVC];
  20.     router.navigationController = rvc;
  22.     return YES;
  23. }

3. 使用

  2. - (void)openClick:(UIButton *)button
  3. {
  4.     [FlutterBoostPlugin open:@"first" urlParams:@{kPageCallBackId:@"MycallbackId#1"} exts:@{@"animated":@(YES)} onPageFinished:^(NSDictionary *result) {
  5.         NSLog(@"call me when page finished, and your result is:%@", result);
  6.     } completion:^(BOOL f) {
  7.         NSLog(@"page is opened");
  8.     }];
  9. }
  11. - (void)openPresentClick:(UIButton *)button
  12. {
  13.     [FlutterBoostPlugin open:@"second" urlParams:@{@"present":@(YES),kPageCallBackId:@"MycallbackId#2"} exts:@{@"animated":@(YES)} onPageFinished:^(NSDictionary *result) {
  14.         NSLog(@"call me when page finished, and your result is:%@", result);
  15.     } completion:^(BOOL f) {
  16.         NSLog(@"page is presented");
  17.     }];
  18. }

同样的，这里可在 Native 端用两种不同的方式去打开我们在 Flutter Module 中注册好的路由名。

至此，我们成功在 iOS 工程中接入了 Flutter Boost，那就开启我们的混编之旅吧~