| Flutter Linux Embedder |

Classes | Macros | Enumerations | Functions | Variables
fl_application.cc File Reference
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_application.h"`
`#include <gtk/gtk.h>`
`#include "flutter/shell/platform/linux/fl_engine_private.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_dart_project.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_plugin_registry.h"`
`#include "flutter/shell/platform/linux/public/flutter_linux/fl_view.h"`

Go to the source code of this file.

## Classes
struct | FlApplicationPrivate

## Macros
#define | FL_APPLICATION_GET_PRIVATE(app)

## Enumerations
enum | { SIGNAL_REGISTER_PLUGINS , SIGNAL_CREATE_WINDOW , LAST_SIGNAL }

## Functions
| G_DEFINE_TYPE_WITH_CODE (FlApplication, fl_application, GTK_TYPE_APPLICATION, G_ADD_PRIVATE(FlApplication)) static void first_frame_cb(FlApplication *self
| if (window !=nullptr &&GTK_IS_WINDOW(window))
static void | fl_application_register_plugins (FlApplication *self, FlPluginRegistry *registry)
static GtkWindow * | fl_application_create_window (FlApplication *self, FlView *view)
static void | fl_application_activate (GApplication *application)
static gboolean | fl_application_local_command_line (GApplication *application, gchar ***arguments, int *exit_status)
static void | fl_application_dispose (GObject *object)
static void | fl_application_class_init (FlApplicationClass *klass)
static void | fl_application_init (FlApplication *self)
G_MODULE_EXPORT FlApplication * | fl_application_new (const gchar *application_id, GApplicationFlags flags)

## Variables
static guint | fl_application_signals [LAST_SIGNAL]
FlView * | view

## Macro Definition Documentation

## ◆ FL_APPLICATION_GET_PRIVATE

#define FL_APPLICATION_GET_PRIVATE | ( |  | app | ) |

Value:
((FlApplicationPrivate*)fl_application_get_instance_private( \
FL_APPLICATION(app)))
FlApplicationPrivate
Definition: fl_application.cc:17

Definition at line 22 of file fl_application.cc.

## Enumeration Type Documentation

## ◆ anonymous enum

anonymous enum

Enumerator
SIGNAL_REGISTER_PLUGINS |
SIGNAL_CREATE_WINDOW |
LAST_SIGNAL |

Definition at line 26 of file fl_application.cc.

26 { SIGNAL_REGISTER_PLUGINS, SIGNAL_CREATE_WINDOW, LAST_SIGNAL };
LAST_SIGNAL
@ LAST_SIGNAL
Definition: fl_application.cc:26
SIGNAL_CREATE_WINDOW
@ SIGNAL_CREATE_WINDOW
Definition: fl_application.cc:26
SIGNAL_REGISTER_PLUGINS
@ SIGNAL_REGISTER_PLUGINS
Definition: fl_application.cc:26

## Function Documentation

## ◆ fl_application_activate()

static void fl_application_activate | ( | GApplication * | application | ) |
| static

Definition at line 85 of file fl_application.cc.

85 {
86 FlApplication* self = FL_APPLICATION(application);
87 FlApplicationPrivate* priv = FL_APPLICATION_GET_PRIVATE(self);
88
89 g_autoptr(FlDartProject) project = fl_dart_project_new();
90 fl_dart_project_set_dart_entrypoint_arguments(
91 project, priv->dart_entrypoint_arguments);
92
93 FlView* view = fl_view_new(project);
94 g_signal_connect_swapped(view, "first-frame", G_CALLBACK(first_frame_cb),
95 self);
96 gtk_widget_show(GTK_WIDGET(view));
97
98 GtkWindow* window;
99 g_signal_emit(self, fl_application_signals[SIGNAL_CREATE_WINDOW], 0, view,
100 &window);
101
102 // Make the resources for the view so rendering can start.
103 // We'll show the view when we have the first frame.
104 gtk_widget_realize(GTK_WIDGET(view));
105
106 g_signal_emit(self, fl_application_signals[SIGNAL_REGISTER_PLUGINS], 0,
107 FL_PLUGIN_REGISTRY(view));
108 }
g_autoptr
g_autoptr(FlEngine) engine
priv
FlAccessibilityHandlerPrivate * priv
Definition: fl_accessibility_handler.cc:26
view
FlView * view
Definition: fl_application.cc:36
fl_application_signals
static guint fl_application_signals[LAST_SIGNAL]
Definition: fl_application.cc:28
FL_APPLICATION_GET_PRIVATE
#define FL_APPLICATION_GET_PRIVATE(app)
Definition: fl_application.cc:22
fl_dart_project_new
G_MODULE_EXPORT FlDartProject * fl_dart_project_new()
Definition: fl_dart_project.cc:52
fl_dart_project_set_dart_entrypoint_arguments
G_MODULE_EXPORT void fl_dart_project_set_dart_entrypoint_arguments(FlDartProject *self, char **argv)
Definition: fl_dart_project.cc:112
fl_view_new
G_MODULE_EXPORT FlView * fl_view_new(FlDartProject *project)
Definition: fl_view.cc:763

References FL_APPLICATION_GET_PRIVATE, fl_application_signals, fl_dart_project_new(), fl_dart_project_set_dart_entrypoint_arguments(), fl_view_new(), g_autoptr(), priv, SIGNAL_CREATE_WINDOW, SIGNAL_REGISTER_PLUGINS, and view.

Referenced by fl_application_class_init().

## ◆ fl_application_class_init()

static void fl_application_class_init | ( | FlApplicationClass * | klass | ) |
| static

Definition at line 145 of file fl_application.cc.

145 {
146 G_APPLICATION_CLASS(klass)->activate = fl_application_activate;
147 G_APPLICATION_CLASS(klass)->local_command_line =
148 fl_application_local_command_line;
149 G_OBJECT_CLASS(klass)->dispose = fl_application_dispose;
150
151 klass->register_plugins = fl_application_register_plugins;
152 klass->create_window = fl_application_create_window;
153
154 fl_application_signals[SIGNAL_REGISTER_PLUGINS] = g_signal_new(
155 "register-plugins", fl_application_get_type(), G_SIGNAL_RUN_LAST,
156 G_STRUCT_OFFSET(FlApplicationClass, register_plugins), nullptr, nullptr,
157 nullptr, G_TYPE_NONE, 1, fl_plugin_registry_get_type());
158 fl_application_signals[SIGNAL_CREATE_WINDOW] = g_signal_new(
159 "create-window", fl_application_get_type(), G_SIGNAL_RUN_LAST,
160 G_STRUCT_OFFSET(FlApplicationClass, create_window),
161 g_signal_accumulator_first_wins, nullptr, nullptr, GTK_TYPE_WINDOW, 1,
162 fl_view_get_type());
163 }
fl_application_dispose
static void fl_application_dispose(GObject *object)
Definition: fl_application.cc:136
fl_application_local_command_line
static gboolean fl_application_local_command_line(GApplication *application, gchar ***arguments, int *exit_status)
Definition: fl_application.cc:111
fl_application_create_window
static GtkWindow * fl_application_create_window(FlApplication *self, FlView *view)
Definition: fl_application.cc:50
fl_application_register_plugins
static void fl_application_register_plugins(FlApplication *self, FlPluginRegistry *registry)
Definition: fl_application.cc:46
fl_application_activate
static void fl_application_activate(GApplication *application)
Definition: fl_application.cc:85

References fl_application_activate(), fl_application_create_window(), fl_application_dispose(), fl_application_local_command_line(), fl_application_register_plugins(), fl_application_signals, SIGNAL_CREATE_WINDOW, and SIGNAL_REGISTER_PLUGINS.

## ◆ fl_application_create_window()

static GtkWindow* fl_application_create_window | ( | FlApplication * | self,
|  | FlView * | view
| ) |  |
| static

Definition at line 50 of file fl_application.cc.

51 {
52 GtkApplicationWindow* window =
53 GTK_APPLICATION_WINDOW(gtk_application_window_new(GTK_APPLICATION(self)));
54
55 // Use a header bar when running in GNOME as this is the common style used
56 // by applications and is the setup most users will be using (e.g. Ubuntu
57 // desktop).
58 // If running on X and not using GNOME then just use a traditional title bar
59 // in case the window manager does more exotic layout, e.g. tiling.
60 // If running on Wayland assume the header bar will work (may need changing
61 // if future cases occur).
62 gboolean use_header_bar = TRUE;
63 #ifdef GDK_WINDOWING_X11
64 GdkScreen* screen = gtk_window_get_screen(GTK_WINDOW(window));
65 if (GDK_IS_X11_SCREEN(screen)) {
66 const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen);
67 if (g_strcmp0(wm_name, "GNOME Shell") != 0) {
68 use_header_bar = FALSE;
69 }
70 }
71 #endif
72 if (use_header_bar) {
73 GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new());
74 gtk_widget_show(GTK_WIDGET(header_bar));
75 gtk_header_bar_set_show_close_button(header_bar, TRUE);
76 gtk_window_set_titlebar(GTK_WINDOW(window), GTK_WIDGET(header_bar));
77 }
78
79 gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view));
80
81 return GTK_WINDOW(window);
82 }
TRUE
return TRUE
Definition: fl_compositor_software.cc:68

