Flutter Linux Embedder
fl_engine.cc File Reference

Go to the source code of this file.

Classes

struct  _FlEngine
 

Functions

static void fl_engine_plugin_registry_iface_init (FlPluginRegistryInterface *iface)
 
 G_DEFINE_TYPE_WITH_CODE (FlEngine, fl_engine, G_TYPE_OBJECT, G_IMPLEMENT_INTERFACE(fl_plugin_registry_get_type(), fl_engine_plugin_registry_iface_init)) enum
 
static void parse_locale (const gchar *locale, gchar **language, gchar **territory, gchar **codeset, gchar **modifier)
 
static void set_app_lifecycle_state (FlEngine *self, const flutter::AppLifecycleState state)
 
static void setup_locales (FlEngine *self)
 
static bool compositor_create_backing_store_callback (const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out, void *user_data)
 
static bool compositor_collect_backing_store_callback (const FlutterBackingStore *renderer, void *user_data)
 
static bool compositor_present_layers_callback (const FlutterLayer **layers, size_t layers_count, void *user_data)
 
static void * fl_engine_gl_proc_resolver (void *user_data, const char *name)
 
static bool fl_engine_gl_make_current (void *user_data)
 
static bool fl_engine_gl_clear_current (void *user_data)
 
static uint32_t fl_engine_gl_get_fbo (void *user_data)
 
static bool fl_engine_gl_present (void *user_data)
 
static bool fl_engine_gl_make_resource_current (void *user_data)
 
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)
 
static bool fl_engine_runs_task_on_current_thread (void *user_data)
 
static void fl_engine_post_task (FlutterTask task, uint64_t target_time_nanos, void *user_data)
 
static void fl_engine_platform_message_cb (const FlutterPlatformMessage *message, void *user_data)
 
static void fl_engine_update_semantics_node_cb (const FlutterSemanticsNode *node, void *user_data)
 
static void fl_engine_on_pre_engine_restart_cb (void *user_data)
 
static void fl_engine_platform_message_response_cb (const uint8_t *data, size_t data_length, void *user_data)
 
static FlPluginRegistrar * fl_engine_get_registrar_for_plugin (FlPluginRegistry *registry, const gchar *name)
 
