Android Gradle 플러그인 8.0.0 (2023년 4월)

Android Gradle 플러그인 8.0.0은 다양한 새 기능과 개선사항이 포함된 주요 버전입니다.

호환성

패치 출시

다음은 Android Gradle 플러그인 8.0의 패치 출시 목록입니다.

Android Gradle 플러그인 8.0.2 (2023년 5월)

AGP 8.0.2에서 수정된 버그 목록은 Android 스튜디오 2022.2.1 해결된 문제를 참고하세요.

Android Gradle 플러그인 8.0.1 (2023년 5월)

이번 소규모 업데이트는 다음과 같은 버그 수정을 포함합니다.

중단 변경사항: 모듈 수준 빌드 스크립트에 네임스페이스 필요

매니페스트 파일이 아닌 모듈 수준 build.gradle.kts 파일에서 네임스페이스를 설정해야 합니다. AGP 7.3부터 namespace DSL 속성을 사용할 수 있습니다. 자세한 내용은 네임스페이스 설정을 참고하세요.

네임스페이스 DSL로 이전할 때는 다음 문제에 유의하세요.

• 이전 버전의 AGP는 경우에 따라 기본 네임스페이스 또는 애플리케이션 ID에서 테스트 네임스페이스를 잘못 추론합니다. AGP 업그레이드 어시스턴트는 프로젝트의 기본 네임스페이스와 테스트 네임스페이스가 동일한 경우 업그레이드를 차단합니다. 업그레이드가 차단된 경우 testNamespace를 수동으로 변경하고 소스 코드를 적절하게 수정해야 합니다.
• 테스트 네임스페이스를 변경한 후 코드는 컴파일되지만 계측 테스트가 런타임에 실패할 수 있습니다. 계측 테스트 소스 코드가 androidTest 및 앱 소스 모두에 정의된 리소스를 참조하는 경우 이러한 오류가 발생할 수 있습니다.

자세한 내용은 문제 #191813691 댓글 #19를 참고하세요.

중대한 변경사항: 빌드 옵션 기본값

AGP 8.0부터 빌드 성능을 개선하기 위해 이러한 플래그의 기본값이 변경되었습니다. 이러한 변경사항 중 일부를 지원하도록 코드를 조정하는 데 도움이 필요하면 AGP 업그레이드 어시스턴트(도구 > AGP 업그레이드 어시스턴트)를 사용하세요. 업그레이드 어시스턴트는 새 동작을 수용하도록 코드를 업데이트하거나 이전 동작을 유지하도록 플래그를 설정하는 방법을 안내합니다.

중대한 변경사항: 적용된 빌드 옵션 값

AGP 8.0부터는 더 이상 이러한 플래그의 값을 변경할 수 없습니다. gradle.properties 파일에서 지정하면 값이 무시되고 AGP에서 경고를 출력합니다.

실행 프로필의 새로운 안정적인 플래그

AGP에는 새 플래그 android.settings.executionProfile가 포함됩니다. 이 플래그를 사용하여 SettingsExtension의 기본 실행 프로필을 재정의합니다. 자세한 내용은 설정 플러그인 문서를 참고하세요.

실험용 플래그를 미리 보려면 미리보기 출시 노트를 참고하세요.

Kotlin 지연 속성 할당이 지원되지 않음

빌드 스크립트에 Gradle의 Kotlin DSL을 사용하는 경우 Android 스튜디오 및 AGP 8.0은 = 연산자를 사용하는 실험용 속성 할당을 지원하지 않습니다. 이 기능에 관한 자세한 내용은 출시 노트 및 문서를 참고하세요.

빌드 분석 도구 작업 카테고리

Android 스튜디오 Flamingo부터 빌드 분석 도구에 빌드 시간에 영향을 미치는 작업을 위한 새로운 기본 보기가 있습니다. 프로젝트에서 AGP 8.0 이상을 사용하는 경우 빌드 분석 도구는 작업을 개별적으로 표시하는 대신 카테고리별로 그룹화합니다. 예를 들어 Android 리소스, Kotlin 또는 Dexing과 관련된 작업은 함께 그룹화된 후 빌드 시간별로 정렬됩니다. 이를 통해 빌드 시간에 가장 큰 영향을 미치는 카테고리를 쉽게 알 수 있습니다. 각 카테고리를 펼치면 해당하는 작업 목록이 표시됩니다. 그룹화하지 않고 태스크를 개별적으로 표시하려면 그룹 기준 드롭다운을 사용하세요.

