Eseguire la migrazione ad Android Studio

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

Se stai eseguendo la migrazione da IntelliJ e il tuo progetto utilizza già Gradle, puoi aprire il tuo progetto esistente da Android Studio. Se utilizzi IntelliJ, ma il tuo progetto non utilizza già Gradle, devi prepara manualmente il progetto prima di poterlo importare in Android Studio. Per ulteriori informazioni, consulta Eseguire la migrazione da IntelliJ .

Nozioni di base su Android Studio

Di seguito sono riportate alcune delle differenze principali da tenere presenti quando ti prepari a eseguire la migrazione ad Android Studio.

Organizzazione di progetti e moduli

Android Studio è basato su IntelliJ IDEA. Per acquisire familiarità alle nozioni di base di IDE, come navigazione, completamento del codice e tastiera vedi 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 creazione e al test del codice. 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à discrete di funzionalità. I moduli possono essere creati, testati e di cui è stato eseguito il debug.

Per ulteriori informazioni su Android Studio progetti e moduli, consulta la panoramica dei progetti.

Sistema di build basato su Gradle

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

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

  • Supporto per le librerie binarie (AAR). Non devi più copiare la raccolta nei tuoi progetti; puoi dichiarare una dipendenza e viene scaricata automaticamente e unita al progetto. Questo include l'unione automatica di risorse, voci manifest, ProGuard regole di esclusione, regole di lint personalizzate e così via in fase di creazione.
  • Supporto per le varianti della build, che ti consentono di creare diverse versioni della tua app (ad esempio un e una versione professionale) dello stesso progetto.
  • Configurazione e personalizzazione facili. Ad esempio, puoi estrarre i nomi e i codici delle versioni dai tag Git durante la compilazione.
  • Gradle può essere utilizzato dall'IDE, dalla riga di comando e dai modelli server di integrazione come Jenkins, fornendo la stessa build ovunque, nel tempo.

Per saperne di più sull'uso e sulla configurazione di Gradle, vedi Configura la tua build.

Dipendenze

Le dipendenze delle librerie in Android Studio utilizzano le dichiarazioni di dipendenza Gradle e le dipendenze Maven per le librerie di origine e binarie locali ben note con coordinate Maven. Per ulteriori informazioni, vedi Dichiara le dipendenze.

Esegui la migrazione da IntelliJ

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

Importa un progetto IntelliJ basato su Gradle

Se utilizzi già Gradle con il tuo progetto IntelliJ, apri il progetto 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 viene aperto in Android Studio.

Importare un progetto IntelliJ non Gradle

Se il tuo progetto IntelliJ non utilizza già il sistema di compilazione Gradle, due opzioni per importare il progetto in Android Studio, che sono descritte nelle sezioni seguenti:

Esegui la migrazione creando un nuovo progetto vuoto

Per eseguire la migrazione del tuo progetto in Android Studio creando un nuovo progetto vuoto, copiando i file di origine nelle nuove directory, procedi come segue:

  1. Apri Android Studio e fai clic su File > Nuovo > Nuovo progetto.
  2. Inserisci un nome per il progetto dell'app e specifica la località in cui si trova da creare, quindi fai clic su Avanti.
  3. Seleziona i fattori di forma su cui viene eseguita la tua app, poi fai clic su Avanti.
  4. Fai clic su Aggiungi nessuna attività, quindi su Fine.
  5. Nella finestra dello strumento Progetto, fai clic sulla freccia per aprire la vista. e seleziona la vista Progetto per vedere ed esplorare del tuo nuovo progetto Android Studio. Per scoprire di più sulle modifiche viste e come Android Studio struttura i progetti, consulta File di progetto.
  6. Vai alla posizione selezionata per il nuovo progetto e sposta codice, test delle unità, test di strumentazione e risorse del vecchio progetto nelle posizioni corrette nella nuova struttura del progetto.
  7. In Android Studio, fai clic su File > struttura del progetto per aprire Finestra di dialogo Struttura del progetto. Assicurati che il modulo dell'app sia selezionato in riquadro a sinistra.
  8. Apporta le modifiche necessarie nella scheda Proprietà per il tuo progetto (ad esempio, la modifica di minSdk targetSdk).
  9. Fai clic su Dipendenze e aggiungi le librerie di cui dipende il tuo progetto come dipendenze Gradle. Per aggiungere una nuova dipendenza, fai clic su Aggiungi. , poi seleziona il tipo di dipendenza da aggiungere e segui le istruzioni.
  10. Fai clic su OK per salvare le modifiche.
  11. Fai clic su Crea > Crea progetto per testare la realizzazione del tuo progetto e se necessario, correggi eventuali errori in sospeso.

