Questo documento descrive come esportare un progetto Godot come app per Android. Godot può generare sia file APK per i test sui dispositivi locali sia Android App Bundle per l'invio al Google Play Store.
Installa un modello di build Android
Godot utilizza un modello di build come punto di partenza per generare file Gradle e altri dati necessari per creare e compilare un'app per Android. Un modello di build deve essere importato in un progetto Godot prima di esportare una build Android. Ogni versione di Godot ha il proprio modello. Per installare un modello di build Android in un progetto, segui questi passaggi:
- Apri il progetto nell'editor Godot.
- Nella barra dei menu, seleziona Project -> Install Android Build Template… (Progetto -> Installa modello di build Android…).
- Fai clic sul pulsante Gestisci modelli….
- Nella finestra Export Template Manager (Gestione modelli di esportazione), fai clic sul pulsante Download per la versione di Godot in uso (versione corrente).
- Seleziona una posizione mirror per scaricare il file.
- Al termine del download, fai clic sul pulsante Chiudi nella finestra Gestione modelli di esportazione.
- Nella barra dei menu dell'editor, seleziona Project (Progetto) -> Install Android Build Template… (Installa modello di build Android…)
- Viene visualizzata una finestra di dialogo di conferma. Fai clic sul pulsante Installa.
I file del template di build verranno archiviati in una sottodirectory android/build relativa alla directory root del progetto. A causa delle dimensioni di questa sottodirectory,
potresti volerla omettere dall'ambito del controllo della versione del tuo progetto.
Aggiungi un preset di esportazione Android
Per il progetto deve essere creato un preset di esportazione per Android. Per creare un preset, segui questi passaggi:
- Nella barra dei menu dell'editor, seleziona Progetto -> Esporta…
- Nella finestra Export (Esporta), seleziona il menu a discesa Add… (Aggiungi…) e poi seleziona l'opzione Android come segue:
Personalizza le opzioni di esportazione di Android
Dopo aver creato un preset di esportazione Android per il tuo progetto, puoi configurare le opzioni di esportazione selezionando il nuovo preset nella finestra Export (Esporta). Le opzioni di esportazione sono raggruppate in categorie a destra della finestra Esporta. Le opzioni più comuni da modificare includono:
Formato di esportazione e Utilizza build personalizzata
L'opzione Formato di esportazione indica se esportare come file APK o come Android App Bundle (.AAB). Per i test su un dispositivo locale durante lo sviluppo, un file APK è più comodo, in quanto può essere installato direttamente utilizzando adb. Per
le build che intendi caricare su Google Play, utilizza un Android App Bundle.
L'opzione Usa build personalizzata controlla se Godot utilizza il proprio processo di build interno o un processo di build Gradle tradizionale. Se l'opzione Usa build personalizzata è selezionata, Godot eseguirà una build Gradle. L'opzione Utilizza build personalizzata deve essere selezionata se si applica una delle seguenti condizioni:
- Il formato di esportazione è impostato su Android App Bundle
- Il progetto utilizza il sistema di plug-in Android di Godot
Architetture
La sezione Architectures specifica le architetture della CPU da includere nella build. L'esportazione di una build con più architetture aumenta le dimensioni del file APK o AAB esportato, il che aumenta il tempo di iterazione durante l'esportazione e il deployment su un dispositivo. Durante lo sviluppo, puoi ridurre il tempo di iterazione selezionando solo l'architettura del dispositivo di test. Quando invii un'app a Google Play, devi esportarla con tutte le architetture disponibili supportate dal tuo progetto.
Archivio chiavi
La sezione Keystore è il punto in cui vengono configurati i file keystore di debug e di release. Queste vengono utilizzate per firmare digitalmente l'app esportata. I campi Debug e Release devono essere percorsi dei rispettivi file keystore. I campi Debug User (Utente di debug) e Release User (Utente di release) devono essere impostati sui nomi degli alias nel keystore.
Se è stato configurato un file del keystore di debug nella sezione globale Impostazioni editor -> Esporta -> Android, i campi del keystore di debug nelle opzioni di esportazione del progetto possono essere lasciati vuoti e il file del keystore di debug globale verrà utilizzato come predefinito.
Per creare una build da caricare sul Google Play Store, puoi utilizzare Android Studio per creare un file keystore di release.
Per creare un file dell'archivio chiavi di release per la tua app:
- Avvia Android Studio.
- Nella finestra Benvenuto in Android Studio, seleziona Crea nuovo progetto.
- Seleziona il modello Nessuna attività e fai clic su Avanti.
- Nella schermata Configura il progetto, fai clic su Fine per creare il progetto.
- Crea un file di archivio chiavi seguendo le istruzioni riportate in Genera una chiave di caricamento e un archivio chiavi.
- Dopo aver creato il file del keystore, esci da Android Studio e torna all'editor Godot.
- Aggiungi il file del keystore al campo Release e inserisci i valori Release User e Release Password nei rispettivi campi.
Versione e pacchetto
Le sezioni Version (Versione) e Package (Pacchetto) specificano il codice della versione, la stringa della versione, l'identificatore del pacchetto e il nome del pacchetto per la tua app. Il campo Unique Name (Nome univoco) deve essere impostato sull'identificatore del pacchetto utilizzato dalla tua app in Google Play Console.
Icone in Avvio applicazioni
La sezione delle icone in Avvio applicazioni specifica i file PNG da utilizzare come icone per la tua app. Se i file delle icone non sono specificati, Godot utilizza un file icona predefinito. Godot supporta la specifica sia delle icone delle applicazioni legacy sia delle icone adattive disponibili in Android 8.0 (livello API 26) e versioni successive. Per suggerimenti sulla creazione di icone adattive, consulta la guida alle icone adattive.
Esporta una build
Per esportare una build, segui questi passaggi:
- Seleziona Progetto -> Esporta… dalla barra dei menu di Godot.
- Seleziona un preset di esportazione Android dall'elenco dei preset.
- Fai clic sul pulsante Esporta progetto nella parte inferiore della finestra Esporta.
- Nella finestra di dialogo Salva un file, scegli un nome per il file esportato.
- Deseleziona la casella di controllo Export With Debug (Esporta con debug) per creare una build di release.
- Fai clic su Salva per esportare la build.
La finestra di avanzamento dell'esportazione sarà diversa se l'opzione Usa build personalizzata è selezionata nel preset di esportazione. Le build personalizzate mostrano l'output del processo di build di Gradle.