diff --git a/docs/topics/multiplatform/multiplatform-configure-compilations.md b/docs/topics/multiplatform/multiplatform-configure-compilations.md index 764f90f8d98..dfe57fceb9d 100644 --- a/docs/topics/multiplatform/multiplatform-configure-compilations.md +++ b/docs/topics/multiplatform/multiplatform-configure-compilations.md @@ -31,42 +31,6 @@ This example configures a compiler option that is common across all targets: ```kotlin kotlin { - targets.all { - compilations.all { - compilerOptions.configure { - allWarningsAsErrors.set(true) - } - } - } -} -``` - - - - -```groovy -kotlin { - targets.all { - compilations.all { - compilerOptions.configure { - allWarningsAsErrors = true - } - } - } -} -``` - - - - -Alternatively, you can use the `compilerOptions {}` [top-level block](multiplatform-dsl-reference.md#top-level-blocks): - - - - -```kotlin -kotlin { - @OptIn(ExperimentalKotlinGradlePluginApi::class) compilerOptions { allWarningsAsErrors.set(true) } @@ -87,52 +51,14 @@ kotlin { -> The support for `compilerOptions {}` as a top-level block is [Experimental](components-stability.md#stability-levels-explained) -> and requires opt-in. It may be dropped or changed at any time. Use it only for evaluation purposes. We would appreciate -> your feedback on it in [YouTrack](https://kotl.in/issue). -> -{style="warning"} - ## Configure compilations for one target -```kotlin -kotlin { - jvm().compilations.all { - compilerOptions.configure { - jvmTarget.set(JvmTarget.JVM_1_8) - } - } -} -``` - - - - -```groovy -kotlin { - jvm().compilations.all { - compilerOptions.configure { - jvmTarget = JvmTarget.JVM_1_8 - } - } -} -``` - - - - -Alternatively, you can use the `compilerOptions {}` block at target level: - - - - ```kotlin kotlin { jvm { - @OptIn(ExperimentalKotlinGradlePluginApi::class) compilerOptions { jvmTarget.set(JvmTarget.JVM_1_8) } @@ -156,13 +82,6 @@ kotlin { -> The support for the `compilerOptions {}` block at target level is [Experimental](components-stability.md#stability-levels-explained) -> and requires opt-in. It may be dropped or changed at any time. Use it only for evaluation purposes. We would appreciate -> your feedback on it in [YouTrack](https://kotl.in/issue). -> -{style="warning"} - - ## Configure one compilation diff --git a/docs/topics/multiplatform/multiplatform-dsl-reference.md b/docs/topics/multiplatform/multiplatform-dsl-reference.md index 9320d43e89e..9ff3a0067a0 100644 --- a/docs/topics/multiplatform/multiplatform-dsl-reference.md +++ b/docs/topics/multiplatform/multiplatform-dsl-reference.md @@ -36,19 +36,13 @@ plugins { `kotlin {}` is the top-level block for multiplatform project configuration in the Gradle build script. Inside `kotlin {}`, you can write the following blocks: -| **Block** | **Description** | -|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| _<targetName>_ | Declares a particular target of a project. The names of available targets are listed in the [Targets](#targets) section. | -| `targets` | All targets of the project. | -| `presets` | All predefined targets. Use this for [configuring multiple predefined targets](#targets) at once. | -| `sourceSets` | Configures predefined and declares custom [source sets](#source-sets) of the project. | -| `compilerOptions` | Extension-level common [compiler options](gradle-compiler-options.md) that are used as defaults for all targets and shared source sets. To use it, add the following opt-in: `@OptIn(ExperimentalKotlinGradlePluginApi::class)` | - -> The support for `compilerOptions {}` as a top-level block is [Experimental](components-stability.md#stability-levels-explained) -> and requires opt-in. It may be dropped or changed at any time. Use it only for evaluation purposes. We would appreciate -> your feedback on it in [YouTrack](https://kotl.in/issue). -> -{style="warning"} +| **Block** | **Description** | +|----------------------|-----------------------------------------------------------------------------------------------------------------------------------------| +| _<targetName>_ | Declares a particular target of a project. The names of available targets are listed in the [Targets](#targets) section. | +| `targets` | All targets of the project. | +| `presets` | All predefined targets. Use this for [configuring multiple predefined targets](#targets) at once. | +| `sourceSets` | Configures predefined and declares custom [source sets](#source-sets) of the project. | +| `compilerOptions` | Extension-level common [compiler options](gradle-compiler-options.md) that are used as defaults for all targets and shared source sets. | ## Targets @@ -134,20 +128,14 @@ Each target can have one or more [compilations](#compilations). In any target block, you can use the following declarations: -| **Name** | **Description** | -|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| -| `attributes` | Attributes used for [disambiguating targets](multiplatform-set-up-targets.md#distinguish-several-targets-for-one-platform) for a single platform. | -| `preset` | The preset that the target has been created from, if any. | -| `platformType` | Designates the Kotlin platform of this target. Available values: `jvm`, `androidJvm`, `js`, `wasm`, `native`, `common`. | -| `artifactsTaskName` | The name of the task that builds the resulting artifacts of this target. | -| `components` | The components used to setup Gradle publications. | -| `compilerOptions` | The [compiler options](gradle-compiler-options.md) used for the target. This declaration overrides any `compilerOptions {}` configured at [top level](multiplatform-dsl-reference.md#top-level-blocks). To use it, add the following opt-in: `@OptIn(ExperimentalKotlinGradlePluginApi::class)` | - -> The support for `compilerOptions {}` as a common target configuration is [Experimental](components-stability.md#stability-levels-explained) -> and requires opt-in. It may be dropped or changed at any time. Use it only for evaluation purposes. We would appreciate -> your feedback on it in [YouTrack](https://kotl.in/issue). -> -{style="warning"} +| **Name** | **Description** | +|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `attributes` | Attributes used for [disambiguating targets](multiplatform-set-up-targets.md#distinguish-several-targets-for-one-platform) for a single platform. | +| `preset` | The preset that the target has been created from, if any. | +| `platformType` | Designates the Kotlin platform of this target. Available values: `jvm`, `androidJvm`, `js`, `wasm`, `native`, `common`. | +| `artifactsTaskName` | The name of the task that builds the resulting artifacts of this target. | +| `components` | The components used to setup Gradle publications. | +| `compilerOptions` | The [compiler options](gradle-compiler-options.md) used for the target. This declaration overrides any `compilerOptions {}` configured at [top level](multiplatform-dsl-reference.md#top-level-blocks). | ### JVM targets @@ -756,12 +744,8 @@ kotlin { } // Configure all compilations of all targets: - targets.all { - compilations.all { - compilerOptions.configure { - allWarningsAsErrors.set(true) - } - } + compilerOptions { + allWarningsAsErrors.set(true) } } ``` @@ -782,42 +766,6 @@ kotlin { compilations.test.runtimeDependencyFiles // get the test runtime classpath } - // Configure all compilations of all targets: - targets.all { - compilations.all { - compilerOptions.configure { - allWarningsAsErrors = true - } - } - } -} -``` - - - - -Alternatively, to configure compiler options that are common for all targets, you can use the `compilerOptions {}` [top-level block](multiplatform-dsl-reference.md#top-level-blocks): - - - - -```kotlin -kotlin { - - // Configure all compilations of all targets: - @OptIn(ExperimentalKotlinGradlePluginApi::class) - compilerOptions { - allWarningsAsErrors.set(true) - } -} -``` - - - - -```groovy -kotlin { - // Configure all compilations of all targets: compilerOptions { allWarningsAsErrors = true @@ -828,13 +776,6 @@ kotlin { -> The support for `compilerOptions {}` as a top-level block is [Experimental](components-stability.md#stability-levels-explained) -> and requires opt-in. It may be dropped or changed at any time. Use it only for evaluation purposes. We would appreciate -> your feedback on it in [YouTrack](https://kotl.in/issue). -> -{style="warning"} - - ## Dependencies The `dependencies {}` block of the source set declaration contains the dependencies of this source set.