Flutter Engine Uber Docs
Docs for the entire Flutter Engine repo.
 
Loading...
Searching...
No Matches
flutter_project_bundle.cc
Go to the documentation of this file.
1// Copyright 2013 The Flutter Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
6
7#include <filesystem>
8
13
14namespace flutter {
15
17 const FlutterDesktopEngineProperties& properties)
18 : assets_path_(properties.assets_path),
19 icu_path_(properties.icu_data_path) {
20 if (properties.aot_library_path != nullptr) {
21 aot_library_path_ = std::filesystem::path(properties.aot_library_path);
22 }
23
24 if (properties.dart_entrypoint && properties.dart_entrypoint[0] != '\0') {
25 dart_entrypoint_ = properties.dart_entrypoint;
26 }
27
28 for (int i = 0; i < properties.dart_entrypoint_argc; i++) {
29 dart_entrypoint_arguments_.push_back(
30 std::string(properties.dart_entrypoint_argv[i]));
31 }
32
33 gpu_preference_ =
34 static_cast<FlutterGpuPreference>(properties.gpu_preference);
35
36 ui_thread_policy_ =
37 static_cast<FlutterUIThreadPolicy>(properties.ui_thread_policy);
38
39 accessibility_mode_ =
40 static_cast<FlutterAccessibilityMode>(properties.accessibility_mode);
41
42 // Resolve any relative paths.
43 if (assets_path_.is_relative() || icu_path_.is_relative() ||
44 (!aot_library_path_.empty() && aot_library_path_.is_relative())) {
45 std::filesystem::path executable_location = GetExecutableDirectory();
46 if (executable_location.empty()) {
47 FML_LOG(ERROR)
48 << "Unable to find executable location to resolve resource paths.";
49 assets_path_ = std::filesystem::path();
50 icu_path_ = std::filesystem::path();
51 } else {
52 assets_path_ = std::filesystem::path(executable_location) / assets_path_;
53 icu_path_ = std::filesystem::path(executable_location) / icu_path_;
54 if (!aot_library_path_.empty()) {
55 aot_library_path_ =
56 std::filesystem::path(executable_location) / aot_library_path_;
57 }
58 }
59 }
60}
61
63 return !assets_path_.empty() && !icu_path_.empty();
64}
65
66// Attempts to load AOT data from the given path, which must be absolute and
67// non-empty. Logs and returns nullptr on failure.
69 const FlutterEngineProcTable& engine_procs) {
70 if (aot_library_path_.empty()) {
71 FML_LOG(ERROR)
72 << "Attempted to load AOT data, but no aot_library_path was provided.";
73 return UniqueAotDataPtr(nullptr, nullptr);
74 }
75 if (!std::filesystem::exists(aot_library_path_)) {
76 FML_LOG(ERROR) << "Can't load AOT data from " << aot_library_path_
77 << "; no such file.";
78 return UniqueAotDataPtr(nullptr, nullptr);
79 }
80 std::string path_string = fml::PathToUtf8(aot_library_path_);
83 source.elf_path = path_string.c_str();
84 FlutterEngineAOTData data = nullptr;
85 auto result = engine_procs.CreateAOTData(&source, &data);
86 if (result != kSuccess) {
87 FML_LOG(ERROR) << "Failed to load AOT data from: " << path_string;
88 return UniqueAotDataPtr(nullptr, nullptr);
89 }
90 return UniqueAotDataPtr(data, engine_procs.CollectAOTData);
91}
92
94
96 const std::vector<std::string>& switches) {
97 engine_switches_ = switches;
98}
99
100const std::vector<std::string> FlutterProjectBundle::GetSwitches() {
101 if (engine_switches_.size() == 0) {
103 }
104 std::vector<std::string> switches;
105 switches.insert(switches.end(), engine_switches_.begin(),
106 engine_switches_.end());
107
108 auto env_switches = GetSwitchesFromEnvironment();
109 switches.insert(switches.end(), env_switches.begin(), env_switches.end());
110
111 return switches;
112}
113
114} // namespace flutter
const std::vector< std::string > GetSwitches()
FlutterProjectBundle(const FlutterDesktopEngineProperties &properties)
UniqueAotDataPtr LoadAotData(const FlutterEngineProcTable &engine_procs)
void SetSwitches(const std::vector< std::string > &switches)
@ kFlutterEngineAOTDataSourceTypeElfPath
Definition embedder.h:2466
#define FML_LOG(severity)
Definition logging.h:101
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
std::vector< std::string > GetSwitchesFromEnvironment()
std::filesystem::path GetExecutableDirectory()
Definition path_utils.cc:16
std::unique_ptr< _FlutterEngineAOTData, FlutterEngineCollectAOTDataFnPtr > UniqueAotDataPtr
std::string PathToUtf8(const std::filesystem::path &path)
FlutterDesktopAccessibilityMode accessibility_mode
FlutterDesktopUIThreadPolicy ui_thread_policy
FlutterDesktopGpuPreference gpu_preference
FlutterEngineAOTDataSourceType type
Definition embedder.h:2472
const char * elf_path
Absolute path to an ELF library file.
Definition embedder.h:2475
Function-pointer-based versions of the APIs above.
Definition embedder.h:3746
FlutterEngineCreateAOTDataFnPtr CreateAOTData
Definition embedder.h:3750
FlutterEngineCollectAOTDataFnPtr CollectAOTData
Definition embedder.h:3751