Eseguire la migrazione ad Android Studio

La migrazione dei progetti ad Android Studio richiede l'adattamento a una nuova struttura del progetto, a un nuovo sistema di compilazione e alle funzionalità dell'IDE.

Se esegui la migrazione da IntelliJ e il tuo progetto utilizza già Gradle, puoi aprire il progetto esistente da Android Studio. Se utilizzi IntelliJ, ma il tuo progetto non utilizza ancora Gradle, devi prepararlo manualmente prima di poterlo importare in Android Studio. Per saperne di più, consulta la sezione Eseguire la migrazione da IntelliJ.

Nozioni di base su Android Studio

Ecco alcune delle principali differenze da tenere presenti durante la preparazione della migrazione ad Android Studio.

Organizzazione di progetti e moduli

Android Studio si basa sull'IDE IntelliJ IDEA. Per familiarizzare con le nozioni di base dell'IDE, come la navigazione, il completamento del codice e le scorciatoie da tastiera, consulta la pagina Scopri Android Studio.

Android Studio organizza il codice in progetti, che contengono tutto ciò che definisce la tua app per Android, dal codice sorgente dell'app alle configurazioni di compilazione e al codice di test. I progetti si aprono in finestre separate di Android Studio. Ogni progetto contiene uno o più moduli, che ti consentono di dividere il progetto in unità di funzionalità discrete. I moduli possono essere creati, testati ed eseguiti il debug in modo indipendente.

Per saperne di più sui progetti e sui moduli di Android Studio, consulta la panoramica dei progetti.

Sistema di compilazione basato su Gradle

Il sistema di compilazione di Android Studio si basa su Gradle e utilizza file di configurazione di compilazione scritti in script Groovy o Kotlin per facilitare l'estensibilità e la personalizzazione.

I progetti basati su Gradle offrono funzionalità significative per lo sviluppo di Android, tra cui le seguenti:

  • Supporto delle librerie binarie (AAR). Non è più necessario copiare le origerie delle librerie nei propri progetti; puoi dichiarare una dipendenza e la libreria viene scaricata e unita automaticamente al tuo progetto. Ciò include l'unione automatica di risorse, voci del manifest, regole di esclusione di Proguard, regole lint personalizzate e così via in tempo di compilazione.
  • Supporto delle varianti di build, che consentono di creare versioni diverse dell'app (ad esempio una versione senza costi e una versione Pro) dallo stesso progetto.
  • Facile configurazione di compilazione e personalizzazione. Ad esempio, puoi estrarre i nomi e i codici delle versioni dai tag Git come parte della build.
  • Gradle può essere utilizzato dall'IDE, dalla riga di comandoe dai server di integrazione continua come Jenkins, fornendo la stessa build ovunque e ogni volta.

Per saperne di più sull'utilizzo e sulla configurazione di Gradle, consulta la pagina Configura la build.

Dipendenze

Le dipendenze delle librerie in Android Studio utilizzano le dichiarazioni di dipendenza di Gradle e le dipendenze di Maven per le librerie binarie e di origine locale note con coordinate Maven. Per saperne di più, consulta la pagina Dichiara le dipendenze.

Eseguire la migrazione da IntelliJ

Se il tuo progetto IntelliJ utilizza il sistema di compilazione Gradle, puoi importarlo direttamente in Android Studio. Se il tuo progetto IntelliJ utilizza Maven o un altro sistema di compilazione, devi configurarlo per funzionare con Gradle prima di poter eseguire la migrazione ad Android Studio.

Importare un progetto IntelliJ basato su Gradle

Se utilizzi già Gradle con il tuo progetto IntelliJ, aprilo in Android Studio seguendo questi passaggi:

  1. Fai clic su File > Nuovo > Importa progetto.
  2. Seleziona la directory del progetto IntelliJ e fai clic su OK. Il progetto si apre in Android Studio.

Importare un progetto IntelliJ non Gradle

Se il tuo progetto IntelliJ non utilizza ancora il sistema di compilazione Gradle, hai due opzioni per importarlo in Android Studio, descritte nelle sezioni seguenti:

Eseguire la migrazione tramite la creazione di un nuovo progetto vuoto

