Flutter Engine Uber Docs
Docs for the entire Flutter Engine repo.
 
Loading...
Searching...
No Matches
flutter::FlutterWindowsEngine Class Reference

#include <flutter_windows_engine.h>

Inheritance diagram for flutter::FlutterWindowsEngine:
flutter::testing::TestFlutterWindowsEngine

Public Member Functions

 FlutterWindowsEngine (const FlutterProjectBundle &project, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr)
 
virtual ~FlutterWindowsEngine ()
 
bool Run ()
 
bool Run (std::string_view entrypoint)
 
virtual bool running () const
 
virtual bool Stop ()
 
std::unique_ptr< FlutterWindowsViewCreateView (std::unique_ptr< WindowBindingHandler > window, bool is_sized_to_content, const BoxConstraints &box_constraints, FlutterWindowsViewSizingDelegate *sizing_delegate=nullptr)
 
virtual void RemoveView (FlutterViewId view_id)
 
FlutterWindowsViewview (FlutterViewId view_id) const
 
FlutterDesktopPluginRegistrarRef GetRegistrar ()
 
void AddPluginRegistrarDestructionCallback (FlutterDesktopOnPluginRegistrarDestroyed callback, FlutterDesktopPluginRegistrarRef registrar)
 
void SetSwitches (const std::vector< std::string > &switches)
 
FlutterDesktopMessengerRef messenger ()
 
IncomingMessageDispatchermessage_dispatcher ()
 
std::shared_ptr< DisplayManagerWin32display_manager ()
 
void UpdateDisplay (const std::vector< FlutterEngineDisplay > &displays)
 
TaskRunnertask_runner ()
 
BinaryMessengermessenger_wrapper ()
 
FlutterWindowsTextureRegistrartexture_registrar ()
 
egl::Manageregl_manager () const
 
WindowProcDelegateManagerwindow_proc_delegate_manager ()
 
void SendWindowMetricsEvent (const FlutterWindowMetricsEvent &event)
 
void SendPointerEvent (const FlutterPointerEvent &event)
 
void SendKeyEvent (const FlutterKeyEvent &event, FlutterKeyEventCallback callback, void *user_data)
 
void SendViewFocusEvent (const FlutterViewFocusEvent &event)
 
KeyboardHandlerBasekeyboard_key_handler ()
 
TextInputPlugintext_input_plugin ()
 
bool SendPlatformMessage (const char *channel, const uint8_t *message, const size_t message_size, const FlutterDesktopBinaryReply reply, void *user_data)
 
void SendPlatformMessageResponse (const FlutterDesktopMessageResponseHandle *handle, const uint8_t *data, size_t data_length)
 
void HandlePlatformMessage (const FlutterPlatformMessage *)
 
void ReloadSystemFonts ()
 
void ScheduleFrame ()
 
void SetNextFrameCallback (fml::closure callback)
 
bool RegisterExternalTexture (int64_t texture_id)
 
bool UnregisterExternalTexture (int64_t texture_id)
 
bool MarkExternalTextureFrameAvailable (int64_t texture_id)
 
virtual bool PostRasterThreadTask (fml::closure callback) const
 
void OnVsync (intptr_t baton)
 
bool DispatchSemanticsAction (FlutterViewId view_id, uint64_t node_id, FlutterSemanticsAction action, fml::MallocMapping data)
 
void UpdateSemanticsEnabled (bool enabled)
 
bool semantics_enabled () const
 
bool iaccessibleex_enabled () const
 
void UpdateAccessibilityFeatures ()
 
void UpdateHighContrastMode ()
 
bool high_contrast_enabled () const
 
void SetRootIsolateCreateCallback (const fml::closure &callback)
 
std::string GetExecutableName () const
 
void OnQuit (std::optional< HWND > hwnd, std::optional< WPARAM > wparam, std::optional< LPARAM > lparam, UINT exit_code)
 
void RequestApplicationQuit (HWND hwnd, WPARAM wparam, LPARAM lparam, AppExitType exit_type)
 
void OnDwmCompositionChanged ()
 
void OnWindowStateEvent (HWND hwnd, WindowStateEvent event)
 
std::optional< LRESULTProcessExternalWindowMessage (HWND hwnd, UINT message, WPARAM wparam, LPARAM lparam)
 
WindowsLifecycleManagerlifecycle_manager ()
 
std::shared_ptr< WindowsProcTablewindows_proc_table ()
 
void UpdateFlutterCursor (const std::string &cursor_name) const
 
void SetFlutterCursor (HCURSOR cursor) const
 
WindowManagerwindow_manager ()
 
FlutterWindowsViewGetViewFromTopLevelWindow (HWND hwnd) const
 

Static Public Member Functions

static FlutterWindowsEngineGetEngineForId (int64_t engine_id)
 

Protected Member Functions

virtual std::unique_ptr< KeyboardHandlerBaseCreateKeyboardKeyHandler (BinaryMessenger *messenger, KeyboardKeyEmbedderHandler::GetKeyStateHandler get_key_state, KeyboardKeyEmbedderHandler::MapVirtualKeyToScanCode map_vk_to_scan)
 
virtual std::unique_ptr< TextInputPluginCreateTextInputPlugin (BinaryMessenger *messenger)
 
void OnPreEngineRestart ()
 
virtual void OnChannelUpdate (std::string name, bool listening)
 
virtual void OnViewFocusChangeRequest (const FlutterViewFocusChangeRequest *request)
 

Friends

class EngineModifier
 

Detailed Description

Definition at line 92 of file flutter_windows_engine.h.

Constructor & Destructor Documentation

◆ FlutterWindowsEngine()

flutter::FlutterWindowsEngine::FlutterWindowsEngine ( const FlutterProjectBundle project,
std::shared_ptr< WindowsProcTable windows_proc_table = nullptr 
)

Definition at line 151 of file flutter_windows_engine.cc.

