Compiling for iOS

Vedi anche

This page describes how to compile iOS export template binaries from source. If you're looking to export your project to iOS instead, read Exporting for iOS.

Requisiti

  • Python 3.8+.

  • Sistema di compilazione SCons 4.0+.

  • Xcode.

    • Avviare Xcode una volta e installare il supporto di iOS. Se Xcode è già stato avviato e si deve installare il supporto di iOS, andare su Xcode -> Settings... -> Platforms.

    • Andare su Xcode -> Settings... -> Locations -> Command Line Tools e selezionare una versione installata. Anche se ne è già selezionata una, selezionarla nuovamente.

  • Scaricare e seguire le istruzioni del README per creare un .xcframework statico dall'SDK MoltenVK.

Nota

Se Homebrew è stato installato, è possibile facilmente installare SCons tramite il seguente comando:

brew install scons

Installando Homebrew verranno recuperati automaticamente anche gli strumenti da riga di comando per Xcode, se non li si ha già.

Similmente, se MacPorts è stato installato, è possibile facilmente installare SCons tramite il seguente comando:

sudo port install scons

Vedi anche

Per ottenere il codice sorgente di Godot per la compilazione, consultare Getting the source.

Per una panoramica generale sull'utilizzo di SCons per Godot, consultare Introduction to the buildsystem.

Compilazione

Aprire un terminale, andare alla cartella principale del codice sorgente del motore e digitare quanto segue per compilare una build di debug:

scons platform=ios target=template_debug generate_bundle=yes

Per compilare una build di rilascio:

scons platform=ios target=template_release generate_bundle=yes

In alternativa, è possibile eseguire il seguente comando per le librerie del simulatore Xcode (facoltativo):

scons platform=ios target=template_debug ios_simulator=yes arch=arm64
scons platform=ios target=template_debug ios_simulator=yes arch=x86_64 generate_bundle=yes

Queste librerie simulatori non si possono utilizzare per eseguire il progetto esportato sul dispositivo di destinazione. Si possono invece utilizzare per eseguire il progetto esportato direttamente sul proprio Mac, continuando a testare le funzionalità specifiche della piattaforma iOS.

Per creare un progetto Xcode come nelle build ufficiali, è necessario utilizzare il modello disponibile in misc/dist/ios_xcode. Le librerie di rilascio e di debug si devono inserire rispettivamente in libgodot.ios.debug.xcframework e libgodot.ios.release.xcframework. Questo processo può essere automatizzato attraverso l'opzione generate_bundle=yes nell'ultimo comando SCons utilizzato per la compilazione dei modelli di esportazione (in modo da includere tutti i file binari).

Anche la cartella statica .xcframework di MoltenVK si deve inserire nella cartella ios_xcode una volta creata. MoltenVK è sempre linkato staticamente su iOS; non è disponibile alcuna opzione di link dinamico, a differenza di macOS.

Esegui

Per eseguire su un dispositivo o simulatore, seguire queste istruzioni: Exporting for iOS.

Risoluzione dei problemi

Fatal error: 'cstdint' file not found

If you get a compilation error of this form early on, it's likely because the Xcode command line tools installation needs to be repaired after a macOS or Xcode update:

./core/typedefs.h:45:10: fatal error: 'cstdint' file not found
45 | #include <cstdint>
   |          ^~~~~~~~~

Run these two commands to reinstall Xcode command line tools (enter your administrator password as needed):

sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install

If it still does not work, try updating Xcode from the Mac App Store and try again.