Lint: základy, statický analyzátor pro Android projekty

Co je Lint — statický analyzátor kódu?

Android Lint — nástroj statické analýzy, který je součástí Android SDK a Android Studio. Lint skenuje zdrojový kód aplikace bez jeho spuštění a nachází problémy, které kompilátor přeskakuje: nepoužité zdroje, nesprávnou lokalizaci, potenciální úniky paměti, nekompatibilitu API s minSdkVersion a porušení doporučení Google ohledně výkonu.

Statická analýza — metoda kontroly softwaru bez skutečného spuštění kódu. Na rozdíl od kompilátoru, který kontroluje pouze syntaxi a typy, statický analyzátor hledá logické chyby, anti-vzory a odchylky od nejlepších praktik. Lint provádí více než 200 vestavěných kontrol v kategoriích: correctness, performance, security, accessibility, usability a I18N.

Lint pracuje na několika úrovních: Analýza XML kontroluje rozvržení (layout), zdroje (strings, colors, dimens), manifest a konfigurační soubory. Analýza Java/Kotlin — zdrojový kód na volání zastaralých API, problémy s vlákny a úniky kontextu. Analýza Gradle — konfiguraci sestavení na kompatibilitu verzí.

Jak Lint kontroluje kód Android projektů

Kontrola Lint se spouští přes Android Studio (Analyze > Inspect Code) nebo příkazem Gradle: ./gradlew lint. Výsledek — HTML zpráva ve složce build/reports/lint-results.html a XML zpráva pro CI systémy. Lint analyzuje každý soubor nezávisle a aplikuje sadu pravidel (Issue), z nichž každé má jedinečné ID, popis, kategorii a úroveň závažnosti.

Úrovně závažnosti Lint: Error (chyba — blokuje sestavení), Warning (upozornění — ovlivňuje kvalitu), Informational (informace — pro vědomost), Ignore (ignorováno ve výchozím nastavení). Úrovně se nastavují v lint.xml. Chyby Lint lze nastavit tak, aby sestavení Gradle při jejich výskytu selhalo pomocí lintOptions.abortOnError true.

android {
    lintOptions {
        abortOnError true
        checkAllWarnings true
        baselineFile file("lint-baseline.xml")
        htmlReport true
        xmlReport true
        lintConfig file("lint.xml")
    }
}

Lint baseline — soubor, který fixuje aktuální upozornění jako přijatelná. Vytváří se příkazem lint --baseline baseline.xml. Po přidání baseline do projektu Lint hlásí pouze nové problémy. To je užitečné pro zavedení Lint do starého projektu se stovkami upozornění — tým postupně opravuje chyby.

Nastavení pravidel Lint v konfiguračních souborech

lint.xml — konfigurační soubor v kořeni projektu pro nastavení pravidel Lint. V něm se uvádějí ignorovaná pravidla, úrovně závažnosti a výjimky pro konkrétní soubory nebo adresáře. Soubor se vytváří ručně a aplikuje se globálně na všechny moduly projektu. Bez lint.xml všechna pravidla pracují s výchozím nastavením.

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- Vypnout kontrolu nepoužitých zdrojů -->
    <issue id="UnusedResources" severity="ignore" />

    <!-- Zvýšit závažnost úniku kontextu -->
    <issue id="StaticFieldLeak" severity="error" />

    <!-- Ignorovat v generovaných souborech -->
    <issue id="MissingTranslation" severity="ignore">
        <ignore path="build/generated" />
    </issue>
</lint>

@SuppressLint — anotace pro vypnutí Lint na úrovni metody nebo třídy v Java/Kotlin. Příklad: @SuppressLint("SetTextI18n") pro metodu, kde je text dynamicky nastavován v TextView. Anotace @RequiresApi určuje minimální úroveň API pro metodu — Lint neupozorní, pokud je minSdk vyšší než zadaná hodnota.

Spuštění kontroly Lint v CI/CD pipeline

CI integrace Lint — standardní praxe ve vývoji Android. Příkaz ./gradlew lint spouští analýzu všech modulů a generuje zprávy. V konfiguraci CI/CD (Jenkins, GitLab CI, GitHub Actions) se Lint spouští při každém pull requestu. Při výskytu chyb sestavení selže a vývojář obdrží oznámení s HTML zprávou Lint.

lint-check:
  script:
    - ./gradlew lint
  artifacts:
    paths:
      - app/build/reports/lint-results.html
    when: always

HTML zpráva Lint obsahuje tabulku všech nalezených problémů s kategorií, ID pravidla, souborem, řádkem a popisem. Zpráva je k dispozici na CI serveru nebo publikována jako artefakt sestavení. XML zpráva (lint-results.xml) se používá pro integraci se systémy analýzy kódu (SonarQube, CodeClimate) a automatické vytváření úkolů v trackerech (Jira, YouTrack).

Lint v pull requestu — nakonfigurujte GitHub Actions nebo GitLab CI tak, aby se Lint spouštěl automaticky při vytvoření MR/PR. Pokud Lint najde chyby, CI vrátí stav failure a sloučení je blokováno. To zabraňuje vniknutí problematického kódu do hlavní větve a udržuje kvalitu kódové základny.

Hlavní kategorie pravidel Lint v Android

Kategorie Lint pokrývají všechny aspekty vývoje Android. Google dělí pravidla do 12 kategorií, každá zodpovědná za určitý typ problému. Nejdůležitější kategorie — Correctness, Performance, Security a Accessibility. Vývojáři stačí znát klíčové kontroly každé kategorie pro efektivní práci s Lint.

Pravidla Performance — nejužitečnější v praxi. UnusedResources nachází zdroje deklarované v XML, ale nepoužívané v kódu. ViewHolder kontroluje, zda se v adaptérech RecyclerView používá vzor ViewHolder. DrawAllocation upozorňuje na vytváření objektů v metodě onDraw. Odstranění těchto problémů snižuje velikost APK a zrychluje aplikaci.

Pravidla Security jsou povinná pro publikované aplikace. ExportedContentProvider kontroluje, zda je ContentProvider exportován bez ochrany. WorldReadableFiles upozorňuje na vytváření souborů přístupných všem aplikacím. AllowBackup kontroluje příznak allowBackup v manifestu — doporučuje se jej vypnout pro bezpečnost dat.