`PlatformView.onFlutterViewAttached()` called multiple times for single instance on Android

[evil159]

Steps to reproduce

1. Run the app with flutter run on Android
2. Tap "Show Native View" button
3. Check logcat for "DummyNativeView" logs

sample_project.zip

Expected results

onFlutterViewAttached() should be called once per PlatformView instance.

Actual results

onFlutterViewAttached() is called multiple times for the same PlatformView instance:

Code sample

Code sample

lib/main.dart:

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(
      title: 'Platform View Test',
      home: const MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key});

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  bool _showNativeView = false;

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('Platform View Test'),
      ),
      body: Column(
        children: [
          ElevatedButton(
            onPressed: () {
              setState(() {
                _showNativeView = !_showNativeView;
              });
            },
            child: Text(_showNativeView ? 'Hide Native View' : 'Show Native View'),
          ),
          Expanded(
            child: _showNativeView
                ? const AndroidView(
                    viewType: 'dummy_native_view',
                    layoutDirection: TextDirection.ltr,
                  )
                : const Center(
                    child: Text('Native view hidden'),
                  ),
          ),
        ],
      ),
    );
  }
}

android/app/src/main/kotlin/com/example/platform_view_test/MainActivity.kt:

package com.example.platform_view_test

import io.flutter.embedding.android.FlutterActivity
import io.flutter.embedding.engine.FlutterEngine

class MainActivity : FlutterActivity() {
    override fun configureFlutterEngine(flutterEngine: FlutterEngine) {
        super.configureFlutterEngine(flutterEngine)
        flutterEngine
            .platformViewsController
            .registry
            .registerViewFactory("dummy_native_view", DummyNativeViewFactory())
    }
}

android/app/src/main/kotlin/com/example/platform_view_test/DummyNativeViewFactory.kt:

package com.example.platform_view_test

import android.content.Context
import android.util.Log
import io.flutter.plugin.common.StandardMessageCodec
import io.flutter.plugin.platform.PlatformView
import io.flutter.plugin.platform.PlatformViewFactory

class DummyNativeViewFactory : PlatformViewFactory(StandardMessageCodec.INSTANCE) {
    override fun create(context: Context, viewId: Int, args: Any?): PlatformView {
        Log.i("DummyNativeView", "Factory.create() called - viewId: $viewId")
        return DummyNativeView(context, viewId)
    }
}

android/app/src/main/kotlin/com/example/platform_view_test/DummyNativeView.kt:

package com.example.platform_view_test

import android.content.Context
import android.graphics.Color
import android.util.Log
import android.view.View
import android.widget.TextView
import io.flutter.plugin.platform.PlatformView

class DummyNativeView(context: Context, private val viewId: Int) : PlatformView {
    private val textView: TextView = TextView(context)

    init {
        Log.i("DummyNativeView", "[$viewId] Constructor called")
        textView.apply {
            text = "Native Android View #$viewId"
            textSize = 20f
            setTextColor(Color.WHITE)
            setBackgroundColor(Color.BLUE)
            setPadding(40, 40, 40, 40)
        }
    }

    override fun getView(): View {
        Log.i("DummyNativeView", "[$viewId] getView() called")
        return textView
    }

    override fun dispose() {
        Log.i("DummyNativeView", "[$viewId] dispose() called")
    }

    override fun onFlutterViewAttached(flutterView: View) {
        Log.i("DummyNativeView", "[$viewId] onFlutterViewAttached() called")
    }

    override fun onFlutterViewDetached() {
        Log.i("DummyNativeView", "[$viewId] onFlutterViewDetached() called")
    }
}

Screenshots or Video

Screenshots / Video demonstration

[Upload media here]

Logs

Logs

DummyNativeView: Factory.create() called - viewId: 0
DummyNativeView: [0] Constructor called
DummyNativeView: [0] getView() called
DummyNativeView: [0] onFlutterViewAttached() called
DummyNativeView: [0] onFlutterViewAttached() called  <-- DUPLICATE CALL

Flutter Doctor output

Doctor output

[✓] Flutter (Channel stable, 3.35.7, on macOS 26.0.1 25A362 darwin-arm64, locale en-US) [571ms]
    • Flutter version 3.35.7 on channel stable at /Users/romanlaitarenko/Developer/flutter
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision adc9010625 (2 weeks ago), 2025-10-21 14:16:03 -0400
    • Engine revision 035316565a
    • Dart version 3.9.2
    • DevTools version 2.48.0
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-swift-package-manager,
      enable-lldb-debugging

