io.flutter.embedding.android.FlutterAndroidComponentTest Class Reference

Public Member Functions
void	pluginsReceiveFlutterPluginBinding ()
void	activityAwarePluginsReceiveActivityBinding ()
void	normalLifecycleStepsDoNotTriggerADetachFromFlutterEngine ()
void	twoOverlappingFlutterActivitiesDoNotCrosstalk ()

Detailed Description

Definition at line 49 of file FlutterAndroidComponentTest.java.

Member Function Documentation

activityAwarePluginsReceiveActivityBinding()

void io.flutter.embedding.android.FlutterAndroidComponentTest.activityAwarePluginsReceiveActivityBinding ( )

inline

Definition at line 107 of file FlutterAndroidComponentTest.java.

                                                           {
    // ---- Test setup ----
    // Place a FlutterEngine in the static cache.
    FlutterLoader mockFlutterLoader = mock(FlutterLoader.class);
    FlutterJNI mockFlutterJni = mock(FlutterJNI.class);
    when(mockFlutterJni.isAttached()).thenReturn(true);
    FlutterEngine cachedEngine = spy(new FlutterEngine(ctx, mockFlutterLoader, mockFlutterJni));
    FlutterEngineCache.getInstance().put("my_flutter_engine", cachedEngine);
 
    // Add mock plugin.
    FlutterPlugin mockPlugin =
        mock(FlutterPlugin.class, withSettings().extraInterfaces(ActivityAware.class));
    ActivityAware activityAwarePlugin = (ActivityAware) mockPlugin;
    ActivityPluginBinding.OnSaveInstanceStateListener mockSaveStateListener =
        mock(ActivityPluginBinding.OnSaveInstanceStateListener.class);
 
    // Add a OnSaveStateListener when the Activity plugin binding is made available.
    doAnswer(
            new Answer() {
              @Override
              public Object answer(InvocationOnMock invocation) throws Throwable {
                ActivityPluginBinding binding =
                    (ActivityPluginBinding) invocation.getArguments()[0];
                binding.addOnSaveStateListener(mockSaveStateListener);
                return null;
              }
            })
        .when(activityAwarePlugin)
        .onAttachedToActivity(any(ActivityPluginBinding.class));
 
    cachedEngine.getPlugins().add(mockPlugin);
 
    // Create a fake Host, which is required by the delegate.
    FlutterActivityAndFragmentDelegate.Host fakeHost = new FakeHost(cachedEngine);
 
    FlutterActivityAndFragmentDelegate delegate = new FlutterActivityAndFragmentDelegate(fakeHost);
 
    // --- Execute the behavior under test ---
    // Push the delegate through all lifecycle methods all the way to destruction.
    delegate.onAttach(ctx);
 
    // Verify plugin was given an ActivityPluginBinding.
    ArgumentCaptor<ActivityPluginBinding> pluginBindingCaptor =
        ArgumentCaptor.forClass(ActivityPluginBinding.class);
    verify(activityAwarePlugin, times(1)).onAttachedToActivity(pluginBindingCaptor.capture());
    ActivityPluginBinding binding = pluginBindingCaptor.getValue();
    assertNotNull(binding.getActivity());
    assertNotNull(binding.getLifecycle());
 
    delegate.onRestoreInstanceState(null);
 
    // Verify that after Activity creation, the plugin was allowed to restore state.
    verify(mockSaveStateListener, times(1)).onRestoreInstanceState(isNull());
 
    delegate.onCreateView(null, null, null, 0, true);
    delegate.onStart();
    delegate.onResume();
    delegate.onPause();
    delegate.onStop();
    delegate.onSaveInstanceState(mock(Bundle.class));
 
    // Verify that the plugin was allowed to save state.
    verify(mockSaveStateListener, times(1)).onSaveInstanceState(any(Bundle.class));
 
    delegate.onDestroyView();
    delegate.onDetach();
 
    // Verify that the plugin was detached from the Activity.
    verify(activityAwarePlugin, times(1)).onDetachedFromActivity();
  }

normalLifecycleStepsDoNotTriggerADetachFromFlutterEngine()

void io.flutter.embedding.android.FlutterAndroidComponentTest.normalLifecycleStepsDoNotTriggerADetachFromFlutterEngine ( )

inline

Definition at line 179 of file FlutterAndroidComponentTest.java.

                                                                         {
    // ---- Test setup ----
    // Place a FlutterEngine in the static cache.
    FlutterLoader mockFlutterLoader = mock(FlutterLoader.class);
    FlutterJNI mockFlutterJni = mock(FlutterJNI.class);
    when(mockFlutterJni.isAttached()).thenReturn(true);
    FlutterEngine cachedEngine = spy(new FlutterEngine(ctx, mockFlutterLoader, mockFlutterJni));
    FlutterEngineCache.getInstance().put("my_flutter_engine", cachedEngine);
 
    // Create a fake Host, which is required by the delegate.
    FakeHost fakeHost = new FakeHost(cachedEngine);
 
    // Create the real object that we're testing.
    FlutterActivityAndFragmentDelegate delegate =
        spy(new FlutterActivityAndFragmentDelegate(fakeHost));
 
    // --- Execute the behavior under test ---
    // Push the delegate through all lifecycle methods all the way to destruction.
    delegate.onAttach(ctx);
    delegate.onRestoreInstanceState(null);
    delegate.onCreateView(null, null, null, 0, true);
    delegate.onStart();
    delegate.onResume();
    delegate.onPause();
    delegate.onStop();
    delegate.onDestroyView();
    delegate.onDetach();
 
    verify(delegate, never()).detachFromFlutterEngine();
  }

