Share via

Android-Layout-Diagnose

  • Artikel

Android-Layout-Diagnose wurden entwickelt, um die Qualität von Android-Layoutdateien zu verbessern, indem allgemeine Qualitätsprobleme und hilfreiche Optimierungen hervorgehoben werden. Dieses Feature ist für Visual Studio 16.5 und höher Visual Studio für Mac 8.5 und höher verfügbar.

Ein Standardsatz von Analysetools wird für eine Vielzahl von Problemen bereitgestellt, die jeweils angepasst werden können, um die spezifischen Anforderungen eines Projekts zu erfüllen. Die Analysetools basieren lose auf dem Android-Lintingsystem.

Aktivieren des Android-Layouts Diagnose in Visual Studio 2019

Stellen Sie sicher, dass die Einstellung Layout Diagnose Layout aktivieren Diagnose aktiviert ist. Um auf diese Optionsseite zuzugreifen, wählen Sie Extras>Optionen und dann Text-Editor>Android XML>Erweitert aus:

Dialogfeld

Nach der Aktivierung zeigt der Android-Layout-Editor Folgende Probleme an:

Android Diagnose in Visual Studio 2019 aktiviert

Funktionen

In den folgenden Abschnitten werden die verfügbaren Features im Android-Layout Diagnose.

Analyzer

Analysetools werden verwendet, um Probleme in Layoutdateien zu erkennen, hartcodierte Werte zu reduzieren, die Leistung zu verbessern und Fehler zu kennzeichnen. Eine Liste der Analysetools finden Sie unter Android Designer-Diagnoseanalysetools.

Diagnosekonfiguration

Analysetools können mithilfe einer XML-Datei konfiguriert werden, sodass Sie den Standardschweregrad ändern, bestimmte Dateien ignorieren und Variablen übergeben können.

Sie können eine Baselinedatei verwenden, wenn Sie über eine Reihe von Konfigurationen verfügen, die Sie für mehrere Android-Apps freigeben möchten. Um dieses Feature zu verwenden, erstellen Sie eine neue Konfigurationsdatei, und fügen Sie an den Dateinamen an -baseline . Zuerst werden die Baselinekonfigurationen und dann die verbleibenden Konfigurationsdateien angewendet.

Tipp

Dies kann hilfreich sein, wenn Sie eine Reihe von Problemen in einer neuen oder vorhandenen Android-App ignorieren möchten.

Das Format lautet:

<?xml version="1.0" encoding="utf-8" ?> 
<configuration>
    <issue id="DuplicateIDs" severity="warning">
        <ignore path="Resources/layout/layout1.xml" />
    </issue>
    <issue id="HardcodedText" severity="informational">
        <ignore path="Resources/layout/layout1.xml" />
        <ignore path="Resource/layout/layout2.xml" />
    </issue>
    <issue id="TooManyViews">
        <variable name="MAX_VIEW_COUNT" value="12" />
    </issue>
    <issue id="TooDeepLayout">
        <variable name="MAX_DEPTH" value="12" />
    </issue>
</configuration>

Hinweis

Derzeit sind MAX_VIEW_COUNT die einzigen Variablen (Standard: 80) und MAX_DEPTH (Standard: 10) für TooManyViews bzw TooDeepLayout . .

Die Schweregrade lauten:

  • Vorschlag
  • Info
  • Warnung
  • Fehler
  • Ignorieren

Hinzufügen einer Konfigurationsdatei

Erstellen Sie eine neue XML-Datei im Stammverzeichnis eines Android-App-Projekts. Der Name der Datei ist nicht wichtig, aber in diesem Beispiel wird verwendet AndroidLayoutDiagnostics.xml:

Neues Element hinzufügen

Nachdem die neue XML-Datei hinzugefügt wurde, sollte sie in der Projektstruktur der Android-App angezeigt werden:

Android-App-Projektstruktur

Stellen Sie sicher, dass die Buildaktion im Eigenschaftenbereich auf AndroidResourceAnalysisConfig festgelegt ist. Die einfachste Möglichkeit, den Eigenschaftenbereich für die neue Datei zu pullen, besteht darin, mit der rechten Maustaste auf die Datei zu klicken und Eigenschaften auszuwählen. Sobald der Eigenschaftenbereich angezeigt wird, sollten Sie die Buildaktion in AndroidResourceAnalysisConfig ändern:

Festlegen der Buildaktion in Elementeigenschaften

Nachdem Sie nun über eine leere XML-Datei verfügen, müssen Sie das <configuration> Stammelement hinzufügen. An diesem Punkt können Sie das Standardverhalten aller unterstützten Probleme anpassen. Wenn Sie sicherstellen möchten, dass hartcodierte Zeichenfolgen als Fehler behandelt werden, fügen Sie Folgendes hinzu:

<issue="HardcodedText" severity="error">
</issue>

Diagnosekonfigurationsdatei

Da hartcodierter Text nun als Fehler betrachtet wird, wird er nun im Layout-Editor mit einer roten Wellenlinie gekennzeichnet:

Layout mithilfe der Diagnosekonfiguration

Hinweis

Damit neue Konfigurationsdateiänderungen wirksam werden, müssen alle derzeit geöffneten Layoutdateien erneut geöffnet werden.

Problembehandlung

Hier sind einige mögliche häufige Probleme.

  • Stellen Sie sicher, dass kein XML-Formatfehler vorliegt.
  • Die Buildaktion ist ordnungsgemäß auf AndroidResourceAnalysisConfig festgelegt.

Bekannte Probleme

  • Der Fehlerblock wird erst aufgefüllt, nachdem die Datei zum ersten Mal geändert wurde.