Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Exécution des applications Godot sur macOS

Voir aussi

Cette page traite du lancement de projets Godot sur macOS. Si vous n'avez pas encore exporté votre projet, voyez d'abord Exportation de macOS.

Par défaut, macOS n'exécute que les applications qui sont signées et notariées.

Note

When running an app from the Downloads folder or when still in quarantine, Gatekeeper will perform path randomization as a security measure. This breaks access to relative paths from the app, which the app relies upon to work. To resolve this issue, move the app to the /Applications folder.

In general, macOS apps should avoid relying on relative paths from the application folder.

Selon la manière dont une application macOS est signée et distribuée, les scénarios suivants sont possibles :

L'application est signée, notariée et distribuée via l'App Store

Note

Les développeurs d'applications doivent s'inscrire à l'Apple Developer Program, configurer les options de signature et de notarisation pendant l'exportation, puis téléverser l'application sur l'App Store.

L'application doit fonctionner immédiatement, sans interaction supplémentaire avec l'utilisateur.

L'application est signée, notariée et distribuée en dehors de l'App Store

Note

Les développeurs d'applications doivent adhérer à l'Apple Developer Program, configurer les options de signature et de notarisation pendant l'exportation, puis distribuer l'application sous forme d'archive ".DMG" ou ".ZIP".

Lorsque vous lancez l'application pour la première fois, la boîte de dialogue suivante s'affiche :

../../_images/signed_and_notarized_0.png

Cliquez Ouvrir pour lancer l'app.

Si la boîte de dialogue d'avertissement suivante s'affiche, votre Mac est configuré pour n'autoriser que les applications provenant de l'App Store.

../../_images/signed_and_notarized_1.png

Pour autoriser les applications tierces, ouvrez les Préférences système, cliquez sur Sécurité et confidentialité, puis sur Général, déverrouillez les paramètres et sélectionnez App Store et développeurs identifiés.

../../_images/sys_pref_0.png

L'application est signée (y compris les signatures ad-hoc) mais n'est pas notariée

Note

Le développeur de l'application a utilisé un certificat auto-signé ou une signature ad-hoc (comportement par défaut de Godot pour les projets exportés).

Lorsque vous lancez l'application pour la première fois, la boîte de dialogue suivante s'affiche :

../../_images/signed_0.png

Pour exécuter cette application, vous pouvez temporairement passer outre Gatekeeper :

  • Soit vous ouvrez Préférences système, cliquez sur Sécurité et confidentialité, puis sur Général, et cliquez sur Ouvrir quand même.

    ../../_images/sys_pref_1.png
  • Ou bien, cliquez avec le bouton droit de la souris (Control-click) sur l'icône de l'application dans la fenêtre du Finder et sélectionnez Ouvrir dans le menu.

    ../../_images/signed_1.png
  • Cliquez ensuite sur Open dans la boîte de dialogue de confirmation.

    ../../_images/signed_2.png
  • Entrez le mot de passe quand il vous sera demandé.

Another option is to disable Gatekeeper entirely. Note that this does decrease the security of your computer by allowing you to run any software you want. To do this, run sudo spctl --master-disable in the Terminal, enter your password, and then the Anywhere option will be available:

../../_images/macos_allow_from_anywhere.png

Note that Gatekeeper will re-enable itself when macOS updates.

App is not signed, executable is linker-signed

Note

L'application est construite à l'aide de modèles d'exportation officiels, mais elle n'est pas signée.

Lorsque vous lancez l'application pour la première fois, la boîte de dialogue suivante s'affiche :

../../_images/linker_signed_1.png

Pour exécuter cette application, vous devez supprimer manuellement l'attribut de fichier étendu de quarantaine :

  • Open Terminal.app (press Cmd + Space and enter Terminal).

  • Naviguez vers le dossier contenant l'application cible.

    Utilisez la commande cd path_to_the_app_folder, par exemple cd ~/Downloads/ si c'est dans le dossier Downloads.

  • Exécutez la commande xattr -dr com.apple.quarantine "Unsigned Game.app" (en incluant les guillemets et l'extension .app).

Neither app nor executable is signed (relevant for Apple Silicon Macs only)

Note

L'application est construite à l'aide de modèles d'exportation personnalisés, compilée à l'aide d'OSXCross, et elle n'est pas du tout signée.

Lorsque vous lancez l'application pour la première fois, la boîte de dialogue suivante s'affiche :

../../_images/unsigned_1.png

Pour faire fonctionner cette application, vous pouvez la signer vous-même de manière ad-hoc :

  • Installez Xcode pour l'App Store, démarrez-le et confirmez l'installation des outils de ligne de commande.

  • Open Terminal.app (press Cmd + Space and enter Terminal).

  • Naviguez vers le dossier contenant l'application cible.

    Utilisez la commande cd path_to_the_app_folder, par exemple cd ~/Downloads/ si c'est dans le dossier Downloads.

  • Exécutez les commandes suivantes :

    xattr -dr com.apple.quarantine "Unsigned Game.app" (y compris les guillemets et l'extension ".app").

    codesign -s - --force --deep "Unsigned Game.app" (y compris les guillemets et l'extension ".app").