Améliorer votre code avec des vérifications lint

En plus de créer des tests pour vous assurer que votre application répond à ses exigences fonctionnelles, elle est important que vous exécutiez également le code via l'outil lint pour vous assurer que votre code n'a aucune structure des problèmes. L'outil lint vous aide à détecter un code mal structuré qui peut affecter la fiabilité et l'efficacité de vos applications Android et compliquer la gestion du code. Nous vous recommandons vivement de corriger les erreurs détectées par lint avant de publier votre application.

Par exemple, si vos fichiers de ressources XML contiennent des espaces de noms inutilisés, cela prend de l'espace et nécessite un traitement inutile. D'autres problèmes structurels, tels que l'utilisation d'éléments obsolètes ou d'appels d'API non compatibles avec les versions d'API cibles, peuvent entraîner une mauvaise exécution du code. lint peut vous aider à résoudre ces problèmes.

Pour améliorer les performances du linting, vous pouvez aussi Ajouter des annotations à votre code

Présentation

Android Studio fournit un outil de lecture de code appelé lint. qui peuvent vous aider à identifier et à corriger les problèmes de qualité structurelle de votre code sans avoir à exécuter l'application ni à écrire des scénarios de test. Chaque problème détecté par l'outil accompagnées d'un message descriptif et d'un niveau de gravité, afin que vous puissiez les améliorations essentielles qui doivent être apportées. Vous pouvez également réduire le niveau de gravité d'un problème pour ignorer les problèmes qui ne sont pas pertinents pour votre projet ou augmenter le niveau de gravité à mettre en évidence des problèmes spécifiques.

L'outil lint vérifie que les fichiers sources de votre projet Android ne présentent pas de bugs potentiels et propose des optimisations visant à garantir leur exactitude, leur sécurité, leurs performances, leur facilité d'utilisation, leur accessibilité et leur internationalisation. Lorsque vous utilisez Android Studio, des inspections lint et IDE configurées s'exécutent lorsque vous compilez votre application. Toutefois, vous pouvez effectuer des inspections manuellement ou Exécutez lint à partir de la ligne de commande, comme décrit sur cette page.

L'outil lint intégré vérifie votre code lorsque vous utilisez Android Studio. Vous pouvez consulter les avertissements et les erreurs des deux manières suivantes :

  • Sous forme de pop-up dans la fenêtre de l'éditeur Lorsque lint détecte un problème, il le met en surbrillance le code problématique en jaune. Pour les problèmes plus graves, il souligne le code en rouge.
  • Dans la fenêtre lint Résultats de l'inspection, lorsque vous cliquez sur Code > Inspecter le code

Remarque:Lorsque votre code est compilé dans Android Studio, Exécution des inspections de code IntelliJ pour simplifier le code pour examen.

La figure 1 montre comment l'outil lint traite les fichiers sources de l'application.

<ph type="x-smartling-placeholder">
</ph> Workflow de lecture de code avec l&#39;outil lint.
Figure 1. Workflow de lecture de code avec lint .
Fichiers sources de l'application
Les fichiers sources sont constitués de fichiers qui constituent votre projet Android, y compris Kotlin, Java et Fichiers XML, icônes et fichiers de configuration ProGuard.
Le fichier lint.xml
Un fichier de configuration que vous pouvez utiliser pour spécifier les vérifications lint que vous voulez exclure et pour personnaliser les niveaux de gravité des problèmes.
L'outil lint
Un outil d'analyse de code statique que vous pouvez exécuter sur votre projet Android depuis le de ligne de commande ou dans Android Studio Lint l'outil vérifie la présence de problèmes de code structurel susceptibles d'affecter la qualité et les performances Application Android.
Résultats de la vérification lint
Vous pouvez afficher les résultats de lint dans la console ou dans les résultats de l'inspection dans Android Studio. Si vous exécutez lint à partir de la ligne de commande, les résultats sont écrit dans le dossier build/. Pour en savoir plus, consultez la section effectuer des inspections manuellement.

Exécuter lint depuis la ligne de commande

Si vous utilisez Android Studio ou Gradle, utilisez le wrapper Gradle pour appeler la tâche lint de votre projet en procédant comme suit : en saisissant l'une des commandes suivantes à partir du répertoire racine de votre projet:

  • Sous Windows :
    gradlew lint
    
  • Sous Linux ou macOS :
    ./gradlew lint
    