Per eseguire la migrazione del progetto in Android Studio creando un nuovo progetto vuoto e copiando i file di origine nelle nuove directory, procedi nel seguente modo:

  1. Apri Android Studio e fai clic su File > Nuovo > Nuovo progetto.
  2. Inserisci un nome per il progetto dell'app e specifica la posizione in cui deve essere creato, quindi fai clic su Avanti.
  3. Seleziona i fattori di forma su cui viene eseguita l'app, quindi fai clic su Avanti.
  4. Fai clic su Aggiungi nessuna attività, quindi su Fine.
  5. Nella finestra degli strumenti Progetto, fai clic sulla freccia per aprire il menu della visualizzazione e seleziona la visualizzazione Progetto per visualizzare ed esplorare l'organizzazione del nuovo progetto Android Studio. Per saperne di più sulla modifica delle visualizzazioni e sulla struttura dei progetti di Android Studio, consulta la pagina File di progetto.
  6. Vai alla posizione selezionata per il nuovo progetto e sposta il codice, i test unitari, i test di strumentazione e le risorse dalle directory del vecchio progetto nelle posizioni corrette nella nuova struttura del progetto.
  7. In Android Studio, fai clic su File > Struttura del progetto per aprire la finestra di dialogo Struttura del progetto. Assicurati che il modulo dell'app sia selezionato in nel riquadro a sinistra.
  8. Apporta le modifiche necessarie nella scheda Proprietà del tuo progetto (ad esempio, modificando minSdk o targetSdk).
  9. Fai clic su Dipendenze e aggiungi tutte le librerie da cui dipende il tuo progetto come dipendenze Gradle. Per aggiungere una nuova dipendenza, fai clic su Aggiungi , quindi seleziona il tipo di dipendenza che vuoi aggiungere e segui le istruzioni.
  10. Fai clic su OK per salvare le modifiche.
  11. Fai clic su Build > Crea progetto per testare la creazione del progetto e se necessario risolvere eventuali errori in sospeso.

Eseguire la migrazione tramite la creazione di un file di build Gradle personalizzato

Per eseguire la migrazione del progetto in Android Studio creando un nuovo file di build Gradle che rimandi ai file di origine esistenti, procedi nel seguente modo:

  1. Prima di iniziare, esegui il backup dei file di progetto in una posizione separata, poiché la procedura di migrazione modifica i contenuti del progetto in loco.
  2. Crea un file nella directory del progetto denominato build.gradle, se utilizzi Groovy, o build.gradle.kts, se utilizzi lo script Kotlin. Questo file contiene tutte le informazioni necessarie per l'esecuzione della build da parte di Gradle.

    Per impostazione predefinita, Android Studio prevede che il progetto sia organizzato come mostrato nella Figura 1.

    Figura 1. La struttura predefinita del progetto per un modulo dell'app Android.

    In settings.gradle per Groovy o settings.gradle.kts per lo script Kotlin, imposta i repository utilizzati per trovare plug-in e dipendenze rispettivamente nei blocchi pluginManagement e dependencyResolutionManagement:

    Alla moda

      pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include ':app'

    Kotlin

      pluginManagement {
      repositories {
          google()
          mavenCentral()
          gradlePluginPortal()
      }
  }
  dependencyResolutionManagement {
      repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
      repositories {
          google()
          mavenCentral()
      }
  }
  rootProject.name = "Test App"
  include(":app")

    Avviso: il repository JCenter è diventato di sola lettura il 31 marzo 2021. Per saperne di più, consulta l'aggiornamento del servizio JCenter.

    Il plug-in Android per Gradle applica alcuni set di origine predefiniti source sets al progetto. Questi set di risorse definiscono le directory utilizzate per archiviare vari tipi di file di origine. Gradle utilizza questi set di origine per determinare le posizioni di tipi di file specifici. Se il tuo progetto esistente non è conforme alle impostazioni predefinite, puoi spostare i file nella posizione corretta o modificare i set di origine predefiniti in modo che Gradle sappia dove trovarli.

    Per saperne di più sulla configurazione e la personalizzazione di un file di build Gradle, consulta la pagina Configura la build.

  3. Poi, identifica i progetti di librerie che utilizzi.

    Con Gradle, non è più necessario aggiungere queste librerie come progetti di codice sorgente. Puoi invece farvi riferimento nel blocco dependencies{} del file di build. Il sistema di compilazione gestisce queste librerie per te, inclusi il download delle librerie, l'unione delle risorse e l'unione delle voci del manifest. L'esempio seguente aggiunge le istruzioni di dichiarazione per una serie di librerie AndroidX al blocco dependencies{} di un file di build.

    Alla moda

    ...
dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar'])

    // AndroidX libraries
    implementation 'androidx.core:core-ktx:1.18.0'
    implementation 'androidx.appcompat:appcompat:1.7.1'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.gridlayout:gridlayout:1.1.0'
    implementation 'androidx.leanback:leanback:'
    implementation 'androidx.mediarouter:mediarouter:1.8.1'
    implementation 'androidx.palette:palette-ktx:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.4.0'
    implementation 'androidx.annotation:annotation:1.10.0'

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle file.
}

    Kotlin

    ...
