diff --git a/topics/tutorials/using_kotlin.md b/topics/tutorials/using_kotlin.md index 83b19864f..5b70b2a4d 100644 --- a/topics/tutorials/using_kotlin.md +++ b/topics/tutorials/using_kotlin.md @@ -97,7 +97,7 @@ See the build.gradle.kts from [kotlin_demo](%gh-sdk-samples-master% {id="kotlin-standard-library"} Since Kotlin 1.4, a dependency on the standard library _stdlib_ is added automatically ([API Docs](https://kotlinlang.org/api/latest/jvm/stdlib/)). -In nearly all cases, it is not necessary to include it in the plugin distribution as the platform already bundles it. +In nearly all cases, it is _not necessary_ to include it in the plugin distribution as the platform already bundles it. To opt out, add this line in gradle.properties: @@ -105,12 +105,29 @@ To opt out, add this line in gradle.properties: kotlin.stdlib.default.dependency = false ``` -The presence of this Gradle property is checked by the [](tools_gradle_intellij_plugin.md) with the [](tools_gradle_intellij_plugin.md#tasks-verifypluginconfiguration) task. -If the property is not present, a warning will be reported during the plugin configuration verification, -as it is a common problem when Kotlin _stdlib_ gets bundled within the plugin archive. +#### Gradle check + +The presence of this Gradle property is checked with the corresponding Gradle task: + + + + +[`verifyPlugin`](tools_intellij_platform_gradle_plugin_tasks.md#verifyPluginProjectConfiguration) task + + + + +[`verifyPluginConfiguration`](tools_gradle_intellij_plugin.md#tasks-verifypluginconfiguration) task + + + + +If the property is not present, a warning will be reported during the plugin configuration verification. To bundle _stdlib_ in the plugin distribution, specify explicitly `kotlin.stdlib.default.dependency = true`. -If a plugin supports [multiple platform versions](build_number_ranges.md), it must either target the lowest bundled _stdlib_ version +#### stdlib - Misc + +If a plugin supports [multiple platform versions](build_number_ranges.md), it must either target the lowest bundled _stdlib_ version (see table below) or the specific version must be [provided in plugin distribution](plugin_content.md#plugin-with-dependencies). See [Dependency on the standard library](https://kotlinlang.org/docs/gradle.html#dependency-on-the-standard-library) for more details.