Un résultat semblable aux lignes suivantes doit s'afficher :

> Task :app:lintDebug
Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html

Lorsque lint effectue ses vérifications, il fournit les chemins d'accès aux versions XML et HTML du rapport lint. Vous pouvez ensuite accéder au rapport HTML et l'ouvrir dans votre navigateur, comme illustré dans la figure 2.

Exemple de rapport lint HTML
Figure 2. Exemple de rapport lint HTML.

Si votre projet inclut des ressources de compilation variantes, lint ne vérifie que la variante par défaut. Si vous souhaitez exécuter lint sur un autre vous devez mettre le nom de la variante en majuscules et le préfixer avec lint.

./gradlew lintRelease

Pour en savoir plus sur la course à pied Gradle à partir de la ligne de commande, consultez Créer votre application à partir de la ligne de commande.

Exécuter lint à l'aide de l'outil autonome

Si vous n'utilisez pas Android Studio ni Gradle, Installez les outils de ligne de commande du SDK Android. pour utiliser l'outil lint autonome. Localiser l'outil lint à android_sdk/cmdline-tools/version/bin/lint.

Remarque:Si vous essayez d'exécuter l'outil autonome sur un projet Gradle, vous obtenez une erreur. Vous devez toujours utiliser gradle lint (sous Windows) ou ./gradlew lint (sous macOS ou Linux) pour exécuter lint sur un projet Gradle.

Pour exécuter lint sur une liste de fichiers dans un répertoire de projet, utilisez la commande suivante :

lint [flags] <project directory>

Vous pouvez par exemple exécuter la commande suivante pour analyser les fichiers du répertoire myproject et de ses sous-répertoires. L'ID de problème MissingPrefix indique à lint de rechercher uniquement les attributs XML qui ne comportent pas le préfixe de l'espace de noms Android.

lint --check MissingPrefix myproject 

Pour consulter la liste complète des options et des arguments de ligne de commande pris en charge par l'outil, utilisez la commande suivante :

lint --help

L'exemple suivant montre la sortie de la console lorsque la commande lint est exécutée sur un appelé Earthquake:

$ lint Earthquake

Scanning Earthquake: ...............................................................................................................................
Scanning Earthquake (Phase 2): .......
AndroidManifest.xml:23: Warning: <uses-sdk> tag appears after <application> tag [ManifestOrder]
  <uses-sdk android:minSdkVersion="7" />
  ^
AndroidManifest.xml:23: Warning: <uses-sdk> tag should specify a target API level (the highest verified version; when running on later versions, compatibility behaviors may be enabled) with android:targetSdkVersion="?" [UsesMinSdkAttributes]
  <uses-sdk android:minSdkVersion="7" />
  ^
res/layout/preferences.xml: Warning: The resource R.layout.preferences appears to be unused [UnusedResources]
res: Warning: Missing density variation folders in res: drawable-xhdpi [IconMissingDensityFolder]
0 errors, 4 warnings

L'exemple de résultat répertorie quatre avertissements et aucune erreur.

Deux avertissements concernent le fichier AndroidManifest.xml du projet:

  • ManifestOrder
  • UsesMinSdkAttributes
Un avertissement concerne le fichier de mise en page Preferences.xml: UnusedResources.

Un avertissement concerne le répertoire res: IconMissingDensityFolder

Configurer lint pour supprimer les avertissements

Par défaut, lorsque vous exécutez une analyse lint, l'outil vérifie tous les problèmes pris en charge par lint. Vous pouvez également limiter les problèmes à vérifier par lint et vous pouvez attribuer des niveaux de gravité en cas de problème. Par exemple, vous pouvez désactiver la vérification lint pour les problèmes spécifiques ne sont pas pertinents pour votre projet, et vous pouvez configurer lint pour signaler les problèmes non critiques à un de gravité plus faible.

Les niveaux de gravité sont les suivants:

  • enable
  • disable ou ignore
  • informational
  • warning
  • error
  • fatal

Vous pouvez configurer la vérification lint pour différents niveaux :

  • Global (intégralité du projet)
  • Module de projet
  • Module de production
  • Module de test
  • Fichiers ouverts
  • Hiérarchie des classes
  • Champs d'application du système de contrôle des versions

