Експорт на macOS

Дивись також

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

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

Вимоги

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

• Спеціальне підписання коду підтримується на всіх платформах без додаткових інструментів.

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

• Дійсний і унікальний Bundle identifier має бути встановлений у розділі Application параметрів експорту.

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

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

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

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

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

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

• Експортуйте ваш проект з комп'ютера під управлінням macOS зі встановленими інструментами командного рядка Xcode.

• Увімкніть 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 пустим (при експорті з комп'ютера під управлінням macOS, на інших платформах ця опція прихована). У цьому випадку Godot буде використовувати спеціальний підпис, що полегшить для кінцевих користувачів запуск експортованого застосунку, див. сторінку Запуск застосунків Godot на macOS для отримання додаткової інформації.

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

Опція	Опис
Увімкнути	Вмикає підписування коду.
Профіль	"Повне ім'я", або "Загальне ім'я", посвідчення підпису, зберігаються в ланцюжку ключів macOS. 1 2
Часова позначка	Запит на сервер часової позначки для автентифікації часу на час підписання. Необхідний для нотаріального засвідчення. 2
Стійке середовище виконання	Вмикає "Hardened Runtime". Необхідний для нотаріального посвідчення. 2
Замінити наявний підпис	Замінює наявні підписи бібліотек GDNative і вбудованих допоміжних виконуваних файлів.

Примітка

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

Параметри Hardened Runtime і Timestamp несумісні зі спеціальним підписом і будуть проігноровані.

1

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

2(1,2,3)

Цей параметр відображається лише під час експорту з комп’ютера під керуванням macOS.

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

Опція	Опис
Увімкнути	Вмикає автоматичне завантаження для нотаріального засвідчення.
Ім'я Apple ID	Ім'я облікового запису Apple ID (адреса електронної пошти)
Пароль до Apple ID	Пароль для з застосунку Apple ID. Перегляньте `Використання паролів для спеціальних застосунків<https://support.apple.com/en-us/HT204397>`__, щоб ввімкнення двофакторну автентифікації та створення пароля застосунку.
Apple Team ID	Ідентифікатор команди, якщо ваш Apple ID належить кільком командам

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

Примітка

Нотаріальне засвідчення підтримується при експорті з комп'ютера під управлінням macOS, на інших платформах ці опції приховані.

Права

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

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

Дозволи	Опис
Дозволити виконання коду JIT 3	Дозволяє створювати записувану та виконувану пам'ять для коду JIT. Якщо використовуються додаткові компоненти з динамічним, або само-змінюваним, рідним кодом, увімкніть їх відповідно до додаткової документації.
Дозволити Unsigned Executable Memory 3	Дозволяє створювати завантажувальну та виконувану пам'ять без обмежень JIT. Якщо використовуються додаткові компоненти з динамічним або само-змінюваним рідним кодом, увімкніть їх відповідно до додаткової документації.
Дозволити DYLD Environment Variables 3	Дозволяє програмі використовувати динамічні змінні середовища зв'язку для введення коду. Якщо ви використовуєте додатки з динамічним або само-змінюваним рідним кодом, увімкніть їх відповідно до додаткової документації.
Вимкнути перевірку бібліотеки	Дозволяє програмі завантажувати довільні бібліотеки та фреймворки. Увімкніть його, якщо ви використовуєте додаткові компоненти GDNative і спеціальний підпис, або хочете підтримувати зовнішні додаткові компоненти, надані користувачем.
Звуковий вхід	Увімкніть, якщо вам потрібно використовувати мікрофон, або інші джерела введення звуку, якщо він включений, ви також повинні надати повідомлення про використання в параметрі privacy/microphone_usage_description.
Фотоапарат	Увімкніть, якщо вам потрібно використовувати камеру, якщо вона включена, ви також повинні надати повідомлення про використання в параметрі privacy/camera_usage_description.
Розташування	Увімкніть, якщо вам потрібно використовувати інформацію про місцезнаходження зі служб визначення місцезнаходження, якщо вона включена, ви також повинні надати повідомлення про використання в параметрі privacy/location_usage_description.
Адресна книга	4 Увімкніть, щоб дозволити доступ до контактів в адресній книзі користувача, якщо він включений, ви також повинні надати повідомлення про використання в параметрі privacy/address_book_usage_description.
Календарі	4 Увімкніть, щоб дозволити доступ до календаря користувача, якщо він увімкнений, ви також повинні надати повідомлення про використання в параметрі privacy/calendar_usage_description.
Бібліотека світлин	4 Увімкніть, щоб дозволити доступ до бібліотеки світлин користувача, якщо ввімкнено, ви також повинні надати повідомлення про використання в параметрі privacy/photos_library_usage_description.
Події Apple	4 Увімкніть, щоб дозволити програмі надсилати події Apple в інші програми.
Діагностика	5 Ви можете тимчасово ввімкнути цей дозвіл на використання власного налагоджувача (GDB, LLDB) з експортованим застосунком. Цей дозвіл повинен бути відключений для експорту продукції.

3(1,2,3)

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

4(1,2,3,4)

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

5

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

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

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

Примітка

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

Дозволи	Опис
Увімкнено	Вмикає пісочницю застосунку.
Мережевий сервер	Увімкніть, щоб дозволити програмі прослуховувати вхідні мережні підключення.
Клієнт мережі	Увімкніть, щоб дозволити програмі встановлювати вихідні мережні підключення.
USB пристрою	Увімкніть, щоб застосунок міг взаємодіяти з USB-пристроями. Цей дозвіл необхідний для використання дротових контролерів.
Bluetooth пристрою	Увімкніть, щоб дозволити програмі взаємодіяти з пристроями Bluetooth. Цей дозвіл необхідний для використання бездротових контролерів.
Завантаження файлів 6	Надає доступ для читання, або запису, папки користувача "Завантаження".
Файли Зображень 6	Дозволяє читати, або записувати, папку користувача "Зображення".
Файли Музики 6	Дозволяє читати, або записувати, папку користувача "Музика".
Файли фільмів 6	Дозволяє читати, або записувати, папку користувача "Фільми".
Файли вибрані користувачем 6	Дозволяє читати, або записувати, довільну теку. Щоб отримати доступ, користувач повинен вибрати теку з рідного діалогового вікна файлів.
Допоміжний виконуваний файл	Список допоміжних виконуваних файлів, вбудованих у пакет програм. Застосунок із пісочницею обмежений виконанням лише цих виконуваних файлів.

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

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

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