154 : project_(std::make_unique<FlutterProjectBundle>(project)),
155 windows_proc_table_(std::move(windows_proc_table)),
156 aot_data_(nullptr, nullptr),
157 lifecycle_manager_(std::make_unique<WindowsLifecycleManager>(this)) {
158 if (windows_proc_table_ == nullptr) {
159 windows_proc_table_ = std::make_shared<WindowsProcTable>();
160 }
161
163
164 embedder_api_.struct_size = sizeof(FlutterEngineProcTable);
165 FlutterEngineGetProcAddresses(&embedder_api_);
166
167 task_runner_ =
168 std::make_unique<TaskRunner>(
169 embedder_api_.GetCurrentTime, [this](const auto* task) {
170 if (!engine_) {
171 FML_LOG(ERROR)
172 << "Cannot post an engine task when engine is not running.";
173 return;
174 }
175 if (embedder_api_.RunTask(engine_, task) != kSuccess) {
176 FML_LOG(ERROR) << "Failed to post an engine task.";
177 }
178 });
179
180 // Set up the legacy structs backing the API handles.
181 messenger_ =
183 messenger_->SetEngine(this);
184 plugin_registrar_ = std::make_unique<FlutterDesktopPluginRegistrar>();
185 plugin_registrar_->engine = this;
186
187 messenger_wrapper_ =
188 std::make_unique<BinaryMessengerImpl>(messenger_->ToRef());
189 message_dispatcher_ =
190 std::make_unique<IncomingMessageDispatcher>(messenger_->ToRef());
191
192 texture_registrar_ =
193 std::make_unique<FlutterWindowsTextureRegistrar>(this, gl_);
194
195 // Check for impeller support.
196 auto& switches = project_->GetSwitches();
197 enable_impeller_ = std::find(switches.begin(), switches.end(),
198 "--enable-impeller=true") != switches.end();
199
200 egl_manager_ = egl::Manager::Create(
201 static_cast<egl::GpuPreference>(project_->gpu_preference()));
202 window_proc_delegate_manager_ = std::make_unique<WindowProcDelegateManager>();
203
204 display_manager_ = std::make_shared<DisplayManagerWin32>(this);
205
206 window_proc_delegate_manager_->RegisterTopLevelWindowProcDelegate(
207 [](HWND hwnd, UINT msg, WPARAM wpar, LPARAM lpar, void* user_data,
208 LRESULT* result) {
211 static_cast<FlutterWindowsEngine*>(user_data);
212
213 BASE_DCHECK(that->display_manager_);
214 if (that->display_manager_->HandleWindowMessage(hwnd, msg, wpar, lpar,
215 result)) {
216 return true;
217 }
218
219 BASE_DCHECK(that->lifecycle_manager_);
220 bool handled =
221 that->lifecycle_manager_->WindowProc(hwnd, msg, wpar, lpar, result);
222 if (handled) {
223 return true;
224 }
225 auto message_result =
226 that->window_manager_->HandleMessage(hwnd, msg, wpar, lpar);
227 if (message_result) {
228 *result = *message_result;
229 return true;
230 }
231 return false;
232 },
233 static_cast<void*>(this));
234
235 // Set up internal channels.
236 // TODO: Replace this with an embedder.h API. See
237 // https://github.com/flutter/flutter/issues/71099
238 internal_plugin_registrar_ =
239 std::make_unique<PluginRegistrar>(plugin_registrar_.get());
240
241 accessibility_plugin_ = std::make_unique<AccessibilityPlugin>(this);
242 AccessibilityPlugin::SetUp(messenger_wrapper_.get(),
243 accessibility_plugin_.get());
244
245 cursor_handler_ =
246 std::make_unique<CursorHandler>(messenger_wrapper_.get(), this);
247 platform_handler_ =
248 std::make_unique<PlatformHandler>(messenger_wrapper_.get(), this);
249 window_manager_ = std::make_unique<WindowManager>(this);
250 settings_plugin_ = std::make_unique<SettingsPlugin>(messenger_wrapper_.get(),
251 task_runner_.get());
252}
static void SetUp(BinaryMessenger *binary_messenger, AccessibilityPlugin *plugin)
FlutterWindowsEngine(const FlutterProjectBundle &project, std::shared_ptr< WindowsProcTable > windows_proc_table=nullptr)
std::shared_ptr< WindowsProcTable > windows_proc_table()
static std::unique_ptr< Manager > Create(GpuPreference gpu_preference)
Definition manager.cc:17
static std::shared_ptr< ProcTable > Create()
Definition proc_table.cc:12
FlutterEngineResult FlutterEngineGetProcAddresses(FlutterEngineProcTable *table)
Gets the table of engine function pointers.
Definition embedder.cc:3741
if(engine==nullptr)
Function-pointer-based versions of the APIs above.
Definition embedder.h:3763
size_t struct_size
The size of this struct. Must be sizeof(FlutterEngineProcs).
Definition embedder.h:3765
FlutterEngineGetCurrentTimeFnPtr GetCurrentTime
Definition embedder.h:3796
FlutterEngineRunTaskFnPtr RunTask
Definition embedder.h:3797
#define BASE_DCHECK(condition)
Definition logging.h:63
LONG_PTR LRESULT
unsigned int UINT
LONG_PTR LPARAM
UINT_PTR WPARAM

References flutter::egl::ProcTable::Create(), FlutterEngineGetProcAddresses(), FlutterEngineProcTable::GetCurrentTime, if(), flutter::kSuccess, FlutterEngineProcTable::RunTask, and FlutterEngineProcTable::struct_size.

◆ ~FlutterWindowsEngine()

flutter::FlutterWindowsEngine::~FlutterWindowsEngine ( )
virtual

Definition at line 254 of file flutter_windows_engine.cc.

254 {
255 messenger_->SetEngine(nullptr);
256 Stop();
257}
void SetEngine(flutter::FlutterWindowsEngine *arg_engine)

Member Function Documentation

◆ AddPluginRegistrarDestructionCallback()

void flutter::FlutterWindowsEngine::AddPluginRegistrarDestructionCallback ( FlutterDesktopOnPluginRegistrarDestroyed  callback,
FlutterDesktopPluginRegistrarRef  registrar 
)

Definition at line 723 of file flutter_windows_engine.cc.

725 {
726 plugin_registrar_destruction_callbacks_[callback] = registrar;
727}
FlutterDesktopBinaryReply callback

References callback.

◆ CreateKeyboardKeyHandler()

std::unique_ptr< KeyboardHandlerBase > flutter::FlutterWindowsEngine::CreateKeyboardKeyHandler ( BinaryMessenger messenger,
KeyboardKeyEmbedderHandler::GetKeyStateHandler  get_key_state,
KeyboardKeyEmbedderHandler::MapVirtualKeyToScanCode  map_vk_to_scan 
)
protectedvirtual

Reimplemented in flutter::testing::TestFlutterWindowsEngine.

Definition at line 930 of file flutter_windows_engine.cc.

933 {
934 auto keyboard_key_handler = std::make_unique<KeyboardKeyHandler>(messenger);
935 keyboard_key_handler->AddDelegate(
936 std::make_unique<KeyboardKeyEmbedderHandler>(
938 void* user_data) {
939 return SendKeyEvent(event, callback, user_data);
940 },
941 get_key_state, map_vk_to_scan));
942 keyboard_key_handler->AddDelegate(
943 std::make_unique<KeyboardKeyChannelHandler>(messenger));
944 keyboard_key_handler->InitKeyboardChannel();
946}
FlutterDesktopMessengerRef messenger()
KeyboardHandlerBase * keyboard_key_handler()
void SendKeyEvent(const FlutterKeyEvent &event, FlutterKeyEventCallback callback, void *user_data)
void(* FlutterKeyEventCallback)(bool, void *)
Definition embedder.h:1482

References callback, and user_data.

Referenced by flutter::testing::TestFlutterWindowsEngine::CreateKeyboardKeyHandler().

◆ CreateTextInputPlugin()

std::unique_ptr< TextInputPlugin > flutter::FlutterWindowsEngine::CreateTextInputPlugin ( BinaryMessenger messenger)
protectedvirtual

Definition at line 948 of file flutter_windows_engine.cc.

949 {
950 return std::make_unique<TextInputPlugin>(messenger, this);
951}

◆ CreateView()

std::unique_ptr< FlutterWindowsView > flutter::FlutterWindowsEngine::CreateView ( std::unique_ptr< WindowBindingHandler window,
bool  is_sized_to_content,
const BoxConstraints box_constraints,
FlutterWindowsViewSizingDelegate sizing_delegate = nullptr 
)

Definition at line 534 of file flutter_windows_engine.cc.

