/**************************************************************************/ /* export_plugin.h */ /**************************************************************************/ /* This file is part of: */ /* GODOT ENGINE */ /* https://godotengine.org */ /**************************************************************************/ /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */ /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */ /* */ /* Permission is hereby granted, free of charge, to any person obtaining */ /* a copy of this software and associated documentation files (the */ /* "Software"), to deal in the Software without restriction, including */ /* without limitation the rights to use, copy, modify, merge, publish, */ /* distribute, sublicense, and/or sell copies of the Software, and to */ /* permit persons to whom the Software is furnished to do so, subject to */ /* the following conditions: */ /* */ /* The above copyright notice and this permission notice shall be */ /* included in all copies or substantial portions of the Software. */ /* */ /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */ /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */ /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */ /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */ /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */ /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */ /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ /**************************************************************************/ #ifndef IOS_EXPORT_PLUGIN_H #define IOS_EXPORT_PLUGIN_H #include "godot_plugin_config.h" #include "core/config/project_settings.h" #include "core/io/file_access.h" #include "core/io/image_loader.h" #include "core/io/marshalls.h" #include "core/io/resource_saver.h" #include "core/io/zip_io.h" #include "core/os/os.h" #include "core/templates/safe_refcount.h" #include "core/version.h" #include "editor/editor_settings.h" #include "editor/export/editor_export_platform.h" #include "main/splash.gen.h" #include "scene/resources/image_texture.h" #include #include // Optional environment variables for defining confidential information. If any // of these is set, they will override the values set in the credentials file. const String ENV_IOS_PROFILE_UUID_DEBUG = "GODOT_IOS_PROVISIONING_PROFILE_UUID_DEBUG"; const String ENV_IOS_PROFILE_UUID_RELEASE = "GODOT_IOS_PROVISIONING_PROFILE_UUID_RELEASE"; class EditorExportPlatformIOS : public EditorExportPlatform { GDCLASS(EditorExportPlatformIOS, EditorExportPlatform); Ref logo; Ref run_icon; // Plugins mutable SafeFlag plugins_changed; SafeFlag devices_changed; struct Device { String id; String name; bool simulator = false; bool wifi = false; bool use_ios_deploy = false; }; Vector devices; Mutex device_lock; Mutex plugins_lock; mutable Vector plugins; #ifdef MACOS_ENABLED Thread check_for_changes_thread; SafeFlag quit_request; SafeFlag has_runnable_preset; static bool _check_xcode_install(); static void _check_for_changes_poll_thread(void *ud); void _update_preset_status(); #endif typedef Error (*FileHandler)(String p_file, void *p_userdata); static Error _walk_dir_recursive(Ref &p_da, FileHandler p_handler, void *p_userdata); static Error _codesign(String p_file, void *p_userdata); void _blend_and_rotate(Ref &p_dst, Ref &p_src, bool p_rot); struct IOSConfigData { String pkg_name; String binary_name; String plist_content; String architectures; String linker_flags; String cpp_code; String modules_buildfile; String modules_fileref; String modules_buildphase; String modules_buildgrp; Vector capabilities; bool use_swift_runtime; }; struct ExportArchitecture { String name; bool is_default = false; ExportArchitecture() {} ExportArchitecture(String p_name, bool p_is_default) { name = p_name; is_default = p_is_default; } }; struct IOSExportAsset { String exported_path; bool is_framework = false; // framework is anything linked to the binary, otherwise it's a resource bool should_embed = false; }; String _get_additional_plist_content(); String _get_linker_flags(); String _get_cpp_code(); void _fix_config_file(const Ref &p_preset, Vector &pfile, const IOSConfigData &p_config, bool p_debug); Error _export_loading_screen_file(const Ref &p_preset, const String &p_dest_dir); Error _export_icons(const Ref &p_preset, const String &p_iconset_dir); Vector _get_supported_architectures() const; Vector _get_preset_architectures(const Ref &p_preset) const; bool _archive_has_arm64(const String &p_path, uint32_t *r_cputype = nullptr, uint32_t *r_cpusubtype = nullptr) const; int _archive_convert_to_simulator(const String &p_path) const; void _check_xcframework_content(const String &p_path, int &r_total_libs, int &r_static_libs, int &r_dylibs, int &r_frameworks) const; Error _convert_to_framework(const String &p_source, const String &p_destination, const String &p_id) const; void _add_assets_to_project(const String &p_out_dir, const Ref &p_preset, Vector &p_project_data, const Vector &p_additional_assets); Error _export_additional_assets(const Ref &p_preset, const String &p_out_dir, const Vector &p_assets, bool p_is_framework, bool p_should_embed, Vector &r_exported_assets); Error _copy_asset(const Ref &p_preset, const String &p_out_dir, const String &p_asset, const String *p_custom_file_name, bool p_is_framework, bool p_should_embed, Vector &r_exported_assets); Error _export_additional_assets(const Ref &p_preset, const String &p_out_dir, const Vector &p_libraries, Vector &r_exported_assets); Error _export_ios_plugins(const Ref &p_preset, IOSConfigData &p_config_data, const String &dest_dir, Vector &r_exported_assets, bool p_debug); Error _export_project_helper(const Ref &p_preset, bool p_debug, const String &p_path, int p_flags, bool p_simulator, bool p_oneclick); bool is_package_name_valid(const String &p_package, String *r_error = nullptr) const; protected: virtual void get_preset_features(const Ref &p_preset, List *r_features) const override; virtual void get_export_options(List *r_options) const override; virtual bool get_export_option_visibility(const EditorExportPreset *p_preset, const String &p_option) const override; virtual String get_export_option_warning(const EditorExportPreset *p_preset, const StringName &p_name) const override; void _notification(int p_what); public: virtual String get_name() const override { return "iOS"; } virtual String get_os_name() const override { return "iOS"; } virtual Ref get_logo() const override { return logo; } virtual Ref get_run_icon() const override { return run_icon; } virtual int get_options_count() const override; virtual String get_options_tooltip() const override; virtual Ref get_option_icon(int p_index) const override; virtual String get_option_label(int p_index) const override; virtual String get_option_tooltip(int p_index) const override; virtual Error run(const Ref &p_preset, int p_device, int p_debug_flags) override; virtual bool poll_export() override { bool dc = devices_changed.is_set(); if (dc) { // don't clear unless we're reporting true, to avoid race devices_changed.clear(); } return dc; } virtual bool should_update_export_options() override { bool export_options_changed = plugins_changed.is_set(); if (export_options_changed) { // don't clear unless we're reporting true, to avoid race plugins_changed.clear(); } return export_options_changed; } virtual List get_binary_extensions(const Ref &p_preset) const override { List list; if (p_preset.is_valid()) { bool project_only = p_preset->get("application/export_project_only"); if (project_only) { list.push_back("xcodeproj"); } else { list.push_back("ipa"); } } return list; } virtual Error export_project(const Ref &p_preset, bool p_debug, const String &p_path, int p_flags = 0) override; virtual bool has_valid_export_configuration(const Ref &p_preset, String &r_error, bool &r_missing_templates, bool p_debug = false) const override; virtual bool has_valid_project_configuration(const Ref &p_preset, String &r_error) const override; virtual void get_platform_features(List *r_features) const override { r_features->push_back("mobile"); r_features->push_back("ios"); } virtual void resolve_platform_feature_priorities(const Ref &p_preset, HashSet &p_features) override { } EditorExportPlatformIOS(); ~EditorExportPlatformIOS(); /// List the gdip files in the directory specified by the p_path parameter. static Vector list_plugin_config_files(const String &p_path, bool p_check_directories) { Vector dir_files; Ref da = DirAccess::open(p_path); if (da.is_valid()) { da->list_dir_begin(); while (true) { String file = da->get_next(); if (file.is_empty()) { break; } if (file == "." || file == "..") { continue; } if (da->current_is_hidden()) { continue; } if (da->current_is_dir()) { if (p_check_directories) { Vector directory_files = list_plugin_config_files(p_path.path_join(file), false); for (int i = 0; i < directory_files.size(); ++i) { dir_files.push_back(file.path_join(directory_files[i])); } } continue; } if (file.ends_with(PluginConfigIOS::PLUGIN_CONFIG_EXT)) { dir_files.push_back(file); } } da->list_dir_end(); } return dir_files; } static Vector get_plugins() { Vector loaded_plugins; String plugins_dir = ProjectSettings::get_singleton()->get_resource_path().path_join("ios/plugins"); if (DirAccess::exists(plugins_dir)) { Vector plugins_filenames = list_plugin_config_files(plugins_dir, true); if (!plugins_filenames.is_empty()) { Ref config_file = memnew(ConfigFile); for (int i = 0; i < plugins_filenames.size(); i++) { PluginConfigIOS config = PluginConfigIOS::load_plugin_config(config_file, plugins_dir.path_join(plugins_filenames[i])); if (config.valid_config) { loaded_plugins.push_back(config); } else { print_error("Invalid plugin config file " + plugins_filenames[i]); } } } } return loaded_plugins; } static Vector get_enabled_plugins(const Ref &p_presets) { Vector enabled_plugins; Vector all_plugins = get_plugins(); for (int i = 0; i < all_plugins.size(); i++) { PluginConfigIOS plugin = all_plugins[i]; bool enabled = p_presets->get("plugins/" + plugin.name); if (enabled) { enabled_plugins.push_back(plugin); } } return enabled_plugins; } }; #endif // IOS_EXPORT_PLUGIN_H