Xcode

Xcode es un IDE gratuito exclusivo para macOS. Puedes descargarlo desde la Mac App Store.

Importando el proyecto

  • Desde la pantalla principal de Xcode, crea un nuevo proyecto utilizando la plantilla Other > External Build System.

../../../_images/xcode_1_create_external_build_project.png

  • Abre los objetivos de construcción desde la sección Targets y selecciona la pestaña Info.

  • Completa los detalles con la siguiente configuración:

    Herramienta de Compilación

    Una ruta completa al ejecutable scons, por ejemplo, /usr/local/bin/scons

    Argumentos

    Lee Introducción al sistema de compilación para una lista completa de parámetros.

    Directorio

    Una ruta completa a la carpeta raíz de Godot
../../../_images/xcode_2_configure_scons.png

  • Agrega un destino de herramienta de línea de comandos que se utilizará para indexar el proyecto seleccionando Archivo > Nuevo > Destino....

../../../_images/xcode_3_add_new_target.png

  • Selecciona OS X > Aplicación > Herramienta de línea de comandos.

../../../_images/xcode_4_select_command_line_target.png

Nota

Nómbralo de manera que sepas que no se debe compilar con este objetivo (por ejemplo, GodotXcodeIndex).

  • Para este objetivo, abre la pestaña Build Settings y busca la opción Header Search Paths (Rutas de búsqueda de encabezados).

  • Establece Header Search Paths a la ruta absoluta de la carpeta raíz de Godot. Debes incluir también los subdirectorios. Para lograrlo, agrega dos asteriscos (**) al final de la ruta, por ejemplo, /Users/yo/repos/godot-source/**.

  • Arrastra y suelta los fuentes de Godot en el navegador de archivos de proyecto.

  • Desmarca la opción Create external build system project.

../../../_images/xcode_5_after_add_godot_source_to_project.png

  • A continuación, selecciona Create groups para la opción Added folders y marca únicamente tu objetivo de indexación de línea de comandos en la sección Add to targets.

../../../_images/xcode_6_after_add_godot_source_to_project_2.png

  • Xcode ahora indexará los archivos. Esto puede llevar algunos minutos.

  • Una vez que Xcode haya terminado de indexar, deberías tener la función de ir a la definición, autocompletado y resaltado completo de la sintaxis.

Depurando el proyecto

Para habilitar el soporte de depuración, necesitas editar los esquemas de compilación y ejecución del objetivo de compilación externo.

  • Abre el editor de esquemas del objetivo de compilación externo.

  • Localiza la sección Build > Post Actions.

  • Agrega un nuevo script de ejecución

  • Bajo Provide build settings from, selecciona tu proyecto. Esto permite hacer referencia al directorio del proyecto dentro del script.

  • Crea un script que le dé al binario un nombre que Xcode pueda reconocer, por ejemplo:

ln -f ${PROJECT_DIR}/godot/bin/godot.osx.tools.64 ${PROJECT_DIR}/godot/bin/godot
../../../_images/xcode_7_setup_build_post_action.png

  • Construye el objetivo de compilación externo.

  • Abre el editor de esquemas nuevamente y selecciona Ejecutar.

../../../_images/xcode_8_setup_run_scheme.png

  • Establece el Ejecutable como el archivo que enlazaste en tu script de acción posterior a la compilación.

  • Marca la casilla Debug executable.

  • Puedes agregar dos argumentos en la pestaña Arguments: el indicador -e abre el editor en lugar del administrador de proyectos, y el argumento --path le indica al ejecutable que abra el proyecto especificado (debe proporcionarse como una ruta absoluta a la raíz del proyecto, no el archivo project.godot).

Para verificar que todo funciona correctamente, coloca un punto de interrupción (breakpoint) en platform/osx/godot_main_osx.mm y ejecuta el proyecto.

Si tienes algún problema, busca ayuda en alguno de los canales de la comunidad Godot.