flutter_boost.dart 6.25 KB
Newer Older
Jidong Chen's avatar
init  
Jidong Chen committed
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
/*
 * The MIT License (MIT)
 * 
 * Copyright (c) 2019 Alibaba Group
 * 
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */
import 'dart:async';
25
import 'dart:io';
Jidong Chen's avatar
init  
Jidong Chen committed
26 27

import 'package:flutter/material.dart';
Yacumima's avatar
dev  
Yacumima committed
28 29
import 'container/boost_container.dart';
import 'container/container_manager.dart';
Jidong Chen's avatar
init  
Jidong Chen committed
30

Yacumima's avatar
Yacumima committed
31
import 'channel/boost_channel.dart';
Jidong Chen's avatar
init  
Jidong Chen committed
32 33 34 35 36 37 38 39
import 'container/container_coordinator.dart';
import 'observers_holders.dart';

export 'container/boost_container.dart';
export 'container/container_manager.dart';

typedef Widget PageBuilder(String pageName, Map params, String uniqueId);

40
typedef Route PrePushRoute(
Yacumima's avatar
dev  
Yacumima committed
41
    String url, String uniqueId, Map params, Route route);
42 43

typedef void PostPushRoute(
Yacumima's avatar
dev  
Yacumima committed
44
    String url, String uniqueId, Map params, Route route, Future result);
45

Jidong Chen's avatar
init  
Jidong Chen committed
46
class FlutterBoost {
Jidong Chen's avatar
Jidong Chen committed
47

Jidong Chen's avatar
init  
Jidong Chen committed
48 49 50 51
  static final FlutterBoost _instance = FlutterBoost();
  final GlobalKey<ContainerManagerState> containerManagerKey =
      GlobalKey<ContainerManagerState>();
  final ObserversHolder _observersHolder = ObserversHolder();
Yacumima's avatar
Yacumima committed
52
  final BoostChannel _boostChannel = BoostChannel();
Jidong Chen's avatar
Jidong Chen committed
53

Jidong Chen's avatar
init  
Jidong Chen committed
54 55 56 57 58
  static FlutterBoost get singleton => _instance;

  static ContainerManagerState get containerManager =>
      _instance.containerManagerKey.currentState;

59 60
  static TransitionBuilder init(
      {TransitionBuilder builder,
Jidong Chen's avatar
Jidong Chen committed
61 62
        PrePushRoute prePush,
        PostPushRoute postPush}) {
Yacumima's avatar
Yacumima committed
63

64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83
    if(Platform.isAndroid){

      WidgetsBinding.instance.addPostFrameCallback((_){

        singleton.channel.invokeMethod<Map>('pageOnStart').then((Map pageInfo){

          if (pageInfo == null || pageInfo.isEmpty) return;

          if (pageInfo.containsKey("name") &&
              pageInfo.containsKey("params") &&
              pageInfo.containsKey("uniqueId")) {

            ContainerCoordinator.singleton.nativeContainerDidShow(
                pageInfo["name"], pageInfo["params"], pageInfo["uniqueId"]);
          }
        });
      });
    }

    
Jidong Chen's avatar
init  
Jidong Chen committed
84 85 86 87
    return (BuildContext context, Widget child) {
      assert(child is Navigator, 'child must be Navigator, what is wrong?');

      final BoostContainerManager manager = BoostContainerManager(
88 89 90 91
          key: _instance.containerManagerKey,
          initNavigator: child,
          prePushRoute: prePush,
          postPushRoute: postPush);
Jidong Chen's avatar
init  
Jidong Chen committed
92 93 94 95 96 97 98 99 100 101 102

      if (builder != null) {
        return builder(context, manager);
      } else {
        return manager;
      }
    };
  }

  ObserversHolder get observersHolder => _observersHolder;

Yacumima's avatar
Yacumima committed
103
  BoostChannel get channel => _boostChannel;
Jidong Chen's avatar
Jidong Chen committed
104

Yacumima's avatar
Yacumima committed
105 106
  FlutterBoost(){
    ContainerCoordinator(_boostChannel);
Jidong Chen's avatar
Jidong Chen committed
107 108
  }

Jidong Chen's avatar
init  
Jidong Chen committed
109 110 111 112 113 114 115 116 117 118
  ///Register a default page builder.
  void registerDefaultPageBuilder(PageBuilder builder) {
    ContainerCoordinator.singleton.registerDefaultPageBuilder(builder);
  }