538 {
539 auto view_id = next_view_id_;
540 auto view = std::make_unique<FlutterWindowsView>(
541 view_id, this, std::move(window), is_sized_to_content, box_constraints,
542 sizing_delegate, windows_proc_table_);
543
545 view->UpdateSemanticsEnabled(semantics_enabled_);
546
547 next_view_id_++;
548
549 {
550 // Add the view to the embedder. This must happen before the engine
551 // is notified the view exists and starts presenting to it.
552 std::unique_lock write_lock(views_mutex_);
553 FML_DCHECK(views_.find(view_id) == views_.end());
554 views_[view_id] = view.get();
555 }
556
557 if (!view->IsImplicitView()) {
559
560 struct Captures {
562 bool added;
563 };
564 Captures captures = {};
565
567
568 FlutterAddViewInfo info = {};
569 info.struct_size = sizeof(FlutterAddViewInfo);
570 info.view_id = view_id;
571 info.view_metrics = &metrics;
572 info.user_data = &captures;
573 info.add_view_callback = [](const FlutterAddViewResult* result) {
574 Captures* captures = reinterpret_cast<Captures*>(result->user_data);
575 captures->added = result->added;
576 captures->latch.Signal();
577 };
578
579 FlutterEngineResult result = embedder_api_.AddView(engine_, &info);
580 if (result != kSuccess) {
581 FML_LOG(ERROR)
582 << "Starting the add view operation failed. FlutterEngineAddView "
583 "returned an unexpected result: "
584 << result << ". This indicates a bug in the Windows embedder.";
585 FML_DCHECK(false);
586 return nullptr;
587 }
588
589 // Block the platform thread until the engine has added the view.
590 // TODO(loicsharma): This blocks the platform thread eagerly and can
591 // cause unnecessary delay in input processing. Instead, this should block
592 // lazily only when the app does an operation which needs the view.
593 // https://github.com/flutter/flutter/issues/146248
594 captures.latch.Wait();
595
596 if (!captures.added) {
597 // Adding the view failed. Update the embedder's state to match the
598 // engine's state. This is unexpected and indicates a bug in the Windows
599 // embedder.
600 FML_LOG(ERROR) << "FlutterEngineAddView failed to add view";
601 std::unique_lock write_lock(views_mutex_);
602 views_.erase(view_id);
603 return nullptr;
604 }
605 }
606
607 return std::move(view);
608}
FlutterWindowsView * view(FlutterViewId view_id) const
virtual void UpdateSemanticsEnabled(bool enabled)
FlutterWindowMetricsEvent CreateWindowMetricsEvent() const
FlutterEngineResult
Definition embedder.h:72
GLFWwindow * window
Definition main.cc:60
G_BEGIN_DECLS FlutterViewId view_id
#define FML_LOG(severity)
Definition logging.h:101
#define FML_DCHECK(condition)
Definition logging.h:122
FlutterAddViewCallback add_view_callback
Definition embedder.h:1147
FlutterViewId view_id
The identifier for the view to add. This must be unique.
Definition embedder.h:1127
const FlutterWindowMetricsEvent * view_metrics
Definition embedder.h:1132
FlutterEngineAddViewFnPtr AddView
Definition embedder.h:3807

References FlutterAddViewInfo::add_view_callback, FML_DCHECK, FML_LOG, kSuccess, FlutterAddViewInfo::struct_size, FlutterAddViewInfo::user_data, view, FlutterAddViewInfo::view_id, view_id, FlutterAddViewInfo::view_metrics, and window.

Referenced by CreateViewController(), and flutter::HostWindow::InitializeFlutterView().

◆ DispatchSemanticsAction()

bool flutter::FlutterWindowsEngine::DispatchSemanticsAction ( FlutterViewId  view_id,
uint64_t  node_id,
FlutterSemanticsAction  action,
fml::MallocMapping  data 
)

Definition at line 989 of file flutter_windows_engine.cc.

993 {
996 .view_id = view_id,
997 .node_id = target,
998 .action = action,
999 .data = data.GetMapping(),
1000 .data_length = data.GetSize(),
1001 };
1002 return (embedder_api_.SendSemanticsAction(engine_, &info));
1003}
uint32_t * target
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot data
Definition switch_defs.h:36
FlutterEngineSendSemanticsActionFnPtr SendSemanticsAction
Definition embedder.h:3810

References action, flutter::data, FlutterSendSemanticsActionInfo::struct_size, target, and view_id.

Referenced by flutter::AccessibilityBridgeWindows::DispatchAccessibilityAction().

◆ display_manager()

std::shared_ptr< DisplayManagerWin32 > flutter::FlutterWindowsEngine::display_manager ( )
inline

Definition at line 166 of file flutter_windows_engine.h.

166 {
167 return display_manager_;
168 }

Referenced by CreateViewController(), and flutter::HostWindow::InitializeFlutterView().

◆ egl_manager()

◆ GetEngineForId()

◆ GetExecutableName()

std::string flutter::FlutterWindowsEngine::GetExecutableName ( ) const

Definition at line 1022 of file flutter_windows_engine.cc.

1022 {
1023 std::pair<bool, std::string> result = fml::paths::GetExecutablePath();
1024 if (result.first) {
1025 const std::string& executable_path = result.second;
1026 size_t last_separator = executable_path.find_last_of("/\\");
1027 if (last_separator == std::string::npos ||
1028 last_separator == executable_path.size() - 1) {
1029 return executable_path;
1030 }
1031 return executable_path.substr(last_separator + 1);
1032 }
1033 return "Flutter";
1034}
std::pair< bool, std::string > GetExecutablePath()

References fml::paths::GetExecutablePath().

◆ GetRegistrar()

FlutterDesktopPluginRegistrarRef flutter::FlutterWindowsEngine::GetRegistrar ( )

Definition at line 719 of file flutter_windows_engine.cc.

719 {
720 return plugin_registrar_.get();
721}

Referenced by FlutterDesktopEngineGetPluginRegistrar().

◆ GetViewFromTopLevelWindow()

FlutterWindowsView * flutter::FlutterWindowsEngine::GetViewFromTopLevelWindow ( HWND  hwnd) const

Definition at line 883 of file flutter_windows_engine.cc.

884 {
885 std::shared_lock read_lock(views_mutex_);
886 auto const iterator =
887 std::find_if(views_.begin(), views_.end(), [hwnd](auto const& pair) {
888 FlutterWindowsView* const view = pair.second;
889 return GetAncestor(view->GetWindowHandle(), GA_ROOT) == hwnd;
890 });
891 if (iterator != views_.end()) {
892 return iterator->second;
893 }
894 return nullptr;
895}

◆ HandlePlatformMessage()

void flutter::FlutterWindowsEngine::HandlePlatformMessage ( const FlutterPlatformMessage engine_message)

Definition at line 807 of file flutter_windows_engine.cc.

808 {
809 if (engine_message->struct_size != sizeof(FlutterPlatformMessage)) {
810 FML_LOG(ERROR) << "Invalid message size received. Expected: "
811 << sizeof(FlutterPlatformMessage) << " but received "
812 << engine_message->struct_size;
813 return;
814 }
815
816 auto message = ConvertToDesktopMessage(*engine_message);
817
818 message_dispatcher_->HandleMessage(message, [this] {}, [this] {});
819}
const char * message
static FlutterDesktopMessage ConvertToDesktopMessage(const FlutterPlatformMessage &engine_message)
size_t struct_size
The size of this struct. Must be sizeof(FlutterPlatformMessage).
Definition embedder.h:1491

References ConvertToDesktopMessage(), FML_LOG, message, and FlutterPlatformMessage::struct_size.

◆ high_contrast_enabled()

bool flutter::FlutterWindowsEngine::high_contrast_enabled ( ) const
inline

Definition at line 275 of file flutter_windows_engine.h.

275{ return high_contrast_enabled_; }

◆ iaccessibleex_enabled()

bool flutter::FlutterWindowsEngine::iaccessibleex_enabled ( ) const
inline

Definition at line 263 of file flutter_windows_engine.h.

263 {
264 return project_->accessibility_mode() ==
266 }

References flutter::IAccessibleEx.

Referenced by flutter::FlutterPlatformNodeDelegateWindows::IsIAccessibleExEnabled().

◆ keyboard_key_handler()

KeyboardHandlerBase * flutter::FlutterWindowsEngine::keyboard_key_handler ( )
inline

Definition at line 203 of file flutter_windows_engine.h.

203 {
204 return keyboard_key_handler_.get();
205 }

Referenced by flutter::FlutterWindowsView::OnPointerMove().

◆ lifecycle_manager()

WindowsLifecycleManager * flutter::FlutterWindowsEngine::lifecycle_manager ( )
inline

Definition at line 320 of file flutter_windows_engine.h.

320 {
321 return lifecycle_manager_.get();
322 }

◆ MarkExternalTextureFrameAvailable()

