Skip to content

Latest commit

 

History

History
61 lines (34 loc) · 3.1 KB

ReadMe.md

File metadata and controls

61 lines (34 loc) · 3.1 KB
Raw

Kotlin Libraries

This area of the project is all written in Kotlin and assumes you've got the Kotlin IDEA plugin installed.

This area of the project uses Gradle and Maven for its build. When you open this project directory in IDEA the first time, it suggests you to import both gradle and maven projects. After importing you'll be able to explore and run gradle tasks and maven goals directly from IDEA with the instruments on the right sidebar.

Building

You need to install a recent Maven distribution and setup environment variables as following:

JAVA_HOME="path to JDK 1.8"
JDK_16="path to JDK 1.6"
JDK_17="path to JDK 1.7"
JDK_18="path to JDK 1.8"

The main part of the Kotlin standard library, kotlin-stdlib, is compiled against JDK 1.6 and also there are two extensions for the standard library, kotlin-stdlib-jdk7 and kotlin-stdlib-jdk8, which are compiled against JDK 1.7 and 1.8 respectively, so you need to have all these JDKs installed.

Be sure to build Kotlin compiler distribution before launching Gradle and Maven: see root ReadMe.md, section "Building".

Core libraries are built with gradle, you can run that build using the gradle wrapper script even without local gradle installation:

./gradlew build install

Note: on Windows type gradlew without the leading ./

This command executes the build task, which assembles the artifacts and run the tests, and the install task, which puts the artifacts to the local maven repository to be used by the subsequent maven build.

The rest of tools and libraries are built with maven:

mvn install

If your maven build is failing with Out-Of-Memory errors, set JVM options for maven in MAVEN_OPTS environment variable like this:

MAVEN_OPTS="-Xmx2G"

Gradle Plugin

The Gradle plugin sources can be found at the kotlin-gradle-plugin module.

To install the Gradle plugin into the local Maven repository, run inside the root Kotlin project:

./gradlew :kotlin-gradle-plugin:install

The subplugin modules are :kotlin-allopen, :kotlin-noarg, :kotlin-sam-with-receiver. To install them, run:

./gradlew :kotlin-allopen:install :kotlin-noarg:install :kotlin-sam-with-receiver:install

Gradle integration tests

Gradle integration tests can be found at the kotlin-gradle-plugin-integration-tests module.

Run the integration tests from the root project:

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

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