Migration AndroidX

par

AndroidX est une amélioration majeure de la bibliothèque de support Android originale.

Il fournit les bibliothèques de paquets androidx.*, dégroupées de l’API de la plate-forme.Cela signifie qu’il offre une rétrocompatibilité et qu’il est mis à jour plus fréquemment que la plate-forme Android.

Questions courantes

Comment puis-je migrer mon projet d’application, de plugin ou de module modifiable par l’hôte existant vers AndroidX ?

Vous aurez besoin d’Android Studio 3.2 ou plus. Si vous ne l’avez pas installé, vous pouvez télécharger la dernière version sur le siteAndroid Studio.

  1. Ouvrir Android Studio.
  2. Sélectionner Ouvrir un projet Android Studio existant.
  3. Ouvrir le répertoire android au sein de votre app.
  4. Attendre que le projet ait été synchronisé avec succès. (Cela se produit automatiquement une fois que vous ouvrez le projet, mais si ce n’est pas le cas,sélectionnez Synchroniser le projet avec les fichiers Gradle dans le menu Fichier).
  5. Sélectionnez Migrer vers AndroidX dans le menu Refactor.
  6. Si on vous demande de sauvegarder le projet avant de procéder,cochez Sauvegarder le projet sous forme de fichier Zip, puis cliquez sur Migrer. Enfin, enregistrez le fichier zip dans l’emplacement de votre choix. Sélectionner le projet de sauvegarde comme fichier zip
  7. L’aperçu du refactoring affiche la liste des modifications. Enfin, cliquez sur Do Refactor : Une animation de la transition de page ascendante sur Android
  8. C’est tout ! Vous avez réussi à migrer votre projet vers AndroidX.

Enfin, si vous avez migré un plugin, publiez la nouvelle version AndroidX dans pub et mettez à jourvotre CHANGELOG.md pour indiquer que cette nouvelle version est compatible avec AndroidX.

Que faire si je ne peux pas utiliser Android Studio ?

Vous pouvez créer un nouveau projet en utilisant l’outil Flutter, puis déplacer le code Dart et lesassets vers le nouveau projet.

Pour créer un nouveau projet, exécutez :

flutter create -t <project-type> <new-project-path>

Ajouter à l’app

Si votre projet Flutter est un type de module à ajouter à une app Android existante, etcontenu un répertoire .android, ajoutez la ligne suivante à pubspec.yaml:

 module: ... androidX: true # Add this line.

Enfin, exécutez flutter clean.

Si votre module contient plutôt un répertoire android, alors suivez les étapes de la section précédente.

Comment puis-je savoir si mon projet utilise AndroidX ?

À partir de Flutter v1.12.13, les nouveaux projets créés avec flutter create -t <project-type>utilisent AndroidX par défaut.

Les projets créés avant cette version de Flutter ne doivent pas dépendre d’un ancien artefact de construction ou d’une ancienne classe de la bibliothèque de support.

Dans un projet d’application ou de module, le fichier android/gradle.properties ou .android/gradle.propertiesdoit contenir :

android.useAndroidX=trueandroid.enableJetifier=true

Et si je ne migre pas mon application ou mon module vers AndroidX ?

Votre application peut continuer à fonctionner. Cependant, la combinaison d’AndroidX et d’artefacts de support n’est généralement pas recommandée car elle peut entraîner des conflits de dépendances ou d’autres types d’échecs de Gradle. Par conséquent, à mesure que davantage de plugins migrent vers AndroidX,les plugins dépendant des bibliothèques centrales d’Android sont susceptibles de provoquer des échecs de construction.

Que faire si mon application est migrée vers AndroidX, mais pas tous les plugins que j’utilise ?

L’outil Flutter utilise Jetifier pour migrer automatiquement les plugins Flutter utilisant la bibliothèque de support vers AndroidX, afin que vous puissiez utiliser les mêmes plugins même s’ils n’ont pas encore été migrés vers AndroidX.

J’ai des problèmes pour migrer vers AndroidX

Ouvrez un problème sur GitHubet ajoutez au titre du problème.

Laisser un commentaire