dependencies {
    implementation(fileTree(mapOf("dir" to "libs", "include" to listOf("*.jar"))))

    // AndroidX libraries
    implementation("androidx.core:core-ktx:1.18.0")
    implementation("androidx.appcompat:appcompat:1.7.1")
    implementation("androidx.cardview:cardview:1.0.0")
    implementation("com.google.android.material:material:1.7.0")
    implementation("androidx.gridlayout:gridlayout:1.1.0")
    implementation("androidx.leanback:leanback:")
    implementation("androidx.mediarouter:mediarouter:1.8.1")
    implementation("androidx.palette:palette-ktx:1.0.0")
    implementation("androidx.recyclerview:recyclerview:1.4.0")
    implementation("androidx.annotation:annotation:1.10.0")

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle.kts file.
}
    Per assistenza nella determinazione delle istruzioni di dichiarazione corrette per le tue librerie, cerca il repository Maven di Google o Maven Central.
  4. Salva il file build.gradle, quindi chiudi il progetto in IntelliJ. Vai alla directory del progetto ed elimina la .idea directory e tutti i file IML nel tuo progetto.
  5. Avvia Android Studio e fai clic su File > Nuovo > Importa progetto.
  6. Individua la directory del progetto, seleziona il build.gradle o build.gradle.kts file che hai creato, quindi fai clic su OK per importare il progetto.
  7. Fai clic su Build > Crea progetto per testare il file di build creando il progetto e correggi eventuali errori riscontrati.

Passaggi successivi

Dopo aver eseguito la migrazione del progetto ad Android Studio, scopri di più sulla creazione con Gradle e sull'esecuzione dell'app in Android Studio leggendo Creare ed eseguire l'app.

A seconda del progetto e del flusso di lavoro, potresti anche voler saperne di più sul controllo della versione, sulla gestione delle dipendenze e sulla configurazione di Android Studio. Per iniziare a utilizzare Android Studio, consulta la pagina Scopri Android Studio.

Configurare il controllo della versione

Android Studio supporta una serie di sistemi di controllo della versione, tra cui Git, Mercurial e Subversion. Altri sistemi di controllo della versione possono essere aggiunti tramite plug-in.

Se l'app è già sotto il controllo del codice sorgente, potrebbe essere necessario attivarlo in Android Studio. Dal menu VCS, fai clic su Enable Version Control Integration (Attiva l'integrazione del controllo della versione) e seleziona il sistema di controllo della versione appropriato.

Se l'app non è sotto il controllo del codice sorgente, puoi configurarla dopo averla importata in Android Studio. Utilizza le opzioni del menu VCS di Android Studio per attivare il supporto VCS per il sistema di controllo della versione desiderato, creare un repository, importare i nuovi file nel controllo della versione ed eseguire altre operazioni di controllo della versione:

  1. Dal menu VCS di Android Studio, fai clic su Enable Version Control Integration (Attiva l'integrazione del controllo della versione).
  2. Seleziona un sistema di controllo della versione da associare alla root del progetto dal menu, quindi fai clic su OK. Il menu VCS ora mostra una serie di opzioni di controllo della versione in base al sistema selezionato.

Nota: puoi anche utilizzare l'opzione del menu File > Impostazioni > Controllo della versione per configurare e modificare il controllo della versione.

Per saperne di più sull'utilizzo del controllo della versione, consulta il riferimento al controllo della versione di IntelliJ.

Firma dell'app

Se in precedenza è stato utilizzato un certificato di debug, potrebbe essere rilevato durante la procedura di importazione. In questo caso, Android Studio continua a fare riferimento a questo certificato. In caso contrario, la configurazione di debug utilizza l'archivio chiavi di debug generato da Android Studio, utilizzando una password nota e una chiave predefinita con una password nota che si trova in $HOME/.android/debug.keystore. Il tipo di compilazione di debug è impostato per utilizzare automaticamente questa configurazione di debug quando esegui o esegui il debug del progetto da Android Studio.

Allo stesso modo, la procedura di importazione potrebbe rilevare un certificato di release esistente. Se in precedenza non è stato definito alcun certificato di release, aggiungi la configurazione di firma della release al file build.gradle o build.gradle.kts oppure utilizza l'opzione del menu Build > Generate Signed APK (Genera APK firmato) per aprire la procedura guidata Genera APK firmato. Per saperne di più sulla firma dell'app, consulta la pagina Firma l'app.

Regolare la dimensione massima dell'heap di Android Studio

Per impostazione predefinita, Android Studio ha una dimensione massima dell'heap di 1280 MB. Se stai lavorando a un progetto di grandi dimensioni o se il tuo sistema ha molta RAM, puoi migliorare le prestazioni aumentando la dimensione massima dell'heap size.

Aggiornamenti software

Android Studio viene aggiornato separatamente dal plug-in Gradle, dagli strumenti di build e dagli strumenti SDK. Puoi specificare le versioni che vuoi utilizzare con Android Studio.

Per impostazione predefinita, Android Studio fornisce aggiornamenti automatici ogni volta che viene rilasciata una nuova versione stabile, ma puoi scegliere di eseguire l'aggiornamento più frequentemente e ricevere versioni canary o RC.

Per saperne di più sull'aggiornamento di Android Studio e sull'utilizzo delle versioni canary e RC, consulta la pagina relativa agli aggiornamenti.