Path: blob/master/platform/macos/export/export_plugin.h
20920 views
/**************************************************************************/1/* export_plugin.h */2/**************************************************************************/3/* This file is part of: */4/* GODOT ENGINE */5/* https://godotengine.org */6/**************************************************************************/7/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */8/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */9/* */10/* Permission is hereby granted, free of charge, to any person obtaining */11/* a copy of this software and associated documentation files (the */12/* "Software"), to deal in the Software without restriction, including */13/* without limitation the rights to use, copy, modify, merge, publish, */14/* distribute, sublicense, and/or sell copies of the Software, and to */15/* permit persons to whom the Software is furnished to do so, subject to */16/* the following conditions: */17/* */18/* The above copyright notice and this permission notice shall be */19/* included in all copies or substantial portions of the Software. */20/* */21/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */22/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */23/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */24/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */25/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */26/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */27/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */28/**************************************************************************/2930#pragma once3132#include "core/config/project_settings.h"33#include "core/io/dir_access.h"34#include "core/io/file_access.h"35#include "core/io/image.h"36#include "core/io/marshalls.h"37#include "core/io/resource_saver.h"38#include "core/os/os.h"39#include "editor/export/editor_export.h"40#include "editor/settings/editor_settings.h"41#include "scene/resources/image_texture.h"4243#include <sys/stat.h>4445// Optional environment variables for defining confidential information. If any46// of these is set, they will override the values set in the credentials file.47const String ENV_MAC_CODESIGN_CERT_FILE = "GODOT_MACOS_CODESIGN_CERTIFICATE_FILE";48const String ENV_MAC_CODESIGN_CERT_PASS = "GODOT_MACOS_CODESIGN_CERTIFICATE_PASSWORD";49const String ENV_MAC_CODESIGN_PROFILE = "GODOT_MACOS_CODESIGN_PROVISIONING_PROFILE";50const String ENV_MAC_NOTARIZATION_UUID = "GODOT_MACOS_NOTARIZATION_API_UUID";51const String ENV_MAC_NOTARIZATION_KEY = "GODOT_MACOS_NOTARIZATION_API_KEY";52const String ENV_MAC_NOTARIZATION_KEY_ID = "GODOT_MACOS_NOTARIZATION_API_KEY_ID";53const String ENV_MAC_NOTARIZATION_APPLE_ID = "GODOT_MACOS_NOTARIZATION_APPLE_ID_NAME";54const String ENV_MAC_NOTARIZATION_APPLE_PASS = "GODOT_MACOS_NOTARIZATION_APPLE_ID_PASSWORD";5556class EditorExportPlatformMacOS : public EditorExportPlatform {57GDCLASS(EditorExportPlatformMacOS, EditorExportPlatform);5859int version_code = 0;6061Ref<ImageTexture> logo;6263struct SSHCleanupCommand {64String host;65String port;66Vector<String> ssh_args;67String cmd_args;68bool wait = false;6970SSHCleanupCommand() {}71SSHCleanupCommand(const String &p_host, const String &p_port, const Vector<String> &p_ssh_arg, const String &p_cmd_args, bool p_wait = false) {72host = p_host;73port = p_port;74ssh_args = p_ssh_arg;75cmd_args = p_cmd_args;76wait = p_wait;77}78};7980Ref<ImageTexture> run_icon;81Ref<ImageTexture> stop_icon;8283Vector<SSHCleanupCommand> cleanup_commands;84OS::ProcessID ssh_pid = 0;85int menu_options = 0;8687void _fix_privacy_manifest(const Ref<EditorExportPreset> &p_preset, Vector<uint8_t> &plist);88void _fix_plist(const Ref<EditorExportPreset> &p_preset, Vector<uint8_t> &plist, const String &p_binary, bool p_lg_icon_exported, const String &p_lg_icon);89void _make_icon(const Ref<EditorExportPreset> &p_preset, const Ref<Image> &p_icon, Vector<uint8_t> &p_data);9091Error _export_liquid_glass_icon(const Ref<EditorExportPreset> &p_preset, const String &p_app_path, const String &p_icon_path);92Error _notarize(const Ref<EditorExportPreset> &p_preset, const String &p_path);93void _code_sign(const Ref<EditorExportPreset> &p_preset, const String &p_path, const String &p_ent_path, bool p_warn = true, bool p_set_id = false);94void _code_sign_directory(const Ref<EditorExportPreset> &p_preset, const String &p_path, const String &p_ent_path, const String &p_helper_ent_path, bool p_should_error_on_non_code = true);95Error _copy_and_sign_files(Ref<DirAccess> &dir_access, const String &p_src_path, const String &p_in_app_path,96bool p_sign_enabled, const Ref<EditorExportPreset> &p_preset, const String &p_ent_path, const String &p_helper_ent_path,97bool p_should_error_on_non_code_sign, bool p_sandbox);98Error _export_macos_plugins_for(Ref<EditorExportPlugin> p_editor_export_plugin, const String &p_app_path_name,99Ref<DirAccess> &dir_access, bool p_sign_enabled, const Ref<EditorExportPreset> &p_preset,100const String &p_ent_path, const String &p_helper_ent_path, bool p_sandbox);101Error _create_dmg(const String &p_dmg_path, const String &p_pkg_name, const String &p_app_path_name);102Error _create_pkg(const Ref<EditorExportPreset> &p_preset, const String &p_pkg_path, const String &p_app_path_name);103Error _export_debug_script(const Ref<EditorExportPreset> &p_preset, const String &p_app_name, const String &p_pkg_name, const String &p_path);104105bool use_codesign() const { return true; }106107bool is_package_name_valid(const String &p_package, String *r_error = nullptr) const {108String pname = p_package;109110if (pname.length() == 0) {111if (r_error) {112*r_error = TTR("Identifier is missing.");113}114return false;115}116117for (int i = 0; i < pname.length(); i++) {118char32_t c = pname[i];119if (!(is_ascii_alphanumeric_char(c) || c == '-' || c == '.')) {120if (r_error) {121*r_error = vformat(TTR("The character '%s' is not allowed in Identifier."), String::chr(c));122}123return false;124}125}126127return true;128}129bool is_shebang(const String &p_path) const;130131protected:132virtual void get_preset_features(const Ref<EditorExportPreset> &p_preset, List<String> *r_features) const override;133virtual void get_export_options(List<ExportOption> *r_options) const override;134virtual bool get_export_option_visibility(const EditorExportPreset *p_preset, const String &p_option) const override;135virtual String get_export_option_warning(const EditorExportPreset *p_preset, const StringName &p_name) const override;136137public:138virtual String get_name() const override {139return "macOS";140}141virtual String get_os_name() const override {142return "macOS";143}144virtual Ref<Texture2D> get_logo() const override {145return logo;146}147148virtual bool is_executable(const String &p_path) const override;149virtual List<String> get_binary_extensions(const Ref<EditorExportPreset> &p_preset) const override;150virtual Error export_project(const Ref<EditorExportPreset> &p_preset, bool p_debug, const String &p_path, BitField<EditorExportPlatform::DebugFlags> p_flags = 0) override;151152virtual bool has_valid_export_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error, bool &r_missing_templates, bool p_debug = false) const override;153virtual bool has_valid_project_configuration(const Ref<EditorExportPreset> &p_preset, String &r_error) const override;154155virtual void get_platform_features(List<String> *r_features) const override {156r_features->push_back("pc");157r_features->push_back("s3tc");158r_features->push_back("macos");159}160161virtual void resolve_platform_feature_priorities(const Ref<EditorExportPreset> &p_preset, HashSet<String> &p_features) override {162}163164virtual Ref<Texture2D> get_run_icon() const override;165virtual bool poll_export() override;166virtual Ref<Texture2D> get_option_icon(int p_index) const override;167virtual int get_options_count() const override;168virtual String get_option_label(int p_index) const override;169virtual String get_option_tooltip(int p_index) const override;170virtual Error run(const Ref<EditorExportPreset> &p_preset, int p_device, BitField<EditorExportPlatform::DebugFlags> p_debug_flags) override;171virtual void cleanup() override;172173virtual void initialize() override;174};175176177