Ajouter un module pour un nouvel appareil

Les modules fournissent un conteneur pour le code source, les fichiers de ressources et les paramètres de votre application, tels que le fichier de compilation au niveau du module et le fichier manifeste Android. Chaque module peut être créé, testé et débogué individuellement.

Android Studio utilise des modules pour faciliter l'ajout de nouveaux appareils à votre projet. En suivant quelques étapes simples dans Android Studio, vous pouvez créer un module contenant un code spécifique à un type d'appareil, comme Wear OS ou Android TV. Android Studio crée automatiquement des répertoires de modules, tels que des répertoires sources et des répertoires de ressources, ainsi qu'un fichier build.gradle par défaut adapté au type d'appareil. En outre, Android Studio crée des modules d'appareil avec les configurations de compilation recommandées, par exemple en utilisant la bibliothèque Leanback pour les modules Android TV.

Cette page explique comment ajouter un nouveau module à un appareil spécifique.

Android Studio vous permet également d'ajouter facilement une bibliothèque ou un module Google Cloud à votre projet. Pour en savoir plus sur la création d'un module de bibliothèque, consultez Créer un module de bibliothèque.

Créer un nouveau module

Pour ajouter un nouveau module à votre projet pour un nouvel appareil, procédez comme suit :

  1. Cliquez sur File > New > New module (Fichier > Nouveau > Nouveau module).
  2. Dans la fenêtre Create New Module (Créer un module) qui s'affiche, les modules suivants sont disponibles dans Android Studio :
    • Module pour téléphone et tablette
    • Module Wear OS
    • Module Android TV
    • Module Glass
    Sélectionnez le module correspondant à l'appareil de votre choix, puis cliquez sur Next (Suivant).
  3. Dans le formulaire Configure your new module (Configurer votre nouveau module), saisissez les informations suivantes :
    • Application Name (Nom de l'application) : nom utilisé comme titre de l'icône du lanceur d'applications pour le nouveau module.
    • Module Name (Nom du module) : nom du dossier dans lequel votre fichier de code source et vos fichiers de ressources sont visibles.
    • Package Name (Nom du package) : espace de noms Java pour le code de votre module. Il est ajouté en tant qu'attribut package dans le fichier manifeste Android du module.
    • Minimum SDK (SDK minimal) : paramètre qui indique la version la plus basse de la plate-forme Android compatible avec le module d'application. Cette valeur définit l'attribut minSdkVersion dans le fichier build.gradle, que vous pouvez modifier ultérieurement.

    Cliquez ensuite sur Next (Suivant).

  4. En fonction du module d'appareil que vous avez sélectionné, la page suivante affiche une sélection de modèles de code adéquats que vous pouvez utiliser comme activité principale. Cliquez sur le modèle d'activité que vous souhaitez utiliser, puis sur Next. Si vous n'avez pas besoin d'une activité, cliquez sur Add No Activity (N'ajouter aucune activité), puis sur Finish (Terminer) pour terminer l'opération.
  5. Si vous avez choisi un modèle d'activité, saisissez les paramètres de votre activité sur la page Customize the Activity (Personnaliser l'activité). La plupart des modèles demandent les informations suivantes : Activity Name (nom d'activité), Layout Name (nom de mise en page), Title (titre) et Source Language (langue source), mais chacun comporte des paramètres spécifiques à l'activité. Cliquez sur Finish. Lorsque vous créez un module d'application avec un modèle d'activité, vous pouvez l'exécuter et le tester immédiatement sur votre appareil.

Android Studio crée tous les fichiers nécessaires au nouveau module et synchronise le projet avec les nouveaux fichiers Gradle du module. L'ajout d'un module à un nouvel appareil ajoute également toutes les dépendances requises pour l'appareil cible dans le fichier de compilation du module.

Une fois la synchronisation du projet Gradle terminée, le nouveau module apparaît dans la fenêtre Project (Projet) à gauche. Si vous ne voyez pas le nouveau dossier du module, assurez-vous que la fenêtre affiche la vue Android.

Importer un module

Pour importer un module existant dans votre projet, procédez comme suit :

  1. Cliquez sur File > New > Import Module (Fichier > Nouveau > Importer un module.
  2. Dans le champ Source directory (Répertoire source), saisissez ou sélectionnez le répertoire du/des module(s) que vous souhaitez importer :
    • Si vous n'importez qu'un module, indiquez son répertoire racine.
    • Si vous importez plusieurs modules à partir d'un projet, indiquez le dossier du projet. Pour chaque module du dossier, une case indique le Source location (Emplacement source) et le Module name (Nom du module). Assurez-vous que la case Import (Importer) est cochée pour chaque module que vous souhaitez importer.
    Si vos modules ont d'autres dépendances, ils seront répertoriés sous Additional required modules (Autres modules requis).
  3. Saisissez le(s) nom(s) de module de votre choix dans le(s) champ(s) Module name (Nom du module).
  4. Cliquez sur Finish (Terminer).

Une fois le module importé, il apparaît dans la fenêtre Project (Projet), sur la gauche.

Étapes suivantes

Une fois que vous avez ajouté un module, vous pouvez modifier son code et ses ressources, configurer ses paramètres, puis le compiler. Vous pouvez également exécuter et déboguer le module comme n'importe quelle autre application.

Vous devrez également ajouter du code et des ressources compatibles avec le nouvel appareil. Pour en savoir plus sur le développement de modules d'application pour différents types d'appareils, consultez les documents correspondants :

Lorsque vous développez votre nouveau module, vous pouvez créer du code indépendant de l'appareil, qui est déjà dupliqué dans un autre module d'application. Au lieu de conserver le code en double, envisagez de déplacer le code partagé vers un module de bibliothèque et d'ajouter la bibliothèque en tant que dépendance à vos modules d'application. Pour savoir comment créer un module de bibliothèque et l'ajouter en tant que dépendance, consultez Créer une bibliothèque Android.