Flutter Mobile Development · Lesson

Native UI Integration

Explore techniques for embedding native platform views within your Flutter widget tree for highly customized user experiences.

Native UI Integration is a free Flutter Mobile Development lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Flutter Mobile Development learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.

Bridging Flutter and Native UI

Welcome to Native UI Integration! While Flutter offers a rich set of widgets, sometimes you might encounter a need to embed a pre-existing or highly specialized native Android or iOS UI component directly into your Flutter application.

This lesson explores how to achieve this, allowing you to leverage the best of both Flutter and native platforms.

Why Embed Native UI?

Why would you choose to embed native UI instead of building everything in Flutter? Here are some common reasons:

Performance: For highly optimized native components like complex map views, video players, or 3D rendering engines.
Complexity: When replicating a feature in Flutter would be overly difficult or time-consuming, especially for intricate platform-specific behaviors.
Existing Libraries: To leverage powerful, platform-specific UI libraries that do not have Flutter equivalents or robust plugins.
Specific Features: Accessing unique native UI elements not easily exposed via standard Flutter widgets or plugins.

It's a powerful tool for advanced integration challenges.

The `PlatformView` Widget

Flutter provides the abstract PlatformView widget as the foundation for embedding native UI. You won't use PlatformView directly, but it serves as the base for platform-specific implementations:

AndroidView for embedding native Android views.
UiKitView for embedding native iOS views.

These widgets act as a crucial bridge, allowing Flutter to render a native view within its own widget tree seamlessly.

Android: `AndroidView` Basics

On Android, you use the AndroidView widget to embed native views. For this to work, you need to register a PlatformViewFactory in your native Android project (Kotlin or Java).

This factory is responsible for creating instances of your native Android View or ViewGroup when Flutter requests it. Each native view needs a unique viewType string to identify it.

Android: Conceptual Setup

Setting up a native Android view for Flutter embedding involves a few key steps on the native side:

Create Native View: Develop your custom Android View or ViewGroup subclass.
Implement Factory: Create a PlatformViewFactory class that instantiates your native view.
Register Factory: Register this factory with a unique viewType in your MainActivity.kt or MainActivity.java.

This tells Flutter how to find and create your specific native UI component.

Flutter `AndroidView` Example

Here's how you'd use AndroidView in your Flutter code. This example assumes you've set up a native Android TextView named "myNativeTextView" via a factory in your Android project.

Try running this simple Flutter code (note: the native view will only appear if the corresponding Android setup is complete):

import 'package:flutter/material.dart';
import 'package:flutter/services.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Native Android View')),
        body: Center(
          child: SizedBox(
            width: 200,
            height: 100,
            child: AndroidView(
              viewType: 'myNativeTextView',
              layoutDirection: TextDirection.ltr,
              creationParams: <String, dynamic>{'text': 'Hello from Android!'},
              creationParamsCodec: const StandardMessageCodec(),
            ),
          ),
        ),
      ),
    );
  }
}

iOS: `UiKitView` Basics

For iOS, the equivalent widget is UiKitView. Similar to Android, you need to register a FlutterPlatformViewFactory in your native iOS project (Swift or Objective-C).

This factory is responsible for creating instances of your native iOS UIView when Flutter needs to display it. Each native view requires a unique viewIdentifier string.

iOS: Conceptual Setup

Integrating an iOS native view for Flutter embedding involves these steps on the native side:

Create Native View: Develop your custom iOS UIView or a UIView subclass.
Implement Factory: Create a FlutterPlatformViewFactory class that instantiates your native view.
Register Factory: Register this factory with a unique viewIdentifier in your AppDelegate.swift or GeneratedPluginRegistrant.m.

This allows Flutter to reference and embed your iOS UI component directly into its widget tree.

Communicating with Native Views

Once a native view is embedded, you'll often need your Flutter app to interact with it, and vice-versa. This communication typically happens using MethodChannels, similar to how Flutter communicates with native code in general.

You can send messages (method calls) from Flutter to the native view controller to update its state or trigger actions. Conversely, the native view can send messages back to Flutter to report events or data changes.

For instance, a native map view could send its current camera position to Flutter, or Flutter could tell it to zoom in.

Quick Check: When to Embed?

You're building a Flutter app and need to integrate a highly optimized 3D rendering engine available only as a native Android/iOS library. Which scenarios best describe when you would use Native UI Integration?

Recap: Native UI Integration

In this lesson, you learned about embedding native Android (AndroidView) and iOS (UiKitView) views within your Flutter application. This technique is invaluable for integrating highly specialized or performance-critical platform-specific UI components.

Remember to consider native UI integration when Flutter's widgets or existing plugins can't fully meet your needs for complex native UI functionality. It's a powerful way to extend your Flutter app's capabilities by bridging to the native platform.

Frequently asked questions

Is the “Native UI Integration” lesson free?

Yes — the full text of “Native UI Integration” is free to read here on the web, and the Flutter Mobile Development course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Flutter Mobile Development course, upgrade to CoddyKit PRO.

What will I learn in “Native UI Integration”?

Explore techniques for embedding native platform views within your Flutter widget tree for highly customized user experiences. You practise Flutter Mobile Development with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.

Do I need any experience to start Flutter Mobile Development?

No prior experience is required. Flutter Mobile Development on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.

How long does the “Native UI Integration” lesson take?

Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.

Can I write and run code in this Flutter Mobile Development lesson?

Yes. Every Flutter Mobile Development lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.

All lessons in this course

← Back to Flutter Mobile Development