Files
kotlin-fork/libraries/tools/kotlin-gradle-plugin-integration-tests
Sergey Igushkin 099ad8de1e Don't set Kotlin platform attribute for the default configuration
Also, fix empty configurations created for targets that have no runtime
outputs (metadata ones, especially), which could get chosen by Gradle
during dependency variant-aware resolution of a `project(...)`
dependency.

See also: d13ca38

With the attribute set, an input configuration that does not require the
Gradle's USAGE attribute but requires Kotlin platform metadata, will
fail to resolve because the attributes set on the consumable
output configurations are not subsets of each other, as follows:

> Cannot choose between the following variants of project :lib:
  - metadataApiElements
  - metadataDefault
  - metadataRuntimeElements
  All of them match the consumer attributes:
    - Variant 'metadataApiElements':
      - Found org.gradle.usage 'java-api' but wasn't required.
      - Required org.jetbrains.kotlin.platform.type 'common' and found
        compatible value 'common'.
    - Variant 'metadataDefault':
      - Required org.jetbrains.kotlin.platform.type 'common' and found
        compatible value 'common'.
    - Variant 'metadataRuntimeElements':
      - Found org.gradle.usage 'java-runtime-jars' but wasn't required.
      - Required org.jetbrains.kotlin.platform.type 'common' and found
        compatible value 'common'.

Issue #KT-26383 Fixed
2018-09-11 17:22:36 +03:00
..
2018-02-14 16:27:11 +03:00

Gradle Plugin Integration Tests

This module contains integration tests for libraries/tools/kotlin-gradle-plugin (and the subplugins mentioned there).

How to run

There are three Gradle tasks that run the tests:

  • Run all tests with the oldest possible Gradle version for each test:

    ./gradlew :kotlin-gradle-plugin-integration-tests:test
    
  • Run with the new Gradle release, choose only the tests that support this Gradle version:

    ./gradlew :kotlin-gradle-plugin-integration-tests:testAdvanceGradleVersion
    
  • Run the incremental compilation tests generated from the JPS ones

    ./gradlew :kotlin-gradle-plugin-integration-tests:testFromJps
    

The tests that use the Gradle plugins DSL (PluginsDslIT) also require the Gradle plugin marker artifacts to be installed:

./gradlew -Pdeploy_version=1.2-test :kotlin-gradle-plugin:plugin-marker:install :kotlin-noarg:plugin-marker:install :kotlin-allopen:plugin-marker:install
./gradlew -Pdeploy_version=1.2-test :kotlin-gradle-plugin-integration-tests:test

How to work with the tests

When you create a new test, figure out which Gradle versions it is supposed to run on. Then, when you instantiate a test project, specify one of:

  • project("someProjectName", GradleVersionRequired.None) or just project("someProjectName") the test can run on the whole range of the supported Gradle versions;
  • project("someProjectName", GradleVersionRequired.AtLeast("X.Y")) the test is supposed to run on Gradle version X.Y and newer (e.g. it tests integration with a Gradle feature that was released in version X.Y);
  • project("someProjectName", GradleVersionRequired.Exact("X.Y")) the test is supposed to run only with Gradle version X.Y (e.g. it tests a workaround for that version or records some special behavior that is not reproducible with newer versions).

⚠️ When your tests target multiple Gradle versions, make sure they pass when run with both tasks test and testAdvanceGradleVersion (see above). In the IDE, you can modify a test run configuration to use a Gradle task other than test.

You can check a Gradle version that the test runs with using Project.testGradleVersionAtLeast("X.Y") and Project.testGradleVersionBelow("X.Y").

Since Gradle output layouts differ from version to version, you can access classes and resources output directories using the functions that adapt to the Gradle version that is used for each test: