Files

T

Alexander.Likhachev a19bd2ed2e [Build] Migrate most of the build logic from Project.buildDir usage

It's going to be deprecated in Gradle 8.3

There's currently no way to pass a `org.gradle.api.provider.Provider` to the JavaExec.systemProperty or Test.systemProperty. There's a workaround using `org.gradle.process.CommandLineArgumentProvider`, but I intentionally don't rework these calls as Gradle is going to allow passing providers to configure system properties: https://github.com/gradle/gradle/issues/12247#issuecomment-1568427242
^KTI-1473 In Progress

2023-12-07 18:31:06 +00:00

src/test

[stdlib-mpp] Change path to the new stdlib artifact in BCV and JdkApi tests

2023-08-03 14:47:20 +00:00

build.gradle.kts

[Build] Migrate most of the build logic from Project.buildDir usage

2023-12-07 18:31:06 +00:00

ReadMe.md

…

ReadMe.md

Verifies that a library compiled with a newer JDK is compatible with older JDK API

Currently, the project only checks kotlin-reflect for JDK 1.6 compatibility. The check is necessary to make sure applications using kotlin-reflect can run on older Android devices.

How to run

Run from the root directory of the kotlin project:

./gradlew :tools:jdk-api-validator:test

How to interpret the result

Successful completion of the test task means the checked libraries are compatible with JDK 1.6 API. In case of failure, the exact location and name of the violating API references are logged as error.

An example of validation error:

[ERROR] /kotlin/libraries/reflect/build/libs/kotlin-reflect-1.9.255-SNAPSHOT.jar:kotlin/reflect/jvm/internal/ComputableClassValue.class:47: Undefined reference: void ClassValue.<init>()

How to fix a failure

If the violating reference can be desugared by R8 or its execution is prevented on Android platform, the error can be suppressed. See suppressAnnotations and undefinedReferencesToIgnore in JdkApiUsageTest.kt. Otherwise, the API should be avoided.

To check if an API can be desugared by R8:

Identify the earliest R8 version that supports current Kotlin version here.
Download the R8 version jar artifact from Google's maven repository here.
Run it using the BackportedMethodList entry point, e.g., java -cp r8-8.0.40.jar com.android.tools.r8.BackportedMethodList.
Check if the violating API reference is in the printed list of methods.

Also, you can get the list of backported methods the downloaded version supports for a given Android API level:

$ java -cp r8-8.0.40.jar com.android.tools.r8.BackportedMethodList --help
Usage: BackportedMethodList [options]
 Options are:
  --output <file>         # Output result in <file>.
  --min-api <number>      # Minimum Android API level for the application
  --desugared-lib <file>  # Desugared library configuration (JSON from the
                          # configuration)
  --lib <file>            # The compilation SDK library (android.jar)
  --version               # Print the version of BackportedMethodList.
  --help                  # Print this message.