AGP(Android Gradle Plugin)이란?

AGP란?

AGP(Android Gradle Plugin)는 Android 앱을 빌드하기 위한 Gradle 플러그인이다.

 

주요 역할

  - Android 프로젝트 빌드: Java/Kotlin 코드 컴파일, 리소스 처리, DEX 변환, APK/AAB 생성
  - Android SDK 통합: Android SDK 도구들과 연동
  - 빌드 설정 관리: build.gradle의 android { } 블록 제공
  - 멀티 모듈 지원: app, library 모듈 관리

버전별 주요 변화

  - AGP 7.x: package 속성과 namespace 공존 가능 (경고만)
  - AGP 8.0+: namespace 필수, package 속성 사용 시 빌드 실패
  - AGP 8.0+: Java 17 필수, Gradle 8.0+ 필수

  AGP 버전별 BuildConfig 생성 정책

AGP 버전	BuildConfig 생성 정책	buildConfigField 필요 여부
4.2 이하	항상 자동 생성	불필요 (자동 생성)
7.0~7.3	기본값으로 생성	불필요 (기본 생성)
7.4.0+	buildConfigField가 있을 때만 생성	필수
8.0+	buildFeatures { buildConfig = true } 명시 필요	필수