Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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.

• Per i progetti 2D, l'estensione di codifica a blocchi può fornire un'alternativa visiva basata su blocchi per comporre script quando non si dispone di una tastiera hardware collegata.

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 C#/Mono.

• Nessun supporto per editor di script esterni.

• Sebbene disponibile, il renderer 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.