問題

Android Studioでアプリをビルドすると、以下のようなエラーが発生しました。

Build Type 'debug' contains custom BuildConfig fields, but the feature is disabled.
To enable the feature, add the following to your module-level build.gradle:
android.buildFeatures.buildConfig true

このエラーは、build.gradle 内でBuildConfigにカスタムフィールドを追加しようとした際に、buildConfig機能が無効になっているために発生します。

このエラーの原因と解決方法を解説します。

エラーの原因

Android Gradle Plugin (AGP) 8 以降では、buildConfig機能がデフォルトで無効になっています。
つまり、カスタムBuildConfigフィールドを使用すると、エラーが発生します。

例えば、以下のようにbuild.gradle (Module: app)にbuildConfigFieldを追加している場合、このエラーが発生します。

android {
    buildTypes {
        debug {
            buildConfigField "String", "API_URL", "\"https://api.example.com\""
        }
    }
}

このエラーを解決するためには、buildConfig機能を有効にする必要があります。

解決策

1. buildConfigを有効にする

build.gradle (Module: app)を開き、以下の設定を追加してください。

android {
    buildFeatures {
        buildConfig true
    }
}

2. Gradle Syncを実行

設定を追加した後、Android Studioの「Sync Project with Gradle Files」を実行し、build.gradleの変更を反映します。

3. プロジェクトをリビルド

次に、プロジェクトをリビルドします。

• メニューから Build → Rebuild Project を実行
• または、ターミナルで以下のコマンドを実行

  ./gradlew clean
  ./gradlew build
  

これでエラーが解消されました。