static void fl_engine_set_property (GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
 
static void fl_engine_dispose (GObject *object)
 
static void fl_engine_class_init (FlEngineClass *klass)
 
static void fl_engine_init (FlEngine *self)
 
FlEngine * fl_engine_new (FlDartProject *project, FlRenderer *renderer)
 
G_MODULE_EXPORT FlEngine * fl_engine_new_headless (FlDartProject *project)
 
gboolean fl_engine_start (FlEngine *self, GError **error)
 
FlutterEngineProcTable * fl_engine_get_embedder_api (FlEngine *self)
 
void fl_engine_set_platform_message_handler (FlEngine *self, FlEnginePlatformMessageHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
 
void fl_engine_set_update_semantics_node_handler (FlEngine *self, FlEngineUpdateSemanticsNodeHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
 
void fl_engine_set_on_pre_engine_restart_handler (FlEngine *self, FlEngineOnPreEngineRestartHandler handler, gpointer user_data, GDestroyNotify destroy_notify)
 
gboolean fl_engine_send_platform_message_response (FlEngine *self, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
 
void fl_engine_send_platform_message (FlEngine *self, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
 
GBytes * fl_engine_send_platform_message_finish (FlEngine *self, GAsyncResult *result, GError **error)
 
void fl_engine_send_window_state_event (FlEngine *self, gboolean visible, gboolean focused)
 
void fl_engine_send_window_metrics_event (FlEngine *self, size_t width, size_t height, double pixel_ratio)
 
void fl_engine_send_mouse_pointer_event (FlEngine *self, 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 *self, const FlutterKeyEvent *event, FlutterKeyEventCallback callback, void *user_data)
 
void fl_engine_dispatch_semantics_action (FlEngine *self, uint64_t id, FlutterSemanticsAction action, GBytes *data)
 
gboolean fl_engine_mark_texture_frame_available (FlEngine *self, int64_t texture_id)
 
gboolean fl_engine_register_external_texture (FlEngine *self, int64_t texture_id)
 
gboolean fl_engine_unregister_external_texture (FlEngine *self, int64_t texture_id)
 
G_MODULE_EXPORT FlBinaryMessenger * fl_engine_get_binary_messenger (FlEngine *self)
 
FlTaskRunner * fl_engine_get_task_runner (FlEngine *self)
 
void fl_engine_execute_task (FlEngine *self, FlutterTask *task)
 
G_MODULE_EXPORT FlTextureRegistrar * fl_engine_get_texture_registrar (FlEngine *self)
 
void fl_engine_update_accessibility_features (FlEngine *self, int32_t flags)
 
GPtrArray * fl_engine_get_switches (FlEngine *self)
 

Variables

static constexpr size_t kPlatformTaskRunnerIdentifier = 1
 
static constexpr int32_t kMousePointerDeviceId = 0
 
static constexpr int32_t kPointerPanZoomDeviceId = 1
 
static constexpr const char * kFlutterLifecycleChannel = "flutter/lifecycle"
 

Function Documentation

◆ compositor_collect_backing_store_callback()

static bool compositor_collect_backing_store_callback ( const FlutterBackingStore *  renderer,
void *  user_data 
)
static

Definition at line 194 of file fl_engine.cc.

196  {
197  g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
198  return fl_renderer_collect_backing_store(FL_RENDERER(user_data), renderer);
199 }

References fl_renderer_collect_backing_store(), and user_data.

Referenced by fl_engine_start().

◆ compositor_create_backing_store_callback()

static bool compositor_create_backing_store_callback ( const FlutterBackingStoreConfig *  config,
FlutterBackingStore *  backing_store_out,
void *  user_data 
)
static

Definition at line 184 of file fl_engine.cc.

187  {
188  g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
189  return fl_renderer_create_backing_store(FL_RENDERER(user_data), config,
190  backing_store_out);
191 }

References fl_renderer_create_backing_store(), and user_data.

Referenced by fl_engine_start().

◆ compositor_present_layers_callback()

static bool compositor_present_layers_callback ( const FlutterLayer **  layers,
size_t  layers_count,
void *  user_data 
)
static

Definition at line 202 of file fl_engine.cc.

204  {
205  g_return_val_if_fail(FL_IS_RENDERER(user_data), false);
206  return fl_renderer_present_layers(FL_RENDERER(user_data), layers,
207  layers_count);
208 }

References fl_renderer_present_layers(), and user_data.

Referenced by fl_engine_start().

◆ fl_engine_class_init()

static void fl_engine_class_init ( FlEngineClass *  klass)
static

Definition at line 444 of file fl_engine.cc.

444  {
445  G_OBJECT_CLASS(klass)->dispose = fl_engine_dispose;
446  G_OBJECT_CLASS(klass)->set_property = fl_engine_set_property;
447 
448  g_object_class_install_property(
449  G_OBJECT_CLASS(klass), kPropBinaryMessenger,
450  g_param_spec_object(
451  "binary-messenger", "messenger", "Binary messenger",
452  fl_binary_messenger_get_type(),
453  static_cast<GParamFlags>(G_PARAM_WRITABLE | G_PARAM_CONSTRUCT_ONLY |
454  G_PARAM_STATIC_STRINGS)));
455 }

References fl_engine_dispose(), and fl_engine_set_property().

◆ 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_dispose()

static void fl_engine_dispose ( GObject *  object)
static

Definition at line 400 of file fl_engine.cc.

400  {
401  FlEngine* self = FL_ENGINE(object);
402 
403  if (self->engine != nullptr) {
404  self->embedder_api.Shutdown(self->engine);
405  self->engine = nullptr;
406  }
407 
408  if (self->aot_data != nullptr) {
409  self->embedder_api.CollectAOTData(self->aot_data);
410  self->aot_data = nullptr;
411  }
412 
413  g_clear_object(&self->project);
414  g_clear_object(&self->renderer);
415  g_clear_object(&self->texture_registrar);
416  g_clear_object(&self->binary_messenger);
417  g_clear_object(&self->settings_plugin);
418  g_clear_object(&self->task_runner);
419 
420  if (self->platform_message_handler_destroy_notify) {
421  self->platform_message_handler_destroy_notify(
422  self->platform_message_handler_data);
423  }
424  self->platform_message_handler_data = nullptr;
425  self->platform_message_handler_destroy_notify = nullptr;
426 
427  if (self->update_semantics_node_handler_destroy_notify) {
428  self->update_semantics_node_handler_destroy_notify(
429  self->update_semantics_node_handler_data);
430  }
431  self->update_semantics_node_handler_data = nullptr;
432  self->update_semantics_node_handler_destroy_notify = nullptr;
433 
434  if (self->on_pre_engine_restart_handler_destroy_notify) {
435  self->on_pre_engine_restart_handler_destroy_notify(
436  self->on_pre_engine_restart_handler_data);
437  }
438  self->on_pre_engine_restart_handler_data = nullptr;
439  self->on_pre_engine_restart_handler_destroy_notify = nullptr;
440 
441  G_OBJECT_CLASS(fl_engine_parent_class)->dispose(object);
442 }

References self.

Referenced by fl_engine_class_init().

◆ 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_binary_messenger()

G_MODULE_EXPORT FlBinaryMessenger* fl_engine_get_binary_messenger ( FlEngine *  engine)

fl_engine_get_binary_messenger: @engine: an #FlEngine.

Gets the messenger to communicate with this engine.

Returns: an #FlBinaryMessenger.

Definition at line 893 of file fl_engine.cc.

894  {
895  g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
896  return self->binary_messenger;
897 }

Referenced by fl_settings_plugin_new(), fl_view_constructed(), fl_view_get_registrar_for_plugin(), fl_view_keyboard_delegate_iface_init(), init_keyboard(), and set_app_lifecycle_state().

◆ 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_registrar_for_plugin()

static FlPluginRegistrar* fl_engine_get_registrar_for_plugin ( FlPluginRegistry *  registry,
const gchar *  name 
)
static

Definition at line 370 of file fl_engine.cc.

372  {
373  FlEngine* self = FL_ENGINE(registry);
374 
375  return fl_plugin_registrar_new(nullptr, self->binary_messenger,
376  self->texture_registrar);
377 }

References fl_plugin_registrar_new(), and self.

Referenced by fl_engine_plugin_registry_iface_init().

◆ 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_get_texture_registrar()

G_MODULE_EXPORT FlTextureRegistrar* fl_engine_get_texture_registrar ( FlEngine *  engine)

fl_engine_get_texture_registrar: @engine: an #FlEngine.

Gets the texture registrar for registering textures.

Returns: an #FlTextureRegistrar.

Definition at line 909 of file fl_engine.cc.

910  {
911  g_return_val_if_fail(FL_IS_ENGINE(self), nullptr);
912  return self->texture_registrar;
913 }

Referenced by fl_view_get_registrar_for_plugin().

◆ fl_engine_gl_clear_current()

static bool fl_engine_gl_clear_current ( void *  user_data)
static

Definition at line 227 of file fl_engine.cc.

227  {
228  FlEngine* self = static_cast<FlEngine*>(user_data);
229  g_autoptr(GError) error = nullptr;
230  gboolean result = fl_renderer_clear_current(self->renderer, &error);
231  if (!result) {
232  g_warning("%s", error->message);
233  }
234  return result;
235 }

References error, fl_renderer_clear_current(), result, self, and user_data.

Referenced by fl_engine_start().

◆ 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 
)
static

Definition at line 259 of file fl_engine.cc.

264  {
265  FlEngine* self = static_cast<FlEngine*>(user_data);
266  if (!self->texture_registrar) {
267  return false;
268  }
269 
270  FlTexture* texture =
272  if (texture == nullptr) {
273  g_warning("Unable to find texture %" G_GINT64_FORMAT, texture_id);
274  return false;
275  }
276 
277  gboolean result;
278  g_autoptr(GError) error = nullptr;
279  if (FL_IS_TEXTURE_GL(texture)) {
280  result = fl_texture_gl_populate(FL_TEXTURE_GL(texture), width, height,
281  opengl_texture, &error);
282  } else if (FL_IS_PIXEL_BUFFER_TEXTURE(texture)) {
283  result =
284  fl_pixel_buffer_texture_populate(FL_PIXEL_BUFFER_TEXTURE(texture),
285  width, height, opengl_texture, &error);
286  } else {
287  g_warning("Unsupported texture type %" G_GINT64_FORMAT, texture_id);
288  return false;
289  }
290 
291  if (!result) {
292  g_warning("%s", error->message);
293  return false;
294  }
295 
296  return true;
297 }

References error, fl_pixel_buffer_texture_populate(), fl_texture_gl_populate(), fl_texture_registrar_lookup_texture(), height, result, self, texture_id, user_data, and width.

Referenced by fl_engine_start().

◆ fl_engine_gl_get_fbo()

static uint32_t fl_engine_gl_get_fbo ( void *  user_data)
static

Definition at line 237 of file fl_engine.cc.

237  {
238  FlEngine* self = static_cast<FlEngine*>(user_data);
239  return fl_renderer_get_fbo(self->renderer);
240 }

References fl_renderer_get_fbo(), self, and user_data.

Referenced by fl_engine_start().

◆ fl_engine_gl_make_current()

static bool fl_engine_gl_make_current ( void *  user_data)
static

Definition at line 217 of file fl_engine.cc.

217  {
218  FlEngine* self = static_cast<FlEngine*>(user_data);
219  g_autoptr(GError) error = nullptr;
220  gboolean result = fl_renderer_make_current(self->renderer, &error);
221  if (!result) {
222  g_warning("%s", error->message);
223  }
224  return result;
225 }

References error, fl_renderer_make_current(), result, self, and user_data.

Referenced by fl_engine_start().

◆ fl_engine_gl_make_resource_current()

static bool fl_engine_gl_make_resource_current ( void *  user_data)
static

Definition at line 248 of file fl_engine.cc.

248  {
249  FlEngine* self = static_cast<FlEngine*>(user_data);
250  g_autoptr(GError) error = nullptr;
251  gboolean result = fl_renderer_make_resource_current(self->renderer, &error);
252  if (!result) {
253  g_warning("%s", error->message);
254  }
255  return result;
256 }

References error, fl_renderer_make_resource_current(), result, self, and user_data.

Referenced by fl_engine_start().

◆ fl_engine_gl_present()

static bool fl_engine_gl_present ( void *  user_data)
static

Definition at line 242 of file fl_engine.cc.

242  {
243  // No action required, as this is handled in
244  // compositor_present_layers_callback.
245  return true;
246 }

Referenced by fl_engine_start().

◆ fl_engine_gl_proc_resolver()

static void* fl_engine_gl_proc_resolver ( void *  user_data,
const char *  name 
)
static

Definition at line 212 of file fl_engine.cc.

212  {
213  FlEngine* self = static_cast<FlEngine*>(user_data);
214  return fl_renderer_get_proc_address(self->renderer, name);
215 }

References fl_renderer_get_proc_address(), self, and user_data.

Referenced by fl_engine_start().

◆ fl_engine_init()

static void fl_engine_init ( FlEngine *  self)
static

Definition at line 457 of file fl_engine.cc.

457  {
458  self->thread = g_thread_self();
459 
460  self->embedder_api.struct_size = sizeof(FlutterEngineProcTable);
461  FlutterEngineGetProcAddresses(&self->embedder_api);
462 
463  self->texture_registrar = fl_texture_registrar_new(self);
464 }

References fl_texture_registrar_new(), and self.

◆ 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_new_headless()

G_MODULE_EXPORT FlEngine* fl_engine_new_headless ( FlDartProject *  project)

FlEngine:

#FlEngine is an object that contains a running Flutter engine. fl_engine_new_headless: @project: an #FlDartProject.

Creates new Flutter engine running in headless mode.

Returns: a new #FlEngine.

Definition at line 477 of file fl_engine.cc.

477  {
478  g_autoptr(FlRendererHeadless) renderer = fl_renderer_headless_new();
479  return fl_engine_new(project, FL_RENDERER(renderer));
480 }

References fl_engine_new(), and fl_renderer_headless_new().

◆ fl_engine_on_pre_engine_restart_cb()

static void fl_engine_on_pre_engine_restart_cb ( void *  user_data)
static

Definition at line 350 of file fl_engine.cc.

350  {
351  FlEngine* self = FL_ENGINE(user_data);
352 
353  if (self->on_pre_engine_restart_handler != nullptr) {
354  self->on_pre_engine_restart_handler(
355  self, self->on_pre_engine_restart_handler_data);
356  }
357 }

References self, and user_data.

Referenced by fl_engine_start().

◆ fl_engine_platform_message_cb()

static void fl_engine_platform_message_cb ( const FlutterPlatformMessage *  message,
void *  user_data 
)
static

Definition at line 315 of file fl_engine.cc.

316  {
317  FlEngine* self = FL_ENGINE(user_data);
318 
319  gboolean handled = FALSE;
320  if (self->platform_message_handler != nullptr) {
321  g_autoptr(GBytes) data =
322  g_bytes_new(message->message, message->message_size);
323  handled = self->platform_message_handler(
324  self, message->channel, data, message->response_handle,
325  self->platform_message_handler_data);
326  }
327 
328  if (!handled) {
329  fl_engine_send_platform_message_response(self, message->response_handle,
330  nullptr, nullptr);
331  }
332 }

References fl_engine_send_platform_message_response(), self, and user_data.

Referenced by fl_engine_start().

◆ 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 
)
static

Definition at line 361 of file fl_engine.cc.

363  {
364  g_autoptr(GTask) task = G_TASK(user_data);
365  g_task_return_pointer(task, g_bytes_new(data, data_length),
366  reinterpret_cast<GDestroyNotify>(g_bytes_unref));
367 }

References user_data.

Referenced by fl_engine_send_platform_message().

◆ fl_engine_plugin_registry_iface_init()

static void fl_engine_plugin_registry_iface_init ( FlPluginRegistryInterface *  iface)
static

Definition at line 379 of file fl_engine.cc.

380  {
381  iface->get_registrar_for_plugin = fl_engine_get_registrar_for_plugin;
382 }

References fl_engine_get_registrar_for_plugin().

◆ fl_engine_post_task()

static void fl_engine_post_task ( FlutterTask  task,
uint64_t  target_time_nanos,
void *  user_data 
)
static

Definition at line 306 of file fl_engine.cc.

308  {
309  FlEngine* self = static_cast<FlEngine*>(user_data);
310 
311  fl_task_runner_post_task(self->task_runner, task, target_time_nanos);
312 }

References fl_task_runner_post_task(), self, and user_data.

Referenced by fl_engine_start().

◆ 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_runs_task_on_current_thread()

static bool fl_engine_runs_task_on_current_thread ( void *  user_data)
static

Definition at line 300 of file fl_engine.cc.

300  {
301  FlEngine* self = static_cast<FlEngine*>(user_data);
302  return self->thread == g_thread_self();
303 }

References user_data.

Referenced by fl_engine_start().

◆ 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(
701  &response_handle);
702  if (result != kSuccess) {
703  g_task_return_new_error(task, fl_engine_error_quark(),
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(),
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) {
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) {
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) {
752  } else if (visible) {
754  } else {
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_property()

static void fl_engine_set_property ( GObject *  object,
guint  prop_id,
const GValue *  value,
GParamSpec *  pspec 
)
static

Definition at line 384 of file fl_engine.cc.

387  {
388  FlEngine* self = FL_ENGINE(object);
389  switch (prop_id) {
390  case kPropBinaryMessenger:
391  g_set_object(&self->binary_messenger,
392  FL_BINARY_MESSENGER(g_value_get_object(value)));
393  break;
394  default:
395  G_OBJECT_WARN_INVALID_PROPERTY_ID(object, prop_id, pspec);
396  break;
397  }
398 }

References self, and value.

Referenced by fl_engine_class_init().

◆ 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 =
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 =
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 =
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 =
543  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) {
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) {
565  "Failed to initialize Flutter engine");
566  return FALSE;
567  }
568 
569  result = self->embedder_api.RunInitialized(self->engine);
570  if (result != kSuccess) {
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_engine_update_semantics_node_cb()

static void fl_engine_update_semantics_node_cb ( const FlutterSemanticsNode *  node,
void *  user_data 
)
static

Definition at line 335 of file fl_engine.cc.

336  {
337  FlEngine* self = FL_ENGINE(user_data);
338 
339  if (self->update_semantics_node_handler != nullptr) {
340  self->update_semantics_node_handler(
341  self, node, self->update_semantics_node_handler_data);
342  }
343 }

References node, self, and user_data.

Referenced by fl_engine_start().

◆ G_DEFINE_TYPE_WITH_CODE()

G_DEFINE_TYPE_WITH_CODE ( FlEngine  ,
fl_engine  ,
G_TYPE_OBJECT  ,
G_IMPLEMENT_INTERFACE(fl_plugin_registry_get_type(), fl_engine_plugin_registry_iface_init  
)

Definition at line 76 of file fl_engine.cc.

83  { kProp0, kPropBinaryMessenger, kPropLast };

References kProp0, and kPropLast.

◆ parse_locale()

static void parse_locale ( const gchar *  locale,
gchar **  language,
gchar **  territory,
gchar **  codeset,
gchar **  modifier 
)
static

Definition at line 86 of file fl_engine.cc.

90  {
91  gchar* l = g_strdup(locale);
92 
93  // Locales are in the form "language[_territory][.codeset][@modifier]"
94  gchar* match = strrchr(l, '@');
95  if (match != nullptr) {
96  if (modifier != nullptr) {
97  *modifier = g_strdup(match + 1);
98  }
99  *match = '\0';
100  } else if (modifier != nullptr) {
101  *modifier = nullptr;
102  }
103 
104  match = strrchr(l, '.');
105  if (match != nullptr) {
106  if (codeset != nullptr) {
107  *codeset = g_strdup(match + 1);
108  }
109  *match = '\0';
110  } else if (codeset != nullptr) {
111  *codeset = nullptr;
112  }
113 
114  match = strrchr(l, '_');
115  if (match != nullptr) {
116  if (territory != nullptr) {
117  *territory = g_strdup(match + 1);
118  }
119  *match = '\0';
120  } else if (territory != nullptr) {
121  *territory = nullptr;
122  }
123 
124  if (language != nullptr) {
125  *language = l;
126  }
127 }

Referenced by setup_locales().

◆ set_app_lifecycle_state()

static void set_app_lifecycle_state ( FlEngine *  self,
const flutter::AppLifecycleState  state 
)
static

Definition at line 129 of file fl_engine.cc.

130  {
131  FlBinaryMessenger* binary_messenger = fl_engine_get_binary_messenger(self);
132 
133  g_autoptr(FlValue) value =
135  g_autoptr(FlStringCodec) codec = fl_string_codec_new();
136  g_autoptr(GBytes) message =
137  fl_message_codec_encode_message(FL_MESSAGE_CODEC(codec), value, nullptr);
138 
139  if (message == nullptr) {
140  return;
141  }
142 
143  fl_binary_messenger_send_on_channel(binary_messenger,
144  kFlutterLifecycleChannel, message,
145  nullptr, nullptr, nullptr);
146 }

References flutter::AppLifecycleStateToString(), fl_binary_messenger_send_on_channel(), fl_engine_get_binary_messenger(), fl_message_codec_encode_message(), fl_string_codec_new(), fl_value_new_string(), kFlutterLifecycleChannel, state, and value.

Referenced by fl_engine_send_window_state_event().

◆ setup_locales()

static void setup_locales ( FlEngine *  self)
static

Definition at line 149 of file fl_engine.cc.

149  {
150  const gchar* const* languages = g_get_language_names();
151  g_autoptr(GPtrArray) locales_array = g_ptr_array_new_with_free_func(g_free);
152  // Helper array to take ownership of the strings passed to Flutter.
153  g_autoptr(GPtrArray) locale_strings = g_ptr_array_new_with_free_func(g_free);
154  for (int i = 0; languages[i] != nullptr; i++) {
155  gchar *language, *territory;
156  parse_locale(languages[i], &language, &territory, nullptr, nullptr);
157  if (language != nullptr) {
158  g_ptr_array_add(locale_strings, language);
159  }
160  if (territory != nullptr) {
161  g_ptr_array_add(locale_strings, territory);
162  }
163 
164  FlutterLocale* locale =
165  static_cast<FlutterLocale*>(g_malloc0(sizeof(FlutterLocale)));
166  g_ptr_array_add(locales_array, locale);
167  locale->struct_size = sizeof(FlutterLocale);
168  locale->language_code = language;
169  locale->country_code = territory;
170  locale->script_code = nullptr;
171  locale->variant_code = nullptr;
172  }
173  FlutterLocale** locales =
174  reinterpret_cast<FlutterLocale**>(locales_array->pdata);
175  FlutterEngineResult result = self->embedder_api.UpdateLocales(
176  self->engine, const_cast<const FlutterLocale**>(locales),
177  locales_array->len);
178  if (result != kSuccess) {
179  g_warning("Failed to set up Flutter locales");
180  }
181 }

References parse_locale(), result, and self.

Referenced by fl_engine_start().

Variable Documentation

◆ kFlutterLifecycleChannel

constexpr const char* kFlutterLifecycleChannel = "flutter/lifecycle"
staticconstexpr

Definition at line 37 of file fl_engine.cc.

Referenced by set_app_lifecycle_state().

◆ kMousePointerDeviceId

constexpr int32_t kMousePointerDeviceId = 0
staticconstexpr

Definition at line 34 of file fl_engine.cc.

Referenced by fl_engine_send_mouse_pointer_event().

◆ kPlatformTaskRunnerIdentifier

constexpr size_t kPlatformTaskRunnerIdentifier = 1
staticconstexpr

Definition at line 30 of file fl_engine.cc.

Referenced by fl_engine_start().

◆ kPointerPanZoomDeviceId

constexpr int32_t kPointerPanZoomDeviceId = 1
staticconstexpr

Definition at line 35 of file fl_engine.cc.

Referenced by fl_engine_send_pointer_pan_zoom_event().

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
fl_texture_registrar_lookup_texture
FlTexture * fl_texture_registrar_lookup_texture(FlTextureRegistrar *self, int64_t texture_id)
Definition: fl_texture_registrar.cc:191
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
FlValue
typedefG_BEGIN_DECLS struct _FlValue FlValue
Definition: fl_value.h:40
fl_renderer_clear_current
gboolean fl_renderer_clear_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:115
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
fl_engine_dispose
static void fl_engine_dispose(GObject *object)
Definition: fl_engine.cc:400
user_data
FlKeyEvent uint64_t FlKeyResponderAsyncCallback gpointer user_data
Definition: fl_key_channel_responder.cc:121
fl_texture_registrar_new
FlTextureRegistrar * fl_texture_registrar_new(FlEngine *engine)
Definition: fl_texture_registrar.cc:216
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_engine_get_binary_messenger
G_MODULE_EXPORT FlBinaryMessenger * fl_engine_get_binary_messenger(FlEngine *self)
Definition: fl_engine.cc:893
fl_renderer_get_proc_address
void * fl_renderer_get_proc_address(FlRenderer *self, const char *name)
Definition: fl_renderer.cc:91
state
AtkStateType state
Definition: fl_accessible_node.cc:10
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
fl_renderer_make_resource_current
gboolean fl_renderer_make_resource_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:105
kPropLast
@ kPropLast
Definition: fl_accessible_node.cc:83
fl_engine_set_property
static void fl_engine_set_property(GObject *object, guint prop_id, const GValue *value, GParamSpec *pspec)
Definition: fl_engine.cc:384
flutter::AppLifecycleState::kInactive
@ kInactive
fl_engine_new
FlEngine * fl_engine_new(FlDartProject *project, FlRenderer *renderer)
Definition: fl_engine.cc:466
fl_renderer_collect_backing_store
gboolean fl_renderer_collect_backing_store(FlRenderer *self, const FlutterBackingStore *backing_store)
Definition: fl_renderer.cc:133
fl_pixel_buffer_texture_populate
gboolean fl_pixel_buffer_texture_populate(FlPixelBufferTexture *texture, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
Definition: fl_pixel_buffer_texture.cc:71
fl_renderer_present_layers
gboolean fl_renderer_present_layers(FlRenderer *self, const FlutterLayer **layers, size_t layers_count)
Definition: fl_renderer.cc:157
fl_renderer_headless_new
FlRendererHeadless * fl_renderer_headless_new()
Definition: fl_renderer_headless.cc:57
fl_task_runner_post_task
void fl_task_runner_post_task(FlTaskRunner *self, FlutterTask task, uint64_t target_time_nanos)
Definition: fl_task_runner.cc:169
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
kProp0
@ kProp0
Definition: fl_accessible_node.cc:83
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
fl_texture_gl_populate
gboolean fl_texture_gl_populate(FlTextureGL *self, uint32_t width, uint32_t height, FlutterOpenGLTexture *opengl_texture, GError **error)
Definition: fl_texture_gl.cc:50
self
GdkEvent FlView * self
Definition: fl_view.cc:100
fl_engine_get_registrar_for_plugin
static FlPluginRegistrar * fl_engine_get_registrar_for_plugin(FlPluginRegistry *registry, const gchar *name)
Definition: fl_engine.cc:370
result
GAsyncResult * result
Definition: fl_text_input_plugin.cc:106
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
parse_locale
static void parse_locale(const gchar *locale, gchar **language, gchar **territory, gchar **codeset, gchar **modifier)
Definition: fl_engine.cc:86
fl_string_codec_new
G_MODULE_EXPORT FlStringCodec * fl_string_codec_new()
Definition: fl_string_codec.cc:53
fl_renderer_create_backing_store
gboolean fl_renderer_create_backing_store(FlRenderer *self, const FlutterBackingStoreConfig *config, FlutterBackingStore *backing_store_out)
Definition: fl_renderer.cc:125
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
fl_message_codec_encode_message
G_MODULE_EXPORT GBytes * fl_message_codec_encode_message(FlMessageCodec *self, FlValue *message, GError **error)
Definition: fl_message_codec.cc:17
flutter::AppLifecycleStateToString
constexpr const char * AppLifecycleStateToString(AppLifecycleState state)
Definition: app_lifecycle_state.h:72
fl_plugin_registrar_new
FlPluginRegistrar * fl_plugin_registrar_new(FlView *view, FlBinaryMessenger *messenger, FlTextureRegistrar *texture_registrar)
Definition: fl_plugin_registrar.cc:87
callback
FlKeyEvent uint64_t FlKeyResponderAsyncCallback callback
Definition: fl_key_channel_responder.cc:120
fl_renderer_make_current
gboolean fl_renderer_make_current(FlRenderer *self, GError **error)
Definition: fl_renderer.cc:95
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_renderer_get_fbo
guint32 fl_renderer_get_fbo(FlRenderer *self)
Definition: fl_renderer.cc:120
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
value
uint8_t value
Definition: fl_standard_message_codec.cc:41
fl_task_runner_new
FlTaskRunner * fl_task_runner_new(FlEngine *engine)
Definition: fl_task_runner.cc:161
fl_engine_send_platform_message_response
gboolean fl_engine_send_platform_message_response(FlEngine *self, const FlutterPlatformMessageResponseHandle *handle, GBytes *response, GError **error)
Definition: fl_engine.cc:647
node
G_BEGIN_DECLS const FlutterSemanticsNode * node
Definition: fl_view_accessible.h:40
fl_binary_messenger_send_on_channel
G_MODULE_EXPORT void fl_binary_messenger_send_on_channel(FlBinaryMessenger *self, const gchar *channel, GBytes *message, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data)
Definition: fl_binary_messenger.cc:451
fl_settings_plugin_new
FlSettingsPlugin * fl_settings_plugin_new(FlEngine *engine)
Definition: fl_settings_plugin.cc:94
fl_value_new_string
G_MODULE_EXPORT FlValue * fl_value_new_string(const gchar *value)
Definition: fl_value.cc:265
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
kFlutterLifecycleChannel
static constexpr const char * kFlutterLifecycleChannel
Definition: fl_engine.cc:37
fl_engine_gl_clear_current
static bool fl_engine_gl_clear_current(void *user_data)
Definition: fl_engine.cc:227