Експорт на macOS

Дивись також

На цій сторінці описано, як експортувати проект Godot на macOS. Якщо ви хочете замість цього скомпілювати редактор, або експортувати шаблони бінарних файлів з джерела, прочитайте Compiling for macOS.

Програми macOS експортуються як пакет .app, це тека з певною структурою, яка зберігає виконуваний файл, бібліотеки та всі файли проекту. Цей пакет упакований в ZIP-архів, або образ диска DMG (підтримується тільки при експорті на macOS).

Вимоги

  • Щоб увімкнути підписи та нотаріальне засвідчення коду, ви повинні виконувати експорт з комп’ютера під керуванням macOS із встановленими інструментами командного рядка Xcode.

  • Завантаження шаблонів експорту Godot. Використовуйте меню Godot: Редактор> Керування шаблонами експортування.

Попередження

Проекти, експортовані без підпису та нотаріального засвідчення коду, будуть заблоковані Gatekeeper, якщо вони завантажені з невідомих джерел, перегляньте сторінку Запуск додатків Godot на MacOS для отримання додаткової інформації.

Підпис та нотаріальне засвідчення коду

За замовчуванням macOS запускатиме лише підписані та нотаріально завірені програми, якщо ви використовуєте будь-яку іншу конфігурацію підпису, шукайте обхідний шлях на сторінці Запуск додатків Godot на macOS.

Щоб нотаріально засвідчити додаток, ви повинні мати дійсний Сертифікат Apple Developer ID.

Якщо у вас є сертифікат Apple Developer ID

  • Увімкніть Code Signing, Notarization, Hardened Runtime та Timestamp і вимкніть право Debug.

  • Надайте дійсні облікові дані Apple ID та посвідчення сертифіката.

Якщо увімкнено Notarization, Godot буде автоматично завантажувати експортований проект для нотаріального засвідчення.

Ви можете використовувати команду xcrun notarytool history, щоб перевірити стан нотаріального засвідчення і скористатися командою xcrun notarytool log {ID} для завантаження логу нотаріальних свідчень.

Якщо у вас виникли проблеми з нотаріальним засвідченням перегляньте Вирішення поширених питань нотаріального засвідчення.

Після завершення нотаріального засвідчення `прикріпіть квиток<https://developer.apple.com/documentation/security/notarizing_macos_software_before_distribution/customizing_the_notarization_workflow>`__ до експортованого проекту.

Якщо у вас немає сертифіката Apple Developer ID

Залиште Code Signing увімкненим і Identity пустим, у цьому випадку Godot буде використовувати спеціальний підпис, що полегшить для кінцевих користувачів запуск експортованого додатка.

Параметри підпису

Опція

Опис

Увімкнути

Вмикає підписування коду.

Профіль

"Повне ім'я", або "Загальне ім'я", посвідчення підпису, зберігаються в ланцюжку ключів macOS. 1

Часова позначка

Запит на сервер часової позначки для автентифікації часу на час підписання. Необхідний для нотаріального засвідчення.

Стійке середовище виконання

Вмикає "Hardened Runtime". Необхідний для нотаріального посвідчення.

Замінити наявний підпис

Замінює наявні підписи бібліотек GDNative і вбудованих допоміжних виконуваних файлів.

Примітка

Для засвідчення ви повинні увімкнути Hardened Runtime та Timestamp.

1

Залиште параметр Identity порожнім, щоб використовувати спеціальний підпис.

Параметри нотаріального засвідчення

Опція

Опис

Увімкнути

Вмикає автоматичне завантаження для нотаріального засвідчення.

Ім'я Apple ID

Ім'я облікового запису Apple ID (адреса електронної пошти)

Пароль до Apple ID

Пароль для програми Apple ID. Перегляньте `Використання паролів для спеціальних додатків<https://support.apple.com/en-us/HT204397>`__, щоб ввімкнення двофакторну автентифікації та створення пароля додатка.

Apple Team ID

Ідентифікатор команди, якщо ваш Apple ID належить кільком командам

Для більшої інформації дивіться Нотаріальне засвідчення програмного забезпечення macOS перед розповсюдженням.

Права

Дозволи Захищеного виконання

За допомогою дозволів Захищеного виконання можна керувати параметрами безпеки та політикою доступу до ресурсів. Докладніше про них можна дізнатися з розділу Захищене виконання.

Дозволи

Опис

Дозволити виконання коду JIT 2

Дозволяє створювати записувану та виконувану пам'ять для коду JIT. Якщо використовуються додаткові компоненти з динамічним, або само-змінюваним, рідним кодом, увімкніть їх відповідно до додаткової документації.

Дозволити Unsigned Executable Memory 2

Дозволяє створювати завантажувальну та виконувану пам'ять без обмежень JIT. Якщо використовуються додаткові компоненти з динамічним або само-змінюваним рідним кодом, увімкніть їх відповідно до додаткової документації.

