"Cannot add task 'wrapper' as a task with that name already exists" 오류

참고 문서

• stackoverflow: Cannot add task 'wrapper' as a task with that name already exists
• Gradle docs 5.2.1: Upgrading your build from Gradle 4.x to 5.0

이 문서의 내용

테스트 환경 및 주요 아젠다

이 프로젝트의 개발 환경

• 개발 언어 및 환경
  • OpenJDK 17.0.9
  • Gradle 6.7.1
• IDE 및 기타 환경
  • macOS Sonoma 14.1.1
  • IntelliJ IDEA 2020.3 Ultimate Edition

build.gradle 파일에서 다음 구문에서 Gradle 빌드 오류가 발생합니다. 오류 메시지는 Cannot add task 'wrapper' as a task with that name already exists입니다.

task wrapper(type: Wrapper) {
    gradleVersion = '6.7.1'
}

스크립트 수정 및 재빌드

kotlin을 사용중인 경우 문제가 발생한 구문을 다음과 같이 수정합니다.

tasks.wrapper {
    gradleVersion = '6.7.1'
}

groovy에서는 다음과 같이 수정합니다.

wrapper {
    gradleVersion = '6.7.1'
}

문제가 발생한 구문 task wrapper(type: Wrapper) { }은 Gradle 4.x에서 사용 가능합니다.

Gradle 5.x에서는 변경된 구문에 맞추어 스크립트를 수정합니다.

버전 업데이트에 따른 변경 사항은 Gradle docs 5.2.1:Upgrading your build from Gradle 4.x to 5.0을 참고합니다.

정리 및 복습

• 구문 task wrapper(type: Wrapper) { }에서 Cannot add task 'wrapper' as a task with that name already exists 오류가 발생합니다.
• 문제의 구문은 Gradle 4.x에서 사용 가능하며 Gradle 5.x부터는 다음과 같이 작성합니다.

kotlin에서는 tasks.wrapper { }을 사용합니다.

tasks.wrapper {
    gradleVersion = '6.7.1'
}

groovy에서는 wrapper { }을 사용합니다.

wrapper {
    gradleVersion = '6.7.1'
}