Esegui la migrazione creando un file di build Gradle personalizzato

Eseguire la migrazione del tuo progetto in Android Studio creando un nuovo file di build Gradle per puntare ai file sorgente esistenti, procedi come segue:

  1. Prima di iniziare, esegui il backup dei file del progetto in una posizione distinta, poiché il processo di migrazione modifica i contenuti del progetto in situ.
  2. Crea nella directory del progetto un file denominato build.gradle, se utilizzi Groovy oppure build.gradle.kts, se utilizzi lo script Kotlin. Questo file contiene tutte le informazioni necessarie per consentire a Gradle di eseguire la compilazione.

    Per impostazione predefinita, Android Studio si aspetta che il progetto sia organizzato come mostrato nella figura 1.

    Figura 1. La struttura di progetto predefinita per un modulo di app Android.

    In settings.gradle, per Groovy, oppure settings.gradle.kts, per lo script Kotlin, imposti i repository utilizzate per trovare plug-in e dipendenze pluginManagement e dependencyResolutionManagement blocchi:

    Groovy

      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 ulteriori informazioni, vedi Aggiornamento del servizio JCenter.

    Il plug-in Android per Gradle applica alcuni set di origine al progetto. Questi i set di origini definiscono le directory utilizzate per archiviare vari tipi di file sorgente. Gradle utilizza questi set di origini per determinare le posizioni di un file specifico di testo. Se il progetto esistente non è conforme ai valori predefiniti, puoi o spostare i file nella posizione desiderata cambia l'impostazione predefinita di codice sorgente, in modo che Gradle sappia dove trovarli.

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

  3. Quindi, identifica i progetti libreria che stai utilizzando.

    Con Gradle, non dovranno più aggiungere queste librerie come progetti di codice sorgente. Puoi invece farvi riferimento nel blocco dependencies{} del file di compilazione. La e creare un sistema di creazione di build, quindi gestisce queste librerie per te, incluso il download librerie, l'unione delle risorse e delle voci 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.13.1'
    implementation 'androidx.appcompat:appcompat:1.7.0'
    implementation 'androidx.cardview:cardview:1.0.0'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.gridlayout:gridlayout:1.0.0'
    implementation 'androidx.leanback:leanback:1.1.0-rc02'
    implementation 'androidx.mediarouter:mediarouter:1.7.0'
    implementation 'androidx.palette:palette-ktx:1.0.0'
    implementation 'androidx.recyclerview:recyclerview:1.3.2'
    implementation 'androidx.annotation:annotation:1.8.2'

    // 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.13.1")
    implementation("androidx.appcompat:appcompat:1.7.0")
    implementation("androidx.cardview:cardview:1.0.0")
    implementation("com.google.android.material:material:1.7.0")
    implementation("androidx.gridlayout:gridlayout:1.0.0")
    implementation("androidx.leanback:leanback:1.1.0-rc02")
    implementation("androidx.mediarouter:mediarouter:1.7.0")
    implementation("androidx.palette:palette-ktx:1.0.0")
    implementation("androidx.recyclerview:recyclerview:1.3.2")
    implementation("androidx.annotation:annotation:1.8.2")

    // Note: these libraries require that the Google repository has been declared
    // in the pluginManagement section of the top-level build.gradle.kts file.
}
    Per aiutarti a determinare le dichiarazioni corrette per il tuo librerie, cerca in Google Maven un repository attendibile o Maven Centrale.
  4. Salva il file build.gradle, quindi chiudi il progetto in IntelliJ Vai alla directory del progetto ed elimina la directory .idea e tutti i file IML al suo interno.
  5. Avvia Android Studio e fai clic su File > Nuovo > Importa Progetto.
  6. Individua la directory del tuo progetto, seleziona build.gradle build.gradle.kts file che hai creato e poi fai clic su OK per importare progetto.
  7. Fai clic su Crea > Crea progetto per testare il file di build creare il tuo progetto e correggere gli eventuali errori riscontrati.

