Up to date

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

Ejecutando la aplicación de Godot macOS

Ver también

Esta página cubre la ejecución de proyectos de Godot en macOS. Si aún no has exportado tu proyecto, primero lee Exportando para macOS.

De forma predeterminada, macOS solo ejecutará aplicaciones que estén firmadas y notarizadas.

Nota

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.

Dependiendo de la forma en que una aplicación de macOS esté firmada y distribuida, son posibles los siguientes escenarios:

La aplicación está firmada, notarizada y distribuida a través de la App Store

Nota

Los desarrolladores de aplicaciones deben unirse al Programa de Desarrolladores de Apple y configurar las opciones de firma y notarización durante la exportación, luego cargar la aplicación en la App Store.

La aplicación debería ejecutarse sin problemas, sin requerir interacciones adicionales por parte del usuario.

La aplicación está firmada, notarizada y distribuida fuera de la App Store

Nota

Los desarrolladores de aplicaciones deben unirse al Programa de Desarrolladores de Apple y configurar las opciones de firma y notarización durante la exportación, luego distribuir la aplicación como archivo ".DMG" o ".ZIP".

Cuando ejecutas la aplicación por primera vez, se muestra el siguiente diálogo:

../../_images/signed_and_notarized_0.png

Haz clic en Abrir para iniciar la aplicación.

Si ves el siguiente mensaje de advertencia, significa que tu Mac está configurado para permitir solo aplicaciones de la App Store.

../../_images/signed_and_notarized_1.png

Para permitir aplicaciones de terceros, abre Preferencias del Sistema, haz clic en Seguridad y privacidad, luego en General, desbloquea la configuración y selecciona App Store y desarrolladores identificados.

../../_images/sys_pref_0.png

La aplicación está firmada (incluyendo firmas ad-hoc) pero no está notarizada

Nota

El desarrollador de la aplicación utilizó un certificado autofirmado o una firma ad-hoc (comportamiento predeterminado de Godot para proyectos exportados).

Cuando ejecutas la aplicación por primera vez, se muestra el siguiente diálogo:

../../_images/signed_0.png

Para ejecutar esta aplicación, puedes anular temporalmente Gatekeeper:

  • O bien, abre Preferencias del Sistema, haz clic en Seguridad y privacidad, luego en General y haz clic en Abrir de todos modos.

    ../../_images/sys_pref_1.png
  • O, haz clic derecho (Control-clic) en el ícono de la aplicación en la ventana del Finder y selecciona Abrir en el menú.

    ../../_images/signed_1.png
  • Después hacer clic en Open dentro del dialogo de confirmación.

    ../../_images/signed_2.png
  • Ingresa tu contraseña si se te solicita.

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

Nota

La aplicación se construyó utilizando plantillas de exportación oficiales, pero no está firmada.

Cuando ejecutas la aplicación por primera vez, se muestra el siguiente diálogo:

../../_images/linker_signed_1.png

Para ejecutar esta aplicación, debes eliminar manualmente el atributo extendido de cuarentena del archivo:

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

  • Navega hasta la carpeta que contiene la aplicación objetivo.

    Utiliza el comando cd ruta_a_la_carpeta_de_la_aplicación, por ejemplo, cd ~/Descargas/ si está en la carpeta Descargas.

  • Ejecuta el comando xattr -dr com.apple.quarantine "Unsigned Game.app" (incluyendo las comillas y la extensión .app).

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

Nota

La aplicación se construyó utilizando plantillas de exportación personalizadas, compiladas utilizando OSXCross, y no está firmada en absoluto.

Cuando ejecutas la aplicación por primera vez, se muestra el siguiente diálogo:

../../_images/unsigned_1.png

Para ejecutar esta aplicación, puedes firmarla ad-hoc por ti mismo:

  • Instala Xcode desde la App Store, ábrelo y confirma la instalación de las herramientas de línea de comandos.

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

  • Navega hasta la carpeta que contiene la aplicación objetivo.

    Utiliza el comando cd ruta_a_la_carpeta_de_la_aplicación, por ejemplo, cd ~/Descargas/ si está en la carpeta Descargas.

  • Corre los siguientes comandos:

    xattr -dr com.apple.quarantine "Unsigned Game.app" (incluyendo comillas y extensión ".app").

    codesign -s - --force --deep "Unsigned Game.app" (incluyendo comillas y extensión ".app").