| Flutter Linux Embedder |

Typedefs | Enumerations | Functions
fl_engine_private.h File Reference
`#include <glib-object.h>`
`#include "flutter/shell/platform/embedder/embedder.h"`
`#include "flutter/shell/platform/linux/fl_renderer.h"`
`#include "flutter/shell/platform/linux/fl_task_runner.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_dart_project.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_engine.h"`

Go to the source code of this file.

## Typedefs
typedef gboolean(* | FlEnginePlatformMessageHandler) (FlEngine *engine, const gchar *channel, GBytes *message, const FlutterPlatformMessageResponseHandle *response_handle, gpointer user_data)
typedef void(* | FlEngineUpdateSemanticsNodeHandler) (FlEngine *engine, const FlutterSemanticsNode *node, gpointer user_data)
typedef void(* | FlEngineOnPreEngineRestartHandler) (FlEngine *engine, gpointer user_data)

## Enumerations
enum | FlEngineError { FL_ENGINE_ERROR_FAILED }

## Functions
GQuark | fl_engine_error_quark (void) G_GNUC_CONST
FlEngine * | fl_engine_new (FlDartProject *project, FlRenderer *renderer)
FlutterEngineProcTable * | fl_engine_get_embedder_api (FlEngine *engine)
void | fl_engine_set_platform_message_handler (FlEngine *engine, FlEnginePlatformMessageHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
void | fl_engine_set_update_semantics_node_handler (FlEngine *engine, FlEngineUpdateSemanticsNodeHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
void | fl_engine_set_on_pre_engine_restart_handler (FlEngine *engine, FlEngineOnPreEngineRestartHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
gboolean | fl_engine_start (FlEngine *engine, GError **error)
void | fl_engine_send_window_metrics_event (FlEngine *engine, size_t width, size_t height, double pixel_ratio)
void | fl_engine_send_window_state_event (FlEngine *engine, gboolean visible, gboolean focused)
void | fl_engine_send_mouse_pointer_event (FlEngine *engine, FlutterPointerPhase phase, size_t timestamp, double x, double y, double scroll_delta_x, double scroll_delta_y, int64_t buttons)
void | fl_engine_send_pointer_pan_zoom_event (FlEngine *self, size_t timestamp, double x, double y, FlutterPointerPhase phase, double pan_x, double pan_y, double scale, double rotation)
void | fl_engine_send_key_event (FlEngine *engine, const FlutterKeyEvent *event, FlutterKeyEventCallback callback, void *user_data)
void | fl_engine_dispatch_semantics_action (FlEngine *engine, uint64_t id, FlutterSemanticsAction action, GBytes *data)
gboolean | fl_engine_send_platform_message_response (FlEngine *engine, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
void | fl_engine_send_platform_message (FlEngine *engine, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
GBytes * | fl_engine_send_platform_message_finish (FlEngine *engine, GAsyncResult *result, GError **error)
FlTaskRunner * | fl_engine_get_task_runner (FlEngine *engine)
void | fl_engine_execute_task (FlEngine *engine, FlutterTask *task)
gboolean | fl_engine_mark_texture_frame_available (FlEngine *engine, int64_t texture_id)
gboolean | fl_engine_register_external_texture (FlEngine *engine, int64_t texture_id)
gboolean | fl_engine_unregister_external_texture (FlEngine *engine, int64_t texture_id)
void | fl_engine_update_accessibility_features (FlEngine *engine, int32_t flags)
GPtrArray * | fl_engine_get_switches (FlEngine *engine)

## Typedef Documentation

## ◆ FlEngineOnPreEngineRestartHandler

typedef void(* FlEngineOnPreEngineRestartHandler) (FlEngine *engine, gpointer user_data)

FlEngineOnPreEngineRestartHandler: @engine: an #FlEngine. @user_data: (closure): data provided when registering this handler.

Function called right before the engine is restarted.

Definition at line 68 of file fl_engine_private.h.

## ◆ FlEnginePlatformMessageHandler

typedef gboolean(* FlEnginePlatformMessageHandler) (FlEngine *engine, const gchar *channel, GBytes *message, const FlutterPlatformMessageResponseHandle *response_handle, gpointer user_data)

FlEnginePlatformMessageHandler: @engine: an #FlEngine. @channel: channel message received on. @message: message content received from Dart. @response_handle: a handle to respond to the message with. @user_data: (closure): data provided when registering this handler.

Function called when platform messages are received.

Returns: TRUE if message has been accepted.

Definition at line 41 of file fl_engine_private.h.

## ◆ FlEngineUpdateSemanticsNodeHandler

typedef void(* FlEngineUpdateSemanticsNodeHandler) (FlEngine *engine, const FlutterSemanticsNode *node, gpointer user_data)

FlEngineUpdateSemanticsNodeHandler: @engine: an #FlEngine. @node: semantic node information. @user_data: (closure): data provided when registering this handler.

Function called when semantics node updates are received.

Definition at line 56 of file fl_engine_private.h.

## Enumeration Type Documentation

## ◆ FlEngineError

enum FlEngineError

FlEngineError: Errors for #FlEngine objects to set on failures.

Enumerator
FL_ENGINE_ERROR_FAILED |

Definition at line 23 of file fl_engine_private.h.

23 {
24 FL_ENGINE_ERROR_FAILED,
25 } FlEngineError;

## Function Documentation

## ◆ fl_engine_dispatch_semantics_action()

void fl_engine_dispatch_semantics_action | ( | FlEngine * | engine,
|  | uint64_t | id,
|  | FlutterSemanticsAction | action,
|  | GBytes * | data
| ) |  |

fl_engine_dispatch_semantics_action: @engine: an #FlEngine. @id: the semantics action identifier. @action: the action being dispatched. @data: (allow-none): data associated with the action.

Definition at line 851 of file fl_engine.cc.

854 {
855 g_return_if_fail(FL_IS_ENGINE(self));
856
857 if (self->engine == nullptr) {
858 return;
859 }
860
861 const uint8_t* action_data = nullptr;
862 size_t action_data_length = 0;
863 if (data != nullptr) {
864 action_data = static_cast<const uint8_t*>(
865 g_bytes_get_data(data, &action_data_length));
866 }
867
868 self->embedder_api.DispatchSemanticsAction(self->engine, id, action,
869 action_data, action_data_length);
870 }

References self.

Referenced by fl_accessible_node_perform_action_impl(), and TEST().

## ◆ fl_engine_error_quark()

GQuark fl_engine_error_quark | ( | void |  | ) |

Referenced by fl_engine_send_platform_message(), fl_engine_send_platform_message_response(), and fl_engine_start().

## ◆ fl_engine_execute_task()

void fl_engine_execute_task | ( | FlEngine * | engine,
|  | FlutterTask * | task
| ) |  |

fl_engine_execute_task: @engine: an #FlEngine. @task: a #FlutterTask to execute.

Executes given Flutter task.

Definition at line 904 of file fl_engine.cc.

904 {
905 g_return_if_fail(FL_IS_ENGINE(self));
906 self->embedder_api.RunTask(self->engine, task);
907 }

References self.

Referenced by fl_task_runner_process_expired_tasks_locked().

## ◆ fl_engine_get_embedder_api()

FlutterEngineProcTable* fl_engine_get_embedder_api | ( | FlEngine * | engine | ) |

fl_engine_get_embedder_api: @engine: an #FlEngine.

Gets the embedder API proc table, allowing modificiations for unit testing.

Returns: a mutable pointer to the embedder API proc table.

Definition at line 590 of file fl_engine.cc.

590 {
591 return &(self->embedder_api);
592 }

Referenced by TEST().

## ◆ fl_engine_get_switches()

GPtrArray* fl_engine_get_switches | ( | FlEngine * | engine | ) |

fl_engine_get_switches: @project: an #FlEngine.

Determines the switches that should be passed to the Flutter engine.

Returns: an array of switches to pass to the Flutter engine.

Definition at line 926 of file fl_engine.cc.

926 {
927 GPtrArray* switches = g_ptr_array_new_with_free_func(g_free);
928 for (const auto& env_switch : flutter::GetSwitchesFromEnvironment()) {
929 g_ptr_array_add(switches, g_strdup(env_switch.c_str()));
930 }
931 return switches;
932 }

References flutter::GetSwitchesFromEnvironment().

Referenced by fl_engine_start(), and TEST().

## ◆ fl_engine_get_task_runner()

FlTaskRunner* fl_engine_get_task_runner | ( | FlEngine * | engine | ) |

fl_engine_get_task_runner: @engine: an #FlEngine.

Returns
  : a #FlTaskRunner.

Returns: task runner responsible for scheduling Flutter tasks.

Definition at line 899 of file fl_engine.cc.

899 {
900 g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
901 return self->task_runner;
902 }

Referenced by fl_renderer_unblock_main_thread(), and fl_renderer_wait_for_frame().

## ◆ fl_engine_mark_texture_frame_available()

gboolean fl_engine_mark_texture_frame_available | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_mark_texture_frame_available: @engine: an #FlEngine. @texture_id: the identifier of the texture whose frame has been updated.

Tells the Flutter engine that a new texture frame is available for the given texture.

Returns: TRUE on success.

Definition at line 872 of file fl_engine.cc.

873 {
874 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
875 return self->embedder_api.MarkExternalTextureFrameAvailable(
876 self->engine, texture_id) == kSuccess;
877 }

References self, and texture_id.

Referenced by mark_texture_frame_available().

## ◆ fl_engine_new()

FlEngine* fl_engine_new | ( | FlDartProject * | project,
|  | FlRenderer * | renderer
| ) |  |

fl_engine_new: @project: an #FlDartProject. @renderer: an #FlRenderer.

Creates new Flutter engine.

Returns: a new #FlEngine.

Definition at line 466 of file fl_engine.cc.

466 {
467 g_return_val_if_fail(FL_IS_DART_PROJECT(project), nullptr);
468 g_return_val_if_fail(FL_IS_RENDERER(renderer), nullptr);
469
470 FlEngine* self = FL_ENGINE(g_object_new(fl_engine_get_type(), nullptr));
471 self->project = FL_DART_PROJECT(g_object_ref(project));
472 self->renderer = FL_RENDERER(g_object_ref(renderer));
473 self->binary_messenger = fl_binary_messenger_new(self);
474 return self;
475 }

References fl_binary_messenger_new().

Referenced by fl_engine_new_headless(), fl_view_constructed(), and make_mock_engine().

## ◆ fl_engine_register_external_texture()

gboolean fl_engine_register_external_texture | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_register_external_texture: @engine: an #FlEngine. @texture_id: the identifier of the texture that is available.

Tells the Flutter engine that a new external texture is available.

Returns: TRUE on success.

Definition at line 879 of file fl_engine.cc.

880 {
881 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
882 return self->embedder_api.RegisterExternalTexture(self->engine, texture_id) ==
883 kSuccess;
884 }

References self, and texture_id.

Referenced by register_texture().

## ◆ fl_engine_send_key_event()

void fl_engine_send_key_event | ( | FlEngine * | engine,
|  | const FlutterKeyEvent * | event,
|  | FlutterKeyEventCallback | callback,
|  | void * | user_data
| ) |  |

fl_engine_send_key_event:

Definition at line 838 of file fl_engine.cc.

841 {
842 g_return_if_fail(FL_IS_ENGINE(self));
843
844 if (self->engine == nullptr) {
845 return;
846 }
847
848 self->embedder_api.SendKeyEvent(self->engine, event, callback, user_data);
849 }

References callback, event, self, and user_data.

Referenced by fl_view_keyboard_delegate_iface_init().

## ◆ fl_engine_send_mouse_pointer_event()

void fl_engine_send_mouse_pointer_event | ( | FlEngine * | engine,
|  | FlutterPointerPhase | phase,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | double | scroll_delta_x,
|  | double | scroll_delta_y,
|  | int64_t | buttons
| ) |  |

fl_engine_send_mouse_pointer_event: @engine: an #FlEngine. @phase: mouse phase. @timestamp: time when event occurred in microseconds. @x: x location of mouse cursor. @y: y location of mouse cursor. @scroll_delta_x: x offset of scroll. @scroll_delta_y: y offset of scroll. @buttons: buttons that are pressed.

Sends a mouse pointer event to the engine.

Definition at line 777 of file fl_engine.cc.

784 {
785 g_return_if_fail(FL_IS_ENGINE(self));
786
787 if (self->engine == nullptr) {
788 return;
789 }
790
791 FlutterPointerEvent fl_event = {};
792 fl_event.struct_size = sizeof(fl_event);
793 fl_event.phase = phase;
794 fl_event.timestamp = timestamp;
795 fl_event.x = x;
796 fl_event.y = y;
797 if (scroll_delta_x != 0 || scroll_delta_y != 0) {
798 fl_event.signal_kind = kFlutterPointerSignalKindScroll;
799 }
800 fl_event.scroll_delta_x = scroll_delta_x;
801 fl_event.scroll_delta_y = scroll_delta_y;
802 fl_event.device_kind = kFlutterPointerDeviceKindMouse;
803 fl_event.buttons = buttons;
804 fl_event.device = kMousePointerDeviceId;
805 self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1);
806 }

References kMousePointerDeviceId, and self.

Referenced by check_pointer_inside(), fl_view_scrolling_delegate_iface_init(), leave_notify_event_cb(), motion_notify_event_cb(), send_pointer_button_event(), and TEST().

## ◆ fl_engine_send_platform_message()

void fl_engine_send_platform_message | ( | FlEngine * | engine,
|  | const gchar * | channel,
|  | GBytes * | message,
|  | GCancellable * | cancellable,
|  | GAsyncReadyCallback | callback,
|  | gpointer | user_data
| ) |  |

fl_engine_send_platform_message: @engine: an #FlEngine. @channel: channel to send to. @message: (allow-none): message buffer to send or NULL for an empty message @cancellable: (allow-none): a #GCancellable or NULL. @callback: (scope async): a #GAsyncReadyCallback to call when the request is satisfied. @user_data: (closure): user data to pass to @callback.

Asynchronously sends a platform message.

Definition at line 679 of file fl_engine.cc.

684 {
685 g_return_if_fail(FL_IS_ENGINE(self));
686
687 GTask* task = nullptr;
688 FlutterPlatformMessageResponseHandle* response_handle = nullptr;
689 if (callback != nullptr) {
690 task = g_task_new(self, cancellable, callback, user_data);
691
692 if (self->engine == nullptr) {
693 g_task_return_new_error(task, fl_engine_error_quark(),
694 FL_ENGINE_ERROR_FAILED, "No engine to send to");
695 return;
696 }
697
698 FlutterEngineResult result =
699 self->embedder_api.PlatformMessageCreateResponseHandle(
700 self->engine, fl_engine_platform_message_response_cb, task,
701 &response_handle);
702 if (result != kSuccess) {
703 g_task_return_new_error(task, fl_engine_error_quark(),
704 FL_ENGINE_ERROR_FAILED,
705 "Failed to create response handle");
706 g_object_unref(task);
707 return;
708 }
709 } else if (self->engine == nullptr) {
710 return;
711 }
712
713 FlutterPlatformMessage fl_message = {};
714 fl_message.struct_size = sizeof(fl_message);
715 fl_message.channel = channel;
716 fl_message.message =
717 message != nullptr
718 ? static_cast<const uint8_t*>(g_bytes_get_data(message, nullptr))
719 : nullptr;
720 fl_message.message_size = message != nullptr ? g_bytes_get_size(message) : 0;
721 fl_message.response_handle = response_handle;
722 FlutterEngineResult result =
723 self->embedder_api.SendPlatformMessage(self->engine, &fl_message);
724
725 if (result != kSuccess && task != nullptr) {
726 g_task_return_new_error(task, fl_engine_error_quark(),
727 FL_ENGINE_ERROR_FAILED,
728 "Failed to send platform messages");
729 g_object_unref(task);
730 }
731
732 if (response_handle != nullptr) {
733 self->embedder_api.PlatformMessageReleaseResponseHandle(self->engine,
734 response_handle);
735 }
736 }

References callback, FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_platform_message_response_cb(), result, self, and user_data.

Referenced by send_on_channel(), and TEST().

## ◆ fl_engine_send_platform_message_finish()

GBytes* fl_engine_send_platform_message_finish | ( | FlEngine * | engine,
|  | GAsyncResult * | result,
|  | GError ** | error
| ) |  |

fl_engine_send_platform_message_finish: @engine: an #FlEngine.

Returns
  : a #GAsyncResult. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Completes request started with fl_engine_send_platform_message().

Returns: message response on success or NULL on error.

Definition at line 738 of file fl_engine.cc.

740 {
741 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
742 g_return_val_if_fail(g_task_is_valid(result, self), FALSE);
743
744 return static_cast<GBytes*>(g_task_propagate_pointer(G_TASK(result), error));
745 }

References error, and result.

Referenced by send_on_channel_finish().

## ◆ fl_engine_send_platform_message_response()

gboolean fl_engine_send_platform_message_response | ( | FlEngine * | engine,
|  | const FlutterPlatformMessageResponseHandle * | handle,
|  | GBytes * | response,
|  | GError ** | error
| ) |  |

fl_engine_send_platform_message_response: @engine: an #FlEngine. @handle: handle that was provided in FlEnginePlatformMessageHandler. @response: (allow-none): response to send or NULL for an empty response. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Responds to a platform message.

Returns: TRUE on success.

Definition at line 647 of file fl_engine.cc.

651 {
652 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
653 g_return_val_if_fail(handle != nullptr, FALSE);
654
655 if (self->engine == nullptr) {
656 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
657 "No engine to send response to");
658 return FALSE;
659 }
660
661 gsize data_length = 0;
662 const uint8_t* data = nullptr;
663 if (response != nullptr) {
664 data =
665 static_cast<const uint8_t*>(g_bytes_get_data(response, &data_length));
666 }
667 FlutterEngineResult result = self->embedder_api.SendPlatformMessageResponse(
668 self->engine, handle, data, data_length);
669
670 if (result != kSuccess) {
671 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
672 "Failed to send platform message response");
673 return FALSE;
674 }
675
676 return TRUE;
677 }

References error, FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), result, self, and TRUE.

Referenced by fl_engine_platform_message_cb(), send_response(), and TEST().

## ◆ fl_engine_send_pointer_pan_zoom_event()

void fl_engine_send_pointer_pan_zoom_event | ( | FlEngine * | self,
|  | size_t | timestamp,
|  | double | x,
|  | double | y,
|  | FlutterPointerPhase | phase,
|  | double | pan_x,
|  | double | pan_y,
|  | double | scale,
|  | double | rotation
| ) |  |

Definition at line 808 of file fl_engine.cc.

816 {
817 g_return_if_fail(FL_IS_ENGINE(self));
818
819 if (self->engine == nullptr) {
820 return;
821 }
822
823 FlutterPointerEvent fl_event = {};
824 fl_event.struct_size = sizeof(fl_event);
825 fl_event.timestamp = timestamp;
826 fl_event.x = x;
827 fl_event.y = y;
828 fl_event.phase = phase;
829 fl_event.pan_x = pan_x;
830 fl_event.pan_y = pan_y;
831 fl_event.scale = scale;
832 fl_event.rotation = rotation;
833 fl_event.device = kPointerPanZoomDeviceId;
834 fl_event.device_kind = kFlutterPointerDeviceKindTrackpad;
835 self->embedder_api.SendPointerEvent(self->engine, &fl_event, 1);
836 }

References kPointerPanZoomDeviceId, and self.

Referenced by fl_view_scrolling_delegate_iface_init(), and TEST().

## ◆ fl_engine_send_window_metrics_event()

void fl_engine_send_window_metrics_event | ( | FlEngine * | engine,
|  | size_t | width,
|  | size_t | height,
|  | double | pixel_ratio
| ) |  |

fl_engine_send_window_metrics_event: @engine: an #FlEngine. @width: width of the window in pixels. @height: height of the window in pixels. @pixel_ratio: scale factor for window.

Sends a window metrics event to the engine.

Definition at line 759 of file fl_engine.cc.

762 {
763 g_return_if_fail(FL_IS_ENGINE(self));
764
765 if (self->engine == nullptr) {
766 return;
767 }
768
769 FlutterWindowMetricsEvent event = {};
770 event.struct_size = sizeof(FlutterWindowMetricsEvent);
771 event.width = width;
772 event.height = height;
773 event.pixel_ratio = pixel_ratio;
774 self->embedder_api.SendWindowMetricsEvent(self->engine, &event);
775 }

References event, height, self, and width.

Referenced by handle_geometry_changed(), and TEST().

## ◆ fl_engine_send_window_state_event()

void fl_engine_send_window_state_event | ( | FlEngine * | engine,
|  | gboolean | visible,
|  | gboolean | focused
| ) |  |

fl_engine_send_window_state_event: @engine: an #FlEngine. @visible: whether the window is currently visible or not. @focused: whether the window is currently focused or not.

Sends a window state event to the engine.

Definition at line 747 of file fl_engine.cc.

749 {
750 if (visible && focused) {
751 set_app_lifecycle_state(self, flutter::AppLifecycleState::kResumed);
752 } else if (visible) {
753 set_app_lifecycle_state(self, flutter::AppLifecycleState::kInactive);
754 } else {
755 set_app_lifecycle_state(self, flutter::AppLifecycleState::kHidden);
756 }
757 }

References flutter::kHidden, flutter::kInactive, flutter::kResumed, and set_app_lifecycle_state().

Referenced by TEST(), and window_state_event_cb().

## ◆ fl_engine_set_on_pre_engine_restart_handler()

void fl_engine_set_on_pre_engine_restart_handler | ( | FlEngine * | engine,
|  | FlEngineOnPreEngineRestartHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_on_pre_engine_restart_handler: @engine: an #FlEngine. @handler: function to call when the engine is restarted. @user_data: (closure): user data to pass to @handler. @destroy_notify: (allow-none): a function which gets called to free @user_data, or NULL.

Registers the function called right before the engine is restarted.

Definition at line 629 of file fl_engine.cc.

633 {
634 g_return_if_fail(FL_IS_ENGINE(self));
635
636 if (self->on_pre_engine_restart_handler_destroy_notify) {
637 self->on_pre_engine_restart_handler_destroy_notify(
638 self->on_pre_engine_restart_handler_data);
639 }
640
641 self->on_pre_engine_restart_handler = handler;
642 self->on_pre_engine_restart_handler_data = user_data;
643 self->on_pre_engine_restart_handler_destroy_notify = destroy_notify;
644 }

References self, and user_data.

Referenced by fl_view_constructed(), fl_view_dispose(), and TEST().

## ◆ fl_engine_set_platform_message_handler()

void fl_engine_set_platform_message_handler | ( | FlEngine * | engine,
|  | FlEnginePlatformMessageHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_platform_message_handler: @engine: an #FlEngine. @handler: function to call when a platform message is received. @user_data: (closure): user data to pass to @handler. @destroy_notify: (allow-none): a function which gets called to free @user_data, or NULL.

Registers the function called when a platform message is received. Call fl_engine_send_platform_message_response() with the response to this message. Ownership of #FlutterPlatformMessageResponseHandle is transferred to the caller, and the message must be responded to avoid memory leaks.

Definition at line 594 of file fl_engine.cc.

598 {
599 g_return_if_fail(FL_IS_ENGINE(self));
600 g_return_if_fail(handler != nullptr);
601
602 if (self->platform_message_handler_destroy_notify) {
603 self->platform_message_handler_destroy_notify(
604 self->platform_message_handler_data);
605 }
606
607 self->platform_message_handler = handler;
608 self->platform_message_handler_data = user_data;
609 self->platform_message_handler_destroy_notify = destroy_notify;
610 }

References self, and user_data.

Referenced by fl_binary_messenger_new().

## ◆ fl_engine_set_update_semantics_node_handler()

void fl_engine_set_update_semantics_node_handler | ( | FlEngine * | engine,
|  | FlEngineUpdateSemanticsNodeHandler | handler,
|  | gpointer | user_data,
|  | GDestroyNotify | destroy_notify
| ) |  |

fl_engine_set_update_semantics_node_handler: @engine: an #FlEngine. @handler: function to call when a semantics node update is received. @user_data: (closure): user data to pass to @handler. @destroy_notify: (allow-none): a function which gets called to free @user_data, or NULL.

Registers the function called when a semantics node update is reveived.

Definition at line 612 of file fl_engine.cc.

616 {
617 g_return_if_fail(FL_IS_ENGINE(self));
618
619 if (self->update_semantics_node_handler_destroy_notify) {
620 self->update_semantics_node_handler_destroy_notify(
621 self->update_semantics_node_handler_data);
622 }
623
624 self->update_semantics_node_handler = handler;
625 self->update_semantics_node_handler_data = user_data;
626 self->update_semantics_node_handler_destroy_notify = destroy_notify;
627 }

References self, and user_data.

Referenced by fl_view_constructed(), and fl_view_dispose().

## ◆ fl_engine_start()

gboolean fl_engine_start | ( | FlEngine * | engine,
|  | GError ** | error
| ) |  |

fl_engine_start: @engine: an #FlEngine. @error: (allow-none): #GError location to store the error occurring, or NULL to ignore.

Starts the Flutter engine.

Returns: TRUE on success.

Definition at line 482 of file fl_engine.cc.

482 {
483 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
484
485 self->task_runner = fl_task_runner_new(self);
486
487 FlutterRendererConfig config = {};
488 config.type = kOpenGL;
489 config.open_gl.struct_size = sizeof(FlutterOpenGLRendererConfig);
490 config.open_gl.gl_proc_resolver = fl_engine_gl_proc_resolver;
491 config.open_gl.make_current = fl_engine_gl_make_current;
492 config.open_gl.clear_current = fl_engine_gl_clear_current;
493 config.open_gl.fbo_callback = fl_engine_gl_get_fbo;
494 config.open_gl.present = fl_engine_gl_present;
495 config.open_gl.make_resource_current = fl_engine_gl_make_resource_current;
496 config.open_gl.gl_external_texture_frame_callback =
497 fl_engine_gl_external_texture_frame_callback;
498
499 FlutterTaskRunnerDescription platform_task_runner = {};
500 platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
501 platform_task_runner.user_data = self;
502 platform_task_runner.runs_task_on_current_thread_callback =
503 fl_engine_runs_task_on_current_thread;
504 platform_task_runner.post_task_callback = fl_engine_post_task;
505 platform_task_runner.identifier = kPlatformTaskRunnerIdentifier;
506
507 FlutterCustomTaskRunners custom_task_runners = {};
508 custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
509 custom_task_runners.platform_task_runner = &platform_task_runner;
510 custom_task_runners.render_task_runner = &platform_task_runner;
511
512 g_autoptr(GPtrArray) command_line_args = fl_engine_get_switches(self);
513 // FlutterProjectArgs expects a full argv, so when processing it for flags
514 // the first item is treated as the executable and ignored. Add a dummy value
515 // so that all switches are used.
516 g_ptr_array_insert(command_line_args, 0, g_strdup("flutter"));
517
518 gchar** dart_entrypoint_args =
519 fl_dart_project_get_dart_entrypoint_arguments(self->project);
520
521 FlutterProjectArgs args = {};
522 args.struct_size = sizeof(FlutterProjectArgs);
523 args.assets_path = fl_dart_project_get_assets_path(self->project);
524 args.icu_data_path = fl_dart_project_get_icu_data_path(self->project);
525 args.command_line_argc = command_line_args->len;
526 args.command_line_argv =
527 reinterpret_cast<const char* const*>(command_line_args->pdata);
528 args.platform_message_callback = fl_engine_platform_message_cb;
529 args.update_semantics_node_callback = fl_engine_update_semantics_node_cb;
530 args.custom_task_runners = &custom_task_runners;
531 args.shutdown_dart_vm_when_done = true;
532 args.on_pre_engine_restart_callback = fl_engine_on_pre_engine_restart_cb;
533 args.dart_entrypoint_argc =
534 dart_entrypoint_args != nullptr ? g_strv_length(dart_entrypoint_args) : 0;
535 args.dart_entrypoint_argv =
536 reinterpret_cast<const char* const*>(dart_entrypoint_args);
537
538 FlutterCompositor compositor = {};
539 compositor.struct_size = sizeof(FlutterCompositor);
540 compositor.user_data = self->renderer;
541 compositor.create_backing_store_callback =
542 compositor_create_backing_store_callback;
543 compositor.collect_backing_store_callback =
544 compositor_collect_backing_store_callback;
545 compositor.present_layers_callback = compositor_present_layers_callback;
546 args.compositor = &compositor;
547
548 if (self->embedder_api.RunsAOTCompiledDartCode()) {
549 FlutterEngineAOTDataSource source = {};
550 source.type = kFlutterEngineAOTDataSourceTypeElfPath;
551 source.elf_path = fl_dart_project_get_aot_library_path(self->project);
552 if (self->embedder_api.CreateAOTData(&source, &self->aot_data) !=
553 kSuccess) {
554 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
555 "Failed to create AOT data");
556 return FALSE;
557 }
558 args.aot_data = self->aot_data;
559 }
560
561 FlutterEngineResult result = self->embedder_api.Initialize(
562 FLUTTER_ENGINE_VERSION, &config, &args, self, &self->engine);
563 if (result != kSuccess) {
564 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
565 "Failed to initialize Flutter engine");
566 return FALSE;
567 }
568
569 result = self->embedder_api.RunInitialized(self->engine);
570 if (result != kSuccess) {
571 g_set_error(error, fl_engine_error_quark(), FL_ENGINE_ERROR_FAILED,
572 "Failed to run Flutter engine");
573 return FALSE;
574 }
575
576 setup_locales(self);
577
578 g_autoptr(FlSettings) settings = fl_settings_new();
579 self->settings_plugin = fl_settings_plugin_new(self);
580 fl_settings_plugin_start(self->settings_plugin, settings);
581
582 result = self->embedder_api.UpdateSemanticsEnabled(self->engine, TRUE);
583 if (result != kSuccess) {
584 g_warning("Failed to enable accessibility features on Flutter engine");
585 }
586
587 return TRUE;
588 }

References args, compositor_collect_backing_store_callback(), compositor_create_backing_store_callback(), compositor_present_layers_callback(), error, fl_dart_project_get_aot_library_path(), fl_dart_project_get_assets_path(), fl_dart_project_get_dart_entrypoint_arguments(), fl_dart_project_get_icu_data_path(), FL_ENGINE_ERROR_FAILED, fl_engine_error_quark(), fl_engine_get_switches(), fl_engine_gl_clear_current(), fl_engine_gl_external_texture_frame_callback(), fl_engine_gl_get_fbo(), fl_engine_gl_make_current(), fl_engine_gl_make_resource_current(), fl_engine_gl_present(), fl_engine_gl_proc_resolver(), fl_engine_on_pre_engine_restart_cb(), fl_engine_platform_message_cb(), fl_engine_post_task(), fl_engine_runs_task_on_current_thread(), fl_engine_update_semantics_node_cb(), fl_settings_new(), fl_settings_plugin_new(), fl_settings_plugin_start(), fl_task_runner_new(), kPlatformTaskRunnerIdentifier, result, self, setup_locales(), and TRUE.

Referenced by make_mock_engine(), realize_cb(), and TEST().

## ◆ fl_engine_unregister_external_texture()

gboolean fl_engine_unregister_external_texture | ( | FlEngine * | engine,
|  | int64_t | texture_id
| ) |  |

fl_engine_unregister_external_texture: @engine: an #FlEngine. @texture_id: the identifier of the texture that is not available anymore.

Tells the Flutter engine that an existing external texture is not available anymore.

Returns: TRUE on success.

Definition at line 886 of file fl_engine.cc.

887 {
888 g_return_val_if_fail(FL_IS_ENGINE(self), FALSE);
889 return self->embedder_api.UnregisterExternalTexture(self->engine,
890 texture_id) == kSuccess;
891 }

References self, and texture_id.

Referenced by unregister_texture().

## ◆ fl_engine_update_accessibility_features()

void fl_engine_update_accessibility_features | ( | FlEngine * | engine,
|  | int32_t | flags
| ) |  |

fl_engine_update_accessibility_features: @engine: an #FlEngine. @flags: the features to enable in the accessibility tree.

Tells the Flutter engine to update the flags on the accessibility tree.

Definition at line 915 of file fl_engine.cc.

915 {
916 g_return_if_fail(FL_IS_ENGINE(self));
917
918 if (self->engine == nullptr) {
919 return;
920 }
921
922 self->embedder_api.UpdateAccessibilityFeatures(
923 self->engine, static_cast<FlutterAccessibilityFeature>(flags));
924 }

References flags, and self.

Referenced by update_settings().

fl_dart_project_get_aot_library_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_aot_library_path(FlDartProject *self)
Definition: fl_dart_project.cc:72
event
FlKeyEvent * event
Definition: fl_key_channel_responder.cc:118
flutter::AppLifecycleState::kHidden
@ kHidden
fl_engine_update_semantics_node_cb
static void fl_engine_update_semantics_node_cb(const FlutterSemanticsNode *node, void *user_data)
Definition: fl_engine.cc:335
fl_engine_platform_message_response_cb
static void fl_engine_platform_message_response_cb(const uint8_t *data, size_t data_length, void *user_data)
Definition: fl_engine.cc:361
fl_engine_gl_get_fbo
static uint32_t fl_engine_gl_get_fbo(void *user_data)
Definition: fl_engine.cc:237
fl_engine_gl_make_resource_current
static bool fl_engine_gl_make_resource_current(void *user_data)
Definition: fl_engine.cc:248
FL_ENGINE_ERROR_FAILED
@ FL_ENGINE_ERROR_FAILED
Definition: fl_engine_private.h:24
kMousePointerDeviceId
static constexpr int32_t kMousePointerDeviceId
Definition: fl_engine.cc:34
set_app_lifecycle_state
static void set_app_lifecycle_state(FlEngine *self, const flutter::AppLifecycleState state)
Definition: fl_engine.cc:129
compositor_collect_backing_store_callback
static bool compositor_collect_backing_store_callback(const FlutterBackingStore *renderer, void *user_data)
Definition: fl_engine.cc:194
fl_settings_new
FlSettings * fl_settings_new()
Definition: fl_settings.cc:55
fl_engine_gl_present
static bool fl_engine_gl_present(void *user_data)
Definition: fl_engine.cc:242
flags
FlutterSemanticsFlag flags
Definition: fl_accessible_node.cc:105
user_data
FlKeyEvent uint64_t FlKeyResponderAsyncCallback gpointer user_data
Definition: fl_key_channel_responder.cc:121
fl_engine_on_pre_engine_restart_cb
static void fl_engine_on_pre_engine_restart_cb(void *user_data)
Definition: fl_engine.cc:350
fl_dart_project_get_assets_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_assets_path(FlDartProject *self)
Definition: fl_dart_project.cc:85
height
G_BEGIN_DECLS int height
Definition: fl_backing_store_provider.h:37
fl_binary_messenger_new
FlBinaryMessenger * fl_binary_messenger_new(FlEngine *engine)
Definition: fl_binary_messenger.cc:406
fl_settings_plugin_start
void fl_settings_plugin_start(FlSettingsPlugin *self, FlSettings *settings)
Definition: fl_settings_plugin.cc:112
kPlatformTaskRunnerIdentifier
static constexpr size_t kPlatformTaskRunnerIdentifier
Definition: fl_engine.cc:30
flutter::AppLifecycleState::kInactive
@ kInactive
compositor_present_layers_callback
static bool compositor_present_layers_callback(const FlutterLayer **layers, size_t layers_count, void *user_data)
Definition: fl_engine.cc:202
fl_engine_gl_external_texture_frame_callback
static bool fl_engine_gl_external_texture_frame_callback(void *user_data, int64_t texture_id, size_t width, size_t height, FlutterOpenGLTexture *opengl_texture)
Definition: fl_engine.cc:259
TRUE
return TRUE
Definition: fl_pixel_buffer_texture_test.cc:53
flutter::GetSwitchesFromEnvironment
std::vector< std::string > GetSwitchesFromEnvironment()
Definition: engine_switches.cc:14
fl_dart_project_get_dart_entrypoint_arguments
G_MODULE_EXPORT gchar ** fl_dart_project_get_dart_entrypoint_arguments(FlDartProject *self)
Definition: fl_dart_project.cc:104
fl_engine_runs_task_on_current_thread
static bool fl_engine_runs_task_on_current_thread(void *user_data)
Definition: fl_engine.cc:300
self
GdkEvent FlView * self
Definition: fl_view.cc:100
result
GAsyncResult * result
Definition: fl_text_input_plugin.cc:106
FlEngineError
FlEngineError
Definition: fl_engine_private.h:23
args
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
Definition: fl_event_channel.h:89
error
const uint8_t uint32_t uint32_t GError ** error
Definition: fl_pixel_buffer_texture_test.cc:40
flutter::AppLifecycleState::kResumed
@ kResumed
fl_engine_gl_proc_resolver
static void * fl_engine_gl_proc_resolver(void *user_data, const char *name)
Definition: fl_engine.cc:212
setup_locales
static void setup_locales(FlEngine *self)
Definition: fl_engine.cc:149
compositor_create_backing_store_callback
static bool compositor_create_backing_store_callback(const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out, void *user_data)
Definition: fl_engine.cc:184
callback
FlKeyEvent uint64_t FlKeyResponderAsyncCallback callback
Definition: fl_key_channel_responder.cc:120
fl_engine_error_quark
GQuark fl_engine_error_quark(void) G_GNUC_CONST
fl_dart_project_get_icu_data_path
const G_MODULE_EXPORT gchar * fl_dart_project_get_icu_data_path(FlDartProject *self)
Definition: fl_dart_project.cc:98
texture_id
int64_t texture_id
Definition: texture_registrar_unittests.cc:24
width
const uint8_t uint32_t * width
Definition: fl_pixel_buffer_texture_test.cc:38
fl_engine_gl_make_current
static bool fl_engine_gl_make_current(void *user_data)
Definition: fl_engine.cc:217
fl_engine_get_switches
GPtrArray * fl_engine_get_switches(FlEngine *self)
Definition: fl_engine.cc:926
fl_engine_post_task
static void fl_engine_post_task(FlutterTask task, uint64_t target_time_nanos, void *user_data)
Definition: fl_engine.cc:306
fl_task_runner_new
FlTaskRunner * fl_task_runner_new(FlEngine *engine)
Definition: fl_task_runner.cc:161
fl_settings_plugin_new
FlSettingsPlugin * fl_settings_plugin_new(FlEngine *engine)
Definition: fl_settings_plugin.cc:94
fl_engine_platform_message_cb
static void fl_engine_platform_message_cb(const FlutterPlatformMessage *message, void *user_data)
Definition: fl_engine.cc:315
kPointerPanZoomDeviceId
static constexpr int32_t kPointerPanZoomDeviceId
Definition: fl_engine.cc:35
fl_engine_gl_clear_current
static bool fl_engine_gl_clear_current(void *user_data)
Definition: fl_engine.cc:227