Configurer le fichier lint

Vous pouvez spécifier vos préférences de vérification lint dans le fichier lint.xml. Si vous créez ce fichier manuellement, placez-le dans le répertoire racine de votre projet Android.

Le fichier lint.xml consiste en une balise parente <lint> englobante qui contient un ou plusieurs éléments enfants <issue>. Lint définit une valeur Valeur de l'attribut id pour chaque <issue>:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- list of issues to configure -->
</lint>

Pour modifier le niveau de gravité d'un problème ou désactiver la vérification lint pour le problème, définissez l'attribut de gravité dans la balise <issue>.

Conseil : Pour obtenir la liste complète des problèmes pris en charge par lint et des ID de problème correspondants, exécutez la commande lint --list.

Exemple de fichier lint.xml

L'exemple suivant montre le contenu d'un fichier lint.xml:

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Disable the IconMissingDensityFolder check in this project -->
    <issue id="IconMissingDensityFolder" severity="ignore" />

    <!-- Ignore the ObsoleteLayoutParam issue in the specified files -->
    <issue id="ObsoleteLayoutParam">
        <ignore path="res/layout/activation.xml" />
        <ignore path="res/layout-xlarge/activation.xml" />
    </issue>

    <!-- Ignore the UselessLeaf issue in the specified file -->
    <issue id="UselessLeaf">
        <ignore path="res/layout/main.xml" />
    </issue>

    <!-- Change the severity of hardcoded strings to "error" -->
    <issue id="HardcodedText" severity="error" />
</lint>

Cet exemple montre comment les différents types de problèmes sont signalés. La IconMissingDensityFolder est entièrement désactivée, tandis que la vérification ObsoleteLayoutParam l'est uniquement dans les fichiers spécifiés dans les déclarations <ignore ... /> ci-jointes.

Configurer la vérification lint pour les fichiers sources Kotlin, Java et XML

Vous pouvez désactiver la vérification lint pour vos fichiers sources Kotlin, Java et XML. dans la boîte de dialogue Preferences (Préférences) :

  1. Sélectionnez Fichier > Settings (Paramètres) (sous Windows) ou Android Studio > Préférences (sous macOS ou Linux).
  2. Sélectionnez Éditeur > Inspections
  3. Pour la désactiver, désélectionnez le fichier source approprié.

Vous pouvez les définir pour l'IDE ou pour des projets individuels en en sélectionnant le profil approprié.

Configurer la vérification lint en Java ou Kotlin

Pour désactiver la vérification lint pour une classe ou une méthode spécifique de votre projet Android, ajoutez l'annotation @SuppressLint à ce code.

L'exemple suivant montre comment désactiver la vérification lint pour le problème NewApi dans la méthode onCreate. L'outil lint continue de rechercher le problème NewApi dans d'autres méthodes de cette classe.

Kotlin

@SuppressLint("NewApi")
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.main)

Java

@SuppressLint("NewApi")
@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.main);

La même chose peut être faite sur n'importe quel composable. L'extrait de code suivant vous montre comment transformer des vérifications NewApi sur n'importe quel composable.

Kotlin

  @SuppressLint("NewApi")
  @Composable
  fun MyComposable{
    ...
  }
  

L'exemple suivant montre comment désactiver la vérification lint pour le problème ParserError dans la classe FeedProvider :

Kotlin

@SuppressLint("ParserError")
class FeedProvider : ContentProvider() {

Java

@SuppressLint("ParserError")
public class FeedProvider extends ContentProvider {

Pour supprimer la vérification de tous les problèmes lint dans le fichier, utilisez le mot clé all:

Kotlin

@SuppressLint("all")

Java

@SuppressLint("all")

Vous pouvez utiliser la même annotation pour supprimer les vérifications lint sur n'importe quelle fonction composable.

Configurer la vérification lint au format XML

Utilisez l'attribut tools:ignore pour désactiver la vérification lint pour des de vos fichiers XML. Placez la valeur de l'espace de noms suivante dans le fichier lint.xml afin que l'outil lint reconnaisse l'attribut :

namespace xmlns:tools="http://schemas.android.com/tools"

L'exemple suivant montre comment désactiver la vérification lint pour le Problème UnusedResources dans un élément <LinearLayout> d'un fichier XML de mise en page. L'attribut ignore est hérité par les éléments enfants du parent. où l'attribut est déclaré. Dans cet exemple, la vérification lint est également désactivée pour élément <TextView> enfant:

<LinearLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    tools:ignore="UnusedResources" >

