Aggiungi un modulo per un nuovo dispositivo

I moduli forniscono un contenitore per il codice sorgente, i file di risorse e le impostazioni a livello di app della tua app, ad esempio il file di build a livello di modulo e il file manifest di Android. Ogni modulo può essere creato, testato ed eseguito il debug in modo indipendente.

Android Studio utilizza moduli per semplificare l'aggiunta di nuovi dispositivi al tuo progetto. Seguendo alcuni semplici passaggi in Android Studio, puoi creare un modulo che contenga il codice specifico per un tipo di dispositivo, ad esempio Wear OS o Android TV. Android Studio crea automaticamente le directory dei moduli, ad esempio le directory di origine e delle risorse, e un file build.gradle predefinito appropriato per il tipo di dispositivo. Inoltre, Android Studio crea moduli per i dispositivi con le configurazioni di build consigliate, ad esempio usando la libreria Leanback per i moduli Android TV.

In questa pagina viene descritto come aggiungere un nuovo modulo per un dispositivo specifico.

Android Studio semplifica inoltre l'aggiunta di una libreria o di un modulo Google Cloud al tuo progetto. Per maggiori dettagli sulla creazione di un modulo della libreria, consulta Creare un modulo della libreria.

Crea un nuovo modulo

Per aggiungere un nuovo modulo al tuo progetto per un nuovo dispositivo, procedi come segue:

  1. Fai clic su File > Nuovo > Nuovo modulo.
  2. Nella finestra Crea nuovo modulo visualizzata, Android Studio offre i seguenti moduli per il dispositivo:
    • Modulo per telefono e tablet
    • Modulo Wear OS
    • Modulo Android TV
    • Modulo di vetro
    Seleziona il modulo per il dispositivo che ti interessa, quindi fai clic su Avanti.
  3. Nel modulo Configura il nuovo modulo, inserisci i seguenti dettagli:
    • Nome applicazione: questo nome viene utilizzato come titolo dell'icona in Avvio applicazioni del nuovo modulo.
    • Nome modulo: questo testo viene utilizzato come nome della cartella in cui sono visibili il codice sorgente e i file delle risorse.
    • Nome pacchetto: si tratta dello spazio dei nomi Java per il codice nel modulo. Viene aggiunto come attributo package nel file manifest di Android del modulo.
    • SDK minimo: questa impostazione indica la versione più bassa della piattaforma Android supportata dal modulo dell'app. Questo valore imposta l'attributo minSdkVersion nel file build.gradle, che potrai modificare in un secondo momento.

    Fai quindi clic su Avanti.

  4. A seconda del modulo del dispositivo selezionato, la pagina seguente mostra una selezione di modelli di codice appropriati che puoi scegliere di utilizzare come attività principale. Fai clic sul modello di attività con cui vuoi iniziare, quindi fai clic su Avanti. Se non hai bisogno di un'attività, fai clic su Aggiungi nessuna attività, poi su Fine.
  5. Se hai scelto un modello di attività, inserisci le impostazioni per la tua attività nella pagina Personalizza la Attività. La maggior parte dei modelli richiede i valori per Nome attività, Nome layout, Titolo e Lingua di origine, ma ogni modello ha impostazioni specifiche per l'attività. Fai clic su Fine. Quando crei un modulo dell'app con un modello di attività, puoi immediatamente eseguirlo e testarlo sul tuo dispositivo.

Android Studio crea tutti i file necessari per il nuovo modulo e sincronizza il progetto con i nuovi file Gradle del modulo. L'aggiunta di un modulo per un nuovo dispositivo aggiunge anche eventuali dipendenze necessarie per il dispositivo di destinazione al file di build del modulo.

Una volta completata la sincronizzazione del progetto Gradle, il nuovo modulo viene visualizzato nella finestra Progetto a sinistra. Se non vedi la cartella Nuovo modulo, assicurati che la finestra mostri la visualizzazione Android.

Importare un modulo

Per importare un modulo esistente nel tuo progetto, procedi come segue:

  1. Fai clic su File > Nuovo > Importa modulo.
  2. Nella casella Directory di origine, digita o seleziona la directory dei moduli che vuoi importare:
    • Se stai importando un modulo, indica la sua directory principale.
    • Se importi più moduli da un progetto, indica la cartella del progetto. Per ogni modulo all'interno della cartella viene visualizzata una casella che indica la Posizione di origine e il Nome modulo. Assicurati che la casella Importa sia selezionata per ogni modulo che vuoi importare.
    Se i moduli hanno altre dipendenze, verranno elencati per l'importazione in Moduli obbligatori aggiuntivi.
  3. Digita i nomi dei moduli che vuoi nei campi Nome modulo.
  4. Fai clic su Fine.

Una volta importato, il modulo viene visualizzato nella finestra Progetto a sinistra.

Passaggi successivi

Dopo aver aggiunto un nuovo modulo, puoi modificare il codice e le risorse del modulo, configurare le impostazioni di compilazione del modulo e creare il modulo. Puoi anche eseguire il modulo ed eseguirne il debug come qualsiasi altra app.

Dovrai anche aggiungere codice e risorse per supportare correttamente il nuovo dispositivo. Per ulteriori informazioni su come sviluppare moduli dell'app per diversi tipi di dispositivi, consulta la documentazione corrispondente:

Durante lo sviluppo del nuovo modulo, potresti creare codice indipendente dal dispositivo che è già duplicato in un altro modulo dell'app. Invece di mantenere il codice duplicato, potresti spostare il codice condiviso in un modulo della libreria e aggiungere la libreria come dipendenza ai moduli dell'app. Per ulteriori informazioni sulla creazione di un modulo della libreria e sull'aggiunta come dipendenza, consulta Creare una libreria Android.