Xcode

Xcode è un IDE gratuito esclusivo per macOS. Si può scaricare dal Mac App Store.

Importare il progetto

  • Dalla schermata principale di Xcode, creare un nuovo progetto attraverso il modello Other > External Build System.

../../../_images/xcode_1_create_external_build_project.webp
  • Ora scegliere un nome per il progetto e imposta il percorso all'eseguibile scons nello strumento di compilazione (per trovare il percorso si può digitare where scons in un terminale).

../../../_images/xcode_2_set_external_build_project_parameters.webp
  • Aprire il target principale dalla sezione Target e selezionare la scheda Info.

../../../_images/xcode_3_configure_scons.webp
  • Fill out the form with the following settings:

    Argomenti

    Consultare Introduction to the buildsystem per un elenco completo di argomenti.

    Cartella

    Un percorso completo alla cartella radice di Godot

  • Add a Command Line Tool target which will be used for indexing the project by choosing File > New > Target....

../../../_images/xcode_4_add_new_target.webp
  • Selezionare macOS > Application > Command Line Tool.

../../../_images/xcode_5_select_command_line_target.webp

Nota

Name it something so you know not to compile with this target (e.g. GodotXcodeIndex).

  • Per questo target, aprire la scheda Build Settings e cercare l'opzione Header Search Paths.

  • Impostare Header Search Paths sul percorso assoluto della cartella radice di Godot. È necessario includere anche le sottocartelle. Per farlo, aggiungere due asterischi (**) alla fine del percorso, ad esempio /Users/me/repos/godot-source/**.

  • Aggiungere la sorgente Godot al progetto trascinandolo e rilasciandolo nel file browser del progetto.

  • Seleziona Create groups per l'opzione Added folders e seleziona soltanto la destinazione di indicizzazione della riga di comando nella sezione Add to targets.

../../../_images/xcode_6_after_add_godot_source_to_project.webp
  • Xcode ora indicizzerà i file. L'operazione potrebbe richiedere alcuni minuti.

  • Una volta che Xcode abbia completato l'indicizzazione, si dovrebbero avere l'abilità di andare a una definizione, il completamento automatico e l'evidenziazione completa della sintassi.

Debugging the project

Per abilitare il supporto del debugging, è necessario modificare gli schemi di compilazione ed esecuzione del target di compilazione esterno.

  • Aprire l'editor di schemi del target di compilazione esterno.

  • Individua la sezione Build > Post Actions.

  • Add a new script run action

  • In Provide build settings from selezionare il proprio progetto. Questo permette di fare riferimento alla cartella del progetto dentro lo script.

  • Creare uno script che darà all'eseguibile un nome che Xcode possa riconoscere, ad esempio:

ln -f ${PROJECT_DIR}/godot/bin/godot.macos.tools.64 ${PROJECT_DIR}/godot/bin/godot
../../../_images/xcode_7_setup_build_post_action.webp
  • Compilare il target di compilazione esterno.

  • Aprire nuovamente l'editor di schemi e selezionare Run.

../../../_images/xcode_8_setup_run_scheme.webp
  • Imposta Executable al file collegato nello script di azione post-compilazione.

  • Spunta Debug executable.

  • È possibile aggiungere due argomenti nella scheda Arguments: il flag -e apre l'editor anziché il Gestore dei progetti e l'argomento --path indica all'eseguibile di aprire il progetto specificato (deve essere fornito come percorso assoluto alla radice del progetto, non al file project.godot).

Per verificare che tutto funzioni, inserire un punto d'interruzione in platform/macos/godot_main_macos.mm ed eseguire il progetto.

Se ci si imbatte in qualsiasi problema, chiedi aiuto in uno dei Canali della comunità di Godot.