[!] Android toolchain - develop for Android devices (Android SDK version 36.0.0) [1,378ms]
    • Android SDK at /Users/romanlaitarenko/Library/Android/sdk
    • Emulator version 35.5.10.0 (build_id 13402964) (CL:N/A)
    • Platform android-36, build-tools 36.0.0
    • ANDROID_HOME = /Users/romanlaitarenko/Library/Android/sdk
    • Java binary at: /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home/bin/java
      This JDK is specified in your Flutter configuration.
      To change the current JDK, run: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment Temurin-17.0.16+8 (build 17.0.16+8)
    ! Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses

[✓] Xcode - develop for iOS and macOS (Xcode 26.1) [992ms]
    • Xcode at /Applications/Xcode.app/Contents/Developer
    • Build 17B55
    • CocoaPods version 1.16.2

[✗] Chrome - develop for the web (Cannot find Chrome executable at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome) [7ms]
    ! Cannot find Chrome. Try setting CHROME_EXECUTABLE to a Chrome executable.

[✓] Android Studio (version 2024.3) [7ms]
    • Android Studio at /Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 21.0.6+-13368085-b895.109)

[✓] Connected device (3 available) [6.3s]
    • sdk gphone16k arm64 (mobile) • emulator-5554                        • android-arm64 • Android 15 (API 35) (emulator)
    • iPhone 17 Pro (mobile)       • 2701564F-9AAF-40CA-8418-AB8BD4C02655 • ios           • com.apple.CoreSimulator.SimRuntime.iOS-26-1 (simulator)
    • macOS (desktop)              • macos                                • darwin-arm64  • macOS 26.0.1 25A362 darwin-arm64
    ! Error: Browsing on the local area network for Roman’s iPhone (2). Ensure the device is unlocked and attached with a cable or associated with the same local area network as this
      Mac.
      The device must be opted into Developer Mode to connect wirelessly. (code -27)

[✓] Network resources [269ms]
    • All expected network resources are available.

! Doctor found issues in 2 categories.

[danagbemava-nc]

Reproducible using the code sample provided above.

This may be working as intended, in which case it would need to be documented. Seems similar to #150855

flutter doctor -v

[✓] Flutter (Channel stable, 3.35.7, on macOS 26.1 25B5062e darwin-arm64, locale en-US) [1,037ms]
    • Flutter version 3.35.7 on channel stable at /Users/deanli/dev/stable
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision adc9010625 (2 weeks ago), 2025-10-21 14:16:03 -0400
    • Engine revision 035316565a
    • Dart version 3.9.2
    • DevTools version 2.48.0
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-lldb-debugging

[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0) [6.6s]
    • Android SDK at /Users/deanli/Library/Android/sdk
    • Emulator version 36.2.12.0 (build_id 14214601) (CL:N/A)
    • Platform android-36.1, build-tools 36.1.0
    • Java binary at: /Users/deanli/Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
      This is the JDK bundled with the latest Android Studio installation on this machine.
      To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment (build 21.0.8+-14196175-b1038.72)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 26.1) [2.4s]
    • Xcode at /Applications/Xcode-26.1.0-beta.2.app/Contents/Developer
    • Build 17B5035f
    • CocoaPods version 1.16.2

[✓] Chrome - develop for the web [12ms]
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Android Studio (version 2025.2) [11ms]
    • Android Studio at /Users/deanli/Applications/Android Studio.app/Contents
    • Flutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutter
    • Dart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dart
    • Java version OpenJDK Runtime Environment (build 21.0.8+-14196175-b1038.72)

[✓] VS Code (version 1.105.0) [9ms]
    • VS Code at /Applications/Visual Studio Code.app/Contents
    • Flutter extension version 3.120.0