References TRUE, and view.

Referenced by fl_application_class_init().

## ◆ fl_application_dispose()

static void fl_application_dispose | ( | GObject * | object | ) |
| static

Definition at line 136 of file fl_application.cc.

136 {
137 FlApplication* self = FL_APPLICATION(object);
138 FlApplicationPrivate* priv = FL_APPLICATION_GET_PRIVATE(self);
139
140 g_clear_pointer(&priv->dart_entrypoint_arguments, g_strfreev);
141
142 G_OBJECT_CLASS(fl_application_parent_class)->dispose(object);
143 }

References FL_APPLICATION_GET_PRIVATE, and priv.

Referenced by fl_application_class_init().

## ◆ fl_application_init()

static void fl_application_init | ( | FlApplication * | self | ) |
| static

Definition at line 165 of file fl_application.cc.

165 {}

## ◆ fl_application_local_command_line()

static gboolean fl_application_local_command_line | ( | GApplication * | application,
|  | gchar *** | arguments,
|  | int * | exit_status
| ) |  |
| static

Definition at line 111 of file fl_application.cc.

113 {
114 FlApplication* self = FL_APPLICATION(application);
115 FlApplicationPrivate* priv = FL_APPLICATION_GET_PRIVATE(self);
116
117 // Strip out the first argument as it is the binary name.
118 priv->dart_entrypoint_arguments = g_strdupv(*arguments + 1);
119
120 g_autoptr(GError) error = nullptr;
121 if (!g_application_register(application, nullptr, &error)) {
122 g_warning("Failed to register: %s", error->message);
123 *exit_status = 1;
124 return TRUE;
125 }
126
127 // This will only run on the primary instance or this instance with
128 // G_APPLICATION_NON_UNIQUE
129 g_application_activate(application);
130 *exit_status = 0;
131
132 return TRUE;
133 }
error
const uint8_t uint32_t uint32_t GError ** error
Definition: fl_pixel_buffer_texture_test.cc:40