    <TextView
        android:text="@string/auto_update_prompt" />
</LinearLayout>

Pour désactiver plusieurs problèmes, répertoriez-les dans une chaîne séparée par des virgules. Exemple :

tools:ignore="NewApi,StringFormatInvalid"

Pour supprimer la vérification de tous les problèmes lint dans l'élément XML, utilisez all mot clé:

tools:ignore="all"

Configurer les options lint avec Gradle

Le plug-in Android pour Gradle vous permet de configurer certaines options lint, telles que les vérifications à exécuter ou à ignorer, à l'aide de la méthode Bloc lint{} au niveau de votre module build.gradle.

L'extrait de code suivant montre certaines les propriétés que vous pouvez configurer:

Kotlin

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable += "TypographyFractions" + "TypographyQuotes"
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable += "RtlHardcoded" + "RtlCompat" + "RtlEnabled"
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly += "NewApi" + "InlinedApi"
        // If set to true, turns off analysis progress reporting by lint.
        quiet = true
        // If set to true (default), stops the build if errors are found.
        abortOnError = false
        // If set to true, lint only reports errors.
        ignoreWarnings = true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies = true
    }
}
...

Groovy

android {
    ...
    lint {
        // Turns off checks for the issue IDs you specify.
        disable 'TypographyFractions','TypographyQuotes'
        // Turns on checks for the issue IDs you specify. These checks are in
        // addition to the default lint checks.
        enable 'RtlHardcoded','RtlCompat', 'RtlEnabled'
        // To enable checks for only a subset of issue IDs and ignore all others,
        // list the issue IDs with the 'check' property instead. This property overrides
        // any issue IDs you enable or disable using the properties above.
        checkOnly 'NewApi', 'InlinedApi'
        // If set to true, turns off analysis progress reporting by lint.
        quiet true
        // If set to true (default), stops the build if errors are found.
        abortOnError false
        // If set to true, lint only reports errors.
        ignoreWarnings true
        // If set to true, lint also checks all dependencies as part of its analysis.
        // Recommended for projects consisting of an app with library dependencies.
        checkDependencies true
    }
}
...

Toutes les méthodes lint qui ignorent le niveau de gravité donné d'un problème respectent le l'ordre de la configuration. Par exemple, si vous définissez un problème comme fatal dans finalizeDsl() remplace sa désactivation dans le DSL principal.

Créer une référence d'avertissements

Vous pouvez prendre un instantané de l'ensemble actuel d'avertissements de votre projet, puis utiliser l'instantané comme référence pour les exécutions d'inspection futures, afin que seuls les nouveaux problèmes soient signalés. L'instantané de référence vous permet de commencer à utiliser lint pour faire échouer la compilation sans avoir à revenir en arrière pour pouvoir résoudre tous les problèmes existants.

Pour créer un instantané de référence, modifiez le fichier build.gradle de votre projet comme suit:

Kotlin

android {
    lint {
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        baseline file("lint-baseline.xml")
    }
}

Lorsque vous ajoutez cette ligne pour la première fois, le fichier lint-baseline.xml est créé pour établir votre référence. Ensuite, les outils ne lisent que le fichier pour déterminer la référence. Si vous voulez Pour créer une référence, supprimez manuellement le fichier et exécutez à nouveau lint pour le recréer.

Exécutez ensuite lint depuis l'IDE en sélectionnant Code > Inspecter le code ou à partir de la ligne de commande comme suit. Le résultat imprime l'emplacement du fichier lint-baseline.xml. La pour votre configuration peut être différent de celui présenté ci-dessous:

$ ./gradlew lintDebug -Dlint.baselines.continue=true
...
Wrote XML report to file:///app/lint-baseline.xml
Created baseline file /app/lint-baseline.xml

L'exécution de lint enregistre tous les les problèmes actuels dans le fichier lint-baseline.xml. L'ensemble des problèmes actuels est appelée référence. Vous pouvez consulter les lint-baseline.xml dans le contrôle des versions si vous souhaitez le partager avec d'autres.

Personnaliser la référence