  ///Register a map builders
  void registerPageBuilders(Map<String, PageBuilder> builders) {
    ContainerCoordinator.singleton.registerPageBuilders(builders);
  }

119
  Future<Map<dynamic,dynamic>> open(String url,{Map<dynamic,dynamic> urlParams,Map<dynamic,dynamic> exts}){
Jidong Chen's avatar
Jidong Chen committed
120

121
    Map<dynamic, dynamic> properties = new Map<dynamic, dynamic>();
Yacumima's avatar
Yacumima committed
122 123 124
    properties["url"] = url;
    properties["urlParams"] = urlParams;
    properties["exts"] = exts;
125
    return channel.invokeMethod<Map<dynamic,dynamic>>(
Yacumima's avatar
Yacumima committed
126
        'openPage', properties);
Jidong Chen's avatar
Jidong Chen committed
127 128
  }

129
  Future<bool> close(String id,{Map<dynamic,dynamic> result,Map<dynamic,dynamic> exts}){
Jidong Chen's avatar
Jidong Chen committed
130

Yacumima's avatar
Yacumima committed
131
    assert(id != null);
Jidong Chen's avatar
Jidong Chen committed
132

Jidong Chen's avatar
Jidong Chen committed
133
    BoostContainerSettings settings = containerManager?.onstageSettings;
134
    Map<dynamic, dynamic> properties = new Map<dynamic, dynamic>();
Jidong Chen's avatar
Jidong Chen committed
135 136

    if(exts == null){
137
      exts = Map<dynamic,dynamic>();
Jidong Chen's avatar
Jidong Chen committed
138 139 140 141 142 143 144 145
    }

    exts["params"] = settings.params;

    if(!exts.containsKey("animated")){
      exts["animated"] = true;
    }

Yacumima's avatar
Yacumima committed
146
    properties["uniqueId"] = id;
Jidong Chen's avatar
Jidong Chen committed
147

Yacumima's avatar
Yacumima committed
148 149
    if (result != null) {
      properties["result"] = result;
Jidong Chen's avatar
Jidong Chen committed
150
    }
Jidong Chen's avatar
Jidong Chen committed
151

Yacumima's avatar
Yacumima committed
152 153
    if (exts != null) {
      properties["exts"] = exts;
Jidong Chen's avatar
Jidong Chen committed
154
    }
Yacumima's avatar
Yacumima committed
155
    return channel.invokeMethod<bool>('closePage', properties);
Jidong Chen's avatar
init  
Jidong Chen committed
156 157
  }

Yacumima's avatar
dev  
Yacumima committed
158
  Future<bool> closeCurrent({Map<String,dynamic> result,Map<String,dynamic> exts}) {
Jidong Chen's avatar
Jidong Chen committed
159 160
    BoostContainerSettings settings = containerManager?.onstageSettings;
    if(exts == null){
Yacumima's avatar
dev  
Yacumima committed
161
      exts = Map<String,dynamic>();
Jidong Chen's avatar
Jidong Chen committed
162 163 164 165 166 167
    }
    exts["params"] = settings.params;
    if(!exts.containsKey("animated")){
      exts["animated"] = true;
    }
    return close(settings.uniqueId,result: result,exts: exts);
Jidong Chen's avatar
init  
Jidong Chen committed
168 169
  }

Yacumima's avatar
dev  
Yacumima committed
170
  Future<bool> closeByContext(BuildContext context,{Map<String,dynamic> result,Map<String,dynamic> exts}) {
Jidong Chen's avatar
Jidong Chen committed
171 172
    BoostContainerSettings settings = containerManager?.onstageSettings;
    if(exts == null){
Yacumima's avatar
dev  
Yacumima committed
173
      exts = Map<String,dynamic>();
Jidong Chen's avatar
Jidong Chen committed
174 175 176 177 178 179
    }
    exts["params"] = settings.params;
    if(!exts.containsKey("animated")){
      exts["animated"] = true;
    }
    return close(settings.uniqueId,result: result,exts: exts);
Jidong Chen's avatar
init  
Jidong Chen committed
180 181 182 183 184 185 186 187 188 189 190 191
  }

  ///register for Container changed callbacks
  VoidCallback addContainerObserver(BoostContainerObserver observer) =>
      _observersHolder.addObserver<BoostContainerObserver>(observer);

  ///register for Container lifecycle callbacks
  VoidCallback addBoostContainerLifeCycleObserver(
          BoostContainerLifeCycleObserver observer) =>
      _observersHolder.addObserver<BoostContainerLifeCycleObserver>(observer);

  ///register callbacks for Navigators push & pop
yangwu.jia's avatar
yangwu.jia committed
192 193
  void addBoostNavigatorObserver(NavigatorObserver observer) =>
      ContainerNavigatorObserver.boostObservers.add(observer);
Jidong Chen's avatar
fix  
Jidong Chen committed
194 195


Jidong Chen's avatar
init  
Jidong Chen committed
196
}