Gradle 플러그인 변형 지원

Gradle 7.0에서는 Gradle 플러그인 개발자를 위한 새로운 기능인 플러그인 변형을 도입했습니다. 이 기능은 최신 Gradle 기능에 대한 지원을 쉽게 추가하면서도 이전 Gradle 버전과의 호환성을 유지할 수 있도록 합니다. Gradle의 변형 선택에 대해 자세히 알아보세요.

Gradle 플러그인 변형을 통해 Kotlin 팀은 다양한 Gradle 버전에 맞춰 다른 Kotlin Gradle 플러그인(KGP) 변형을 제공할 수 있습니다. 목표는 Gradle의 가장 오래된 지원 버전에 해당하는 main 변형에서 기본 Kotlin 컴파일을 지원하는 것입니다. 각 변형은 해당 릴리스의 Gradle 기능에 대한 구현을 포함할 것입니다. 최신 변형은 최신 Gradle 기능 세트를 지원할 것입니다. 이 접근 방식을 통해 제한된 기능으로 이전 Gradle 버전에 대한 지원을 확장할 수 있습니다.

현재 Kotlin Gradle 플러그인의 변형은 다음과 같습니다.

변형 이름	해당 Gradle 버전
main	7.6.0–7.6.3
gradle80	8.0–8.0.2
gradle81	8.1.1
gradle82	8.2.1–8.4
gradle85	8.5 and higher

향후 Kotlin 릴리스에서는 더 많은 변형이 추가될 것입니다.

빌드가 어떤 변형을 사용하는지 확인하려면 --info 로그 레벨을 활성화하고 출력에서 Using Kotlin Gradle plugin으로 시작하는 문자열을 찾아보세요. 예를 들어, Using Kotlin Gradle plugin main variant와 같습니다.

문제 해결

NOTE

Gradle의 변형 선택과 관련된 몇 가지 알려진 문제에 대한 해결 방법은 다음과 같습니다.

• pluginManagement의 ResolutionStrategy가 다중 변형 플러그인에 대해 작동하지 않음

• 플러그인이 buildSrc 공통 종속성으로 추가될 때 플러그인 변형이 무시됨

Gradle이 사용자 정의 구성에서 KGP 변형을 선택할 수 없음

Gradle이 사용자 정의 구성에서 KGP 변형을 선택할 수 없는 것은 예상된 상황입니다. 사용자 정의 Gradle 구성을 사용하는 경우:

Kotlin

configurations.register("customConfiguration") {
    // ...
}

Groovy

configurations.register("customConfiguration") {
    // ...
}

그리고 Kotlin Gradle 플러그인에 대한 종속성을 추가하려는 경우, 예를 들어:

Kotlin

dependencies {
    customConfiguration("org.jetbrains.kotlin:kotlin-gradle-plugin:2.1.21")
}

Groovy

dependencies {
    customConfiguration 'org.jetbrains.kotlin:kotlin-gradle-plugin:2.1.21'
}

customConfiguration에 다음 속성을 추가해야 합니다:

Kotlin

configurations {
    customConfiguration {
        attributes {
            attribute(
                Usage.USAGE_ATTRIBUTE,
                project.objects.named(Usage.class, Usage.JAVA_RUNTIME)
            )
            attribute(
                Category.CATEGORY_ATTRIBUTE,
                project.objects.named(Category.class, Category.LIBRARY)
            )
            // If you want to depend on a specific KGP variant:
            attribute(
                GradlePluginApiVersion.GRADLE_PLUGIN_API_VERSION_ATTRIBUTE,
                project.objects.named("7.0")
            )
        }
    }
}

Groovy

configurations {
    customConfiguration {
        attributes {
            attribute(
                Usage.USAGE_ATTRIBUTE,
                project.objects.named(Usage, Usage.JAVA_RUNTIME)
            )
            attribute(
                Category.CATEGORY_ATTRIBUTE,
                project.objects.named(Category, Category.LIBRARY)
            )
            // If you want to depend on a specific KGP variant:
            attribute(
                GradlePluginApiVersion.GRADLE_PLUGIN_API_VERSION_ATTRIBUTE,
                project.objects.named('7.0')
            )
        }
    }
}

그렇지 않으면 다음과 유사한 오류가 발생합니다:

 > Could not resolve all files for configuration ':customConfiguration'.
      > Could not resolve org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.0.
        Required by:
            project :
         > Cannot choose between the following variants of org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.0:
             - gradle70RuntimeElements
             - runtimeElements
           All of them match the consumer attributes:
             - Variant 'gradle70RuntimeElements' capability org.jetbrains.kotlin:kotlin-gradle-plugin:1.7.0:
                 - Unmatched attributes:

다음 단계는 무엇인가요?

Gradle의 기본 및 세부 사항에 대해 자세히 알아보세요.