bool flutter::FlutterWindowsEngine::MarkExternalTextureFrameAvailable ( int64_t  texture_id)

Definition at line 963 of file flutter_windows_engine.cc.

964 {
965 return (embedder_api_.MarkExternalTextureFrameAvailable(
966 engine_, texture_id) == kSuccess);
967}
FlutterEngineMarkExternalTextureFrameAvailableFnPtr MarkExternalTextureFrameAvailable
Definition embedder.h:3786
int64_t texture_id

References kSuccess, and texture_id.

◆ message_dispatcher()

IncomingMessageDispatcher * flutter::FlutterWindowsEngine::message_dispatcher ( )
inline

Definition at line 162 of file flutter_windows_engine.h.

162 {
163 return message_dispatcher_.get();
164 }

Referenced by FlutterDesktopMessengerSetCallback().

◆ messenger()

FlutterDesktopMessengerRef flutter::FlutterWindowsEngine::messenger ( )
inline

Definition at line 160 of file flutter_windows_engine.h.

160{ return messenger_->ToRef(); }
FlutterDesktopMessengerRef ToRef()
Convert to FlutterDesktopMessengerRef.

References flutter::FlutterDesktopMessenger::ToRef().

Referenced by flutter::testing::TestFlutterWindowsEngine::CreateKeyboardKeyHandler(), and FlutterDesktopEngineGetMessenger().

◆ messenger_wrapper()

BinaryMessenger * flutter::FlutterWindowsEngine::messenger_wrapper ( )
inline

Definition at line 175 of file flutter_windows_engine.h.

175{ return messenger_wrapper_.get(); }

◆ OnChannelUpdate()

void flutter::FlutterWindowsEngine::OnChannelUpdate ( std::string  name,
bool  listening 
)
protectedvirtual

Definition at line 1110 of file flutter_windows_engine.cc.

1110 {
1111 if (name == "flutter/platform" && listening) {
1112 lifecycle_manager_->BeginProcessingExit();
1113 } else if (name == "flutter/lifecycle" && listening) {
1114 lifecycle_manager_->BeginProcessingLifecycle();
1115 }
1116}
DEF_SWITCHES_START aot vmservice shared library name
Definition switch_defs.h:27

References name.

◆ OnDwmCompositionChanged()

void flutter::FlutterWindowsEngine::OnDwmCompositionChanged ( )

Definition at line 1073 of file flutter_windows_engine.cc.

1073 {
1074 if (display_manager_) {
1075 display_manager_->UpdateDisplays();
1076 }
1077
1078 std::shared_lock read_lock(views_mutex_);
1079 for (auto iterator = views_.begin(); iterator != views_.end(); iterator++) {
1080 iterator->second->OnDwmCompositionChanged();
1081 }
1082}

Referenced by flutter::WindowsLifecycleManager::WindowProc().

◆ OnPreEngineRestart()

void flutter::FlutterWindowsEngine::OnPreEngineRestart ( )
protected

Definition at line 1017 of file flutter_windows_engine.cc.

1017 {
1018 // Reset the keyboard's state on hot restart.
1019 InitializeKeyboard();
1020}

Referenced by flutter::EngineModifier::Restart().

◆ OnQuit()

void flutter::FlutterWindowsEngine::OnQuit ( std::optional< HWND >  hwnd,
std::optional< WPARAM wparam,
std::optional< LPARAM lparam,
UINT  exit_code 
)

Definition at line 1066 of file flutter_windows_engine.cc.

1069 {
1070 lifecycle_manager_->Quit(hwnd, wparam, lparam, exit_code);
1071}

Referenced by flutter::PlatformHandler::QuitApplication().

◆ OnViewFocusChangeRequest()

void flutter::FlutterWindowsEngine::OnViewFocusChangeRequest ( const FlutterViewFocusChangeRequest request)
protectedvirtual

Definition at line 1118 of file flutter_windows_engine.cc.

1119 {
1120 std::shared_lock read_lock(views_mutex_);
1121
1122 auto iterator = views_.find(request->view_id);
1123 if (iterator == views_.end()) {
1124 return;
1125 }
1126
1127 FlutterWindowsView* view = iterator->second;
1128 view->Focus();
1129}
FlView * view
FlutterViewId view_id
The identifier of the view that received the focus event.
Definition embedder.h:1257

References view, and FlutterViewFocusChangeRequest::view_id.

Referenced by flutter::EngineModifier::OnViewFocusChangeRequest().

◆ OnVsync()

void flutter::FlutterWindowsEngine::OnVsync ( intptr_t  baton)

Definition at line 679 of file flutter_windows_engine.cc.

679 {
680 std::chrono::nanoseconds current_time =
681 std::chrono::nanoseconds(embedder_api_.GetCurrentTime());
682 std::chrono::nanoseconds frame_interval = FrameInterval();
683 auto next = SnapToNextTick(current_time, start_time_, frame_interval);
684 embedder_api_.OnVsync(engine_, baton, next.count(),
685 (next + frame_interval).count());
686}
FlutterEngineOnVsyncFnPtr OnVsync
Definition embedder.h:3790

◆ OnWindowStateEvent()

void flutter::FlutterWindowsEngine::OnWindowStateEvent ( HWND  hwnd,
WindowStateEvent  event 
)

Definition at line 1084 of file flutter_windows_engine.cc.

1085 {
1086 lifecycle_manager_->OnWindowStateEvent(hwnd, event);
1087}

Referenced by flutter::FlutterWindowsView::OnWindowStateEvent(), and flutter::FlutterWindowsView::~FlutterWindowsView().

◆ PostRasterThreadTask()

bool flutter::FlutterWindowsEngine::PostRasterThreadTask ( fml::closure  callback) const
virtual

Definition at line 969 of file flutter_windows_engine.cc.

969 {
970 struct Captures {
972 };
973 auto captures = new Captures();
974 captures->callback = std::move(callback);
975 if (embedder_api_.PostRenderThreadTask(
976 engine_,
977 [](void* opaque) {
978 auto captures = reinterpret_cast<Captures*>(opaque);
979 captures->callback();
980 delete captures;
981 },
982 captures) == kSuccess) {
983 return true;
984 }
985 delete captures;
986 return false;
987}
std::function< void()> closure
Definition closure.h:14
FlutterEnginePostRenderThreadTaskFnPtr PostRenderThreadTask
Definition embedder.h:3795

References callback, and kSuccess.

Referenced by flutter::FlutterWindowsTextureRegistrar::UnregisterTexture().

◆ ProcessExternalWindowMessage()

std::optional< LRESULT > flutter::FlutterWindowsEngine::ProcessExternalWindowMessage ( HWND  hwnd,
UINT  message,
WPARAM  wparam,
LPARAM  lparam 
)

Definition at line 1089 of file flutter_windows_engine.cc.

1093 {
1094 if (lifecycle_manager_) {
1095 return lifecycle_manager_->ExternalWindowMessage(hwnd, message, wparam,
1096 lparam);
1097 }
1098 return std::nullopt;
1099}

References message.

Referenced by FlutterDesktopEngineProcessExternalWindowMessage().

◆ RegisterExternalTexture()

bool flutter::FlutterWindowsEngine::RegisterExternalTexture ( int64_t  texture_id)

Definition at line 953 of file flutter_windows_engine.cc.

953 {
954 return (embedder_api_.RegisterExternalTexture(engine_, texture_id) ==
955 kSuccess);
956}
FlutterEngineRegisterExternalTextureFnPtr RegisterExternalTexture
Definition embedder.h:3783

References kSuccess, and texture_id.

◆ ReloadSystemFonts()

void flutter::FlutterWindowsEngine::ReloadSystemFonts ( )

Definition at line 821 of file flutter_windows_engine.cc.