pluginsReceiveFlutterPluginBinding()

void io.flutter.embedding.android.FlutterAndroidComponentTest.pluginsReceiveFlutterPluginBinding ( )

inline

Definition at line 53 of file FlutterAndroidComponentTest.java.

                                                   {
    // ---- Test setup ----
    // Place a FlutterEngine in the static cache.
    FlutterLoader mockFlutterLoader = mock(FlutterLoader.class);
    FlutterJNI mockFlutterJni = mock(FlutterJNI.class);
    when(mockFlutterJni.isAttached()).thenReturn(true);
    FlutterEngine cachedEngine = spy(new FlutterEngine(ctx, mockFlutterLoader, mockFlutterJni));
    FlutterEngineCache.getInstance().put("my_flutter_engine", cachedEngine);
 
    // Add mock plugin.
    FlutterPlugin mockPlugin = mock(FlutterPlugin.class);
    cachedEngine.getPlugins().add(mockPlugin);
 
    // Create a fake Host, which is required by the delegate.
    FakeHost fakeHost = new FakeHost(cachedEngine);
    fakeHost.shouldDestroyEngineWithHost = true;
 
    // Create the real object that we're testing.
    FlutterActivityAndFragmentDelegate delegate = new FlutterActivityAndFragmentDelegate(fakeHost);
 
    // --- Execute the behavior under test ---
    // Push the delegate through all lifecycle methods all the way to destruction.
    delegate.onAttach(ctx);
 
    // Verify that the plugin is attached to the FlutterEngine.
    ArgumentCaptor<FlutterPlugin.FlutterPluginBinding> pluginBindingCaptor =
        ArgumentCaptor.forClass(FlutterPlugin.FlutterPluginBinding.class);
    verify(mockPlugin, times(1)).onAttachedToEngine(pluginBindingCaptor.capture());
    FlutterPlugin.FlutterPluginBinding binding = pluginBindingCaptor.getValue();
    assertNotNull(binding.getApplicationContext());
    assertNotNull(binding.getBinaryMessenger());
    assertNotNull(binding.getTextureRegistry());
    assertNotNull(binding.getPlatformViewRegistry());
 
    delegate.onRestoreInstanceState(null);
    delegate.onCreateView(null, null, null, 0, true);
    delegate.onStart();
    delegate.onResume();
    delegate.onPause();
    delegate.onStop();
    delegate.onDestroyView();
    delegate.onDetach();
 
    // Verify the plugin was detached from the FlutterEngine.
    pluginBindingCaptor = ArgumentCaptor.forClass(FlutterPlugin.FlutterPluginBinding.class);
    verify(mockPlugin, times(1)).onDetachedFromEngine(pluginBindingCaptor.capture());
    binding = pluginBindingCaptor.getValue();
    assertNotNull(binding.getApplicationContext());
    assertNotNull(binding.getBinaryMessenger());
    assertNotNull(binding.getTextureRegistry());
    assertNotNull(binding.getPlatformViewRegistry());
  }

twoOverlappingFlutterActivitiesDoNotCrosstalk()

void io.flutter.embedding.android.FlutterAndroidComponentTest.twoOverlappingFlutterActivitiesDoNotCrosstalk ( )

inline

Definition at line 211 of file FlutterAndroidComponentTest.java.

                                                              {
    // ---- Test setup ----
    // Place a FlutterEngine in the static cache.
    FlutterLoader mockFlutterLoader = mock(FlutterLoader.class);
    FlutterJNI mockFlutterJni = mock(FlutterJNI.class);
    when(mockFlutterJni.isAttached()).thenReturn(true);
    FlutterEngine cachedEngine = spy(new FlutterEngine(ctx, mockFlutterLoader, mockFlutterJni));
    FlutterEngineCache.getInstance().put("my_flutter_engine", cachedEngine);
    LifecycleChannel mockLifecycleChannel = mock(LifecycleChannel.class);
    when(cachedEngine.getLifecycleChannel()).thenReturn(mockLifecycleChannel);
 
    Intent intent = FlutterActivity.withCachedEngine("my_flutter_engine").build(ctx);
    ActivityController<FlutterActivity> activityController1 =
        Robolectric.buildActivity(FlutterActivity.class, intent);
    activityController1.create().start().resume();
 
    InOrder inOrder = inOrder(mockLifecycleChannel);
    inOrder.verify(mockLifecycleChannel, times(1)).appIsResumed();
    verifyNoMoreInteractions(mockLifecycleChannel);
 
    activityController1.pause();
    // Create a second instance on the same engine and start running it as well.
    ActivityController<FlutterActivity> activityController2 =
        Robolectric.buildActivity(FlutterActivity.class, intent);
    activityController2.create().start().resume();
 
    // From the onPause of the first activity.
    inOrder.verify(mockLifecycleChannel, times(1)).appIsInactive();
    // By creating the second activity, we should automatically detach the first activity.
    inOrder.verify(mockLifecycleChannel, times(1)).appIsDetached();
    // In order, the second activity then is resumed.
    inOrder.verify(mockLifecycleChannel, times(1)).appIsResumed();
    verifyNoMoreInteractions(mockLifecycleChannel);
 
    // The first activity goes through the normal lifecycles of destruction, but since we
    // detached the first activity during the second activity's creation, we should ignore the
    // first activity's destruction events to avoid crosstalk.
    activityController1.stop().destroy();
    verifyNoMoreInteractions(mockLifecycleChannel);
  }

---

The documentation for this class was generated from the following file:

• shell/platform/android/test/io/flutter/embedding/android/FlutterAndroidComponentTest.java