Si vous ne souhaitez ajouter que certains types de problèmes à la version de référence, indiquez le à ajouter en modifiant le fichier build.gradle de votre projet comme suit:

Kotlin

android {
    lint {
        checkOnly += "NewApi" + "HandlerLeak"
        baseline = file("lint-baseline.xml")
    }
}

Groovy

android {
    lintOptions {
        checkOnly 'NewApi', 'HandlerLeak'
        baseline file("lint-baseline.xml")
    }
}

Si vous ajoutez de nouveaux avertissements au codebase après avoir créé la référence, les listes lint uniquement les nouveaux bugs.

Avertissement de référence

Lorsqu'une référence est utilisée, un avertissement vous informe qu'un ou plusieurs les problèmes ont été filtrés, car ils sont répertoriés dans la référence. Ce vous permet de vous rappeler que vous avez configuré une référence et que vous devez résoudre tous les problèmes à un moment donné.

Cet avertissement vous permet également de garder une trace des problèmes qui ne sont plus signalés. Ces informations permettent vous savez si vous avez résolu les problèmes. Vous pouvez donc recréer la référence pour éviter une erreur de ne plus être détectée.

Remarque : Les références sont activées lorsque vous exécutez des inspections en mode de traitement par lot dans l'IDE, mais elles sont ignorées pour les vérifications dans l'éditeur exécutées en arrière-plan lorsque vous modifiez un fichier. En effet, Elles sont destinées aux cas où un codebase comporte un grand nombre d'avertissements existants, mais que vous voulez résoudre les problèmes localement pendant que vous touchez le code.

Exécuter des inspections manuellement

Pour exécuter manuellement des inspections lint et autres inspections IDE configurées, sélectionnez Code > Inspecter le code Les résultats de l'inspection s'affichent dans la fenêtre Résultats de l'inspection.

Définir le champ d'application et le profil d'inspection

