Pour migrer vos projets vers Android Studio, vous devez vous adapter à une nouvelle structure de projet, à un nouveau système de compilation et à une nouvelle fonctionnalité IDE.
Si la migration se fait à partir d'IntelliJ et que votre projet utilise déjà Gradle, vous pouvez simplement ouvrir votre projet existant depuis Android Studio. Si vous utilisez IntelliJ, mais que votre projet n'utilise pas déjà Gradle, vous devrez préparer manuellement votre projet avant de pouvoir l'importer dans Android Studio. Pour en savoir plus, consultez la section Migrer depuis IntelliJ.
Principes de base d'Android Studio
Voici quelques-unes des principales différences à prendre en considération lorsque vous préparez une migration vers Android Studio.
Organisation des projets et des modules
Android Studio est basé sur l'IDE IntelliJ IDEA. Pour vous familiariser avec les bases de l'IDE, comme la navigation, la saisie automatique de code et les raccourcis clavier, consultez la section Découvrir Android Studio.
Android Studio organise le code en projets, qui contiennent tout ce qui définit votre application Android, du code source de l'application aux configurations de compilation et au code de test. Chaque projet s'ouvre dans une fenêtre Android Studio distincte. Il contient un ou plusieurs modules, qui vous permettent de le diviser en unités de fonctionnalité distinctes. Les modules peuvent être créés, testés et débogués indépendamment.
Pour en savoir plus sur les projets et les modules Android Studio, consultez la page Présentation des projets.
Système de compilation basé sur Gradle
Le système de compilation d'Android Studio est basé sur Gradle et utilise des fichiers de configuration de compilation écrits en Groovy ou en script Kotlin pour faciliter son évolutivité et sa personnalisation.
Les projets basés sur Gradle offrent des fonctionnalités importantes pour le développement Android, par exemple :
- Prise en charge des bibliothèques binaires (AAR). Vous n'avez plus besoin de copier les sources de la bibliothèque dans vos propres projets. Il vous suffit de déclarer une dépendance pour que la bibliothèque soit automatiquement téléchargée et fusionnée avec votre projet. Cela inclut la fusion automatique des ressources, des entrées de manifeste, des règles d'exclusion ProGuard, des règles lint personnalisées, etc., au moment de la compilation.
- Prise en charge des variantes de compilation, qui vous permettent de créer différentes versions de votre application (telles qu'une version sans frais et une version professionnelle) à partir du même projet.
- Configuration de compilation et personnalisation faciles. Par exemple, vous pouvez extraire des noms de version et des codes de version à partir de balises Git dans le cadre de la compilation.
- Gradle peut être utilisé depuis l'IDE, depuis la ligne de commande et depuis des serveurs d'intégration continue tels que Jenkins, qui fournissent la même compilation partout et à chaque fois.
Pour en savoir plus sur l'utilisation et la configuration de Gradle, consultez Configurer votre build.
Dépendances
Dans Android Studio, les dépendances de bibliothèque utilisent des déclarations de dépendance Gradle et des dépendances Maven pour les bibliothèques binaires et source locales bien connues avec des coordonnées Maven. Pour en savoir plus, consultez la section Déclarer des dépendances.
Migrer depuis IntelliJ
Si votre projet IntelliJ utilise le système de compilation Gradle, vous pouvez importer votre projet directement dans Android Studio. Si votre projet IntelliJ utilise Maven ou un autre système de compilation, vous devez le configurer pour qu'il fonctionne avec Gradle avant de pouvoir migrer vers Android Studio.
Importer un projet IntelliJ basé sur Gradle
Si vous utilisez déjà Gradle avec votre projet IntelliJ, vous pouvez l'ouvrir dans Android Studio comme suit :
- Cliquez sur File > New > Import Project (Fichier > Nouveau > Importer un projet).
- Sélectionnez le répertoire de votre projet IntelliJ, puis cliquez sur OK. Votre projet s'ouvre dans Android Studio.
Importer un projet IntelliJ autre que Gradle
Si votre projet IntelliJ n'utilise pas déjà le système de compilation Gradle, deux options, décrites dans les sections suivantes, s'offrent à vous pour importer votre projet dans Android Studio :
- Créez un projet Android Studio vide et copiez votre code source existant dans les répertoires associés au nouveau projet. Pour en savoir plus, découvrez comment effectuer une migration en créant un projet vide.
- Créez un fichier de compilation Gradle pour votre projet, puis importez le projet et le nouveau fichier de compilation dans Android Studio. Pour en savoir plus, découvrez comment effectuer une migration en créant un fichier de compilation Gradle personnalisé.
Migrer en créant un projet vide
Pour migrer votre projet vers Android Studio en créant un projet vide et en copiant vos fichiers sources dans les nouveaux répertoires, procédez comme suit :
- Ouvrez Android Studio, puis cliquez sur File > New > New Project (Fichier > Nouveau > Nouveau projet).
- Saisissez le nom de votre projet d'application et spécifiez l'emplacement dans lequel il doit être créé. Cliquez ensuite sur Next (Suivant).
- Sélectionnez les facteurs de forme de votre application, puis cliquez sur Next (Suivant).
- Cliquez sur Add No Activity (N'ajouter aucune activité), puis sur Finish (Terminer).
- Dans la fenêtre d'outil Project (Projet), cliquez sur la flèche pour ouvrir le menu "View" (Vue), puis sélectionnez la vue Project (Projet) pour afficher et explorer l'organisation de votre nouveau projet Android Studio. Pour en savoir plus sur la modification des vues et sur la manière dont Android Studio structure les projets, consultez Fichiers de projet.
- Accédez à l'emplacement que vous avez sélectionné pour votre nouveau projet, puis déplacez le code, les tests unitaires, les tests d'instrumentation et les ressources de vos anciens répertoires de projet vers les emplacements appropriés de votre nouvelle structure de projet.
- Dans Android Studio, cliquez sur File > Project Structure (Fichier > Structure du projet) pour ouvrir la boîte de dialogue Project Structure (Structure du projet). Assurez-vous que le module de votre application est sélectionné dans le volet de gauche.
- Apportez toutes les modifications nécessaires dans l'onglet Properties (Propriétés) de votre projet (modification de
minSdk
outargetSdk
, par exemple). - Cliquez sur Dependencies (Dépendances) et ajoutez les bibliothèques dont dépend votre projet en tant que dépendances Gradle. Pour ajouter une dépendance, cliquez sur Add (Ajouter)
, puis sélectionnez le type de dépendance que vous souhaitez ajouter et suivez les invites.
- Cliquez sur OK pour enregistrer les modifications.
- Cliquez sur Build > Make Project (Compilation > Créer un projet) pour tester la compilation du projet et, si nécessaire, corriger les erreurs potentielles.
Migrer en créant un fichier de compilation Gradle personnalisé
Pour migrer votre projet vers Android Studio en créant un fichier de compilation Gradle pour qu'il pointe vers vos fichiers sources existants, procédez comme suit :
- Avant de commencer, veillez à sauvegarder les fichiers de votre projet dans un emplacement distinct, car le processus de migration modifiera le contenu de votre projet en place.
- Dans le répertoire de votre projet, créez un fichier nommé
build.gradle
si vous utilisez Groovy oubuild.gradle.kts
si vous utilisez un script Kotlin. Ce fichier contiendra toutes les informations nécessaires à Gradle pour exécuter votre compilation.Par défaut, Android Studio s'attend à ce que votre projet soit organisé comme illustré dans la figure 1.
Figure 1. Structure de projet par défaut d'un module d'application Android Dans
settings.gradle
(pour Groovy) ou danssettings.gradle.kts
(pour le script Kotlin), définissez les dépôts utilisés pour trouver les plug-ins et les dépendances dans les blocspluginManagement
etdependencyResolutionManagement
, respectivement :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")
Avertissement : Le dépôt JCenter est en lecture seule depuis le 31 mars 2021. Pour en savoir plus, consultez Mise à jour du service JCenter.
Le plug-in Android Gradle applique des ensembles de sources par défaut au projet. Ces ensembles de sources définissent les répertoires utilisés pour stocker différents types de fichiers sources. Gradle utilise ces ensembles de sources pour déterminer l'emplacement de certains types de fichiers. Si votre projet existant ne respecte pas la structure par défaut, vous pouvez déplacer les fichiers vers leur emplacement initial ou modifier les ensembles de sources par défaut pour que Gradle sache où les trouver.
Pour en savoir plus sur la configuration et la personnalisation d'un fichier de compilation Gradle, consultez Configurer votre build.
Ensuite, identifiez les projets de bibliothèque que vous utilisez.
Avec Gradle, vous n'avez plus besoin d'ajouter ces bibliothèques en tant que projets de code source. Vous pouvez vous y référer dans le bloc
dependencies{}
de votre fichier de compilation à la place. Le système de compilation gère ensuite ces bibliothèques pour vous, y compris le téléchargement de bibliothèques, la fusion de ressources et la fusion d'entrées de fichier manifeste. L'exemple suivant ajoute les instructions de déclaration de plusieurs bibliothèques AndroidX au blocdependencies{}
d'un fichier de compilation.Groovy
... 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. }
- Enregistrez votre fichier
build.gradle
, puis fermez le projet dans IntelliJ. Accédez au répertoire de votre projet, puis supprimez le répertoire.idea
et tous les fichiers IML de votre projet. - Lancez Android Studio, puis cliquez sur File > New > Import Project (Fichier > Nouveau > Importer un projet).
- Recherchez le répertoire de votre projet, sélectionnez le fichier
build.gradle
oubuild.gradle.kts
que vous avez créé, puis cliquez sur OK pour importer votre projet. - Cliquez sur Build > Make Project (Compilation > Créer un projet) pour tester votre fichier de compilation en compilant votre projet, et corrigez les erreurs détectées.
Étapes suivantes
Une fois votre projet migré vers Android Studio, consultez Compiler et exécuter votre application pour découvrir comment compiler avec Gradle et exécuter votre application dans Android Studio.
Selon votre projet et votre workflow, vous souhaiterez peut-être en savoir plus sur le contrôle des versions, la gestion des dépendances et la configuration d'Android Studio. Pour faire vos premiers pas avec Android Studio, consultez Découvrir Android Studio.
Configurer le contrôle des versions
Android Studio est compatible avec divers systèmes de contrôle des versions, y compris Git, Mercurial et Subversion. D'autres systèmes de contrôle des versions peuvent être ajoutés via des plug-ins.
Si votre application est déjà soumise au contrôle de la source, vous devrez peut-être l'activer dans Android Studio. Dans le menu VCS, cliquez sur Enable Version Control Integration (Activer l'intégration du contrôle des versions), puis sélectionnez le système approprié de contrôle des versions.
Si votre application n'est pas soumise au contrôle de la source, vous pouvez la configurer après l'avoir importée dans Android Studio. Utilisez les options du menu VCS d'Android Studio pour activer la compatibilité de VCS avec le système de contrôle des versions souhaité, créer un dépôt, importer les nouveaux fichiers dans le contrôle des versions et effectuer d'autres opérations de contrôle des versions :
- Dans le menu VCS d'Android Studio, cliquez sur Enable Version Control Integration (Activer l'intégration du contrôle des versions).
- Dans le menu, sélectionnez un système de contrôle des versions à associer à la racine du projet, puis cliquez sur OK. Le menu VCS affiche désormais un certain nombre d'options de contrôle des versions en fonction du système que vous avez sélectionné.
Remarque : Vous pouvez également utiliser l'option de menu File > Settings > Version Control (Fichier > Paramètres > Contrôle des versions) pour configurer et modifier le contrôle des versions.
Pour en savoir plus, consultez la documentation de référence sur le contrôle des versions d'IntelliJ.
Signature d'application
Si un certificat de débogage a déjà été utilisé, il est possible qu'il soit détecté lors du processus d'importation. Dans ce cas, Android Studio continuera de référencer ce certificat. Sinon, la configuration de débogage utilisera le keystore de débogage généré par Android Studio, avec un mot de passe connu et une clé par défaut avec un mot de passe connu situé dans $HOME/.android/debug.keystore
. Le type de compilation "debug" est configuré pour utiliser automatiquement cette configuration de débogage lorsque vous exécutez ou déboguez votre projet depuis Android Studio.
De même, le processus d'importation peut détecter un certificat de version existant.
Si aucun certificat de version n'a été défini précédemment, ajoutez la configuration de signature de version au fichier build.gradle
ou build.gradle.kts
, ou utilisez l'option de menu Build > Generate Signed APK (Compilation > Générer un APK signé) pour ouvrir l'assistant de création d'un APK signé, Generate Signed APK Wizard. Pour en savoir plus sur la signature de votre application, consultez la section Signer votre application.
Ajuster la taille maximale des tas de mémoire d'Android Studio
Par défaut, la taille maximale des tas de mémoire d'Android Studio est de 1 280 Mo. Si vous travaillez sur un projet volumineux ou si votre système dispose d'une grande RAM, vous pouvez améliorer les performances en augmentant la taille maximale des tas de mémoire.
Mises à jour logicielles
Android Studio est mis à jour séparément du plug-in Gradle, des outils de compilation et des outils du SDK. Vous pouvez spécifier les versions que vous souhaitez utiliser avec Android Studio.
Par défaut, Android Studio propose des mises à jour automatiques dès qu'une nouvelle version stable est publiée. Toutefois, vous pouvez choisir d'effectuer des mises à jour plus fréquentes et de recevoir des versions preview ou bêta.
Pour en savoir plus sur la mise à jour d'Android Studio, ainsi que sur l'utilisation des versions preview et bêta, cliquez ici.