Дозволити DYLD Environment Variables 2

Дозволяє програмі використовувати динамічні змінні середовища зв'язку для введення коду. Якщо ви використовуєте додатки з динамічним або само-змінюваним рідним кодом, увімкніть їх відповідно до додаткової документації.

Вимкнути перевірку бібліотеки

Дозволяє програмі завантажувати довільні бібліотеки та фреймворки. Увімкніть його, якщо ви використовуєте додаткові компоненти GDNative і спеціальний підпис, або хочете підтримувати зовнішні додаткові компоненти, надані користувачем.

Звуковий вхід

Увімкніть, якщо вам потрібно використовувати мікрофон, або інші джерела введення звуку, якщо він включений, ви також повинні надати повідомлення про використання в параметрі privacy/microphone_usage_description.

Фотоапарат

Увімкніть, якщо вам потрібно використовувати камеру, якщо вона включена, ви також повинні надати повідомлення про використання в параметрі privacy/camera_usage_description.

Розташування

Увімкніть, якщо вам потрібно використовувати інформацію про місцезнаходження зі служб визначення місцезнаходження, якщо вона включена, ви також повинні надати повідомлення про використання в параметрі privacy/location_usage_description.

Адресна книга

3 Увімкніть, щоб дозволити доступ до контактів в адресній книзі користувача, якщо він включений, ви також повинні надати повідомлення про використання в параметрі privacy/address_book_usage_description.

Календарі

3 Увімкніть, щоб дозволити доступ до календаря користувача, якщо він увімкнений, ви також повинні надати повідомлення про використання в параметрі privacy/calendar_usage_description.

Бібліотека фото

3 Увімкніть, щоб дозволити доступ до бібліотеки фотографій користувача, якщо він включений, ви також повинні надати повідомлення про використання в параметрі privacy/photos_library_usage_description.

Події Apple

3 Увімкніть, щоб дозволити програмі надсилати події Apple в інші програми.

Діагностика

4 Ви можете тимчасово ввімкнути цей дозвіл на використання власного налагоджувача (GDB, LLDB) з експортованим додатком. Цей дозвіл повинен бути відключений для експорту продукції.

2(1,2,3)

Allow JIT Code Execution, Allow Unsigned Executable Memory і Allow DYLD Environment Variables дозволи завжди ввімкнені для експорту Godot Mono, і не відображаються в параметрах експорту.

3(1,2,3,4)

Ці функції не підтримуються Godot з коробки, вмикайте їх, лише якщо ви використовуєте додаткові компоненти, які їх потребують.

4

Щоб засвідчити додаток, потрібно вимкнути дозвіл Debugging.

Дозвіл Пісочниці додатка

Пісочниця додатка обмежує доступ до даних користувачів, мереж і пристроїв. Програми з пісочницею не можуть отримати доступ до більшості файлових систем, не можуть використовувати власні діалогові вікна файлів і виконувати двійкові файли (за допомогою OS.execute і OS.create_process) за межами пакета .app. Докладніше про це можна дізнатися з Пісочниця додатка.

Примітка

Щоб розповсюдити додаток через App Store, потрібно ввімкнути Пісочницю додатка.

Дозволи

Опис

Увімкнено

Вмикає пісочницю додатка.

Мережевий сервер

Увімкніть, щоб дозволити програмі прослуховувати вхідні мережні підключення.

Клієнт мережі

Увімкніть, щоб дозволити програмі встановлювати вихідні мережні підключення.

USB пристрою

Увімкніть, щоб додаток міг взаємодіяти з USB-пристроями. Цей дозвіл необхідний для використання дротових контролерів.

Bluetooth пристрою

Увімкніть, щоб дозволити програмі взаємодіяти з пристроями Bluetooth. Цей дозвіл необхідний для використання бездротових контролерів.

Завантаження файлів 5

Надає доступ для читання, або запису, папки користувача "Завантаження".

Файли Зображень 5

Дозволяє читати, або записувати, папку користувача "Зображення".

Файли Музики 5

Дозволяє читати, або записувати, папку користувача "Музика".

Файли фільмів 5

Дозволяє читати, або записувати, папку користувача "Фільми".

Файли вибрані користувачем 5

Дозволяє читати, або записувати, довільну теку. Щоб отримати доступ, користувач повинен вибрати теку з рідного діалогового вікна файлів.

Допоміжний виконуваний файл

Список допоміжних виконуваних файлів, вбудованих у пакет програм. Додаток із пісочницею обмежений виконанням лише цих виконуваних файлів.

5(1,2,3,4,5)

За бажання ви можете надавати повідомлення про використання для різних папок у параметрах privacy/*_folder_usage_description.

Ви можете перевизначити дозволи за замовчуванням, вибравши файл користувацьких дозволів, у цьому випадку всі інші дозволи ігноруються.