Utilizzare l'editor Android

Nel 2023 abbiamo aggiunto una versione Android dell'editor che si può utilizzare per creare, sviluppare ed esportare progetti 2D e 3D sui dispositivi Android.

L'app può essere scaricata dalla pagina di download di Godot o dal Google Play Store.

Nota

L'editor per Android è in accesso anticipato, mentre continuiamo a perfezionarne l'esperienza. Consultare Limitazioni e problemi noti in seguito.

Supporto per dispositivi Android

L'editor Android richiede dispositivi con Android 5 Lollipop o superiore, con almeno il supporto per OpenGL 3. Questo include (non esaustivo):

Tablet Android, pieghevoli e telefoni grandi
Netbook con sistema Android
Chromebook che supportano le applicazioni per Android

Permessi in fase di esecuzione

Autorizzazione di accesso a tutti i file: permette all'editor di creare, importare e leggere file di progetto da qualsiasi posizione sul dispositivo. Senza questa autorizzazione, l'editor è comunque funzionante, ma ha accesso limitato ai file e alle cartelle del dispositivo.
REQUEST_INSTALL_PACKAGES: permette all'editor di installare gli APK del progetto esportato.
RECORD_AUDIO: Richiesto quando l'impostazione del progetto audio/driver/enable_input è abilitata.

Consigli e trucchi

Input

Per un'esperienza ottimale e un elevato livello di produttività, si consiglia di collegare una tastiera e un mouse Bluetooth per interagire con l'editor Android. L'editor Android supporta tutte le scorciatoie e le mappature dei tasti più comuni.
Quando si interagisce con tastiera e mouse, è possibile ridurre le dimensioni della barra di scorrimento tramite l'impostazione dell'editor interface/touchscreen/increase_scrollbar_touch_area.
For 2D projects, the block coding plugin can provide a block-based visual alternative to composing scripts when lacking a connected hardware keyboard.

Multi-tasking

Sui dispositivi più piccoli, attivare e usare la modalità Picture-in-Picture (PiP) consente di passare facilmente dall'Editor alla Finestra di gioco.
- PiP può essere abilitato tramite l'impostazione dell'editor run/window_placement/play_window_pip_mode.
- L'impostazione dell'editor run/window_placement/android_window si può utilizzare per specificare se la finestra Gioco si debba sempre avviare in modalità PiP.
- Nota: in modalità PiP, la finestra Gioco non ha accesso all'input.

Sincronizzazione dei progetti

Per sincronizzare progetti tramite Git, si può scaricare un client Git per Android. Consigliamo il terminal Termux, un emulatore di terminale Android che fornisce accesso a utilità comuni di terminale come Git e SSH.
- Nota: Per utilizzare Git con il terminale Termux, è necessario concedere il permesso WRITE al terminale. Ciò si può fare eseguendo il seguente comando <https://wiki.termux.com/wiki/Termux-setup-storage>`__ dal terminale: ``termux-setup-storage

Estensioni

Le estensioni GDExtension funzionano come previsto, ma richiedono che lo sviluppatore dell'estensione fornisca i binari nativi per Android.

Limitazioni e problemi noti

Ecco le limitazioni e i problemi noti dell'editor Android:

Nessun supporto per la compilazione Gradle.
No support for Android plugins as they require gradle build support. GDExtensions plugins are supported.
Nessun supporto per C#/Mono.
Nessun supporto per editor di script esterni.
Sebbene disponibile, il renderer Vulkan Forward+ non è consigliato a causa di severi problemi di prestazioni.
L'UX non è ottimizzata per il fattore forma dei telefoni Android.
I dispositivi Android Go non dispongono dell'autorizzazione Accesso a tutti i file necessaria per l'accesso in lettura/scrittura al dispositivo. Come alternativa, quando si utilizza un dispositivo Android Go, si consiglia di creare nuovi progetti solo nelle cartelle Documenti o Download di Android.
L'editor non si riprende correttamente quando l'opzione Non mantenere attività è abilitata nelle Opzioni per sviluppatori.
Esiste un bug con la tastiera Samsung che causa l'inserimento di input casuali durante la scrittura di script. Si consiglia di utilizzare invece la tastiera Google (Gboard).

Vedi anche

Consultare l'elenco dei problemi aperti su GitHub riguardo l'editor Android per un elenco dei bug conosciuti.