Sdílet prostřednictvím


Diagnostika rozložení Androidu

Diagnostika rozložení pro Android je navržená tak, aby pomohla zlepšit kvalitu souborů rozložení Androidu tím, že zvýrazní běžné problémy s kvalitou a užitečné optimalizace. Tato funkce je dostupná pro Visual Studio 16.5 nebo novější i pro Visual Studio pro Mac 8.5 nebo novější.

Výchozí sada analyzátorů je poskytována pro širokou škálu problémů a každý z nich je možné přizpůsobit tak, aby zahrnoval konkrétní potřeby projektu. Analyzátory jsou volně založené na systému lintování Androidu.

Povolení diagnostiky rozložení Androidu v sadě Visual Studio 2019

Ujistěte se, že je povolené nastavení diagnostiky rozložení, Povolit diagnostiku rozložení. Na tuto stránku možností se dostanete tak, že zvolíte Možnosti nástrojů>a pak zvolíte Rozšířený textový editor>Android XML:>

Options dialog showing how to enable diagnostics option

Po povolení se v editoru rozložení androidu zobrazí problémy:

Android diagnostics enabled on Visual Studio 2019

Funkce

Následující části popisují dostupné funkce v diagnostice rozložení Androidu.

Analyzátory

Analyzátory se používají k detekci problémů v souborech rozložení, omezení pevně zakódovaných hodnot, zlepšení výkonu a chyb příznaků. Seznam analyzátorů najdete v diagnostických analyzátorech Android Designeru.

Diagnostická konfigurace

Analyzátory je možné nakonfigurovat pomocí souboru XML, který umožňuje změnit výchozí úroveň závažnosti, ignorovat určité soubory a předávat proměnné.

Pokud máte sadu konfigurací, které chcete sdílet napříč několika aplikacemi pro Android, můžete použít základní soubor. Pokud chcete tuto funkci použít, vytvořte nový konfigurační soubor a připojte -baseline se k názvu souboru. Nejprve se použijí základní konfigurace a zbývající konfigurační soubory.

Tip

To může být užitečné, pokud chcete ignorovat sadu problémů v nové nebo existující aplikaci pro Android.

Formát je následující:

<?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>

Poznámka:

V současné době jsou MAX_VIEW_COUNT jediné proměnné (výchozí: 80) a MAX_DEPTH (výchozí: 10) pro TooManyViews a TooDeepLayout v uvedeném pořadí.

Úrovně závažnosti jsou následující:

  • Návrh
  • Informace
  • Upozorňující
  • Error
  • Ignorovat

Přidání konfiguračního souboru

V kořenovém adresáři projektu aplikace pro Android vytvořte nový soubor XML. Název souboru není důležitý, ale tento příklad používá AndroidLayoutDiagnostics.xml:

Add New Item

Po přidání nového souboru XML by se měl zobrazit ve stromu projektu aplikace pro Android:

Android App Project Tree

Ujistěte se, že je akce sestavení nastavená na AndroidResourceAnalysisConfig na panelu vlastností. Nejjednodušší způsob, jak stáhnout panel vlastností pro nový soubor, je kliknout pravým tlačítkem myši na soubor a vybrat vlastnosti. Po zobrazení panelu vlastností byste měli změnit akci sestavení na AndroidResourceAnalysisConfig:

Set Build Action in Item Properties

Teď, když máte prázdný soubor XML, musíte přidat <configuration> kořenový element. V tuto chvíli můžete upravit výchozí chování všech podporovaných problémů. Pokud chcete zajistit, aby pevně zakódované řetězce byly považovány za chyby:

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

Diagnostics Configuration File

Teď, když je pevně zakódovaný text považován za chybu, je teď označen červenou vlnovkou v editoru rozložení:

Layout using Diagnostics Configuration

Poznámka:

Aby se změny nového konfiguračního souboru projevily, je potřeba znovu otevřít všechny aktuálně otevřené soubory rozložení.

Řešení problému

Tady jsou některé možné běžné problémy.

  • Ujistěte se, že nedošlo k chybě formátu XML.
  • Akce sestavení je správně nastavena na AndroidResourceAnalysisConfig.

Známé problémy

  • Panel chyb se nenaplní, dokud se soubor poprvé nezmění.