List the responsibilities of FlutterActivity

Overview

FlutterActivity

FlutterActivity

Key Responsibilities of FlutterActivity

1. Host the Flutter Engine

FlutterActivity

FlutterEngine

kotlinCopy
// Default — Flutter creates and manages the engine
class MainActivity : FlutterActivity()

2. Render Flutter UI via FlutterView

It attaches a

FlutterView

3. Lifecycle Management

FlutterActivity

kotlinCopy
// FlutterActivity internally forwards these to Dart/Flutter
override fun onResume() → notifies Flutter engine
override fun onPause() → suspends Flutter
override fun onDestroy() → cleans up FlutterEngine
override fun onBackPressed() → dispatches to Flutter's Navigator

4. Handle Platform Channels

It sets up the

BinaryMessenger

kotlinCopy
class MainActivity : FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)

        // Register platform channel
        MethodChannel(flutterEngine.dartExecutor.binaryMessenger, "com.example/battery")
            .setMethodCallHandler { call, result ->
                if (call.method == "getBatteryLevel") {
                    result.success(getBatteryLevel())
                } else {
                    result.notImplemented()
                }
            }
    }
}

5. Plugin Registration

FlutterActivity

GeneratedPluginRegistrant

kotlinCopy
// This is called automatically by FlutterActivity
GeneratedPluginRegistrant.registerWith(flutterEngine)

6. Handle Intent and Deep Links

kotlinCopy
class MainActivity : FlutterActivity() {
    override fun onNewIntent(intent: Intent) {
        super.onNewIntent(intent)
        // Handle deep links, push notification taps, etc.
    }
}

7. Configure Transparent Background / No History

kotlinCopy
// Configuring FlutterActivity via Intent
val intent = FlutterActivity
    .withNewEngine()
    .backgroundMode(FlutterActivityLaunchConfigs.BackgroundMode.transparent)
    .build(context)
startActivity(intent)

FlutterActivity vs FlutterFragment

Customizing FlutterActivity

kotlinCopy
class MainActivity : FlutterActivity() {
    // Change the Dart entrypoint
    override fun getDartEntrypointFunctionName() = "customMain"

    // Use a pre-warmed engine
    override fun provideFlutterEngine(context: Context): FlutterEngine? {
        return MyApp.flutterEngine // Shared pre-warmed engine
    }

    // Custom initial route
    override fun getInitialRoute() = "/onboarding"
}

Summary of Responsibilities

FlutterEngine

FlutterView

onResume

onPause

onDestroy

BinaryMessenger

GeneratedPluginRegistrant

onNewIntent

onBackPressed

FlutterSurfaceView

FlutterTextureView