public interface ActivityControlSurface
Activity
attaches to a FlutterEngine
.
An Activity
that contains a FlutterView
and associated FlutterEngine
should coordinate itself with the FlutterEngine
's ActivityControlSurface
.
Activity
is created, and its associated FlutterEngine
is executing
Dart code, the Activity
should invoke attachToActivity(
ExclusiveAppComponent, Lifecycle)
. At this point the FlutterEngine
is considered
"attached" to the Activity
and all ActivityAware
plugins are given access
to the Activity
.
Activity
is destroyed for configuration change purposes,
that Activity
should invoke detachFromActivityForConfigChanges()
, giving
each ActivityAware
plugin an opportunity to clean up its references before the
is destroyed
.
Activity
is recreated after configuration changes, that Activity
should invoke #reattachToActivityAfterConfigChange(Activity)
so that all ActivityAware
plugins can re-establish references to the Activity
.
Activity
is destroyed for non-configuration-change purposes, or when the
Activity
is no longer interested in displaying a FlutterEngine
's content,
the Activity
should invoke detachFromActivity()
.
Activity
is being attached while an existing ExclusiveAppComponent
is already attached, the existing ExclusiveAppComponent
is given a chance to detach
first via ExclusiveAppComponent.detachFromFlutterEngine()
before the new activity
attaches.
Activity
should also forward all Activity
calls that this ActivityControlSurface
supports, e.g., onRequestPermissionsResult(int, String[],
int[])
. These forwarded calls are made available to all ActivityAware
plugins that are
added to the attached FlutterEngine
.Modifier and Type | Method and Description |
---|---|
void |
attachToActivity(Activity activity,
androidx.lifecycle.Lifecycle lifecycle)
Deprecated.
Prefer using the
attachToActivity(ExclusiveAppComponent, Lifecycle) API to
avoid situations where multiple activities are driving the FlutterEngine simultaneously.
See https://github.com/flutter/flutter/issues/66192. |
void |
attachToActivity(ExclusiveAppComponent<Activity> exclusiveActivity,
androidx.lifecycle.Lifecycle lifecycle)
Call this method from the
ExclusiveAppComponent that is displaying the visual content
of the FlutterEngine that is associated with this ActivityControlSurface . |
void |
detachFromActivity()
|
void |
detachFromActivityForConfigChanges()
|
boolean |
onActivityResult(int requestCode,
int resultCode,
Intent data)
|
void |
onNewIntent(Intent intent)
|
boolean |
onRequestPermissionsResult(int requestCode,
String[] permissions,
int[] grantResult)
|
void |
onRestoreInstanceState(Bundle bundle)
Call this method from the
Activity or Fragment that is attached to this ActivityControlSurface 's FlutterEngine when Activity.onCreate(Bundle) or
Fragment#onCreate(Bundle) is invoked in the Activity or Fragment . |
void |
onSaveInstanceState(Bundle bundle)
|
void |
onUserLeaveHint()
|
@Deprecated void attachToActivity(@NonNull Activity activity, @NonNull androidx.lifecycle.Lifecycle lifecycle)
attachToActivity(ExclusiveAppComponent, Lifecycle)
API to
avoid situations where multiple activities are driving the FlutterEngine simultaneously.
See https://github.com/flutter/flutter/issues/66192.Activity
that is displaying the visual content of the FlutterEngine
that is associated with this ActivityControlSurface
.
Once an Activity
is created, and its associated FlutterEngine
is executing
Dart code, the Activity
should invoke this method. At that point the FlutterEngine
is considered "attached" to the Activity
and all ActivityAware
plugins are given access to the Activity
.
void attachToActivity(@NonNull ExclusiveAppComponent<Activity> exclusiveActivity, @NonNull androidx.lifecycle.Lifecycle lifecycle)
ExclusiveAppComponent
that is displaying the visual content
of the FlutterEngine
that is associated with this ActivityControlSurface
.
Once an ExclusiveAppComponent
is created, and its associated FlutterEngine
is executing Dart code, the ExclusiveAppComponent
should invoke this method. At that
point the FlutterEngine
is considered "attached" to the ExclusiveAppComponent
and all ActivityAware
plugins are given access to the ExclusiveAppComponent
's
Activity
.
This method differs from attachToActivity(Activity, Lifecycle)
in that it calls
back the existing ExclusiveAppComponent
to give it a chance to cleanly detach before a
new ExclusiveAppComponent
is attached.
void detachFromActivityForConfigChanges()
Activity
that is attached to this ActivityControlSurfaces
's FlutterEngine
when the Activity
is about to be
destroyed due to configuration changes.
This method gives each ActivityAware
plugin an opportunity to clean up its
references before the is destroyed
.
void detachFromActivity()
Activity
that is attached to this ActivityControlSurfaces
's FlutterEngine
when the Activity
is about to be
destroyed for non-configuration-change reasons.
This method gives each ActivityAware
plugin an opportunity to clean up its
references before the is destroyed
.
boolean onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResult)
boolean onActivityResult(int requestCode, int resultCode, @Nullable Intent data)
void onNewIntent(@NonNull Intent intent)
void onUserLeaveHint()
void onSaveInstanceState(@NonNull Bundle bundle)
void onRestoreInstanceState(@Nullable Bundle bundle)
Activity
or Fragment
that is attached to this ActivityControlSurface
's FlutterEngine
when Activity.onCreate(Bundle)
or
Fragment#onCreate(Bundle)
is invoked in the Activity
or Fragment
.