Lint: 基本、Androidプロジェクトのための静的アナライザー

Lintとは — 静的コードアナライザー

Android Lintは、Android SDKおよびAndroid Studioに含まれる静的解析ツールです。Lintはアプリケーションのソースコードを実行せずにスキャンし、コンパイラが見逃す問題を検出します：未使用のリソース、不適切なローカライゼーション、潜在的なメモリリーク、minSdkVersionとのAPI非互換性、Googleのパフォーマンス推奨事項の違反。

静的解析は、実際のコード実行を必要としないソフトウェア検証手法です。構文と型のみをチェックするコンパイラとは異なり、静的アナライザーは論理エラー、アンチパターン、ベストプラクティスからの逸脱を探します。Lintはカテゴリ別に200以上の組み込みチェックを実行します：correctness、performance、security、accessibility、usability、I18N。

Lintは複数のレベルで動作します：XML解析はレイアウト、リソース（strings、colors、dimens）、マニフェスト、設定ファイルをチェックします。Java/Kotlin解析はソースコードを調べて、非推奨API呼び出し、スレッド問題、コンテキストリークを検出します。Gradle解析はビルド設定のバージョン互換性をチェックします。

LintがAndroidプロジェクトのコードをチェックする方法

LintチェックはAndroid Studio（Analyze > Inspect Code）またはGradleコマンドで起動します：./gradlew lint。結果はbuild/reports/lint-results.htmlフォルダのHTMLレポートとCIシステム用のXMLレポートです。Lintは各ファイルを独立して解析し、一連のルール（Issue）を適用します。各ルールには一意のID、説明、カテゴリ、重大度レベルがあります。

Lintの重大度レベル：Error（エラー — ビルドをブロック）、Warning（警告 — 品質に影響）、Informational（情報 — 参考用）、Ignore（デフォルトで無視）。レベルはlint.xmlで設定します。LintエラーはlintOptions.abortOnError trueでGradleビルドを失敗させるように設定できます。

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

Lint baseline — 現在の警告を許容可能としてマークするファイル。lint --baseline baseline.xmlコマンドで作成します。プロジェクトにbaselineを追加すると、Lintは新しい問題のみを報告します。これは数百の警告がある古いプロジェクトにLintを導入するのに便利です — チームは徐々にエラーを修正します。

設定ファイルでのLintルールの構成

lint.xml — Lintルールをカスタマイズするためのプロジェクトルートの設定ファイル。無視するルール、重大度レベル、特定のファイルやディレクトリの例外を指定します。ファイルは手動で作成され、プロジェクトのすべてのモジュールにグローバルに適用されます。lint.xmlがない場合、すべてのルールはデフォルト設定で動作します。

<?xml version="1.0" encoding="UTF-8"?>
<lint>
    <!-- 未使用リソースのチェックを無効にする -->
    <issue id="UnusedResources" severity="ignore" />

    <!-- コンテキストリークの重大度を上げる -->
    <issue id="StaticFieldLeak" severity="error" />

    <!-- 生成ファイルでは無視する -->
    <issue id="MissingTranslation" severity="ignore">
        <ignore path="build/generated" />
    </issue>
</lint>

@SuppressLint — Java/KotlinでメソッドまたはクラスレベルでLintを無効にするアノテーション。例：@SuppressLint("SetTextI18n")はTextViewに動的にテキストを設定するメソッドに使用します。@RequiresApiアノテーションはメソッドの最小APIレベルを指定します — minSdkが指定値を超える場合、Lintは警告を発行しません。

CI/CDパイプラインでのLintチェックの実行

LintのCI統合はAndroid開発における標準的なプラクティスです。./gradlew lintコマンドですべてのモジュールの解析を実行し、レポートを生成します。CI/CD設定（Jenkins、GitLab CI、GitHub Actions）では、Lintは各プルリクエストで実行されます。エラーが見つかるとビルドは失敗し、開発者はLint HTMLレポートの通知を受け取ります。

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

Lint HTMLレポートには、カテゴリ、ルールID、ファイル、行、説明とともに見つかったすべての問題の表が含まれます。レポートはCIサーバーで利用可能か、ビルド成果物として公開されます。XMLレポート（lint-results.xml）はコード解析システム（SonarQube、CodeClimate）との統合や、トラッカー（Jira、YouTrack）での自動タスク作成に使用されます。

プルリクエストでのLint — MR/PR作成時にLintが自動的に実行されるようにGitHub ActionsまたはGitLab CIを設定します。Lintがエラーを見つけた場合、CIは失敗ステータスを返し、マージはブロックされます。これにより問題のあるコードがメインブランチに入るのを防ぎ、コードベースの品質を維持します。

AndroidのLintルールの主要カテゴリ

LintカテゴリはAndroid開発のすべての側面をカバーしています。Googleはルールを12のカテゴリに分類しており、各カテゴリは特定の種類の問題を担当します。最も重要なカテゴリはCorrectness、Performance、Security、Accessibilityです。開発者はLintを効果的に使用するために、各カテゴリの主要なチェックを理解する必要があります。

パフォーマンスルールは実際に最も役立ちます。UnusedResourcesはXMLで宣言されているがコードで使用されていないリソースを検出します。ViewHolderはRecyclerViewアダプターでViewHolderパターンが使用されているかをチェックします。DrawAllocationはonDrawメソッドでのオブジェクト作成について警告します。これらの問題を修正するとAPKサイズが減少し、アプリケーションが高速化します。

セキュリティルールは公開アプリケーションに必須です。ExportedContentProviderはContentProviderが保護なしでエクスポートされているかをチェックします。WorldReadableFilesはすべてのアプリケーションがアクセス可能なファイルの作成について警告します。AllowBackupはマニフェストのallowBackupフラグをチェックします — データセキュリティのために無効にすることを推奨します。