Neben Tests erstellen, um sicherzustellen, dass Ihre App die funktionalen Anforderungen erfüllt, ist es wichtig, den Code auch mit dem Lint-Tool zu prüfen, um sicherzustellen, dass er keine strukturellen Probleme aufweist. Das Lint-Tool hilft bei der Suche nach schlecht strukturiertem Code, der die Zuverlässigkeit und Effizienz Ihrer Android-Apps beeinträchtigen und die Wartung Ihres Codes erschweren kann. Wir empfehlen Ihnen dringend, alle Fehler zu beheben, die durch Lint gefunden werden, bevor Sie Ihre Anwendung veröffentlichen.
Wenn Ihre XML-Ressourcendateien beispielsweise nicht verwendete Namespaces enthalten, wird Speicherplatz belegt und eine unnötige Verarbeitung erforderlich. Andere strukturelle Probleme wie die Verwendung von eingestellten Elementen oder API-Aufrufen, die von den Ziel-API-Versionen nicht unterstützt werden, können dazu führen, dass Code nicht korrekt ausgeführt wird. Lint kann Ihnen helfen, diese Probleme zu beheben.
Um die Leistung des Lint-Tools zu verbessern, können Sie auch Anmerkungen zu Ihrem Code hinzufügen.
Übersicht
Android Studio bietet ein Code-Scantool namens lint, mit dem Sie Probleme mit der strukturellen Qualität Ihres Codes erkennen und korrigieren können, ohne die App ausführen oder Testfälle schreiben zu müssen. Jedes vom Tool erkannte Problem wird mit einer Beschreibung und einem Schweregrad gemeldet, sodass Sie die erforderlichen Verbesserungen priorisieren können. Sie können den Schweregrad eines Problems auch senken, um Probleme zu ignorieren, die für Ihr Projekt nicht relevant sind, oder den Schweregrad erhöhen, um bestimmte Probleme hervorzuheben.
Das Lint-Tool prüft die Quelldateien Ihres Android-Projekts auf potenzielle Fehler und Optimierungsverbesserungen in Bezug auf Korrektheit, Sicherheit, Leistung, Nutzerfreundlichkeit, Barrierefreiheit und Internationalisierung. Wenn Sie Android Studio verwenden, werden konfigurierte Lint- und IDE-Prüfungen ausgeführt, wenn Sie Ihre App erstellen. Sie können jedoch Prüfungen manuell ausführen oder Lint über die Befehlszeile ausführen, wie auf dieser Seite beschrieben.
Das integrierte Lint-Tool prüft Ihren Code, während Sie Android Studio verwenden. Sie haben zwei Möglichkeiten, sich Warnungen und Fehler anzusehen:
- Als Pop-up-Text im Editorfenster. Wenn Lint ein Problem findet, wird der problematische Code gelb hervorgehoben. Bei schwerwiegenden Problemen wird der Code rot unterstrichen.
- Klicken Sie im Lint-Fenster Prüfungsergebnisse auf Code > Code prüfen.
Hinweis:Wenn Ihr Code in Android Studio kompiliert wird, werden zusätzliche IntelliJ-Codeprüfungen ausgeführt, um die Codeüberprüfung zu optimieren. Halte Android Studio immer auf dem neuesten Stand, damit die neuesten Lint-Regeln und -Prüfungen verfügbar sind.
Abbildung 1 zeigt, wie das Lint-Tool Quelldateien von Anwendungen verarbeitet.
- App-Quelldateien
- Die Quelldateien bestehen aus Dateien, die Ihr Android-Projekt bilden, einschließlich Kotlin-, Java- und XML-Dateien, Symbolen und ProGuard-Konfigurationsdateien.
- Die Datei
lint.xml - Eine Konfigurationsdatei, mit der Sie alle auszuschließenden Lint-Prüfungen angeben und die Schwere von Problemen anpassen können.
- Das Lint-Tool
- Ein Tool zum Scannen von statischem Code, das Sie in Ihrem Android-Projekt entweder über die Befehlszeile oder in Android Studio ausführen können. Das Lint-Tool prüft auf Probleme mit Strukturcode, die sich auf die Qualität und Leistung Ihrer Android-App auswirken können.
- Ergebnisse der Lint-Prüfung
- Sie können die Ergebnisse von lint entweder in der Konsole oder im Fenster Inspection Results (Prüfungsergebnisse) in Android Studio aufrufen. Wenn Sie
lintüber die Befehlszeile ausführen, werden die Ergebnisse in den Ordnerbuild/geschrieben. Weitere Informationen finden Sie im Abschnitt Prüfungen manuell ausführen.
Lint über die Befehlszeile ausführen
Wenn Sie Android Studio oder Gradle verwenden, verwenden Sie den Gradle-Wrapper, um die lint-Aufgabe für Ihr Projekt aufzurufen. Geben Sie dazu einen der folgenden Befehle im Stammverzeichnis Ihres Projekts ein:
Hinweis:Halten Sie das Android Gradle-Plug-in so aktuell wie möglich, um die neuesten Lint-Regeln zu verwenden.
- Unter Windows:
gradlew lint
- Unter Linux oder macOS:
./gradlew lint
Die Ausgabe sollte in etwa so aussehen:
> Task :app:lintDebug Wrote HTML report to file:<path-to-project>/app/build/reports/lint-results-debug.html
Wenn das Lint-Tool die Prüfungen abgeschlossen hat, stellt es Pfade zu den XML- und HTML-Versionen des Lint-Berichts bereit. Sie können dann den HTML-Bericht aufrufen und in Ihrem Browser öffnen, wie in Abbildung 2 dargestellt.
Wenn Ihr Projekt Buildvarianten enthält, wird nur die Standardvariante geprüft. Wenn Sie lint für eine andere Variante ausführen möchten, müssen Sie den Namen der Variante großschreiben und mit lint beginnen.
./gradlew lintRelease
Hinweis:Lint wird nicht automatisch als Teil Ihres Builds ausgeführt. Wir empfehlen dringend, Lint explizit als Teil eines Continuous-Integration-Builds auszuführen, damit Sie beim Erstellen Ihres vorhandenen Quellcodes die neuesten Lint-Prüfungen sehen.
Weitere Informationen zum Ausführen von Gradle-Aufgaben über die Befehlszeile finden Sie unter App über die Befehlszeile erstellen.
Lint mit dem eigenständigen Tool ausführen
Wenn Sie nicht Android Studio oder Gradle verwenden, müssen Sie die Android SDK-Befehlszeilentools installieren, um das eigenständige Lint-Tool verwenden zu können. Suchen Sie das Lint-Tool unter android_sdk/cmdline-tools/version/bin/lint.
Hinweis:Wenn Sie versuchen, das eigenständige Tool in einem Gradle-Projekt auszuführen, wird ein Fehler ausgegeben. Sie sollten immer gradle lint (unter Windows) oder ./gradlew
lint (unter macOS oder Linux) verwenden, um Lint in einem Gradle-Projekt auszuführen.
Wenn Sie lint auf eine Liste von Dateien in einem Projektverzeichnis anwenden möchten, verwenden Sie den folgenden Befehl:
lint [flags] <project directory>
Mit dem folgenden Befehl können Sie beispielsweise die Dateien im Verzeichnis myproject und in seinen Unterverzeichnissen scannen. Die Problem-ID MissingPrefix weist lint an, nur nach XML-Attributen zu suchen, bei denen das Android-Namespacepräfix fehlt.
lint --check MissingPrefix myproject
Mit dem folgenden Befehl können Sie eine vollständige Liste der vom Tool unterstützten Flags und Befehlszeilenargumente aufrufen:
lint --help
Das folgende Beispiel zeigt die Konsolenausgabe, wenn der lint-Befehl für ein Projekt namens Earthquake ausgeführt wird:
$ 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
Die Beispielausgabe enthält vier Warnungen und keine Fehler.
Zwei Warnungen beziehen sich auf die AndroidManifest.xml-Datei des Projekts:
ManifestOrderUsesMinSdkAttributes
Preferences.xml-Layoutdatei: UnusedResources.
Eine Warnung bezieht sich auf das Verzeichnis res:
IconMissingDensityFolder.
Lint so konfigurieren, dass Warnungen unterdrückt werden
Wenn Sie einen Lint-Scan ausführen, sucht das Tool standardmäßig nach allen Problemen, die Lint unterstützen. Sie können auch einschränken, welche Probleme von Lint geprüft werden sollen, und den Problemen Schweregrade zuweisen. Sie können beispielsweise die Lint-Prüfung für bestimmte Probleme unterdrücken, die für Ihr Projekt nicht relevant sind. Außerdem können Sie Lint so konfigurieren, dass nicht kritische Probleme mit einer niedrigeren Schwere gemeldet werden.
Die Schweregrade sind:
enabledisableoderignoreinformationalwarningerrorfatal
Sie können Lint-Prüfungen für verschiedene Ebenen konfigurieren:
- Global (gesamtes Projekt)
- Projektmodul
- Produktionsmodul
- Testmodul
- Dateien öffnen
- Klassenhierarchie
- Bereiche des Versionskontrollsystems (VCS)
Lint-Datei konfigurieren
Sie können Ihre Einstellungen für die Lint-Prüfung in der Datei lint.xml angeben. Wenn Sie diese Datei manuell erstellen, legen Sie sie im Stammverzeichnis Ihres Android-Projekts ab.
Die lint.xml-Datei besteht aus einem umschließenden <lint>-Übergeordneten-Tag, das ein oder mehrere untergeordnete <issue>-Elemente enthält. Lint definiert für jeden <issue> einen eindeutigen id-Attributwert:
<?xml version="1.0" encoding="UTF-8"?> <lint> <!-- list of issues to configure --> </lint>
Wenn Sie die Schwere eines Problems ändern oder die Lint-Prüfung für das Problem deaktivieren möchten, legen Sie das Attribut „severity“ im <issue>-Tag fest.
Tipp:Eine vollständige Liste der von Lint unterstützten Probleme und ihrer entsprechenden Problem-IDs erhalten Sie mit dem Befehl lint --list.
Beispiel für eine lint.xml-Datei
Das folgende Beispiel zeigt den Inhalt einer lint.xml-Datei:
<?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>
Dieses Beispiel zeigt, wie verschiedene Arten von Problemen gemeldet werden. Die IconMissingDensityFolder-Prüfung ist vollständig und die ObsoleteLayoutParam-Prüfung nur in den Dateien deaktiviert, die in den beigefügten <ignore ... />-Deklarationen angegeben sind.
Linten-Prüfung für Kotlin-, Java- und XML-Quelldateien konfigurieren
Sie können die Lint-Prüfung für Ihre Kotlin-, Java- und XML-Quelldateien im Dialogfeld Einstellungen deaktivieren:
- Wählen Sie unter Windows Datei > Einstellungen oder unter macOS oder Linux Android Studio > Einstellungen aus.
- Wählen Sie Bearbeiter > Prüfungen aus.
- Wenn Sie die Funktion deaktivieren möchten, heben Sie die Auswahl der entsprechenden Quelldatei auf.
Sie können sie entweder für die IDE oder für einzelne Projekte festlegen, indem Sie das entsprechende Profil auswählen.
Lint-Prüfung in Java oder Kotlin konfigurieren
Wenn Sie die Lint-Prüfung speziell für eine Klasse oder Methode in Ihrem Android-Projekt deaktivieren möchten, fügen Sie dem Code die @SuppressLint-Anmerkung hinzu.
Das folgende Beispiel zeigt, wie Sie die Lint-Prüfung für das NewApi-Problem in der onCreate-Methode deaktivieren. Das Lint-Tool sucht weiterhin in anderen Methoden dieser Klasse nach dem NewApi-Problem.
@SuppressLint("NewApi") override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.main)
@SuppressLint("NewApi") @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main);
Das Gleiche gilt für alle Composables. Das folgende Code-Snippet zeigt, wie Sie NewApi-Prüfungen für beliebige Composables deaktivieren können.
@SuppressLint("NewApi") @Composable fun MyComposable{ ... }
Im folgenden Beispiel wird gezeigt, wie die Lint-Prüfung für das ParserError-Problem in der FeedProvider-Klasse deaktiviert wird:
@SuppressLint("ParserError") class FeedProvider : ContentProvider() {
@SuppressLint("ParserError") public class FeedProvider extends ContentProvider {
Wenn Sie die Prüfung auf alle Lint-Probleme in der Datei unterdrücken möchten, verwenden Sie das Schlüsselwort all:
@SuppressLint("all")
@SuppressLint("all")
Mit derselben Anmerkung können Sie Lint-Prüfungen für jede zusammensetzbare Funktion unterdrücken.
Lint-Prüfung in XML konfigurieren
Mit dem Attribut tools:ignore können Sie die Lint-Prüfung für bestimmte Abschnitte Ihrer XML-Dateien deaktivieren. Fügen Sie den folgenden Namespacewert in die Datei lint.xml ein, damit das Lint-Tool das Attribut erkennt:
namespace xmlns:tools="http://schemas.android.com/tools"Im folgenden Beispiel wird gezeigt, wie Sie die Lint-Prüfung für das UnusedResources-Problem in einem <LinearLayout>-Element einer XML-Layoutdatei deaktivieren. Das ignore-Attribut wird von den untergeordneten Elementen des übergeordneten Elements übernommen, in dem es deklariert ist. In diesem Beispiel ist die Lint-Prüfung auch für das untergeordnete Element <TextView> deaktiviert:
<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>
Wenn Sie mehrere Probleme deaktivieren möchten, listen Sie diese in einem durch Kommas getrennten String auf. Beispiel:
tools:ignore="NewApi,StringFormatInvalid"
Wenn Sie die Prüfung auf alle Lint-Probleme im XML-Element unterdrücken möchten, verwenden Sie das Keyword all:
tools:ignore="all"
Lint-Optionen mit Gradle konfigurieren
Mit dem Android Gradle-Plug-in können Sie bestimmte Lint-Optionen konfigurieren, z. B. welche Prüfungen ausgeführt oder ignoriert werden sollen. Verwenden Sie dazu den Block
lint{} in der build.gradle-Datei auf Modulebene.
Das folgende Code-Snippet zeigt einige der konfigurierbaren Properties:
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 } } ...
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 } } ...
Alle Lint-Methoden, die den angegebenen Schweregrad eines Problems überschreiben, respektieren die Konfigurationsreihenfolge. Wenn Sie ein Problem beispielsweise in finalizeDsl() als fatal festlegen, wird die Deaktivierung im Haupt-DSL überschrieben.
Warnungsmesswert erstellen
Sie können einen Snapshot der aktuellen Warnungen Ihres Projekts erstellen und ihn dann als Referenz für zukünftige Prüfungen verwenden, damit nur neue Probleme gemeldet werden. Mit dem Snapshot als Baseline können Sie Lint verwenden, um den Build zu beenden, ohne zuerst alle vorhandenen Probleme beheben zu müssen.
So ändern Sie die Datei build.gradle Ihres Projekts, um einen Referenz-Snapshot zu erstellen:
android { lint { baseline = file("lint-baseline.xml") } }
android { lintOptions { baseline file("lint-baseline.xml") } }
Wenn Sie diese Zeile zum ersten Mal hinzufügen, wird die lint-baseline.xml-Datei erstellt, um die Baseline festzulegen. Danach lesen die Tools die Datei nur noch, um die Baseline zu ermitteln. Wenn Sie eine neue Baseline erstellen möchten, löschen Sie die Datei manuell und führen Sie „lint“ noch einmal aus, um sie neu zu erstellen.
Führen Sie dann lint über die IDE aus, indem Sie Code > Code prüfen auswählen, oder über die Befehlszeile wie unten beschrieben. In der Ausgabe wird der Speicherort der lint-baseline.xml-Datei ausgegeben. Der Dateispeicherort für Ihre Einrichtung kann von dem hier gezeigten abweichen:
$ ./gradlew lintDebug -Dlint.baselines.continue=true ... Wrote XML report to file:///app/lint-baseline.xml Created baseline file /app/lint-baseline.xml
Wenn Sie lint ausführen, werden alle aktuellen Probleme in der Datei lint-baseline.xml protokolliert. Die Gruppe der aktuellen Probleme wird als Baseline bezeichnet. Sie können die Datei lint-baseline.xml in die Versionskontrolle aufnehmen, wenn Sie sie für andere freigeben möchten.
Baseline anpassen
Wenn Sie der Baseline nur bestimmte Problemtypen hinzufügen möchten, geben Sie die hinzuzufügenden Probleme an. Bearbeiten Sie dazu die Datei build.gradle Ihres Projekts so:
android { lint { checkOnly += "NewApi" + "HandlerLeak" baseline = file("lint-baseline.xml") } }
android { lintOptions { checkOnly 'NewApi', 'HandlerLeak' baseline file("lint-baseline.xml") } }
Wenn Sie der Codebasis nach dem Erstellen der Baseline neue Warnungen hinzufügen, werden in Lint nur die neu eingeführten Fehler aufgeführt.
Ursprüngliche Warnung
Wenn eine Baseline gilt, erhalten Sie eine Warnung mit dem Hinweis, dass ein oder mehrere Probleme herausgefiltert wurden, weil sie in der Baseline aufgeführt sind. Diese Warnung soll Sie daran erinnern, dass Sie eine Baseline konfiguriert haben und alle Probleme irgendwann beheben müssen.
Mit dieser Information erhalten Sie auch einen Überblick über Probleme, die nicht mehr gemeldet werden. Anhand dieser Informationen können Sie feststellen, ob Probleme tatsächlich behoben wurden. Sie können die Baseline optional neu erstellen, um zu verhindern, dass ein Fehler unerkannt wieder auftritt.
Hinweis:Baselines werden aktiviert, wenn Sie Prüfungen im Batchmodus in der IDE ausführen. Sie werden jedoch für die Prüfungen im Editor ignoriert, die im Hintergrund ausgeführt werden, während Sie eine Datei bearbeiten. Das liegt daran, dass Baselines für den Fall gedacht sind, dass eine Codebasis eine große Anzahl vorhandener Warnungen enthält, Sie aber Probleme lokal beheben möchten, während Sie den Code bearbeiten.
Prüfungen manuell ausführen
Wenn Sie konfigurierte Lint- und andere IDE-Prüfungen manuell ausführen möchten, wählen Sie Code > Code prüfen aus. Die Ergebnisse der Prüfung werden im Fenster Prüfungsergebnisse angezeigt.
Prüfumfang und -profil festlegen
Wählen Sie die Dateien aus, die Sie analysieren möchten (Umfang der Prüfung), und die Prüfungen, die Sie ausführen möchten (Profil der Prüfung) so aus:
- Öffnen Sie in der Ansicht Android Ihr Projekt und wählen Sie das Projekt, den Ordner oder die Datei aus, die Sie analysieren möchten.
- Wählen Sie in der Menüleiste Code > Code prüfen aus.
Prüfen Sie die Einstellungen im Dialogfeld Prüftoolumfang festlegen.
Abbildung 3: Prüfen Sie die Einstellungen für den Prüfumfang. Die Optionen, die im Dialogfeld Prüfumfang angeben angezeigt werden, variieren je nachdem, ob Sie ein Projekt, einen Ordner oder eine Datei ausgewählt haben:
- Wenn Sie ein Projekt, eine Datei oder ein Verzeichnis auswählen, wird im Dialogfeld Prüfumfang angeben der Pfad zum ausgewählten Projekt, zur ausgewählten Datei oder zum ausgewählten Verzeichnis angezeigt.
- Wenn Sie mehrere Projekte, Dateien oder Verzeichnisse auswählen, wird im Dialogfeld Prüfumfang angeben das Kästchen für Ausgewählte Dateien ausgewählt.
Wenn Sie die Prüfung ändern möchten, wählen Sie eines der anderen Optionsfelder aus. Eine Beschreibung aller möglichen Felder im Dialogfeld Prüfumfang angeben finden Sie unter Dialogfeld „Prüfumfang angeben“.
- Wählen Sie unter Prüfprofil das gewünschte Profil aus.
Klicken Sie auf OK, um die Prüfung auszuführen.
Abbildung 4 zeigt die Ergebnisse der Lint- und anderen IDE-Prüfungen aus dem Code prüfen-Lauf:
Abbildung 4: Ergebnisse der Prüfung. Wählen Sie ein Problem aus, um die Lösung aufzurufen. -
Maximieren Sie im Bereich Inspektionsergebnisse die Inspektionsergebnisse und wählen Sie Fehlerkategorien, Typen oder Probleme aus.
Im Bereich Prüfbericht wird der Prüfbericht für die im Bereich Prüfergebnisse ausgewählte Fehlerkategorie, den Fehlertyp oder das Problem angezeigt. Außerdem werden der Name und der Speicherort des Fehlers angezeigt. Gegebenenfalls enthält der Prüfbericht weitere Informationen, z. B. eine Problemübersicht, die Ihnen bei der Behebung des Problems helfen kann.
Klicken Sie im Bereich Prüfergebnisse in der Baumansicht mit der rechten Maustaste auf eine Kategorie, einen Typ oder ein Problem, um das Kontextmenü aufzurufen.
Je nach Kontext haben Sie folgende Möglichkeiten:
- Zur Quelle springen.
- Ausgewählte Elemente ausschließen und einschließen
- Probleme unterdrücken
- Bearbeiten Sie die Einstellungen.
- Prüfbenachrichtigungen verwalten
- Wiederholen Sie die Prüfung.
Beschreibungen der Symbolleistenschaltflächen, Kontextmenüelemente und Felder im Inspektionsbericht finden Sie im Hilfeartikel Toolfenster „Inspektionsergebnisse“.
Benutzerdefinierten Bereich verwenden
So verwenden Sie einen der benutzerdefinierten Bereiche in Android Studio:
- Wählen Sie im Dialogfeld Prüfungsumfang festlegen die Option Benutzerdefinierter Umfang aus.
Klicken Sie auf die Liste Benutzerdefinierter Umfang, um die verfügbaren Optionen anzuzeigen:
Abbildung 5. Wählen Sie die benutzerdefinierte Ebene aus, die Sie verwenden möchten. - Alle Orte:Alle Dateien.
- Projektdateien:Alle Dateien im aktuellen Projekt.
- Projekt-Quelldateien:Nur die Quelldateien im aktuellen Projekt.
- Produktionsdateien des Projekts:Nur die Produktionsdateien im aktuellen Projekt.
- Projekttestdateien:Nur die Testdateien im aktuellen Projekt.
- Scratches und Konsolen: Nur die Scratch-Dateien und Konsolen, die im aktuellen Projekt geöffnet sind.
- Zuletzt angesehene Dateien:Nur Dateien, die im aktuellen Projekt zuletzt angesehen wurden.
- Aktuelle Datei:Nur die aktuelle Datei im aktuellen Projekt. Wird angezeigt, wenn Sie eine Datei oder einen Ordner ausgewählt haben.
- Ausgewähltes Verzeichnis:Nur der aktuelle Ordner im aktuellen Projekt. Wird angezeigt, wenn ein Ordner ausgewählt ist.
- Klassenhierarchie:Wenn Sie diese Option auswählen und auf OK klicken, wird ein Dialogfeld mit allen Klassen im aktuellen Projekt angezeigt. Verwenden Sie im Dialogfeld das Feld Nach Name suchen, um die zu prüfenden Klassen zu filtern und auszuwählen. Wenn Sie die Kursliste nicht filtern, werden bei der Codeprüfung alle Kurse geprüft.
- Klicken Sie auf OK.
Wenn Sie für das Projekt eine VCS konfiguriert haben, können Sie die Suche auch auf Dateien beschränken, die geändert wurden.
Benutzerdefinierten Umfang erstellen
Wenn Sie eine Auswahl von Dateien und Verzeichnissen prüfen möchten, die von keinem der verfügbaren benutzerdefinierten Bereiche abgedeckt werden, können Sie einen benutzerdefinierten Bereich erstellen:
- Wählen Sie im Dialogfeld Prüfumfang angeben die Option Benutzerdefinierter Umfang aus.
Klicken Sie auf die drei Punkte nach der Liste Benutzerdefinierter Umfang.
Abbildung 6: Dialogfeld „Prüfumfang angeben“ Das Dialogfeld Bereiche wird angezeigt.
Abbildung 7. Erstellen Sie einen benutzerdefinierten Umfang. - Klicken Sie links oben im Dialogfeld auf die Schaltfläche
, um einen neuen Umfang zu definieren. - Wählen Sie in der Liste Umfang hinzufügen die Option Lokal aus.
Sowohl der lokale als auch der freigegebene Bereich werden im Projekt für die Funktion Code prüfen verwendet. Der Bereich Gemeinsam kann auch für andere Projektfunktionen verwendet werden, die ein Feld für den Bereich haben. Wenn Sie beispielsweise auf Einstellungen bearbeiten
klicken, um die Einstellungen für Nutzungen suchen zu ändern, enthält das sich öffnende Dialogfeld ein Feld Umfang, in dem Sie einen gemeinsamen Umfang auswählen können.
Abbildung 8: Wählen Sie im Dialogfeld Nutzungen finden einen freigegebenen Bereich aus. - Geben Sie einen Namen für den Umfang ein und klicken Sie auf OK.
Im rechten Bereich des Dialogfelds Bereiche werden Optionen angezeigt, mit denen Sie den benutzerdefinierten Bereich definieren können.
- Wählen Sie in der Liste Projekt aus.
Daraufhin wird eine Liste der verfügbaren Projekte angezeigt.
Hinweis:Sie können den benutzerdefinierten Bereich für Projekte oder Pakete erstellen. Die Schritte sind dieselben.
Maximieren Sie die Projektordner, wählen Sie aus, was Sie dem benutzerdefinierten Bereich hinzufügen möchten, und legen Sie fest, ob er ein- oder ausgeschlossen werden soll.
Abbildung 9. Benutzerdefinierten Umfang definieren. - Einschließen: Dieser Ordner und seine Dateien werden eingeschlossen, aber keine Unterordner.
- Rekursiv einschließen: Dieser Ordner und seine Dateien sowie seine Unterordner und ihre Dateien werden eingeschlossen.
- Ausschließen: Schließen Sie diesen Ordner und die zugehörigen Dateien aus, aber keine seiner Unterordner.
- Rekursiv ausschließen: Dieser Ordner und seine Dateien sowie seine Unterordner und ihre Dateien werden ausgeschlossen.
Abbildung 10 zeigt, dass der Ordner main enthalten ist und dass die Ordner java und res rekursiv eingeschlossen sind. Blau steht für einen teilweise eingeschlossenen Ordner und Grün für rekursiv eingeschlossene Ordner und Dateien.
Abbildung 10. Beispiel für ein Muster für einen benutzerdefinierten Umfang. - Wenn Sie den Ordner java auswählen und auf Ausschließen Rekursiver Ordner klicken, wird die grüne Hervorhebung für den Ordner java und alle untergeordneten Ordner und Dateien entfernt.
- Wenn Sie die grün hervorgehobene Datei MainActivity.kt auswählen und auf Ausschließen klicken, wird MainActivity.kt nicht mehr grün hervorgehoben, alle anderen Dateien im Ordner java bleiben jedoch grün.
- Klicken Sie auf OK. Der benutzerdefinierte Umfang wird am Ende der Liste angezeigt.
Prüfprofile prüfen und bearbeiten
Android Studio bietet eine Auswahl an Lint- und anderen Prüfprofilen, die über Android-Updates aktualisiert werden. Sie können diese Profile unverändert verwenden oder ihre Namen, Beschreibungen, Schweregrade und Gültigkeitsbereiche bearbeiten. Sie können auch ganze Profile oder einzelne Profile innerhalb einer Gruppe aktivieren und deaktivieren.
So rufen Sie die Einstellungen für Prüfungen auf:
- Wählen Sie Datei > Einstellungen aus. (unter Windows) oder Android Studio > Einstellungen (unter macOS oder Linux).
- Wählen Sie Bearbeiter > Prüfungen aus.
-
Der Bereich Prüfungen enthält eine Liste der unterstützten Prüfungen und ihre Beschreibungen.
Abbildung 11. Unterstützte Prüfungen und ihre Beschreibungen. Wählen Sie die Liste Profil aus, um zwischen Standardprüfungen (Android Studio) und Projektstandard (das aktive Projekt) zu wechseln.
Weitere Informationen finden Sie auf der IntelliJ-Seite Profile verwalten.
Wählen Sie im linken Bereich in der Liste Prüfungen eine Profilkategorie der obersten Ebene aus oder maximieren Sie eine Gruppe und wählen Sie ein bestimmtes Profil aus.
Wenn Sie eine Profilkategorie auswählen, können Sie alle Prüfungen in dieser Kategorie als eine einzelne Prüfung bearbeiten.
- Wählen Sie die Liste Schemaaktionen für Sendungen
aus, um Prüfungen zu kopieren, umzubenennen, Beschreibungen hinzuzufügen, zu exportieren und zu importieren. - Wenn Sie fertig sind, klicken Sie auf OK.