821 {
822 embedder_api_.ReloadSystemFonts(engine_);
823}
FlutterEngineReloadSystemFontsFnPtr ReloadSystemFonts
Definition embedder.h:3791

Referenced by FlutterDesktopEngineReloadSystemFonts().

◆ RemoveView()

void flutter::FlutterWindowsEngine::RemoveView ( FlutterViewId  view_id)
virtual

Definition at line 610 of file flutter_windows_engine.cc.

610 {
612
613 // Notify the engine to stop rendering to the view if it isn't the implicit
614 // view. The engine and framework assume the implicit view always exists and
615 // can continue presenting.
616 if (view_id != kImplicitViewId) {
617 struct Captures {
619 bool removed;
620 };
621 Captures captures = {};
622
623 FlutterRemoveViewInfo info = {};
624 info.struct_size = sizeof(FlutterRemoveViewInfo);
625 info.view_id = view_id;
626 info.user_data = &captures;
627 info.remove_view_callback = [](const FlutterRemoveViewResult* result) {
628 // This is invoked on an engine thread. If
629 // |FlutterRemoveViewResult.removed| is `true`, the engine guarantees the
630 // view won't be presented.
631 Captures* captures = reinterpret_cast<Captures*>(result->user_data);
632 captures->removed = result->removed;
633 captures->latch.Signal();
634 };
635
636 FlutterEngineResult result = embedder_api_.RemoveView(engine_, &info);
637 if (result != kSuccess) {
638 FML_LOG(ERROR) << "Starting the remove view operation failed. "
639 "FlutterEngineRemoveView "
640 "returned an unexpected result: "
641 << result
642 << ". This indicates a bug in the Windows embedder.";
643 FML_DCHECK(false);
644 return;
645 }
646
647 // Block the platform thread until the engine has removed the view.
648 // TODO(loicsharma): This blocks the platform thread eagerly and can
649 // cause unnecessary delay in input processing. Instead, this should block
650 // lazily only when an operation needs the view.
651 // https://github.com/flutter/flutter/issues/146248
652 captures.latch.Wait();
653
654 if (!captures.removed) {
655 // Removing the view failed. This is unexpected and indicates a bug in the
656 // Windows embedder.
657 FML_LOG(ERROR) << "FlutterEngineRemoveView failed to remove view";
658 return;
659 }
660 }
661
662 {
663 // The engine no longer presents to the view. Remove the view from the
664 // embedder.
665 std::unique_lock write_lock(views_mutex_);
666
667 FML_DCHECK(views_.find(view_id) != views_.end());
668
669 // Reset text input state if the removed view is the active text input
670 // view, to prevent stale view references.
671 if (text_input_plugin_) {
672 text_input_plugin_->OnViewRemoved(view_id);
673 }
674
675 views_.erase(view_id);
676 }
677}
constexpr FlutterViewId kImplicitViewId
FlutterEngineRemoveViewFnPtr RemoveView
Definition embedder.h:3808
FlutterRemoveViewCallback remove_view_callback
Definition embedder.h:1195
FlutterViewId view_id
Definition embedder.h:1178

References FML_DCHECK, FML_LOG, kImplicitViewId, kSuccess, FlutterRemoveViewInfo::remove_view_callback, FlutterRemoveViewInfo::struct_size, FlutterRemoveViewInfo::user_data, FlutterRemoveViewInfo::view_id, and view_id.

◆ RequestApplicationQuit()

void flutter::FlutterWindowsEngine::RequestApplicationQuit ( HWND  hwnd,
WPARAM  wparam,
LPARAM  lparam,
AppExitType  exit_type 
)

Definition at line 1059 of file flutter_windows_engine.cc.

1062 {
1063 platform_handler_->RequestAppExit(hwnd, wparam, lparam, exit_type, 0);
1064}

◆ Run() [1/2]

bool flutter::FlutterWindowsEngine::Run ( )

Definition at line 268 of file flutter_windows_engine.cc.

268 {
269 return Run("");
270}

Referenced by FlutterDesktopEngineRun().

◆ Run() [2/2]

bool flutter::FlutterWindowsEngine::Run ( std::string_view  entrypoint)

Definition at line 272 of file flutter_windows_engine.cc.

