export_plugin.cpp 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702
  1. /**************************************************************************/
  2. /* export_plugin.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "export_plugin.h"
  31. #include "logo_svg.gen.h"
  32. #include "run_icon_svg.gen.h"
  33. #include "core/config/project_settings.h"
  34. #include "editor/editor_scale.h"
  35. #include "editor/editor_settings.h"
  36. #include "editor/export/editor_export.h"
  37. #include "scene/resources/image_texture.h"
  38. #include "modules/modules_enabled.gen.h" // For mono and svg.
  39. #ifdef MODULE_SVG_ENABLED
  40. #include "modules/svg/image_loader_svg.h"
  41. #endif
  42. Error EditorExportPlatformWeb::_extract_template(const String &p_template, const String &p_dir, const String &p_name, bool pwa) {
  43. Ref<FileAccess> io_fa;
  44. zlib_filefunc_def io = zipio_create_io(&io_fa);
  45. unzFile pkg = unzOpen2(p_template.utf8().get_data(), &io);
  46. if (!pkg) {
  47. add_message(EXPORT_MESSAGE_ERROR, TTR("Prepare Templates"), vformat(TTR("Could not open template for export: \"%s\"."), p_template));
  48. return ERR_FILE_NOT_FOUND;
  49. }
  50. if (unzGoToFirstFile(pkg) != UNZ_OK) {
  51. add_message(EXPORT_MESSAGE_ERROR, TTR("Prepare Templates"), vformat(TTR("Invalid export template: \"%s\"."), p_template));
  52. unzClose(pkg);
  53. return ERR_FILE_CORRUPT;
  54. }
  55. do {
  56. //get filename
  57. unz_file_info info;
  58. char fname[16384];
  59. unzGetCurrentFileInfo(pkg, &info, fname, 16384, nullptr, 0, nullptr, 0);
  60. String file = String::utf8(fname);
  61. // Skip folders.
  62. if (file.ends_with("/")) {
  63. continue;
  64. }
  65. // Skip service worker and offline page if not exporting pwa.
  66. if (!pwa && (file == "godot.service.worker.js" || file == "godot.offline.html")) {
  67. continue;
  68. }
  69. Vector<uint8_t> data;
  70. data.resize(info.uncompressed_size);
  71. //read
  72. unzOpenCurrentFile(pkg);
  73. unzReadCurrentFile(pkg, data.ptrw(), data.size());
  74. unzCloseCurrentFile(pkg);
  75. //write
  76. String dst = p_dir.path_join(file.replace("godot", p_name));
  77. Ref<FileAccess> f = FileAccess::open(dst, FileAccess::WRITE);
  78. if (f.is_null()) {
  79. add_message(EXPORT_MESSAGE_ERROR, TTR("Prepare Templates"), vformat(TTR("Could not write file: \"%s\"."), dst));
  80. unzClose(pkg);
  81. return ERR_FILE_CANT_WRITE;
  82. }
  83. f->store_buffer(data.ptr(), data.size());
  84. } while (unzGoToNextFile(pkg) == UNZ_OK);
  85. unzClose(pkg);
  86. return OK;
  87. }
  88. Error EditorExportPlatformWeb::_write_or_error(const uint8_t *p_content, int p_size, String p_path) {
  89. Ref<FileAccess> f = FileAccess::open(p_path, FileAccess::WRITE);
  90. if (f.is_null()) {
  91. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), p_path));
  92. return ERR_FILE_CANT_WRITE;
  93. }
  94. f->store_buffer(p_content, p_size);
  95. return OK;
  96. }
  97. void EditorExportPlatformWeb::_replace_strings(HashMap<String, String> p_replaces, Vector<uint8_t> &r_template) {
  98. String str_template = String::utf8(reinterpret_cast<const char *>(r_template.ptr()), r_template.size());
  99. String out;
  100. Vector<String> lines = str_template.split("\n");
  101. for (int i = 0; i < lines.size(); i++) {
  102. String current_line = lines[i];
  103. for (const KeyValue<String, String> &E : p_replaces) {
  104. current_line = current_line.replace(E.key, E.value);
  105. }
  106. out += current_line + "\n";
  107. }
  108. CharString cs = out.utf8();
  109. r_template.resize(cs.length());
  110. for (int i = 0; i < cs.length(); i++) {
  111. r_template.write[i] = cs[i];
  112. }
  113. }
  114. void EditorExportPlatformWeb::_fix_html(Vector<uint8_t> &p_html, const Ref<EditorExportPreset> &p_preset, const String &p_name, bool p_debug, int p_flags, const Vector<SharedObject> p_shared_objects, const Dictionary &p_file_sizes) {
  115. // Engine.js config
  116. Dictionary config;
  117. Array libs;
  118. for (int i = 0; i < p_shared_objects.size(); i++) {
  119. libs.push_back(p_shared_objects[i].path.get_file());
  120. }
  121. Vector<String> flags;
  122. gen_export_flags(flags, p_flags & (~DEBUG_FLAG_DUMB_CLIENT));
  123. Array args;
  124. for (int i = 0; i < flags.size(); i++) {
  125. args.push_back(flags[i]);
  126. }
  127. config["canvasResizePolicy"] = p_preset->get("html/canvas_resize_policy");
  128. config["experimentalVK"] = p_preset->get("html/experimental_virtual_keyboard");
  129. config["focusCanvas"] = p_preset->get("html/focus_canvas_on_start");
  130. config["gdextensionLibs"] = libs;
  131. config["executable"] = p_name;
  132. config["args"] = args;
  133. config["fileSizes"] = p_file_sizes;
  134. String head_include;
  135. if (p_preset->get("html/export_icon")) {
  136. head_include += "<link id='-gd-engine-icon' rel='icon' type='image/png' href='" + p_name + ".icon.png' />\n";
  137. head_include += "<link rel='apple-touch-icon' href='" + p_name + ".apple-touch-icon.png'/>\n";
  138. }
  139. if (p_preset->get("progressive_web_app/enabled")) {
  140. head_include += "<link rel='manifest' href='" + p_name + ".manifest.json'>\n";
  141. config["serviceWorker"] = p_name + ".service.worker.js";
  142. }
  143. // Replaces HTML string
  144. const String str_config = Variant(config).to_json_string();
  145. const String custom_head_include = p_preset->get("html/head_include");
  146. HashMap<String, String> replaces;
  147. replaces["$GODOT_URL"] = p_name + ".js";
  148. replaces["$GODOT_PROJECT_NAME"] = GLOBAL_GET("application/config/name");
  149. replaces["$GODOT_HEAD_INCLUDE"] = head_include + custom_head_include;
  150. replaces["$GODOT_CONFIG"] = str_config;
  151. _replace_strings(replaces, p_html);
  152. }
  153. Error EditorExportPlatformWeb::_add_manifest_icon(const String &p_path, const String &p_icon, int p_size, Array &r_arr) {
  154. const String name = p_path.get_file().get_basename();
  155. const String icon_name = vformat("%s.%dx%d.png", name, p_size, p_size);
  156. const String icon_dest = p_path.get_base_dir().path_join(icon_name);
  157. Ref<Image> icon;
  158. if (!p_icon.is_empty()) {
  159. icon.instantiate();
  160. const Error err = ImageLoader::load_image(p_icon, icon);
  161. if (err != OK) {
  162. add_message(EXPORT_MESSAGE_ERROR, TTR("Icon Creation"), vformat(TTR("Could not read file: \"%s\"."), p_icon));
  163. return err;
  164. }
  165. if (icon->get_width() != p_size || icon->get_height() != p_size) {
  166. icon->resize(p_size, p_size);
  167. }
  168. } else {
  169. icon = _get_project_icon();
  170. icon->resize(p_size, p_size);
  171. }
  172. const Error err = icon->save_png(icon_dest);
  173. if (err != OK) {
  174. add_message(EXPORT_MESSAGE_ERROR, TTR("Icon Creation"), vformat(TTR("Could not write file: \"%s\"."), icon_dest));
  175. return err;
  176. }
  177. Dictionary icon_dict;
  178. icon_dict["sizes"] = vformat("%dx%d", p_size, p_size);
  179. icon_dict["type"] = "image/png";
  180. icon_dict["src"] = icon_name;
  181. r_arr.push_back(icon_dict);
  182. return err;
  183. }
  184. Error EditorExportPlatformWeb::_build_pwa(const Ref<EditorExportPreset> &p_preset, const String p_path, const Vector<SharedObject> &p_shared_objects) {
  185. String proj_name = GLOBAL_GET("application/config/name");
  186. if (proj_name.is_empty()) {
  187. proj_name = "Godot Game";
  188. }
  189. // Service worker
  190. const String dir = p_path.get_base_dir();
  191. const String name = p_path.get_file().get_basename();
  192. bool extensions = (bool)p_preset->get("variant/extensions_support");
  193. HashMap<String, String> replaces;
  194. replaces["@GODOT_VERSION@"] = String::num_int64(OS::get_singleton()->get_unix_time()) + "|" + String::num_int64(OS::get_singleton()->get_ticks_usec());
  195. replaces["@GODOT_NAME@"] = proj_name.substr(0, 16);
  196. replaces["@GODOT_OFFLINE_PAGE@"] = name + ".offline.html";
  197. // Files cached during worker install.
  198. Array cache_files;
  199. cache_files.push_back(name + ".html");
  200. cache_files.push_back(name + ".js");
  201. cache_files.push_back(name + ".offline.html");
  202. if (p_preset->get("html/export_icon")) {
  203. cache_files.push_back(name + ".icon.png");
  204. cache_files.push_back(name + ".apple-touch-icon.png");
  205. }
  206. cache_files.push_back(name + ".worker.js");
  207. cache_files.push_back(name + ".audio.worklet.js");
  208. replaces["@GODOT_CACHE@"] = Variant(cache_files).to_json_string();
  209. // Heavy files that are cached on demand.
  210. Array opt_cache_files;
  211. opt_cache_files.push_back(name + ".wasm");
  212. opt_cache_files.push_back(name + ".pck");
  213. if (extensions) {
  214. opt_cache_files.push_back(name + ".side.wasm");
  215. for (int i = 0; i < p_shared_objects.size(); i++) {
  216. opt_cache_files.push_back(p_shared_objects[i].path.get_file());
  217. }
  218. }
  219. replaces["@GODOT_OPT_CACHE@"] = Variant(opt_cache_files).to_json_string();
  220. const String sw_path = dir.path_join(name + ".service.worker.js");
  221. Vector<uint8_t> sw;
  222. {
  223. Ref<FileAccess> f = FileAccess::open(sw_path, FileAccess::READ);
  224. if (f.is_null()) {
  225. add_message(EXPORT_MESSAGE_ERROR, TTR("PWA"), vformat(TTR("Could not read file: \"%s\"."), sw_path));
  226. return ERR_FILE_CANT_READ;
  227. }
  228. sw.resize(f->get_length());
  229. f->get_buffer(sw.ptrw(), sw.size());
  230. }
  231. _replace_strings(replaces, sw);
  232. Error err = _write_or_error(sw.ptr(), sw.size(), dir.path_join(name + ".service.worker.js"));
  233. if (err != OK) {
  234. return err;
  235. }
  236. // Custom offline page
  237. const String offline_page = p_preset->get("progressive_web_app/offline_page");
  238. if (!offline_page.is_empty()) {
  239. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
  240. const String offline_dest = dir.path_join(name + ".offline.html");
  241. err = da->copy(ProjectSettings::get_singleton()->globalize_path(offline_page), offline_dest);
  242. if (err != OK) {
  243. add_message(EXPORT_MESSAGE_ERROR, TTR("PWA"), vformat(TTR("Could not read file: \"%s\"."), offline_dest));
  244. return err;
  245. }
  246. }
  247. // Manifest
  248. const char *modes[4] = { "fullscreen", "standalone", "minimal-ui", "browser" };
  249. const char *orientations[3] = { "any", "landscape", "portrait" };
  250. const int display = CLAMP(int(p_preset->get("progressive_web_app/display")), 0, 4);
  251. const int orientation = CLAMP(int(p_preset->get("progressive_web_app/orientation")), 0, 3);
  252. Dictionary manifest;
  253. manifest["name"] = proj_name;
  254. manifest["start_url"] = "./" + name + ".html";
  255. manifest["display"] = String::utf8(modes[display]);
  256. manifest["orientation"] = String::utf8(orientations[orientation]);
  257. manifest["background_color"] = "#" + p_preset->get("progressive_web_app/background_color").operator Color().to_html(false);
  258. Array icons_arr;
  259. const String icon144_path = p_preset->get("progressive_web_app/icon_144x144");
  260. err = _add_manifest_icon(p_path, icon144_path, 144, icons_arr);
  261. if (err != OK) {
  262. return err;
  263. }
  264. const String icon180_path = p_preset->get("progressive_web_app/icon_180x180");
  265. err = _add_manifest_icon(p_path, icon180_path, 180, icons_arr);
  266. if (err != OK) {
  267. return err;
  268. }
  269. const String icon512_path = p_preset->get("progressive_web_app/icon_512x512");
  270. err = _add_manifest_icon(p_path, icon512_path, 512, icons_arr);
  271. if (err != OK) {
  272. return err;
  273. }
  274. manifest["icons"] = icons_arr;
  275. CharString cs = Variant(manifest).to_json_string().utf8();
  276. err = _write_or_error((const uint8_t *)cs.get_data(), cs.length(), dir.path_join(name + ".manifest.json"));
  277. if (err != OK) {
  278. return err;
  279. }
  280. return OK;
  281. }
  282. void EditorExportPlatformWeb::get_preset_features(const Ref<EditorExportPreset> &p_preset, List<String> *r_features) const {
  283. if (p_preset->get("vram_texture_compression/for_desktop")) {
  284. r_features->push_back("s3tc");
  285. }
  286. if (p_preset->get("vram_texture_compression/for_mobile")) {
  287. r_features->push_back("etc2");
  288. }
  289. r_features->push_back("wasm32");
  290. }
  291. void EditorExportPlatformWeb::get_export_options(List<ExportOption> *r_options) const {
  292. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "custom_template/debug", PROPERTY_HINT_GLOBAL_FILE, "*.zip"), ""));
  293. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "custom_template/release", PROPERTY_HINT_GLOBAL_FILE, "*.zip"), ""));
  294. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "variant/extensions_support"), false)); // Export type.
  295. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "vram_texture_compression/for_desktop"), true)); // S3TC
  296. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "vram_texture_compression/for_mobile"), false)); // ETC or ETC2, depending on renderer
  297. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "html/export_icon"), true));
  298. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "html/custom_html_shell", PROPERTY_HINT_FILE, "*.html"), ""));
  299. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "html/head_include", PROPERTY_HINT_MULTILINE_TEXT), ""));
  300. r_options->push_back(ExportOption(PropertyInfo(Variant::INT, "html/canvas_resize_policy", PROPERTY_HINT_ENUM, "None,Project,Adaptive"), 2));
  301. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "html/focus_canvas_on_start"), true));
  302. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "html/experimental_virtual_keyboard"), false));
  303. r_options->push_back(ExportOption(PropertyInfo(Variant::BOOL, "progressive_web_app/enabled"), false));
  304. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "progressive_web_app/offline_page", PROPERTY_HINT_FILE, "*.html"), ""));
  305. r_options->push_back(ExportOption(PropertyInfo(Variant::INT, "progressive_web_app/display", PROPERTY_HINT_ENUM, "Fullscreen,Standalone,Minimal UI,Browser"), 1));
  306. r_options->push_back(ExportOption(PropertyInfo(Variant::INT, "progressive_web_app/orientation", PROPERTY_HINT_ENUM, "Any,Landscape,Portrait"), 0));
  307. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "progressive_web_app/icon_144x144", PROPERTY_HINT_FILE, "*.png,*.webp,*.svg"), ""));
  308. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "progressive_web_app/icon_180x180", PROPERTY_HINT_FILE, "*.png,*.webp,*.svg"), ""));
  309. r_options->push_back(ExportOption(PropertyInfo(Variant::STRING, "progressive_web_app/icon_512x512", PROPERTY_HINT_FILE, "*.png,*.webp,*.svg"), ""));
  310. r_options->push_back(ExportOption(PropertyInfo(Variant::COLOR, "progressive_web_app/background_color", PROPERTY_HINT_COLOR_NO_ALPHA), Color()));
  311. }
  312. String EditorExportPlatformWeb::get_name() const {
  313. return "Web";
  314. }
  315. String EditorExportPlatformWeb::get_os_name() const {
  316. return "Web";
  317. }
  318. Ref<Texture2D> EditorExportPlatformWeb::get_logo() const {
  319. return logo;
  320. }
  321. bool EditorExportPlatformWeb::has_valid_export_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error, bool &r_missing_templates, bool p_debug) const {
  322. #ifdef MODULE_MONO_ENABLED
  323. // Don't check for additional errors, as this particular error cannot be resolved.
  324. r_error += TTR("Exporting to Web is currently not supported in Godot 4 when using C#/.NET. Use Godot 3 to target Web with C#/Mono instead.") + "\n";
  325. r_error += TTR("If this project does not use C#, use a non-C# editor build to export the project.") + "\n";
  326. return false;
  327. #else
  328. String err;
  329. bool valid = false;
  330. bool extensions = (bool)p_preset->get("variant/extensions_support");
  331. // Look for export templates (first official, and if defined custom templates).
  332. bool dvalid = exists_export_template(_get_template_name(extensions, true), &err);
  333. bool rvalid = exists_export_template(_get_template_name(extensions, false), &err);
  334. if (p_preset->get("custom_template/debug") != "") {
  335. dvalid = FileAccess::exists(p_preset->get("custom_template/debug"));
  336. if (!dvalid) {
  337. err += TTR("Custom debug template not found.") + "\n";
  338. }
  339. }
  340. if (p_preset->get("custom_template/release") != "") {
  341. rvalid = FileAccess::exists(p_preset->get("custom_template/release"));
  342. if (!rvalid) {
  343. err += TTR("Custom release template not found.") + "\n";
  344. }
  345. }
  346. valid = dvalid || rvalid;
  347. r_missing_templates = !valid;
  348. if (!err.is_empty()) {
  349. r_error = err;
  350. }
  351. return valid;
  352. #endif // !MODULE_MONO_ENABLED
  353. }
  354. bool EditorExportPlatformWeb::has_valid_project_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error) const {
  355. String err;
  356. bool valid = true;
  357. // Validate the project configuration.
  358. if (p_preset->get("vram_texture_compression/for_mobile")) {
  359. String etc_error = test_etc2();
  360. if (!etc_error.is_empty()) {
  361. valid = false;
  362. err += etc_error;
  363. }
  364. }
  365. if (!err.is_empty()) {
  366. r_error = err;
  367. }
  368. return valid;
  369. }
  370. List<String> EditorExportPlatformWeb::get_binary_extensions(const Ref<EditorExportPreset> &p_preset) const {
  371. List<String> list;
  372. list.push_back("html");
  373. return list;
  374. }
  375. Error EditorExportPlatformWeb::export_project(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &p_path, int p_flags) {
  376. ExportNotifier notifier(*this, p_preset, p_debug, p_path, p_flags);
  377. const String custom_debug = p_preset->get("custom_template/debug");
  378. const String custom_release = p_preset->get("custom_template/release");
  379. const String custom_html = p_preset->get("html/custom_html_shell");
  380. const bool export_icon = p_preset->get("html/export_icon");
  381. const bool pwa = p_preset->get("progressive_web_app/enabled");
  382. const String base_dir = p_path.get_base_dir();
  383. const String base_path = p_path.get_basename();
  384. const String base_name = p_path.get_file().get_basename();
  385. // Find the correct template
  386. String template_path = p_debug ? custom_debug : custom_release;
  387. template_path = template_path.strip_edges();
  388. if (template_path.is_empty()) {
  389. bool extensions = (bool)p_preset->get("variant/extensions_support");
  390. template_path = find_export_template(_get_template_name(extensions, p_debug));
  391. }
  392. if (!DirAccess::exists(base_dir)) {
  393. return ERR_FILE_BAD_PATH;
  394. }
  395. if (!template_path.is_empty() && !FileAccess::exists(template_path)) {
  396. add_message(EXPORT_MESSAGE_ERROR, TTR("Prepare Templates"), vformat(TTR("Template file not found: \"%s\"."), template_path));
  397. return ERR_FILE_NOT_FOUND;
  398. }
  399. // Export pck and shared objects
  400. Vector<SharedObject> shared_objects;
  401. String pck_path = base_path + ".pck";
  402. Error error = save_pack(p_preset, p_debug, pck_path, &shared_objects);
  403. if (error != OK) {
  404. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), pck_path));
  405. return error;
  406. }
  407. {
  408. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
  409. for (int i = 0; i < shared_objects.size(); i++) {
  410. String dst = base_dir.path_join(shared_objects[i].path.get_file());
  411. error = da->copy(shared_objects[i].path, dst);
  412. if (error != OK) {
  413. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), shared_objects[i].path.get_file()));
  414. return error;
  415. }
  416. }
  417. }
  418. // Extract templates.
  419. error = _extract_template(template_path, base_dir, base_name, pwa);
  420. if (error) {
  421. return error;
  422. }
  423. // Parse generated file sizes (pck and wasm, to help show a meaningful loading bar).
  424. Dictionary file_sizes;
  425. Ref<FileAccess> f = FileAccess::open(pck_path, FileAccess::READ);
  426. if (f.is_valid()) {
  427. file_sizes[pck_path.get_file()] = (uint64_t)f->get_length();
  428. }
  429. f = FileAccess::open(base_path + ".wasm", FileAccess::READ);
  430. if (f.is_valid()) {
  431. file_sizes[base_name + ".wasm"] = (uint64_t)f->get_length();
  432. }
  433. // Read the HTML shell file (custom or from template).
  434. const String html_path = custom_html.is_empty() ? base_path + ".html" : custom_html;
  435. Vector<uint8_t> html;
  436. f = FileAccess::open(html_path, FileAccess::READ);
  437. if (f.is_null()) {
  438. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not read HTML shell: \"%s\"."), html_path));
  439. return ERR_FILE_CANT_READ;
  440. }
  441. html.resize(f->get_length());
  442. f->get_buffer(html.ptrw(), html.size());
  443. f.unref(); // close file.
  444. // Generate HTML file with replaced strings.
  445. _fix_html(html, p_preset, base_name, p_debug, p_flags, shared_objects, file_sizes);
  446. Error err = _write_or_error(html.ptr(), html.size(), p_path);
  447. if (err != OK) {
  448. return err;
  449. }
  450. html.resize(0);
  451. // Export splash (why?)
  452. Ref<Image> splash = _get_project_splash();
  453. const String splash_png_path = base_path + ".png";
  454. if (splash->save_png(splash_png_path) != OK) {
  455. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), splash_png_path));
  456. return ERR_FILE_CANT_WRITE;
  457. }
  458. // Save a favicon that can be accessed without waiting for the project to finish loading.
  459. // This way, the favicon can be displayed immediately when loading the page.
  460. if (export_icon) {
  461. Ref<Image> favicon = _get_project_icon();
  462. const String favicon_png_path = base_path + ".icon.png";
  463. if (favicon->save_png(favicon_png_path) != OK) {
  464. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), favicon_png_path));
  465. return ERR_FILE_CANT_WRITE;
  466. }
  467. favicon->resize(180, 180);
  468. const String apple_icon_png_path = base_path + ".apple-touch-icon.png";
  469. if (favicon->save_png(apple_icon_png_path) != OK) {
  470. add_message(EXPORT_MESSAGE_ERROR, TTR("Export"), vformat(TTR("Could not write file: \"%s\"."), apple_icon_png_path));
  471. return ERR_FILE_CANT_WRITE;
  472. }
  473. }
  474. // Generate the PWA worker and manifest
  475. if (pwa) {
  476. err = _build_pwa(p_preset, p_path, shared_objects);
  477. if (err != OK) {
  478. return err;
  479. }
  480. }
  481. return OK;
  482. }
  483. bool EditorExportPlatformWeb::poll_export() {
  484. Ref<EditorExportPreset> preset;
  485. for (int i = 0; i < EditorExport::get_singleton()->get_export_preset_count(); i++) {
  486. Ref<EditorExportPreset> ep = EditorExport::get_singleton()->get_export_preset(i);
  487. if (ep->is_runnable() && ep->get_platform() == this) {
  488. preset = ep;
  489. break;
  490. }
  491. }
  492. int prev = menu_options;
  493. menu_options = preset.is_valid();
  494. if (server->is_listening()) {
  495. if (menu_options == 0) {
  496. MutexLock lock(server_lock);
  497. server->stop();
  498. } else {
  499. menu_options += 1;
  500. }
  501. }
  502. return menu_options != prev;
  503. }
  504. Ref<ImageTexture> EditorExportPlatformWeb::get_option_icon(int p_index) const {
  505. return p_index == 1 ? stop_icon : EditorExportPlatform::get_option_icon(p_index);
  506. }
  507. int EditorExportPlatformWeb::get_options_count() const {
  508. return menu_options;
  509. }
  510. Error EditorExportPlatformWeb::run(const Ref<EditorExportPreset> &p_preset, int p_option, int p_debug_flags) {
  511. if (p_option == 1) {
  512. MutexLock lock(server_lock);
  513. server->stop();
  514. return OK;
  515. }
  516. const String dest = EditorPaths::get_singleton()->get_cache_dir().path_join("web");
  517. Ref<DirAccess> da = DirAccess::create(DirAccess::ACCESS_FILESYSTEM);
  518. if (!da->dir_exists(dest)) {
  519. Error err = da->make_dir_recursive(dest);
  520. if (err != OK) {
  521. add_message(EXPORT_MESSAGE_ERROR, TTR("Run"), vformat(TTR("Could not create HTTP server directory: %s."), dest));
  522. return err;
  523. }
  524. }
  525. const String basepath = dest.path_join("tmp_js_export");
  526. Error err = export_project(p_preset, true, basepath + ".html", p_debug_flags);
  527. if (err != OK) {
  528. // Export generates several files, clean them up on failure.
  529. DirAccess::remove_file_or_error(basepath + ".html");
  530. DirAccess::remove_file_or_error(basepath + ".offline.html");
  531. DirAccess::remove_file_or_error(basepath + ".js");
  532. DirAccess::remove_file_or_error(basepath + ".worker.js");
  533. DirAccess::remove_file_or_error(basepath + ".audio.worklet.js");
  534. DirAccess::remove_file_or_error(basepath + ".service.worker.js");
  535. DirAccess::remove_file_or_error(basepath + ".pck");
  536. DirAccess::remove_file_or_error(basepath + ".png");
  537. DirAccess::remove_file_or_error(basepath + ".side.wasm");
  538. DirAccess::remove_file_or_error(basepath + ".wasm");
  539. DirAccess::remove_file_or_error(basepath + ".icon.png");
  540. DirAccess::remove_file_or_error(basepath + ".apple-touch-icon.png");
  541. return err;
  542. }
  543. const uint16_t bind_port = EDITOR_GET("export/web/http_port");
  544. // Resolve host if needed.
  545. const String bind_host = EDITOR_GET("export/web/http_host");
  546. IPAddress bind_ip;
  547. if (bind_host.is_valid_ip_address()) {
  548. bind_ip = bind_host;
  549. } else {
  550. bind_ip = IP::get_singleton()->resolve_hostname(bind_host);
  551. }
  552. ERR_FAIL_COND_V_MSG(!bind_ip.is_valid(), ERR_INVALID_PARAMETER, "Invalid editor setting 'export/web/http_host': '" + bind_host + "'. Try using '127.0.0.1'.");
  553. const bool use_tls = EDITOR_GET("export/web/use_tls");
  554. const String tls_key = EDITOR_GET("export/web/tls_key");
  555. const String tls_cert = EDITOR_GET("export/web/tls_certificate");
  556. // Restart server.
  557. {
  558. MutexLock lock(server_lock);
  559. server->stop();
  560. err = server->listen(bind_port, bind_ip, use_tls, tls_key, tls_cert);
  561. }
  562. if (err != OK) {
  563. add_message(EXPORT_MESSAGE_ERROR, TTR("Run"), vformat(TTR("Error starting HTTP server: %d."), err));
  564. return err;
  565. }
  566. OS::get_singleton()->shell_open(String((use_tls ? "https://" : "http://") + bind_host + ":" + itos(bind_port) + "/tmp_js_export.html"));
  567. // FIXME: Find out how to clean up export files after running the successfully
  568. // exported game. Might not be trivial.
  569. return OK;
  570. }
  571. Ref<Texture2D> EditorExportPlatformWeb::get_run_icon() const {
  572. return run_icon;
  573. }
  574. void EditorExportPlatformWeb::_server_thread_poll(void *data) {
  575. EditorExportPlatformWeb *ej = static_cast<EditorExportPlatformWeb *>(data);
  576. while (!ej->server_quit) {
  577. OS::get_singleton()->delay_usec(6900);
  578. {
  579. MutexLock lock(ej->server_lock);
  580. ej->server->poll();
  581. }
  582. }
  583. }
  584. EditorExportPlatformWeb::EditorExportPlatformWeb() {
  585. if (EditorNode::get_singleton()) {
  586. server.instantiate();
  587. server_thread.start(_server_thread_poll, this);
  588. #ifdef MODULE_SVG_ENABLED
  589. Ref<Image> img = memnew(Image);
  590. const bool upsample = !Math::is_equal_approx(Math::round(EDSCALE), EDSCALE);
  591. ImageLoaderSVG::create_image_from_string(img, _web_logo_svg, EDSCALE, upsample, false);
  592. logo = ImageTexture::create_from_image(img);
  593. ImageLoaderSVG::create_image_from_string(img, _web_run_icon_svg, EDSCALE, upsample, false);
  594. run_icon = ImageTexture::create_from_image(img);
  595. #endif
  596. Ref<Theme> theme = EditorNode::get_singleton()->get_editor_theme();
  597. if (theme.is_valid()) {
  598. stop_icon = theme->get_icon(SNAME("Stop"), SNAME("EditorIcons"));
  599. } else {
  600. stop_icon.instantiate();
  601. }
  602. }
  603. }
  604. EditorExportPlatformWeb::~EditorExportPlatformWeb() {
  605. if (server.is_valid()) {
  606. server->stop();
  607. }
  608. server_quit = true;
  609. if (server_thread.is_started()) {
  610. server_thread.wait_to_finish();
  611. }
  612. }