Android Studio

Android Studio è un IDE gratuito per lo sviluppo su Android creato da Google e JetBrains. È basato su IntelliJ IDEA e dispone di un editor ricco di funzionalità che supporta Java e C/C++. Si può utilizzare per lavorare sia sul motore principale di Godot, sia sul codice base della piattaforma Android.

Importare il progetto

  • Dalla finestra di benvenuto di Android Studio seleziona Open.

../../../_images/android_studio_setup_project_1.png

Finestra di benvenuto di Android Studio.

  • Navigare a <cartella radice di Godot>/platform/android/java e selezionare il file settings.gradle.

  • Android Studio importerà e indicizzerà il progetto.

Disposizione del progetto in Android Studio

Il progetto è organizzato attraverso i moduli di Android Studio:

  • Modulo lib:
    • Situato in <cartella radice di Godot>/platform/android/java/lib, questo è un modulo di libreria che organizza

      il codice Java e nativo di Godot e lo rende disponibile come dipendenza/artefatto riutilizzabile.

    • L'artefatto generato da questo modulo è reso disponibile per altri moduli/progetti Android da utilizzare come dipendenza, tramite MavenCentral.

  • Modulo editor:
    • Situato in <cartella radice di Godot>/platform/android/java/editor, questo è un modulo di applicazione che contiene

      il codice sorgente per la versione Android del Godot Editor.

    • Questo modulo ha una dipendenza dal modulo lib.

  • Modulo app:
    • Situato in <cartella radice di Godot>/platform/android/java/app, questo è un modulo di applicazione che contiene

      il codice sorgente per i modelli di compilazione Android.

    • Questo modulo ha una dipendenza dal modulo lib.

Compilazione e debug del modulo editor

  • Per compilare il modulo editor:
    ../../../_images/android_studio_editor_configurations_drop_down.webp
  • Per effettuare il debug del modulo editor:
    • Aprire la finestra Build Variants attraverso View > Tools Windows > Build Variants dal menu in alto.

    • Nella finestra Build Variants, assicurarsi che nella colonna Active Build Variant la voce :editor sia impostata su dev.

    ../../../_images/android_studio_editor_build_variant.webp
    • Aprire la finestra Run/Debug Configurations cliccando su Run > Edit Configurations... nel menu in alto.

    • Nella finestra Run/Debug Configurations , selezionare la voce editor e in Debugger assicurarsi che Debug Type sia impostato su Dual (Java + Native)

    ../../../_images/android_studio_editor_debug_type_setup.webp

Building & debugging the app module

Il modulo app richiede la presenza di un progetto Godot nella sua cartella assets (<cartella radice di Godot>/platform/android/java/app/assets) per essere eseguito. Questa operazione è solitamente gestita dall'editor Godot durante il processo di esportazione. Durante lo sviluppo in Android Studio, è necessario aggiungere manualmente un progetto Godot in questa cartella per replicare il processo di esportazione. Una volta fatto, si possono seguire le istruzioni seguenti per l'esecuzione o il debug del modulo app:

  • Per compilare il modulo app:
    ../../../_images/android_studio_app_configurations_drop_down.webp
  • Per effettuare il debug del modulo app:
    • Aprire la finestra Build Variants attraverso View > Tools Windows > Build Variants dal menu in alto.

    • Nella finestra Build Variants, assicurarsi che nella colonna Active Build Variant la voce :app sia impostata su dev.

    ../../../_images/android_studio_app_build_variant.webp
    • Aprire la finestra Run/Debug Configurations cliccando su Run > Edit Configurations... nel menu in alto.

    • Nella finestra Run/Debug Configurations, selezionare la voce app e in Debugger assicurarsi che Debug Type sia impostato su Dual (Java + Native)

    ../../../_images/android_studio_app_debug_type_setup.webp

Se ci si imbatte in qualsiasi problema, chiedere aiuto in uno dei canali di sviluppo per Android di Godot.