Passaggi successivi

Dopo aver eseguito la migrazione del tuo progetto ad Android Studio, scopri di più sulla creazione con Gradle ed eseguire l'app in Android Studio leggendo Crea ed esegui la tua app.

A seconda del progetto e del flusso di lavoro, potrebbe essere utile anche saperne di più controllo della versione, gestione delle dipendenze e configurazione di Android Studio. Per ottenere hai iniziato a usare Android Studio, leggi Scopri Android Studio.

Configura il controllo della versione

Android Studio supporta una varietà di sistemi di controllo delle versioni, tra cui Git, Mercurial e Subversion. Altri sistemi di controllo delle versioni possono essere aggiunti tramite o plug-in.

Se la tua app è già sotto il controllo del codice sorgente, potrebbe essere necessario abilitarla in Android Studio. Dal menu VCS, fai clic su Abilita l'integrazione del controllo delle versioni. e selezionare il sistema di controllo della versione appropriato.

Se la tua app non è soggetta al controllo del codice sorgente, puoi configurarla dopo l'importazione la tua app in Android Studio. Utilizza le opzioni di menu VCS di Android Studio per attivare la funzionalità Supporto VCS per il sistema di controllo della versione desiderato, creare un repository, importare i nuovi file nel controllo della versione ed eseguire altri controlli operazioni:

  1. Nel menu VCS di Android Studio, fai clic su Abilita controllo versione Integrazione.
  2. Seleziona un sistema di controllo della versione da associare alla radice del progetto dall' quindi fai clic su OK. Il menu VCS ora mostra una serie di opzioni di controllo versione in base al sistema selezionato.

Nota: puoi anche utilizzare il menu File > Impostazioni > Opzione di menu Controllo della versione per impostare e modificare la versione controllo.

Per ulteriori informazioni sull'utilizzo del controllo della versione, vedi Riferimento al controllo della versione di IntelliJ.

Firma dell'app

Se in precedenza è stato utilizzato un certificato di debug, potrebbe essere rilevato durante il processo di importazione. In questo caso, Android Studio continua a indicare che certificato. In caso contrario, la configurazione di debug utilizza il modello generato da Android Studio eseguire il debug dell'archivio chiavi utilizzando una password nota e una chiave predefinita con password presente in $HOME/.android/debug.keystore. Il tipo di build di debug è impostato di utilizzare automaticamente questa configurazione di debug quando esegui o esegui il debug del tuo progetto da Android Studio.

Analogamente, il processo di importazione potrebbe rilevare un certificato di rilascio esistente. Se non è stato definito alcun certificato di rilascio in precedenza, aggiungi la firma della release configurazione al file build.gradle o build.gradle.kts oppure utilizza Crea > Genera APK firmato per aprire l'opzione di menu Genera APK firmato. guidata. Per ulteriori informazioni sulla firma dell'app, vedi Firma l'app.

Modificare la dimensione massima heap di Android Studio

Per impostazione predefinita, Android Studio ha una dimensione massima dello heap di 1280 MB. Se lavori su un progetto di grandi dimensioni o il tuo sistema ha molta RAM, puoi migliorare le prestazioni aumentando l'heap massimo dimensioni.

Aggiornamenti software

Android Studio si aggiorna separatamente dal plug-in Gradle, dagli strumenti di creazione e gli strumenti SDK. Puoi specificare quali versioni desideri utilizzare con Android Studio.

Per impostazione predefinita, Android Studio fornisce aggiornamenti automatici ogni volta che viene ma puoi scegliere di eseguire aggiornamenti più spesso e ricevere versioni in anteprima o beta.

Per ulteriori informazioni sull'aggiornamento di Android Studio e sull'utilizzo dell'anteprima e della versione beta versioni, scopri di più sugli aggiornamenti.