272 {
273 if (!project_->HasValidPaths()) {
274 FML_LOG(ERROR) << "Missing or unresolvable paths to assets.";
275 return false;
276 }
277 std::string assets_path_string = fml::PathToUtf8(project_->assets_path());
278 std::string icu_path_string = fml::PathToUtf8(project_->icu_path());
279 if (embedder_api_.RunsAOTCompiledDartCode()) {
280 aot_data_ = project_->LoadAotData(embedder_api_);
281 if (!aot_data_) {
282 FML_LOG(ERROR) << "Unable to start engine without AOT data.";
283 return false;
284 }
285 }
286
287 // FlutterProjectArgs is expecting a full argv, so when processing it for
288 // flags the first item is treated as the executable and ignored. Add a dummy
289 // value so that all provided arguments are used.
290 std::string executable_name = GetExecutableName();
291 std::vector<const char*> argv = {executable_name.c_str()};
292 std::vector<std::string> switches = project_->GetSwitches();
293 if (enable_impeller_) {
294 if (std::find(switches.begin(), switches.end(),
295 "--impeller-use-sdfs=true") == switches.end() &&
296 std::find(switches.begin(), switches.end(),
297 "--impeller-use-sdfs=false") == switches.end()) {
298 switches.push_back("--impeller-use-sdfs=true");
299 }
300 }
301 std::transform(
302 switches.begin(), switches.end(), std::back_inserter(argv),
303 [](const std::string& arg) -> const char* { return arg.c_str(); });
304
305 const std::vector<std::string>& entrypoint_args =
306 project_->dart_entrypoint_arguments();
307 std::vector<const char*> entrypoint_argv;
308 std::transform(
309 entrypoint_args.begin(), entrypoint_args.end(),
310 std::back_inserter(entrypoint_argv),
311 [](const std::string& arg) -> const char* { return arg.c_str(); });
312
313 // Configure task runners.
314 FlutterTaskRunnerDescription platform_task_runner = {};
315 platform_task_runner.struct_size = sizeof(FlutterTaskRunnerDescription);
316 platform_task_runner.user_data = task_runner_.get();
317 platform_task_runner.runs_task_on_current_thread_callback =
318 [](void* user_data) -> bool {
319 return static_cast<TaskRunner*>(user_data)->RunsTasksOnCurrentThread();
320 };
321 platform_task_runner.post_task_callback = [](FlutterTask task,
322 uint64_t target_time_nanos,
323 void* user_data) -> void {
324 static_cast<TaskRunner*>(user_data)->PostFlutterTask(task,
325 target_time_nanos);
326 };
327 FlutterCustomTaskRunners custom_task_runners = {};
328 custom_task_runners.struct_size = sizeof(FlutterCustomTaskRunners);
329 custom_task_runners.platform_task_runner = &platform_task_runner;
330 custom_task_runners.thread_priority_setter =
332
333 if (project_->ui_thread_policy() !=
335 custom_task_runners.ui_task_runner = &platform_task_runner;
336 } else {
337 FML_LOG(WARNING) << "Running with unmerged platform and UI threads. This "
338 "will be removed in future.";
339 }
340
343 args.shutdown_dart_vm_when_done = true;
344 args.assets_path = assets_path_string.c_str();
345 args.icu_data_path = icu_path_string.c_str();
346 args.command_line_argc = static_cast<int>(argv.size());
347 args.command_line_argv = argv.empty() ? nullptr : argv.data();
348 args.engine_id = reinterpret_cast<int64_t>(this);
349
350 // Fail if conflicting non-default entrypoints are specified in the method
351 // argument and the project.
352 //
353 // TODO(cbracken): https://github.com/flutter/flutter/issues/109285
354 // The entrypoint method parameter should eventually be removed from this
355 // method and only the entrypoint specified in project_ should be used.
356 if (!project_->dart_entrypoint().empty() && !entrypoint.empty() &&
357 project_->dart_entrypoint() != entrypoint) {
358 FML_LOG(ERROR) << "Conflicting entrypoints were specified in "
359 "FlutterDesktopEngineProperties.dart_entrypoint and "
360 "FlutterDesktopEngineRun(engine, entry_point). ";
361 return false;
362 }
363 if (!entrypoint.empty()) {
364 args.custom_dart_entrypoint = entrypoint.data();
365 } else if (!project_->dart_entrypoint().empty()) {
366 args.custom_dart_entrypoint = project_->dart_entrypoint().c_str();
367 }
368 args.dart_entrypoint_argc = static_cast<int>(entrypoint_argv.size());
369 args.dart_entrypoint_argv =
370 entrypoint_argv.empty() ? nullptr : entrypoint_argv.data();
371 args.platform_message_callback =
372 [](const FlutterPlatformMessage* engine_message,
373 void* user_data) -> void {
374 auto host = static_cast<FlutterWindowsEngine*>(user_data);
375 return host->HandlePlatformMessage(engine_message);
376 };
377 args.vsync_callback = [](void* user_data, intptr_t baton) -> void {
378 auto host = static_cast<FlutterWindowsEngine*>(user_data);
379 host->OnVsync(baton);
380 };
381 args.on_pre_engine_restart_callback = [](void* user_data) {
382 auto host = static_cast<FlutterWindowsEngine*>(user_data);
383 host->OnPreEngineRestart();
384 };
385 args.update_semantics_callback2 = [](const FlutterSemanticsUpdate2* update,
386 void* user_data) {
387 auto host = static_cast<FlutterWindowsEngine*>(user_data);
388
389 auto view = host->view(update->view_id);
390 if (!view) {
391 return;
392 }
393
394 auto accessibility_bridge = view->accessibility_bridge().lock();
395 if (!accessibility_bridge) {
396 return;
397 }
398
399 for (size_t i = 0; i < update->node_count; i++) {
400 const FlutterSemanticsNode2* node = update->nodes[i];
401 accessibility_bridge->AddFlutterSemanticsNodeUpdate(*node);
402 }
403
404 for (size_t i = 0; i < update->custom_action_count; i++) {
406 accessibility_bridge->AddFlutterSemanticsCustomActionUpdate(*action);
407 }
408
409 accessibility_bridge->CommitUpdates();
410 };
411 args.root_isolate_create_callback = [](void* user_data) {
412 auto host = static_cast<FlutterWindowsEngine*>(user_data);
413 if (host->root_isolate_create_callback_) {
414 host->root_isolate_create_callback_();
415 }
416 };
417 args.channel_update_callback = [](const FlutterChannelUpdate* update,
418 void* user_data) {
419 auto host = static_cast<FlutterWindowsEngine*>(user_data);
420 if (SAFE_ACCESS(update, channel, nullptr) != nullptr) {
421 std::string channel_name(update->channel);
422 host->OnChannelUpdate(std::move(channel_name),
423 SAFE_ACCESS(update, listening, false));
424 }
425 };
426 args.view_focus_change_request_callback =
427 [](const FlutterViewFocusChangeRequest* request, void* user_data) {
428 auto host = static_cast<FlutterWindowsEngine*>(user_data);
429 host->OnViewFocusChangeRequest(request);
430 };
431
432 args.custom_task_runners = &custom_task_runners;
433
434 if (!platform_view_plugin_) {
435 platform_view_plugin_ = std::make_unique<PlatformViewPlugin>(
436 messenger_wrapper_.get(), task_runner_.get());
437 }
438 if (egl_manager_) {
439 auto resolver = [](const char* name) -> void* {
440 return reinterpret_cast<void*>(::eglGetProcAddress(name));
441 };
442
443 // TODO(schectman) Pass the platform view manager to the compositor
444 // constructors: https://github.com/flutter/flutter/issues/143375
445 compositor_ =
446 std::make_unique<CompositorOpenGL>(this, resolver, enable_impeller_);
447 } else {
448 compositor_ = std::make_unique<CompositorSoftware>();
449 }
450
451 FlutterCompositor compositor = {};
452 compositor.struct_size = sizeof(FlutterCompositor);
453 compositor.user_data = this;
455 [](const FlutterBackingStoreConfig* config,
456 FlutterBackingStore* backing_store_out, void* user_data) -> bool {
457 auto host = static_cast<FlutterWindowsEngine*>(user_data);
458
459 return host->compositor_->CreateBackingStore(*config, backing_store_out);
460 };
461
463 [](const FlutterBackingStore* backing_store, void* user_data) -> bool {
464 auto host = static_cast<FlutterWindowsEngine*>(user_data);
465
466 return host->compositor_->CollectBackingStore(backing_store);
467 };
468
469 compositor.present_view_callback =
470 [](const FlutterPresentViewInfo* info) -> bool {
471 auto host = static_cast<FlutterWindowsEngine*>(info->user_data);
472
473 return host->Present(info);
474 };
475 args.compositor = &compositor;
476
477 if (aot_data_) {
478 args.aot_data = aot_data_.get();
479 }
480
481 // The platform thread creates OpenGL contexts. These
482 // must be released to be used by the engine's threads.
483 FML_DCHECK(!egl_manager_ || !egl_manager_->HasContextCurrent());
484
485 FlutterRendererConfig renderer_config;
486
487 if (enable_impeller_) {
488 // Impeller does not support a Software backend. Avoid falling back and
489 // confusing the engine on which renderer is selected.
490 if (!egl_manager_) {
491 FML_LOG(ERROR) << "Could not create surface manager. Impeller backend "
492 "does not support software rendering.";
493 return false;
494 }
495 renderer_config = GetOpenGLRendererConfig();
496 } else {
497 renderer_config =
498 egl_manager_ ? GetOpenGLRendererConfig() : GetSoftwareRendererConfig();
499 }
500
501 auto result = embedder_api_.Run(FLUTTER_ENGINE_VERSION, &renderer_config,
502 &args, this, &engine_);
503 if (result != kSuccess || engine_ == nullptr) {
504 FML_LOG(ERROR) << "Failed to start Flutter engine: error " << result;
505 return false;
506 }
507
508 display_manager_->UpdateDisplays();
509
510 SendSystemLocales();
511
512 settings_plugin_->StartWatching();
513 settings_plugin_->SendSettings();
514
515 InitializeKeyboard();
516
517 return true;
518}
std::weak_ptr< AccessibilityBridgeWindows > accessibility_bridge()
#define FLUTTER_ENGINE_VERSION
Definition embedder.h:70
#define SAFE_ACCESS(pointer, member, default_value)
G_BEGIN_DECLS G_MODULE_EXPORT FlValue * args
const gchar * channel
char ** argv
Definition library.h:9
DEF_SWITCHES_START aot vmservice shared library Name of the *so containing AOT compiled Dart assets for launching the service isolate vm snapshot The VM snapshot data that will be memory mapped as read only SnapshotAssetPath must be present isolate snapshot The isolate snapshot data that will be memory mapped as read only SnapshotAssetPath must be present cache dir Path to the cache directory This is different from the persistent_cache_path in embedder which is used for Skia shader cache icu native lib Path to the library file that exports the ICU data vm service host
Definition switch_defs.h:69
static void WindowsPlatformThreadPrioritySetter(FlutterThreadPriority priority)
std::string PathToUtf8(const std::filesystem::path &path)
An update to whether a message channel has a listener set or not.
Definition embedder.h:1884
const char * channel
The name of the channel.
Definition embedder.h:1888
FlutterBackingStoreCreateCallback create_backing_store_callback
Definition embedder.h:2268
size_t struct_size
This size of this struct. Must be sizeof(FlutterCompositor).
Definition embedder.h:2252
FlutterPresentViewCallback present_view_callback
Definition embedder.h:2305
FlutterBackingStoreCollectCallback collect_backing_store_callback
Definition embedder.h:2273
void(* thread_priority_setter)(FlutterThreadPriority)
Definition embedder.h:1959
const FlutterTaskRunnerDescription * ui_task_runner
Definition embedder.h:1963
const FlutterTaskRunnerDescription * platform_task_runner
Definition embedder.h:1951
size_t struct_size
The size of this struct. Must be sizeof(FlutterCustomTaskRunners).
Definition embedder.h:1946
FlutterEngineRunsAOTCompiledDartCodeFnPtr RunsAOTCompiledDartCode
Definition embedder.h:3799
FlutterEngineRunFnPtr Run
Definition embedder.h:3769
size_t struct_size
The size of this struct. Must be sizeof(FlutterProjectArgs).
Definition embedder.h:2513
A batch of updates to semantics nodes and custom actions.
Definition embedder.h:1851
size_t node_count
The number of semantics node updates.
Definition embedder.h:1855
size_t custom_action_count
The number of semantics custom action updates.
Definition embedder.h:1859
FlutterSemanticsNode2 ** nodes
Definition embedder.h:1857
FlutterSemanticsCustomAction2 ** custom_actions
Definition embedder.h:1862
FlutterViewId view_id
Definition embedder.h:1864
size_t struct_size
The size of this struct. Must be sizeof(FlutterTaskRunnerDescription).
Definition embedder.h:1919
BoolCallback runs_task_on_current_thread_callback
Definition embedder.h:1925
FlutterTaskRunnerPostTaskCallback post_task_callback
Definition embedder.h:1936

