Make FlutterEngineGroup support more params (flutter#107394) (flutter#34663)

Author: Nayuta403

shell/platform/android/io/flutter/embedding/engine/FlutterEngine.java

@@ -393,7 +393,10 @@ private boolean isAttachedToJni() {
       @NonNull Context context,
       @NonNull DartEntrypoint dartEntrypoint,
       @Nullable String initialRoute,
-      @Nullable List<String> dartEntrypointArgs) {
+      @Nullable List<String> dartEntrypointArgs,
+      @Nullable PlatformViewsController platformViewsController,
+      boolean automaticallyRegisterPlugins,
+      boolean waitForRestorationData) {
     if (!isAttachedToJni()) {
       throw new IllegalStateException(
           "Spawn can only be called on a fully constructed FlutterEngine");
@@ -409,7 +412,11 @@ private boolean isAttachedToJni() {
         context, // Context.
         null, // FlutterLoader. A null value passed here causes the constructor to get it from the
         // FlutterInjector.
-        newFlutterJNI); // FlutterJNI.
+        newFlutterJNI, // FlutterJNI.
+        platformViewsController, // PlatformViewsController.
+        null, // String[]. The Dart VM has already started, this arguments will have no effect.
+        automaticallyRegisterPlugins, // boolean.
+        waitForRestorationData); // boolean
   }
 
   /**

shell/platform/android/io/flutter/embedding/engine/FlutterEngineGroup.java

@@ -11,6 +11,7 @@
 import io.flutter.FlutterInjector;
 import io.flutter.embedding.engine.dart.DartExecutor.DartEntrypoint;
 import io.flutter.embedding.engine.loader.FlutterLoader;
+import io.flutter.plugin.platform.PlatformViewsController;
 import java.util.ArrayList;
 import java.util.List;
 
@@ -142,20 +143,39 @@ public FlutterEngine createAndRunEngine(@NonNull Options options) {
     DartEntrypoint dartEntrypoint = options.getDartEntrypoint();
     String initialRoute = options.getInitialRoute();
     List<String> dartEntrypointArgs = options.getDartEntrypointArgs();
+    PlatformViewsController platformViewsController = options.getPlatformViewsController();
+    platformViewsController =
+        platformViewsController != null ? platformViewsController : new PlatformViewsController();
+    boolean automaticallyRegisterPlugins = options.getAutomaticallyRegisterPlugins();
+    boolean waitForRestorationData = options.getWaitForRestorationData();
 
     if (dartEntrypoint == null) {
       dartEntrypoint = DartEntrypoint.createDefault();
     }
 
     if (activeEngines.size() == 0) {
-      engine = createEngine(context);
+      engine =
+          createEngine(
+              context,
+              platformViewsController,
+              automaticallyRegisterPlugins,
+              waitForRestorationData);
       if (initialRoute != null) {
         engine.getNavigationChannel().setInitialRoute(initialRoute);
       }
       engine.getDartExecutor().executeDartEntrypoint(dartEntrypoint, dartEntrypointArgs);
     } else {
       engine =
-          activeEngines.get(0).spawn(context, dartEntrypoint, initialRoute, dartEntrypointArgs);
+          activeEngines
+              .get(0)
+              .spawn(
+                  context,
+                  dartEntrypoint,
+                  initialRoute,
+                  dartEntrypointArgs,
+                  platformViewsController,
+                  automaticallyRegisterPlugins,
+                  waitForRestorationData);
     }
 
     activeEngines.add(engine);
@@ -178,8 +198,19 @@ public void onEngineWillDestroy() {
   }
 
   @VisibleForTesting
-  /* package */ FlutterEngine createEngine(Context context) {
-    return new FlutterEngine(context);
+  /* package */ FlutterEngine createEngine(
+      Context context,
+      @NonNull PlatformViewsController platformViewsController,
+      boolean automaticallyRegisterPlugins,
+      boolean waitForRestorationData) {
+    return new FlutterEngine(
+        context, // Context.
+        null, // FlutterLoader.
+        null, // FlutterJNI.
+        platformViewsController, // PlatformViewsController.
+        null, // String[]. The Dart VM has already started, this arguments will have no effect.
+        automaticallyRegisterPlugins, // boolean.
+        waitForRestorationData); // boolean.
   }
 
   /** Options that control how a FlutterEngine should be created. */
@@ -188,6 +219,9 @@ public static class Options {
     @Nullable private DartEntrypoint dartEntrypoint;
     @Nullable private String initialRoute;
     @Nullable private List<String> dartEntrypointArgs;
+    @NonNull private PlatformViewsController platformViewsController;
+    private boolean automaticallyRegisterPlugins = true;
+    private boolean waitForRestorationData = false;
 
     public Options(@NonNull Context context) {
       this.context = context;
@@ -219,6 +253,28 @@ public List<String> getDartEntrypointArgs() {
       return dartEntrypointArgs;
     }
 
+    /** Manages platform views. */
+    public PlatformViewsController getPlatformViewsController() {
+      return platformViewsController;
+    }
+
+    /**
+     * If plugins are automatically registered, then they are registered during the {@link
+     * io.flutter.embedding.engine.FlutterEngine}'s constructor.
+     */
+    public boolean getAutomaticallyRegisterPlugins() {
+      return automaticallyRegisterPlugins;
+    }
+
+    /**
+     * The waitForRestorationData flag controls whether the engine delays responding to requests
+     * from the framework for restoration data until that data has been provided to the engine via
+     * {@code RestorationChannel.setRestorationData(byte[] data)}.
+     */
+    public boolean getWaitForRestorationData() {
+      return waitForRestorationData;
+    }
+
     /**
      * Setter for `dartEntrypoint` property.
      *
@@ -251,5 +307,41 @@ public Options setDartEntrypointArgs(List<String> dartEntrypointArgs) {
       this.dartEntrypointArgs = dartEntrypointArgs;
       return this;
     }
+
+    /**
+     * Setter for `platformViewsController` property.
+     *
+     * @param platformViewsController Manages platform views.
+     */
+    public Options setPlatformViewsController(
+        @NonNull PlatformViewsController platformViewsController) {
+      this.platformViewsController = platformViewsController;
+      return this;
+    }
+
+    /**
+     * Setter for `automaticallyRegisterPlugins` property.
+     *
+     * @param automaticallyRegisterPlugins If plugins are automatically registered, then they are
+     *     registered during the execution of {@link io.flutter.embedding.engine.FlutterEngine}'s
+     *     constructor.
+     */
+    public Options setAutomaticallyRegisterPlugins(boolean automaticallyRegisterPlugins) {
+      this.automaticallyRegisterPlugins = automaticallyRegisterPlugins;
+      return this;
+    }
+
+    /**
+     * Setter for `waitForRestorationData` property.
+     *
+     * @param waitForRestorationData The waitForRestorationData flag controls whether the engine
+     *     delays responding to requests from the framework for restoration data until that data has
+     *     been provided to the engine via {@code RestorationChannel.setRestorationData(byte[]
+     *     data)}.
+     */
+    public Options setWaitForRestorationData(boolean waitForRestorationData) {
+      this.waitForRestorationData = waitForRestorationData;
+      return this;
+    }
   }
 }