[✓] Connected device (6 available) [14.2s]
    • sdk gphone64 arm64 (mobile)           • emulator-5554             • android-arm64  • Android 16 (API 36) (emulator)
    • Nexus (wireless) (mobile)             • 00008020-001875E83A38002E • ios            • iOS 18.6.2 22G100
    • iPhone 16 Pro Max (wireless) (mobile) • 00008140-00194CC23A68801C • ios            • iOS 26.1 23B82
    • Dean iPad (wireless) (mobile)         • 00008103-000825C811E3401E • ios            • iOS 26.1 23B5059e
    • macOS (desktop)                       • macos                     • darwin-arm64   • macOS 26.1 25B5062e darwin-arm64
    • Chrome (web)                          • chrome                    • web-javascript • Google Chrome 142.0.7444.60

[✓] Network resources [2.6s]
    • All expected network resources are available.

• No issues found!

[!] Flutter (Channel master, 3.38.0-1.0.pre-461, on macOS 26.1 25B5062e darwin-arm64, locale en-US) [3.5s]
    • Flutter version 3.38.0-1.0.pre-461 on channel master at /Users/deanli/dev/master
    ! Warning: `flutter` on your path resolves to /Users/deanli/dev/stable/bin/flutter, which is not inside your current Flutter SDK checkout at /Users/deanli/dev/master. Consider adding /Users/deanli/dev/master/bin to the front of your path.
    ! Warning: `dart` on your path resolves to /Users/deanli/dev/stable/bin/dart, which is not inside your current Flutter SDK checkout at /Users/deanli/dev/master. Consider adding /Users/deanli/dev/master/bin to the front of your path.
    • Upstream repository https://github.com/flutter/flutter.git
    • Framework revision 3ee372ceb5 (4 hours ago), 2025-11-06 23:44:36 -0500
    • Engine revision 3ee372ceb5
    • Dart version 3.11.0 (build 3.11.0-93.1.beta)
    • DevTools version 2.52.0
    • Feature flags: enable-web, enable-linux-desktop, enable-macos-desktop, enable-windows-desktop, enable-android, enable-ios, cli-animations, enable-native-assets, omit-legacy-version-file, enable-lldb-debugging
    • If those were intentional, you can disregard the above warnings; however it is recommended to use "git" directly to perform update checks and upgrades.

[✓] Android toolchain - develop for Android devices (Android SDK version 36.1.0) [1,667ms]
    • Android SDK at /Users/deanli/Library/Android/sdk
    • Emulator version 36.2.12.0 (build_id 14214601) (CL:N/A)
    • Platform android-36.1, build-tools 36.1.0
    • Java binary at: /Users/deanli/Applications/Android Studio.app/Contents/jbr/Contents/Home/bin/java
      This is the JDK bundled with the latest Android Studio installation on this machine.
      To manually set the JDK path, use: `flutter config --jdk-dir="path/to/jdk"`.
    • Java version OpenJDK Runtime Environment (build 21.0.8+-14196175-b1038.72)
    • All Android licenses accepted.

[✓] Xcode - develop for iOS and macOS (Xcode 26.1) [1,207ms]
    • Xcode at /Applications/Xcode-26.1.0-beta.2.app/Contents/Developer
    • Build 17B5035f
    • CocoaPods version 1.16.2

[✓] Chrome - develop for the web [6ms]
    • Chrome at /Applications/Google Chrome.app/Contents/MacOS/Google Chrome

[✓] Connected device (6 available) [7.6s]
    • sdk gphone64 arm64 (mobile)           • emulator-5554             • android-arm64  • Android 16 (API 36) (emulator)
    • Nexus (wireless) (mobile)             • 00008020-001875E83A38002E • ios            • iOS 18.6.2 22G100
    • iPhone 16 Pro Max (wireless) (mobile) • 00008140-00194CC23A68801C • ios            • iOS 26.1 23B82
    • Dean iPad (wireless) (mobile)         • 00008103-000825C811E3401E • ios            • iOS 26.1 23B5059e
    • macOS (desktop)                       • macos                     • darwin-arm64   • macOS 26.1 25B5062e darwin-arm64
    • Chrome (web)                          • chrome                    • web-javascript • Google Chrome 142.0.7444.60

[✓] Network resources [1,117ms]
    • All expected network resources are available.

! Doctor found issues in 1 category.

[reidbaker]

P1 to decide what the expected behavior should be. Documentation does not say what to expect for the number of calls. My first pass expectation would be onFlutterViewAttached can be called multiple times but I would expect a detach in between.

https://api.flutter.dev/javadoc/io/flutter/plugin/platform/PlatformView.html