References action, args, argv, channel, FlutterSemanticsUpdate2::custom_action_count, FlutterSemanticsUpdate2::custom_actions, FLUTTER_ENGINE_VERSION, FML_DCHECK, FML_LOG, flutter::host, i, kSuccess, name, FlutterSemanticsUpdate2::node_count, FlutterSemanticsUpdate2::nodes, fml::PathToUtf8(), FlutterCustomTaskRunners::platform_task_runner, FlutterTaskRunnerDescription::post_task_callback, FlutterTaskRunnerDescription::runs_task_on_current_thread_callback, SAFE_ACCESS, FlutterTaskRunnerDescription::struct_size, FlutterCustomTaskRunners::struct_size, FlutterProjectArgs::struct_size, FlutterCustomTaskRunners::thread_priority_setter, FlutterCustomTaskRunners::ui_task_runner, user_data, FlutterTaskRunnerDescription::user_data, view, and FlutterSemanticsUpdate2::view_id.

◆ running()

virtual bool flutter::FlutterWindowsEngine::running ( ) const
inlinevirtual

Definition at line 125 of file flutter_windows_engine.h.

125{ return engine_ != nullptr; }

Referenced by flutter::HostWindow::InitializeFlutterView().

◆ ScheduleFrame()

void flutter::FlutterWindowsEngine::ScheduleFrame ( )

Definition at line 825 of file flutter_windows_engine.cc.

825 {
826 embedder_api_.ScheduleFrame(engine_);
827}
FlutterEngineScheduleFrameFnPtr ScheduleFrame
Definition embedder.h:3805

Referenced by flutter::FlutterWindowsView::ForceRedraw().

◆ semantics_enabled()

bool flutter::FlutterWindowsEngine::semantics_enabled ( ) const
inline

Definition at line 261 of file flutter_windows_engine.h.

261{ return semantics_enabled_; }

Referenced by flutter::AccessibilityPlugin::Announce().

◆ SendKeyEvent()

void flutter::FlutterWindowsEngine::SendKeyEvent ( const FlutterKeyEvent event,
FlutterKeyEventCallback  callback,
void *  user_data 
)

Definition at line 751 of file flutter_windows_engine.cc.

753 {
754 if (engine_) {
755 embedder_api_.SendKeyEvent(engine_, &event, callback, user_data);
756 }
757}
FlutterEngineSendKeyEventFnPtr SendKeyEvent
Definition embedder.h:3776

References callback, and user_data.

◆ SendPlatformMessage()

bool flutter::FlutterWindowsEngine::SendPlatformMessage ( const char *  channel,
const uint8_t *  message,
const size_t  message_size,
const FlutterDesktopBinaryReply  reply,
void *  user_data 
)

Definition at line 766 of file flutter_windows_engine.cc.

771 {
772 FlutterPlatformMessageResponseHandle* response_handle = nullptr;
773 if (reply != nullptr && user_data != nullptr) {
774 FlutterEngineResult result =
776 engine_, reply, user_data, &response_handle);
777 if (result != kSuccess) {
778 FML_LOG(ERROR) << "Failed to create response handle";
779 return false;
780 }
781 }
782
783 FlutterPlatformMessage platform_message = {
785 channel,
786 message,
787 message_size,
788 response_handle,
789 };
790
791 FlutterEngineResult message_result =
792 embedder_api_.SendPlatformMessage(engine_, &platform_message);
793 if (response_handle != nullptr) {
794 embedder_api_.PlatformMessageReleaseResponseHandle(engine_,
795 response_handle);
796 }
797 return message_result == kSuccess;
798}
FlutterEnginePlatformMessageReleaseResponseHandleFnPtr PlatformMessageReleaseResponseHandle
Definition embedder.h:3781
FlutterEngineSendPlatformMessageFnPtr SendPlatformMessage
Definition embedder.h:3777
FlutterEnginePlatformMessageCreateResponseHandleFnPtr PlatformMessageCreateResponseHandle
Definition embedder.h:3779

References channel, FML_LOG, kSuccess, message, and user_data.

Referenced by FlutterDesktopMessengerSendWithReply().

◆ SendPlatformMessageResponse()

void flutter::FlutterWindowsEngine::SendPlatformMessageResponse ( const FlutterDesktopMessageResponseHandle handle,
const uint8_t *  data,
size_t  data_length 
)

Definition at line 800 of file flutter_windows_engine.cc.

803 {
804 embedder_api_.SendPlatformMessageResponse(engine_, handle, data, data_length);
805}
FlutterEngineSendPlatformMessageResponseFnPtr SendPlatformMessageResponse
Definition embedder.h:3782

References flutter::data.

Referenced by FlutterDesktopMessengerSendResponse().

◆ SendPointerEvent()

void flutter::FlutterWindowsEngine::SendPointerEvent ( const FlutterPointerEvent event)

Definition at line 745 of file flutter_windows_engine.cc.

745 {
746 if (engine_) {
747 embedder_api_.SendPointerEvent(engine_, &event, 1);
748 }
749}
FlutterEngineSendPointerEventFnPtr SendPointerEvent
Definition embedder.h:3775

◆ SendViewFocusEvent()

void flutter::FlutterWindowsEngine::SendViewFocusEvent ( const FlutterViewFocusEvent event)

Definition at line 759 of file flutter_windows_engine.cc.

760 {
761 if (engine_) {
762 embedder_api_.SendViewFocusEvent(engine_, &event);
763 }
764}
FlutterEngineSendViewFocusEventFnPtr SendViewFocusEvent
Definition embedder.h:3809

◆ SendWindowMetricsEvent()

void flutter::FlutterWindowsEngine::SendWindowMetricsEvent ( const FlutterWindowMetricsEvent event)

Definition at line 738 of file flutter_windows_engine.cc.

739 {
740 if (engine_) {
741 embedder_api_.SendWindowMetricsEvent(engine_, &event);
742 }
743}
FlutterEngineSendWindowMetricsEventFnPtr SendWindowMetricsEvent
Definition embedder.h:3774

Referenced by flutter::FlutterWindowsView::SendInitialBounds(), and flutter::FlutterWindowsView::SetSizedToContent().

