Installa Godot e configura i progetti per Android

Questa guida illustra i seguenti passaggi:

  • Selezione di una versione e release di Godot.
  • Download e installazione di Godot.
  • È in corso la configurazione di Godot per lo sviluppo Android.
  • Configurazione del sistema per lo sviluppo e l'esportazione di C# (solo release mono di Godot).

Seleziona una versione

Se possibile, utilizza l'ultima release stabile di Godot. Per lo sviluppo per Android, utilizza la versione 3.3 o successive.

Scarica ed esegui Godot

Visita la pagina di download di Godot per scaricare il motore di gioco per il tuo ambiente preferito.

Godot offre due release nella sua pagina di download: standard e Mono. Entrambi possono essere utilizzati per lo sviluppo per Android. La release Mono è obbligatoria per lo sviluppo C#.

Godot è distribuito come applicazione autonoma. Non richiede un processo di installazione; dopo aver estratto l'archivio di download, puoi eseguirlo così com'è.

Configurare il supporto di Android

Configurare le impostazioni dell'SDK Android Studio

  1. Se non l'hai ancora fatto, scarica e installa l'ultima versione stabile di Android Studio.
  2. Avvia Android Studio.
  3. Nella finestra Ti diamo il benvenuto in Android Studio, apri il menu a discesa Configura e seleziona SDK Manager.
  4. Nella parte superiore della finestra, prendi nota della posizione dell'SDK Android sul computer. Dovrai specificare la posizione nell'editor Godot.
  5. Nella scheda Piattaforme SDK, individua la voce dell'elenco relativa ad Android 11.0 R. Seleziona l'elemento se è deselezionato.
  6. Nella scheda Strumenti SDK, individua gli elementi dell'elenco per NDK (Side by side), Strumenti a riga di comando dell'SDK Android e CMake. Selezionale se sono deselezionate.
  7. Se lo stato di alcune voci dell'elenco è impostato su Aggiornamento disponibile, abilita la casella di controllo corrispondente per eseguire l'aggiornamento alla versione più recente.
  8. Fai clic sul pulsante OK. Conferma il download e accetta i contratti di licenza per completare l'installazione.

Creazione di un archivio chiavi di debug

Le app Android devono essere con firma digitale per poter essere eseguite su un dispositivo. Per i test locali, è possibile usare un file di archivio chiavi di debug per firmare le app. Android Studio creerà automaticamente un archivio chiavi di debug predefinito. Se in precedenza hai creato app utilizzando una configurazione di debug con Android Studio, un file debug.keystore dovrebbe trovarsi nella seguente directory:

  • Microsoft Windows: C:\Users\$username\.android\debug.keystore
  • Linux/macOS: ~\.android\debug.keystore

Se il file debug.keystore non esiste, creane uno seguendo questi passaggi:

  1. Avvia Android Studio.
  2. Nella finestra Ti diamo il benvenuto in Android Studio, seleziona l'opzione Importa un esempio di codice Android.
  3. Seleziona l'esempio Ndk -> Hello GL2 dall'elenco e fai clic sul pulsante Avanti.
  4. Scegli una località per il progetto e fai clic sul pulsante Finish (Fine).
  5. Attendi che il progetto venga caricato e sincronizzato con Gradle, quindi seleziona Crea -> Crea progetto dalla barra dei menu di Android Studio.
  6. Attendi il completamento della build, quindi verifica che sia stato creato un file debug.keystore nella directory appropriata.

Imposta l'SDK Android ed esegui il debug della posizione dell'archivio chiavi nell'editor Godot

  1. Avvia l'editor Godot.
  2. Crea o apri un progetto.
  3. Seleziona Editor -> Impostazioni editor... dalla barra dei menu Editor.
  4. Nella finestra Impostazioni editor, seleziona l'elemento Esporta -> Android nel riquadro a sinistra.
  5. Nel riquadro a destra, vai alla casella di testo Percorso SDK Android e inserisci il percorso dell'SDK Android.
  6. Nella casella di testo Debug Keystore, inserisci il percorso del file debug.keystore.
Impostazione del percorso dell'SDK per Android nelle impostazioni dell'editor Godot
Figura 1. Il campo Percorso SDK Android nelle Impostazioni Editor

Configura Mono

Installa MSBuild

La versione Mono di Godot richiede MSBuild per creare ed esportare progetti che utilizzano C#. Per installare MSBuild:

Linux e macOS

Microsoft Windows

Configura un editor C#

Godot ha un supporto molto limitato per la modifica del codice C#. Si consiglia vivamente di utilizzare un editor esterno per i file C#. Godot supporta i seguenti editor C#:

  • Microsoft Visual Studio/Visual Studio per Mac
  • Codice di Microsoft Visual Studio
  • Cavaliere JetBrains
  • MonoSviluppo

Per configurare un editor C# esterno, apri un progetto nell'editor Godot ed esegui questi passaggi:

  1. Seleziona Editor -> Impostazioni editor... dalla barra dei menu dell'editor.
  2. Nella finestra Impostazioni Editor, seleziona l'elemento Mono -> Editor nel riquadro a sinistra.
  3. Scegli l'editor che ti interessa dal menu a discesa Editor esterno.
Impostazione editor esterno nelle impostazioni dell'editor Godot
Figura 2: il campo Editor esterno in Impostazioni Editor

Plug-in dell'editor C# per Godot

  • C# Tools for Godot: un plug-in per Microsoft Visual Studio Code che aggiunge il supporto per il debug C# e funzionalità di completamento parziale del codice.
  • Plug-in JetBrains Rider: aggiunge il supporto per il debug C#.