새 설정 플러그인

AGP 8.0.0-alpha09에서는 새로운 설정 플러그인이 도입되었습니다. 설정 플러그인을 사용하면 모든 모듈에 적용되는 글로벌 구성을 한곳으로 중앙 집중화할 수 있으므로 여러 모듈에서 구성을 복사하여 붙여넣을 필요가 없습니다. 또한 설정 플러그인을 사용하여 도구 실행 프로필 또는 도구를 실행하는 방법에 관한 다양한 안내를 만들고 그 사이를 전환할 수 있습니다.

설정 플러그인을 사용하려면 settings.gradle 파일에 플러그인을 적용합니다.

apply plugin 'com.android.settings'

전역 구성 중앙화

전역 구성을 구성하려면 settings.gradle 파일에서 새 android 블록을 사용하세요. 예를 들면 다음과 같습니다.

android {
  compileSdk 31
  minSdk 28
  ...
}

도구 실행 프로필

설정 플러그인을 사용하면 일부 도구의 실행 프로필을 만들 수도 있습니다. 실행 프로필은 도구가 실행되는 방식을 결정합니다. 환경에 따라 다른 실행 프로필을 선택할 수 있습니다. 실행 프로필에서 도구의 JVM 인수를 설정하고 별도의 프로세스에서 실행되도록 구성할 수 있습니다. 현재는 R8 도구만 지원됩니다.

다음 예와 같이 실행 프로필을 만들고 settings.gradle 파일에서 기본 실행 프로필을 설정합니다.

android {
  execution {
    profiles {
      high {
        r8 {
          jvmOptions += ["-Xms2048m", "-Xmx8192m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      low {
        r8 {
          jvmOptions += ["-Xms256m", "-Xmx2048m", "-XX:+HeapDumpOnOutOfMemoryError"]
          runInSeparateProcess true
        }
      }
      ci {
        r8.runInSeparateProcess false
      }
    }
    defaultProfile "low"
  }
}

기본 프로필을 재정의하려면 gradle.properties 파일에서 android.experimental.settings.executionProfile 속성을 사용하여 다른 프로필을 선택합니다.

android.experimental.settings.executionProfile=high

명령줄을 사용하여 이 속성을 설정할 수도 있습니다. 그러면 다양한 워크플로를 설정할 수 있습니다. 예를 들어 지속적인 통합 워크플로가 있는 경우 명령줄을 사용하여 settings.gradle 파일을 변경하지 않고도 실행 프로필을 변경할 수 있습니다.

./gradlew assembleRelease \
  -Pandroid.experimental.settings.executionProfile=ci

AGP 8.0을 실행하려면 JDK 17이 필요함

Android Gradle 플러그인 8.0을 사용하여 앱을 빌드하는 경우 이제 Gradle을 실행하려면 JDK 17이 필요합니다. Android 스튜디오 Flamingo는 JDK 17을 번들로 제공하고 Gradle을 기본적으로 사용하도록 구성합니다. 즉, 대부분의 Android 스튜디오 사용자는 프로젝트 구성을 변경할 필요가 없습니다.

Android 스튜디오 내 AGP에 사용되는 JDK 버전을 수동으로 설정해야 하는 경우 JDK 17 이상을 사용해야 합니다.

Android 스튜디오와는 별개로 AGP를 사용하는 경우 JAVA_HOME 환경 변수 또는 -Dorg.gradle.java.home 명령줄 옵션을 JDK 17의 설치 디렉터리로 설정하여 JDK 버전을 업그레이드합니다.

해결된 문제

Android Gradle 플러그인 8.0.0

Android Gradle 플러그인 8.0.1

Android Gradle 플러그인 8.0.2