◆ SetFlutterCursor()

void flutter::FlutterWindowsEngine::SetFlutterCursor ( HCURSOR  cursor) const

Definition at line 1106 of file flutter_windows_engine.cc.

1106 {
1107 windows_proc_table_->SetCursor(cursor);
1108}

◆ SetNextFrameCallback()

void flutter::FlutterWindowsEngine::SetNextFrameCallback ( fml::closure  callback)

Definition at line 829 of file flutter_windows_engine.cc.

829 {
830 next_frame_callback_ = std::move(callback);
831
832 embedder_api_.SetNextFrameCallback(
833 engine_,
834 [](void* user_data) {
835 // Embedder callback runs on raster thread. Switch back to platform
836 // thread.
838 static_cast<FlutterWindowsEngine*>(user_data);
839
840 self->task_runner_->PostTask(std::move(self->next_frame_callback_));
841 },
842 this);
843}
FlutterEngineSetNextFrameCallbackFnPtr SetNextFrameCallback
Definition embedder.h:3806

References callback, self, and user_data.

Referenced by FlutterDesktopEngineSetNextFrameCallback().

◆ SetRootIsolateCreateCallback()

void flutter::FlutterWindowsEngine::SetRootIsolateCreateCallback ( const fml::closure callback)
inline

Definition at line 286 of file flutter_windows_engine.h.

286 {
287 root_isolate_create_callback_ = callback;
288 }

References callback.

Referenced by flutter::testing::WindowsConfigBuilder::Run(), and flutter::testing::WindowsConfigBuilder::RunHeadless().

◆ SetSwitches()

void flutter::FlutterWindowsEngine::SetSwitches ( const std::vector< std::string > &  switches)

Definition at line 263 of file flutter_windows_engine.cc.

264 {
265 project_->SetSwitches(switches);
266}

References SetSwitches().

Referenced by SetSwitches().

◆ Stop()

bool flutter::FlutterWindowsEngine::Stop ( )
virtual

Definition at line 520 of file flutter_windows_engine.cc.

520 {
521 if (engine_) {
522 window_manager_->OnEngineShutdown();
523 for (const auto& [callback, registrar] :
524 plugin_registrar_destruction_callbacks_) {
525 callback(registrar);
526 }
527 FlutterEngineResult result = embedder_api_.Shutdown(engine_);
528 engine_ = nullptr;
529 return (result == kSuccess);
530 }
531 return false;
532}
FlutterEngineShutdownFnPtr Shutdown
Definition embedder.h:3770

References callback, and kSuccess.

◆ task_runner()

◆ text_input_plugin()

TextInputPlugin * flutter::FlutterWindowsEngine::text_input_plugin ( )
inline

Definition at line 206 of file flutter_windows_engine.h.

206{ return text_input_plugin_.get(); }

◆ texture_registrar()

FlutterWindowsTextureRegistrar * flutter::FlutterWindowsEngine::texture_registrar ( )
inline

Definition at line 177 of file flutter_windows_engine.h.

177 {
178 return texture_registrar_.get();
179 }

◆ UnregisterExternalTexture()

bool flutter::FlutterWindowsEngine::UnregisterExternalTexture ( int64_t  texture_id)

Definition at line 958 of file flutter_windows_engine.cc.

958 {
959 return (embedder_api_.UnregisterExternalTexture(engine_, texture_id) ==
960 kSuccess);
961}
FlutterEngineUnregisterExternalTextureFnPtr UnregisterExternalTexture
Definition embedder.h:3784

References kSuccess, and texture_id.

◆ UpdateAccessibilityFeatures()

void flutter::FlutterWindowsEngine::UpdateAccessibilityFeatures ( )

◆ UpdateDisplay()

void flutter::FlutterWindowsEngine::UpdateDisplay ( const std::vector< FlutterEngineDisplay > &  displays)

Definition at line 729 of file flutter_windows_engine.cc.

730 {
731 if (engine_) {
732 embedder_api_.NotifyDisplayUpdate(engine_,
734 displays.data(), displays.size());
735 }
736}
@ kFlutterEngineDisplaysUpdateTypeStartup
Definition embedder.h:2379
std::vector< FlutterEngineDisplay > * displays
FlutterEngineNotifyDisplayUpdateFnPtr NotifyDisplayUpdate
Definition embedder.h:3804

References displays, and kFlutterEngineDisplaysUpdateTypeStartup.

Referenced by flutter::DisplayManagerWin32::UpdateDisplays().

◆ UpdateFlutterCursor()

void flutter::FlutterWindowsEngine::UpdateFlutterCursor ( const std::string &  cursor_name) const

Definition at line 1101 of file flutter_windows_engine.cc.

1102 {
1103 SetFlutterCursor(GetCursorByName(cursor_name));
1104}
void SetFlutterCursor(HCURSOR cursor) const

◆ UpdateHighContrastMode()

void flutter::FlutterWindowsEngine::UpdateHighContrastMode ( )

Definition at line 1040 of file flutter_windows_engine.cc.

1040 {
1041 high_contrast_enabled_ = windows_proc_table_->GetHighContrastEnabled();
1042
1043 SendAccessibilityFeatures();
1044 settings_plugin_->UpdateHighContrastMode(high_contrast_enabled_);
1045}

Referenced by flutter::FlutterWindowsView::OnHighContrastChanged().

◆ UpdateSemanticsEnabled()

void flutter::FlutterWindowsEngine::UpdateSemanticsEnabled ( bool  enabled)

Definition at line 1005 of file flutter_windows_engine.cc.

1005 {
1006 if (engine_ && semantics_enabled_ != enabled) {
1007 std::shared_lock read_lock(views_mutex_);
1008
1009 semantics_enabled_ = enabled;
1010 embedder_api_.UpdateSemanticsEnabled(engine_, enabled);
1011 for (auto iterator = views_.begin(); iterator != views_.end(); iterator++) {
1012 iterator->second->UpdateSemanticsEnabled(enabled);
1013 }
1014 }
1015}
FlutterEngineUpdateSemanticsEnabledFnPtr UpdateSemanticsEnabled
Definition embedder.h:3787

Referenced by flutter::FlutterWindowsView::OnUpdateSemanticsEnabled(), flutter::testing::TEST_F(), and flutter::testing::TEST_F().

◆ view()

FlutterWindowsView * flutter::FlutterWindowsEngine::view ( FlutterViewId  view_id) const

Definition at line 707 of file flutter_windows_engine.cc.

707 {
708 std::shared_lock read_lock(views_mutex_);
709
710 auto iterator = views_.find(view_id);
711 if (iterator == views_.end()) {
712 return nullptr;
713 }
714
715 return iterator->second;
716}

References view_id.

Referenced by flutter::AccessibilityPlugin::Announce().

◆ window_manager()

WindowManager * flutter::FlutterWindowsEngine::window_manager ( )
inline

Definition at line 335 of file flutter_windows_engine.h.

335{ return window_manager_.get(); }

◆ window_proc_delegate_manager()

WindowProcDelegateManager * flutter::FlutterWindowsEngine::window_proc_delegate_manager ( )
inline

Definition at line 185 of file flutter_windows_engine.h.

185 {
186 return window_proc_delegate_manager_.get();
187 }

Referenced by flutter::HostWindowDialog::HandleMessage().

◆ windows_proc_table()

std::shared_ptr< WindowsProcTable > flutter::FlutterWindowsEngine::windows_proc_table ( )
inline

Definition at line 324 of file flutter_windows_engine.h.

324 {
325 return windows_proc_table_;
326 }

Referenced by CreateViewController(), and flutter::HostWindow::InitializeFlutterView().

Friends And Related Symbol Documentation

◆ EngineModifier

friend class EngineModifier
friend

Definition at line 373 of file flutter_windows_engine.h.


The documentation for this class was generated from the following files: