Everything in this doc and linked from this doc is experimental. These details WILL change. Do not use these instructions or APIs in production code because we will break you.

Flutter can be added to an Android app as a single View in an Activity's View hierarchy.

Before adding Flutter as a single View, you should consider if it is possible to add Flutter as a Fragment or an Activity to reduce your development burden.

• How to use a FlutterActivity
• How to use a FlutterFragment

If you really need to add Flutter as a single View then do the following.

Create and start a FlutterEngine by following the appropriate instructions. See the FlutterEngine page

// Instantiate a new FlutterView.
FlutterView flutterView = new FlutterView(this);

// Add your FlutterView wherever you'd like. In this case we add
// the FlutterView to a FrameLayout.
FrameLayout frameLayout = findViewById(R.id.framelayout);
frameLayout.addView(flutterView);

Your FlutterView will not render anything at this point because it is not backed by any particular Flutter app.

flutterView.attachToFlutterEngine(flutterEngine);

At this point you should see your Flutter UI rendering to your FlutterView, and touch interaction should work.

TODO(mattcarroll): update this info about the platform plugin

Fundamental communication between the Android platform and your Flutter app takes place over a MethodChannel with the name "flutter/platform". For example, Android's onPostResume() call must be forwarded over the flutterPlatformChannel with the message "AppLifecycleState.resumed".

  platformPlugin = new PlatformPlugin(activity);
  MethodChannel flutterPlatformChannel = new MethodChannel(
    flutterEngine.getDartExecutor(),
    "flutter/platform",
    JSONMethodCodec.INSTANCE
  );
  flutterPlatformChannel.setMethodCallHandler(platformPlugin);

TODO(mattcarroll)

TODO(mattcarroll)

TODO(mattcarroll)