References error, FL_APPLICATION_GET_PRIVATE, g_autoptr(), priv, and TRUE.

Referenced by fl_application_class_init().

## ◆ fl_application_new()

G_MODULE_EXPORT FlApplication* fl_application_new | ( | const gchar * | application_id,
|  | GApplicationFlags | flags
| ) |  |

FlApplication:

#Flutter-based application with the GTK embedder.

Provides default behaviour for basic Flutter applications. fl_application_new: @application_id: (allow-none): The application ID or NULL. @flags: The application flags.

Creates a new Flutter-based application.

Returns: a new #FlApplication

Definition at line 168 of file fl_application.cc.

169 {
170 return FL_APPLICATION(g_object_new(fl_application_get_type(),
171 "application-id", application_id, "flags",
172 flags, nullptr));
173 }

Referenced by TEST().

## ◆ fl_application_register_plugins()

static void fl_application_register_plugins | ( | FlApplication * | self,
|  | FlPluginRegistry * | registry
| ) |  |
| static

Definition at line 46 of file fl_application.cc.

47 {}

Referenced by fl_application_class_init().

## ◆ G_DEFINE_TYPE_WITH_CODE()

G_DEFINE_TYPE_WITH_CODE | ( | FlApplication | ,
|  | fl_application | ,
|  | GTK_TYPE_APPLICATION | ,
|  | G_ADD_PRIVATE(FlApplication) |
| ) |  |

## ◆ if()

if | ( | window ! | = `nullptr && GTK_IS_WINDOW(window)` | ) |

Definition at line 40 of file fl_application.cc.

40 {
41 gtk_window_present(GTK_WINDOW(window));
42 }

## Variable Documentation

## ◆ fl_application_signals

guint fl_application_signals[LAST_SIGNAL]
| static

Definition at line 28 of file fl_application.cc.

Referenced by fl_application_activate(), and fl_application_class_init().

## ◆ view

FlView* view

Initial value:
{
GtkWidget* window = gtk_widget_get_toplevel(GTK_WIDGET(view))

Definition at line 36 of file fl_application.cc.

Referenced by fl_application_activate(), and fl_application_create_window().