Diagnostika rozložení pro Android

Diagnostika rozložení pro Android je navržená tak, aby pomáhala vylepšit kvalitu souborů rozložení pro Android 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 a Visual Studio pro Mac 8.5 nebo více.

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

Povolení diagnostiky rozložení pro Android na Visual Studio 2019

Ujistěte se, že je povolené nastavení diagnostiky rozložení Povolit diagnostiku rozložení. Na tuto stránku možností se můžete dostat tak, žezvolíte Možnosti nástrojů a pak zvolíte Textový editorAndroid XMLAdvanced:

Dialogové okno Možnosti, které ukazuje, jak povolit možnost diagnostiky

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

Diagnostika Androidu povolená na Visual Studio 2019

Funkce

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

Analyzátory

Analyzátory pomáhají detekovat problémy v souborech rozložení, omezit pevně zakódované hodnoty, zlepšit výkon a označit chyby. Seznam analyzátorů najdete v tématu Diagnostické analyzátory Android Designeru.

Konfigurace diagnostiky

Analyzátory lze konfigurovat pomocí souboru XML, což vám umožní změnit výchozí úroveň závažnosti, ignorovat určité soubory a předat proměnné.

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

Tip

To může být užitečné, pokud chcete ignorovat sadu problémů u nové nebo existující aplikace 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

Aktuálně jsou jediné proměnné MAX_VIEW_COUNT (výchozí: 80) MAX_DEPTH a (výchozí hodnota je 10) pro proměnné a TooManyViewsTooDeepLayout .

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

  • Návrh
  • Informace
  • Upozornění
  • Chyba
  • Ignorovat

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

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

Přidat novou položku

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í na panelu vlastností nastavená na AndroidResourceAnalysisConfig. Nejjednodušší způsob, jak vyžádat panel vlastností nového souboru, je kliknout pravým tlačítkem na soubor a vybrat vlastnosti. Jakmile se zobrazí panel vlastností, měli byste akci sestavení změnit naAndroidResourceAnalysisConfig:

Nastavení akce sestavení ve vlastnostech položky

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 se s pevnými řetězci zachází jako s chybami, přidejte:

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

Konfigurační soubor diagnostiky

Když je teď pevný text považován za chybu, je teď v editoru rozložení označen červenouquiggle:

Rozložení s využitím konfigurace diagnostiky

Poznámka

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

Řešení potíží

Tady je několik možných běžných problémů.

  • Ujistěte se, že neexistuje žádná chyba formátu XML.
  • Akce sestavení je správně nastavená na AndroidResourceAnalysisConfig.

Známé problémy

  • Panel chyb se naplní až po první změně souboru.