Flutter Engine
The Flutter Engine
|
#include <platform_view_android.h>
Public Member Functions | |
PlatformViewAndroid (PlatformView::Delegate &delegate, const flutter::TaskRunners &task_runners, const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade, bool use_software_rendering, uint8_t msaa_samples) | |
PlatformViewAndroid (PlatformView::Delegate &delegate, const flutter::TaskRunners &task_runners, const std::shared_ptr< PlatformViewAndroidJNI > &jni_facade, const std::shared_ptr< flutter::AndroidContext > &android_context) | |
Creates a new PlatformViewAndroid but using an existing Android GPU context to create new surfaces. This maximizes resource sharing between 2 PlatformViewAndroids of 2 Shells. | |
~PlatformViewAndroid () override | |
void | NotifyCreated (fml::RefPtr< AndroidNativeWindow > native_window) |
void | NotifySurfaceWindowChanged (fml::RefPtr< AndroidNativeWindow > native_window) |
void | NotifyChanged (const SkISize &size) |
void | NotifyDestroyed () override |
Used by embedders to notify the shell that the platform view has been destroyed. This notification used to collect the rendering surface and all associated resources. Frame scheduling is also suspended. | |
void | DispatchPlatformMessage (JNIEnv *env, std::string name, jobject message_data, jint message_position, jint response_id) |
void | DispatchEmptyPlatformMessage (JNIEnv *env, std::string name, jint response_id) |
void | DispatchSemanticsAction (JNIEnv *env, jint id, jint action, jobject args, jint args_position) |
void | RegisterExternalTexture (int64_t texture_id, const fml::jni::ScopedJavaGlobalRef< jobject > &surface_texture) |
void | RegisterImageTexture (int64_t texture_id, const fml::jni::ScopedJavaGlobalRef< jobject > &image_texture_entry) |
void | LoadDartDeferredLibrary (intptr_t loading_unit_id, std::unique_ptr< const fml::Mapping > snapshot_data, std::unique_ptr< const fml::Mapping > snapshot_instructions) override |
Loads the Dart shared library into the Dart VM. When the Dart library is loaded successfully, the Dart future returned by the originating loadLibrary() call completes. | |
void | LoadDartDeferredLibraryError (intptr_t loading_unit_id, const std::string error_message, bool transient) override |
Indicates to the dart VM that the request to load a deferred library with the specified loading unit id has failed. | |
void | UpdateAssetResolverByType (std::unique_ptr< AssetResolver > updated_asset_resolver, AssetResolver::AssetResolverType type) override |
Replaces the asset resolver handled by the engine's AssetManager of the specified type with updated_asset_resolver . The matching AssetResolver is removed and replaced with updated_asset_resolvers . | |
const std::shared_ptr< AndroidContext > & | GetAndroidContext () |
std::shared_ptr< PlatformMessageHandler > | GetPlatformMessageHandler () const override |
Specifies a delegate that will receive PlatformMessages from Flutter to the host platform. | |
Public Member Functions inherited from flutter::PlatformView | |
PlatformView (Delegate &delegate, const TaskRunners &task_runners) | |
Creates a platform view with the specified delegate and task runner. The base class by itself does not do much but is suitable for use in test environments where full platform integration may not be necessary. The platform view may only be created, accessed and destroyed on the platform task runner. | |
virtual | ~PlatformView () |
Destroys the platform view. The platform view is owned by the shell and will be destroyed by the same on the platform tasks runner. | |
void | DispatchPlatformMessage (std::unique_ptr< PlatformMessage > message) |
Used by embedders to dispatch a platform message to a running root isolate hosted by the engine. If an isolate is not running, the message is dropped. If there is no one on the other side listening on the channel, the message is dropped. When a platform message is dropped, any response handles associated with that message will be dropped as well. All users of platform messages must assume that message may not be delivered and/or their response handles may not be invoked. Platform messages are not buffered. | |
void | DispatchSemanticsAction (int32_t node_id, SemanticsAction action, fml::MallocMapping args) |
Used by embedders to dispatch an accessibility action to a running isolate hosted by the engine. | |
virtual void | SetSemanticsEnabled (bool enabled) |
Used by embedder to notify the running isolate hosted by the engine on the UI thread that the accessibility tree needs to be generated. | |
virtual void | SetAccessibilityFeatures (int32_t flags) |
Used by the embedder to specify the features to enable in the accessibility tree generated by the isolate. This information is forwarded to the root isolate hosted by the engine on the UI thread. | |
virtual void | SendChannelUpdate (const std::string &name, bool listening) |
Used by the framework to tell the embedder that it has registered a listener on a given channel. | |
void | SetViewportMetrics (int64_t view_id, const ViewportMetrics &metrics) |
Used by embedders to specify the updated viewport metrics for a view. In response to this call, on the raster thread, the rasterizer may need to be reconfigured to the updated viewport dimensions. On the UI thread, the framework may need to start generating a new frame for the updated viewport metrics as well. | |
void | NotifyCreated () |
Used by embedders to notify the shell that a platform view has been created. This notification is used to create a rendering surface and pick the client rendering API to use to render into this surface. No frames will be scheduled or rendered before this call. The surface must remain valid till the corresponding call to NotifyDestroyed. | |
void | ScheduleFrame () |
Used by embedders to schedule a frame. In response to this call, the framework may need to start generating a new frame. | |
void | AddView (int64_t view_id, const ViewportMetrics &viewport_metrics, AddViewCallback callback) |
Used by embedders to notify the shell of a new non-implicit view. | |
void | RemoveView (int64_t view_id, RemoveViewCallback callback) |
Used by embedders to notify the shell of a removed non-implicit view. | |
virtual PointerDataDispatcherMaker | GetDispatcherMaker () |
Returns a platform-specific PointerDataDispatcherMaker so the Engine can construct the PointerDataPacketDispatcher based on platforms. | |
fml::WeakPtr< PlatformView > | GetWeakPtr () const |
Returns a weak pointer to the platform view. Since the platform view may only be created, accessed and destroyed on the platform thread, any access to the platform view from a non-platform task runner needs a weak pointer to the platform view along with a reference to the platform task runner. A task must be posted to the platform task runner with the weak pointer captured in the same. The platform view method may only be called in the posted task once the weak pointer validity has been checked. This method is used by callers to obtain that weak pointer. | |
void | SetNextFrameCallback (const fml::closure &closure) |
Sets a callback that gets executed when the rasterizer renders the next frame. Due to the asynchronous nature of rendering in Flutter, embedders usually add a placeholder over the contents in which Flutter is going to render when Flutter is first initialized. This callback may be used as a signal to remove that placeholder. The callback is executed on the render task runner and not the platform task runner. It is the embedder's responsibility to re-thread as necessary. | |
void | DispatchPointerDataPacket (std::unique_ptr< PointerDataPacket > packet) |
Dispatches pointer events from the embedder to the framework. Each pointer data packet may contain multiple pointer input events. Each call to this method wakes up the UI thread. | |
void | RegisterTexture (std::shared_ptr< flutter::Texture > texture) |
Used by the embedder to specify a texture that it wants the rasterizer to composite within the Flutter layer tree. All textures must have a unique identifier. When the rasterizer encounters an external texture within its hierarchy, it gives the embedder a chance to update that texture on the raster thread before it composites the same on-screen. | |
void | UnregisterTexture (int64_t texture_id) |
Used by the embedder to notify the rasterizer that it will no longer attempt to composite the specified texture within the layer tree. This allows the rasterizer to collect associated resources. | |
void | MarkTextureFrameAvailable (int64_t texture_id) |
Used by the embedder to notify the rasterizer that the context of the previously registered texture have been updated. Typically, Flutter will only render a frame if there is an updated layer tree. However, in cases where the layer tree is static but one of the externally composited textures has been updated by the embedder, the embedder needs to notify the rasterizer to render a new frame. In such cases, the existing layer tree may be reused with the frame re-composited with all updated external textures. Unlike the calls to register and unregister the texture, this call must be made each time a new texture frame is available. | |
const Settings & | GetSettings () const |
Get the settings for this platform view instance. | |
Static Public Member Functions | |
static bool | Register (JNIEnv *env) |
Private Member Functions | |
void | UpdateSemantics (flutter::SemanticsNodeUpdates update, flutter::CustomAccessibilityActionUpdates actions) override |
Used by the framework to tell the embedder to apply the specified semantics node updates. The default implementation of this method does nothing. | |
void | HandlePlatformMessage (std::unique_ptr< flutter::PlatformMessage > message) override |
Overridden by embedders to perform actions in response to platform messages sent from the framework to the embedder. Default implementation of this method simply returns an empty response. | |
void | OnPreEngineRestart () const override |
Gives embedders a chance to react to a "cold restart" of the running isolate. The default implementation of this method does nothing. | |
std::unique_ptr< VsyncWaiter > | CreateVSyncWaiter () override |
Invoked by the shell to obtain a platform specific vsync waiter. It is optional for platforms to override this method and provide a custom vsync waiter because a timer based fall-back waiter is used by default. However, it is highly recommended that platform provide their own Vsync waiter as the timer based fall-back will not render frames aligned with vsync boundaries. | |
std::unique_ptr< Surface > | CreateRenderingSurface () override |
std::shared_ptr< ExternalViewEmbedder > | CreateExternalViewEmbedder () override |
std::unique_ptr< SnapshotSurfaceProducer > | CreateSnapshotSurfaceProducer () override |
Creates an object that produces surfaces suitable for raster snapshotting. The rasterizer will request this surface if no on screen surface is currently available when an application requests a snapshot, e.g. if Scene.toImage or Picture.toImage are called while the application is in the background. | |
sk_sp< GrDirectContext > | CreateResourceContext () const override |
Used by the shell to obtain a Skia GPU context that is capable of operating on the IO thread. The context must be in the same share-group as the Skia GPU context used on the render thread. This context will always be used on the IO thread. Because it is in the same share-group as the separate render thread context, any GPU resources uploaded in this context will be visible to the render thread context (synchronization of GPU resources is managed by Skia). | |
void | ReleaseResourceContext () const override |
Used by the shell to notify the embedder that the resource context previously obtained via a call to CreateResourceContext() is being collected. The embedder is free to collect an platform specific resources associated with this context. | |
std::shared_ptr< impeller::Context > | GetImpellerContext () const override |
std::unique_ptr< std::vector< std::string > > | ComputePlatformResolvedLocales (const std::vector< std::string > &supported_locale_data) override |
Directly invokes platform-specific APIs to compute the locale the platform would have natively resolved to. | |
void | RequestDartDeferredLibrary (intptr_t loading_unit_id) override |
Invoked when the dart VM requests that a deferred library be loaded. Notifies the engine that the deferred library identified by the specified loading unit id should be downloaded and loaded into the Dart VM via LoadDartDeferredLibrary | |
double | GetScaledFontSize (double unscaled_font_size, int configuration_id) const override |
Synchronously invokes platform-specific APIs to apply the system text scaling on the given unscaled font size. | |
Additional Inherited Members | |
Public Types inherited from flutter::PlatformView | |
using | AddViewCallback = std::function< void(bool added)> |
using | RemoveViewCallback = std::function< void(bool removed)> |
Protected Attributes inherited from flutter::PlatformView | |
PlatformView::Delegate & | delegate_ |
const TaskRunners | task_runners_ |
PointerDataPacketConverter | pointer_data_packet_converter_ |
fml::WeakPtrFactory< PlatformView > | weak_factory_ |
Definition at line 42 of file platform_view_android.h.
flutter::PlatformViewAndroid::PlatformViewAndroid | ( | PlatformView::Delegate & | delegate, |
const flutter::TaskRunners & | task_runners, | ||
const std::shared_ptr< PlatformViewAndroidJNI > & | jni_facade, | ||
bool | use_software_rendering, | ||
uint8_t | msaa_samples | ||
) |
Definition at line 91 of file platform_view_android.cc.
flutter::PlatformViewAndroid::PlatformViewAndroid | ( | PlatformView::Delegate & | delegate, |
const flutter::TaskRunners & | task_runners, | ||
const std::shared_ptr< PlatformViewAndroidJNI > & | jni_facade, | ||
const std::shared_ptr< flutter::AndroidContext > & | android_context | ||
) |
Creates a new PlatformViewAndroid but using an existing Android GPU context to create new surfaces. This maximizes resource sharing between 2 PlatformViewAndroids of 2 Shells.
Definition at line 111 of file platform_view_android.cc.
|
overridedefault |
|
overrideprivatevirtual |
Directly invokes platform-specific APIs to compute the locale the platform would have natively resolved to.
[in] | supported_locale_data | The vector of strings that represents the locales supported by the app. Each locale consists of three strings: languageCode, countryCode, and scriptCode in that order. |
Reimplemented from flutter::PlatformView.
Definition at line 401 of file platform_view_android.cc.
|
overrideprivatevirtual |
Reimplemented from flutter::PlatformView.
Definition at line 349 of file platform_view_android.cc.
|
overrideprivatevirtual |
Reimplemented from flutter::PlatformView.
Definition at line 339 of file platform_view_android.cc.
|
overrideprivatevirtual |
Used by the shell to obtain a Skia GPU context that is capable of operating on the IO thread. The context must be in the same share-group as the Skia GPU context used on the render thread. This context will always be used on the IO thread. Because it is in the same share-group as the separate render thread context, any GPU resources uploaded in this context will be visible to the render thread context (synchronization of GPU resources is managed by Skia).
If such context cannot be created on the IO thread, callers may return nullptr
. This will mean that all texture uploads will be queued onto the render thread which will cause performance issues. When this context is nullptr
, an error is logged to the console. It is highly recommended that all platforms provide a resource context.
nullptr
in case such a context cannot be created. Reimplemented from flutter::PlatformView.
Definition at line 364 of file platform_view_android.cc.
|
overrideprivatevirtual |
Creates an object that produces surfaces suitable for raster snapshotting. The rasterizer will request this surface if no on screen surface is currently available when an application requests a snapshot, e.g. if Scene.toImage
or Picture.toImage
are called while the application is in the background.
Not all backends support this kind of surface usage, and the default implementation returns nullptr. Platforms should override this if they can support GPU operations in the background and support GPU resource context usage.
Reimplemented from flutter::PlatformView.
Definition at line 356 of file platform_view_android.cc.
|
overrideprivatevirtual |
Invoked by the shell to obtain a platform specific vsync waiter. It is optional for platforms to override this method and provide a custom vsync waiter because a timer based fall-back waiter is used by default. However, it is highly recommended that platform provide their own Vsync waiter as the timer based fall-back will not render frames aligned with vsync boundaries.
Reimplemented from flutter::PlatformView.
Definition at line 334 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::DispatchEmptyPlatformMessage | ( | JNIEnv * | env, |
std::string | name, | ||
jint | response_id | ||
) |
Definition at line 224 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::DispatchPlatformMessage | ( | JNIEnv * | env, |
std::string | name, | ||
jobject | message_data, | ||
jint | message_position, | ||
jint | response_id | ||
) |
Definition at line 203 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::DispatchSemanticsAction | ( | JNIEnv * | env, |
jint | id, | ||
jint | action, | ||
jobject | args, | ||
jint | args_position | ||
) |
Definition at line 250 of file platform_view_android.cc.
|
inline |
Definition at line 114 of file platform_view_android.h.
|
overrideprivatevirtual |
Reimplemented from flutter::PlatformView.
Definition at line 391 of file platform_view_android.cc.
|
inlineoverridevirtual |
Specifies a delegate that will receive PlatformMessages from Flutter to the host platform.
If this returns null
that means PlatformMessages should be sent to the PlatformView. That is to protect legacy behavior, any embedder that wants to support executing Platform Channel handlers on background threads should be returning a thread-safe PlatformMessageHandler instead.
Reimplemented from flutter::PlatformView.
Definition at line 118 of file platform_view_android.h.
|
overrideprivatevirtual |
Synchronously invokes platform-specific APIs to apply the system text scaling on the given unscaled font size.
Platforms that support this feature (currently it's only implemented for Android SDK level 34+) will send a valid configuration_id to potential callers, before this method can be called.
[in] | unscaled_font_size | The unscaled font size specified by the app developer. The value is in logical pixels, and is guaranteed to be finite and non-negative. |
[in] | configuration_id | The unique id of the configuration to use for computing the scaled font size. |
Reimplemented from flutter::PlatformView.
Definition at line 460 of file platform_view_android.cc.
|
overrideprivatevirtual |
Overridden by embedders to perform actions in response to platform messages sent from the framework to the embedder. Default implementation of this method simply returns an empty response.
Embedders that wish to send platform messages to the framework may use the DispatchPlatformMessage
method. This method is for messages that go the other way.
[in] | message | The message |
Reimplemented from flutter::PlatformView.
Definition at line 239 of file platform_view_android.cc.
|
overridevirtual |
Loads the Dart shared library into the Dart VM. When the Dart library is loaded successfully, the Dart future returned by the originating loadLibrary() call completes.
The Dart compiler may generate separate shared libraries files called 'loading units' when libraries are imported as deferred. Each of these shared libraries are identified by a unique loading unit id. Callers should open and resolve a SymbolMapping from the shared library. The Mappings should be moved into this method, as ownership will be assumed by the dart isolate after successful loading and released after shutdown of the dart isolate. If loading fails, the mappings will naturally go out of scope.
This method is paired with a RequestDartDeferredLibrary invocation that provides the embedder with the loading unit id of the deferred library to load.
[in] | loading_unit_id | The unique id of the deferred library's loading unit, as passed in by RequestDartDeferredLibrary. |
[in] | snapshot_data | Dart snapshot data of the loading unit's shared library. |
[in] | snapshot_data | Dart snapshot instructions of the loading unit's shared library. |
Reimplemented from flutter::PlatformView.
Definition at line 416 of file platform_view_android.cc.
|
overridevirtual |
Indicates to the dart VM that the request to load a deferred library with the specified loading unit id has failed.
The dart future returned by the initiating loadLibrary() call will complete with an error.
[in] | loading_unit_id | The unique id of the deferred library's loading unit, as passed in by RequestDartDeferredLibrary. |
[in] | error_message | The error message that will appear in the dart Future. |
[in] | transient | A transient error is a failure due to temporary conditions such as no network. Transient errors allow the dart VM to re-request the same deferred library and loading_unit_id again. Non-transient errors are permanent and attempts to re-request the library will instantly complete with an error. |
Reimplemented from flutter::PlatformView.
Definition at line 425 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::NotifyChanged | ( | const SkISize & | size | ) |
Definition at line 189 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::NotifyCreated | ( | fml::RefPtr< AndroidNativeWindow > | native_window | ) |
Definition at line 137 of file platform_view_android.cc.
|
overridevirtual |
Used by embedders to notify the shell that the platform view has been destroyed. This notification used to collect the rendering surface and all associated resources. Frame scheduling is also suspended.
Reimplemented from flutter::PlatformView.
Definition at line 174 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::NotifySurfaceWindowChanged | ( | fml::RefPtr< AndroidNativeWindow > | native_window | ) |
Definition at line 156 of file platform_view_android.cc.
|
overrideprivatevirtual |
Gives embedders a chance to react to a "cold restart" of the running isolate. The default implementation of this method does nothing.
While a "hot restart" patches a running isolate, a "cold restart" restarts the root isolate in a running shell.
Reimplemented from flutter::PlatformView.
Definition at line 246 of file platform_view_android.cc.
|
static |
Definition at line 1027 of file platform_view_android_jni_impl.cc.
void flutter::PlatformViewAndroid::RegisterExternalTexture | ( | int64_t | texture_id, |
const fml::jni::ScopedJavaGlobalRef< jobject > & | surface_texture | ||
) |
Definition at line 277 of file platform_view_android.cc.
void flutter::PlatformViewAndroid::RegisterImageTexture | ( | int64_t | texture_id, |
const fml::jni::ScopedJavaGlobalRef< jobject > & | image_texture_entry | ||
) |
Definition at line 302 of file platform_view_android.cc.
|
overrideprivatevirtual |
Used by the shell to notify the embedder that the resource context previously obtained via a call to CreateResourceContext()
is being collected. The embedder is free to collect an platform specific resources associated with this context.
Reimplemented from flutter::PlatformView.
Definition at line 384 of file platform_view_android.cc.
|
overrideprivatevirtual |
Invoked when the dart VM requests that a deferred library be loaded. Notifies the engine that the deferred library identified by the specified loading unit id should be downloaded and loaded into the Dart VM via LoadDartDeferredLibrary
Upon encountering errors or otherwise failing to load a loading unit with the specified id, the failure should be directly reported to dart by calling LoadDartDeferredLibraryFailure
to ensure the waiting dart future completes with an error.
[in] | loading_unit_id | The unique id of the deferred library's loading unit. This id is to be passed back into LoadDartDeferredLibrary in order to identify which deferred library to load. |
Reimplemented from flutter::PlatformView.
Definition at line 408 of file platform_view_android.cc.
|
overridevirtual |
Replaces the asset resolver handled by the engine's AssetManager of the specified type
with updated_asset_resolver
. The matching AssetResolver is removed and replaced with updated_asset_resolvers
.
AssetResolvers should be updated when the existing resolver becomes obsolete and a newer one becomes available that provides updated access to the same type of assets as the existing one. This update process is meant to be performed at runtime.
If a null resolver is provided, nothing will be done. If no matching resolver is found, the provided resolver will be added to the end of the AssetManager resolvers queue. The replacement only occurs with the first matching resolver. Any additional matching resolvers are untouched.
[in] | updated_asset_resolver | The asset resolver to replace the resolver of matching type with. |
[in] | type | The type of AssetResolver to update. Only resolvers of the specified type will be replaced by the updated resolver. |
Reimplemented from flutter::PlatformView.
Definition at line 434 of file platform_view_android.cc.
|
overrideprivatevirtual |
Used by the framework to tell the embedder to apply the specified semantics node updates. The default implementation of this method does nothing.
[in] | updates | A map with the stable semantics node identifier as key and the node properties as the value. |
[in] | actions | A map with the stable semantics node identifier as key and the custom node action as the value. |
Reimplemented from flutter::PlatformView.
Definition at line 271 of file platform_view_android.cc.