Sélectionnez les fichiers que vous souhaitez analyser (le champ d'application de l'inspection) et les que vous souhaitez exécuter (le profil d'inspection) comme suit:

  1. Dans la vue Android, ouvrez votre projet et sélectionnez le projet, le dossier ou que vous souhaitez analyser.
  2. Dans la barre de menus, sélectionnez Code > Inspecter le code
  3. Dans la boîte de dialogue Spécifier le champ d'application de l'inspection, vérifiez les paramètres.

    <ph type="x-smartling-placeholder">
    </ph> Spécifier le champ d&#39;application de l&#39;inspection
    Figure 3. Examinez les paramètres du champ d'application de l'inspection.

    Les options qui s'affichent dans la boîte de dialogue Spécifier l'étendue de l'inspection varient selon que vous avez sélectionné un projet, un dossier ou un fichier:

    • Lorsque vous sélectionnez un projet, un fichier ou un répertoire, Spécifier l'étendue de l'inspection affiche le chemin d'accès au projet, au fichier ou dans le répertoire de destination que vous avez sélectionné.
    • Si vous sélectionnez plusieurs projets, fichiers ou répertoires, l'option Spécifier l'inspection La boîte de dialogue "Portée" affiche la case d'option sélectionnée pour Fichiers sélectionnés.

    Pour modifier les éléments à inspecter, sélectionnez l'une des autres cases d'option. Voir Boîte de dialogue "Spécifier l'étendue de l'inspection" pour obtenir une description de tous champs possibles dans la boîte de dialogue Spécifier l'étendue de l'inspection.

  4. Sous Profil d'inspection, sélectionnez le profil que vous souhaitez utiliser.
  5. Cliquez sur OK pour exécuter l'inspection.

    La figure 4 illustre l'inspection lint et autre inspection de l'IDE de l'exécution Inspect Code (Inspecter le code) :

    Sélectionnez un problème pour voir sa résolution.
    Figure 4. Résultats de l'inspection. Sélectionner un problème pour voir la résolution.
  6. Dans le volet Inspection Results (Résultats de l'inspection), affichez les résultats de l'inspection en développant et en sélectionnant des catégories, des types ou des problèmes d'erreur.

    Le volet Inspection Report (Rapport d'inspection) affiche le rapport d'inspection pour la catégorie d'erreur, le type ou le problème sélectionné dans le volet Inspection Results (Résultats de l'inspection), et affiche le nom et l'emplacement de l'erreur. Le cas échéant, le rapport d'inspection affiche d'autres informations, comme un résumé du problème, pour vous aider à le corriger.

  7. Dans l'arborescence du volet Inspection Results (Résultats de l'inspection), effectuez un clic droit sur une catégorie, un type ou un problème pour écran le menu contextuel.

    Selon le contexte, vous pouvez:

    • Accédez à la source.
    • Exclure et inclure les éléments sélectionnés.
    • Supprimer les problèmes.
    • Modifiez les paramètres.
    • Gérer les alertes d'inspection
    • Réexécutez une inspection.

Pour obtenir une description des boutons de la barre d'outils, des éléments du menu contextuel et du contrôle les champs du rapport, voir Fenêtre de l'outil Résultats d'inspection

Utiliser un champ d'application personnalisé

Utilisez l'un des champs d'application personnalisés fournis dans Android Studio comme suit:

  1. Dans la boîte de dialogue Spécifier l'étendue de l'inspection, sélectionnez Champ d'application personnalisé.
  2. Cliquez sur la liste Champ d'application personnalisé pour afficher les options disponibles:

    <ph type="x-smartling-placeholder">
    </ph> Choisir le champ d&#39;application de l&#39;inspection
    Figure 5. Sélectionnez le champ d'application personnalisé que vous souhaitez utiliser.
    • Tous les lieux:tous les fichiers.
    • Fichiers du projet:tous les fichiers du projet actuel.
    • Fichiers sources du projet:uniquement les fichiers sources du projet actuel.
    • Fichiers de production du projet : uniquement les fichiers de production du projet actuel.
    • Fichiers de test du projet : uniquement les fichiers de test du projet actuel.
    • Scratches et consoles:uniquement les fichiers de travail et les consoles que vous avez ouverts dans projet en cours.
    • Fichiers consultés récemment:uniquement les fichiers consultés récemment dans le projet actuel.
    • Fichier actuel : uniquement le fichier actuel de votre projet. S'affiche lorsque vous avez un fichier ou un dossier sélectionné.
    • Répertoire sélectionné:uniquement le dossier actuel de votre projet. Apparaît lorsque vous sélectionner un dossier.
    • Hiérarchie des classes:lorsque vous sélectionnez cette option et cliquez sur OK, une boîte de dialogue s'affiche avec toutes les classes du projet actuel. Dans la boîte de dialogue, utilisez le champ Rechercher par nom. pour filtrer et sélectionner les cours à inspecter. Si vous ne filtrez pas la liste des classes, l'inspection du code inspecte toutes les classes.

    Si un VCS est configuré pour le projet, des options permettent également de limiter la recherche qu'aux fichiers qui ont été modifiés.

  3. Cliquez sur OK.

Créer un champ d'application personnalisé

Lorsque vous souhaitez inspecter une sélection de fichiers et de répertoires qui ne sont couverts par aucun des les champs d'application personnalisés actuellement disponibles, vous pouvez en créer un:

  1. Dans la boîte de dialogue Spécifier l'étendue de l'inspection, sélectionnez Champ d'application personnalisé.
  2. Cliquez sur les trois points après la liste Champ d'application personnalisé.

    <ph type="x-smartling-placeholder">
    </ph> Boîte de dialogue &quot;Spécifier l&#39;étendue de l&#39;inspection&quot;
    Figure 6. Boîte de dialogue "Spécifier l'étendue de l'inspection"

    La boîte de dialogue Champs d'application s'affiche.

    <ph type="x-smartling-placeholder">
    </ph> Créer un champ d&#39;application personnalisé
    Figure 7. Créez un champ d'application personnalisé.
  3. Cliquez sur le dans l'angle supérieur gauche de la boîte de dialogue pour définir un nouveau champ d'application.
  4. Dans la liste Ajouter un champ d'application qui s'affiche, sélectionnez Local.

    Les champs d'application locaux et partagés sont utilisées dans le projet pour la fonctionnalité Inspecter le code. Un champ d'application partagé peut également être utilisé avec d'autres fonctionnalités de projet associées à un champ d'application. Par exemple, lorsque vous cliquez surModifier les paramètres pour modifier les paramètres de Trouver des utilisations, la boîte de dialogue qui s'affiche alors contient un champ Champ d'application dans lequel vous pouvez sélectionner un champ d'application partagé.

    <ph type="x-smartling-placeholder">
    </ph> Sélectionnez un champ d&#39;application partagé dans la boîte de dialogue &quot;Rechercher des utilisations&quot;
    Figure 8. Sélectionnez un champ d'application partagé dans le Boîte de dialogue Find Usages (Rechercher des utilisations)
  5. Attribuez un nom au champ d'application, puis cliquez sur OK.

    Volet droit de la boîte de dialogue Champs d'application contient des options qui vous permettent de définir le champ d'application personnalisé.

  6. Dans la liste, sélectionnez Projet.

    La liste des projets disponibles s'affiche.

    Remarque : Vous pouvez créer une portée personnalisée pour les projets ou les packages. La les étapes sont les mêmes.

  7. Développez les dossiers du projet, sélectionnez ce que vous souhaitez ajouter au champ d'application personnalisé, puis sélectionnez si vous souhaitez l'inclure ou l'exclure.

    <ph type="x-smartling-placeholder">
    </ph> Définir un champ d&#39;application personnalisé
    Figure 9. Définissez un champ d'application personnalisé.
    • Inclure : permet d'inclure ce dossier et ses fichiers, mais aucun de ses sous-dossiers.
    • Inclure de manière récursive: permet d'inclure ce dossier et ses fichiers, ainsi que ses sous-dossiers et leurs .
    • Exclure : permet d'exclure ce dossier et ses fichiers, mais aucun de ses sous-dossiers.
    • Exclure de manière récursive: excluez ce dossier et ses fichiers, ainsi que ses sous-dossiers et leurs .

    La figure 10 montre que le dossier main est inclus et que la classe java et res sont inclus de manière récursive. Le bleu indique un dossier partiellement inclus et le vert. indique les dossiers et les fichiers inclus de manière récursive.

    <ph type="x-smartling-placeholder">
    </ph> Exemple de modèle pour un champ d&#39;application personnalisé
    Figure 10. Exemple de modèle pour un champ d'application personnalisé
    • Si vous sélectionnez le dossier java et cliquez sur Exclure de manière récursive, l'icône verte la mise en surbrillance du dossier java et de tous les dossiers et fichiers qu'il contient n'est plus mise en surbrillance.
    • Si vous sélectionnez le fichier MainActivity.kt mis en surbrillance en vert et cliquez sur Exclure. MainActivity.kt n'est plus surligné en vert, mais tout le reste du dossier java reste vert.
  8. Cliquez sur OK. Le champ d'application personnalisé s'affiche en bas de la liste.

Examiner et modifier les profils d'inspection

Android Studio propose une sélection de profils d'inspection lint et autres qui sont mis à jour à Mises à jour Android Vous pouvez utiliser ces profils tels quels ou modifier leur nom, leur description, leur niveau de gravité et des niveaux d'accès. Vous pouvez également activer et désactiver des groupes de profils entiers ou des profils individuels au sein d'un groupe.

Pour accéder aux paramètres Inspections:

  1. Sélectionnez Fichier > Paramètres. (sous Windows) ou Android Studio > Préférences (sous macOS ou Linux).
  2. Sélectionnez Éditeur > Inspections
  3. Le volet Inspections (Inspections) affiche la liste des inspections prises en charge et leurs des descriptions détaillées.

    <ph type="x-smartling-placeholder">
    </ph> Inspections compatibles et leur description
    Figure 11. Les inspections acceptées et leurs descriptions.
  4. Sélectionnez la liste Profil pour basculer entre les paramètres Par défaut (Android Studio) et Inspections Project Default (Projet actif) par défaut.

    Pour en savoir plus, consultez la documentation Gérer les profils.

  5. Dans la liste Inspections du volet de gauche, sélectionnez une catégorie de profil de niveau supérieur ou développer un groupe et sélectionner un profil spécifique.

    Lorsque vous sélectionnez une catégorie de profil, vous pouvez : modifier toutes les inspections de cette catégorie en une seule inspection.

  6. Sélectionnez la liste Show Schema Actions (Afficher les actions de schéma) Icône Afficher les actions sur le schéma pour copier, renommer et ajouter les descriptions, l'exportation et l'importation d'inspections.
  7. Lorsque vous avez terminé, cliquez sur OK.