You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/topics/configure-build-for-eap.md
+3-3
Original file line number
Diff line number
Diff line change
@@ -6,7 +6,7 @@ You only need to configure your build manually for existing projects — project
6
6
7
7
To configure your build to use the EAP version of Kotlin, you need to:
8
8
9
-
* Specify the EAP version of Kotlin. Available EAP versions are listed [here](eap.md#build-details).
9
+
* Specify the EAP version of Kotlin. [Available EAP versions are listed here](eap.md#build-details).
10
10
* Change the versions of dependencies to EAP ones.
11
11
The EAP version of Kotlin may not work with the libraries of the previously released version.
12
12
@@ -25,7 +25,7 @@ This section describes how you can:
25
25
### Adjust the Kotlin version
26
26
27
27
In the `plugins` block within `build.gradle(.kts)`, change the `KOTLIN-EAP-VERSION` to the actual EAP version,
28
-
such as `%kotlinEapVersion%`. Available EAP versions are listed [here](eap.md#build-details).
28
+
such as `%kotlinEapVersion%`. [Available EAP versions are listed here](eap.md#build-details).
29
29
30
30
Alternatively, you can specify the EAP version in the `pluginManagement` block in `settings.gradle(.kts)` – see [Gradle documentation](https://docs.gradle.org/current/userguide/plugins.html#sec:plugin_version_management) for details.
31
31
@@ -93,7 +93,7 @@ dependencies {
93
93
## Configure in Maven
94
94
95
95
In the sample Maven project definition, replace `KOTLIN-EAP-VERSION` with the actual version, such as `%kotlinEapVersion%`.
96
-
Available EAP versions are listed [here](eap.md#build-details).
96
+
[Available EAP versions are listed here](eap.md#build-details).
See the [documentation](type-aliases.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/type-aliases.md) for more details.
123
+
See the [type aliases documentation](type-aliases.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/type-aliases.md) for more details.
124
124
125
125
### Bound callable references
126
126
@@ -171,7 +171,7 @@ fun main(args: Array<String>) {
Read the [documentation](destructuring-declarations.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/destructuring-in-parameters.md) for more details.
199
+
Read the [destructuring declarations documentation](destructuring-declarations.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/destructuring-in-parameters.md) for more details.
200
200
201
201
### Underscores for unused parameters
202
202
@@ -290,7 +290,7 @@ fun main(args: Array<String>) {
290
290
291
291
You can also mark the entire property as `inline` - then the modifier is applied to both accessors.
292
292
293
-
Read the [documentation](inline-functions.md#inline-properties) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/inline-properties.md) for more details.
293
+
Read the [inline functions documentation](inline-functions.md#inline-properties) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/inline-properties.md) for more details.
294
294
295
295
### Local delegated properties
296
296
@@ -348,7 +348,7 @@ class MyUI {
348
348
The `provideDelegate` method will be called for each property during the creation of a `MyUI` instance, and it can perform
349
349
the necessary validation right away.
350
350
351
-
Read the [documentation](delegated-properties.md) for more details.
351
+
Read the [delegated properties documentation](delegated-properties.md) for more details.
352
352
353
353
### Generic enum value access
354
354
@@ -391,7 +391,7 @@ In Kotlin 1.1, you can restrict that, so that only methods defined on the implic
391
391
will be available inside the lambda passed to `td`. You do that by defining your annotation marked with the `@DslMarker` meta-annotation
392
392
and applying it to the base class of the tag classes.
393
393
394
-
Read the [documentation](type-safe-builders.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/scope-control-for-implicit-receivers.md) for more details.
394
+
Read the [type safe builders documentation](type-safe-builders.md) and [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/scope-control-for-implicit-receivers.md) for more details.
Learn more about [Kotlin functional interfaces and SAM conversions](fun-interfaces.md).
41
+
[Learn more about Kotlin functional interfaces and SAM conversions](fun-interfaces.md).
42
42
43
43
### Explicit API mode for library authors
44
44
@@ -102,7 +102,7 @@ with the value `strict` or `warning`.
102
102
-Xexplicit-api={strict|warning}
103
103
```
104
104
105
-
For more details about the explicit API mode, see the [KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/explicit-api-mode.md).
105
+
[Find more details about the explicit API mode in the KEEP](https://github.com/Kotlin/KEEP/blob/master/proposals/explicit-api-mode.md).
106
106
107
107
### Mixing named and positional arguments
108
108
@@ -572,7 +572,7 @@ In 1.4.0, we've added a new mode for generating default methods: `-Xjvm-default=
572
572
interfaces to `default` Java methods. For compatibility with the code that uses the interfaces compiled without `default`,
573
573
we also added `all-compatibility` mode.
574
574
575
-
For more information about default methods in the Java interop, see the [documentation](java-to-kotlin-interop.md#default-methods-in-interfaces) and
575
+
For more information about default methods in the Java interop, see the [interoperability documentation](java-to-kotlin-interop.md#default-methods-in-interfaces) and
576
576
[this blog post](https://blog.jetbrains.com/kotlin/2020/07/kotlin-1-4-m3-generating-default-methods-in-interfaces/).
577
577
578
578
### Unified exception type for null checks
@@ -631,10 +631,10 @@ On the JS platform, Kotlin 1.4.0 provides the following improvements:
631
631
632
632
The `kotlin.js` Gradle plugin comes with an adjusted Gradle DSL, which provides a number of new configuration options and is more closely aligned to the DSL used by the `kotlin-multiplatform` plugin. Some of the most impactful changes include:
633
633
634
-
- Explicit toggles for the creation of executable files via `binaries.executable()`. Read more about the executing Kotlin/JS and its environment [here](js-project-setup.md#execution-environments).
635
-
- Configuration of webpack's CSS and style loaders from within the Gradle configuration via `cssSupport`. Read more about using them [here](js-project-setup.md#css).
636
-
- Improved management for npm dependencies, with mandatory version numbers or [semver](https://docs.npmjs.com/misc/semver#versions) version ranges, as well as support for _development_, _peer_, and _optional_ npm dependencies using `devNpm`, `optionalNpm` and `peerNpm`. Read more about dependency management for npm packages directly from Gradle [here](js-project-setup.md#npm-dependencies).
637
-
- Stronger integrations for [Dukat](https://github.com/Kotlin/dukat), the generator for Kotlin external declarations. External declarations can now be generated at build time, or can be manually generated via a Gradle task. Read more about how to use the integration [here](js-external-declarations-with-dukat.md).
634
+
- Explicit toggles for the creation of executable files via `binaries.executable()`. Read more about the [executing Kotlin/JS and its environment here](js-project-setup.md#execution-environments).
635
+
- Configuration of webpack's CSS and style loaders from within the Gradle configuration via `cssSupport`. Read more about [using CSS and style loaders here](js-project-setup.md#css).
636
+
- Improved management for npm dependencies, with mandatory version numbers or [semver](https://docs.npmjs.com/misc/semver#versions) version ranges, as well as support for _development_, _peer_, and _optional_ npm dependencies using `devNpm`, `optionalNpm` and `peerNpm`. [Read more about dependency management for npm packages directly from Gradle here](js-project-setup.md#npm-dependencies).
637
+
- Stronger integrations for [Dukat](https://github.com/Kotlin/dukat), the generator for Kotlin external declarations. External declarations can now be generated at build time, or can be manually generated via a Gradle task. [Read more about how to use the integration here](js-external-declarations-with-dukat.md).
638
638
639
639
### New JS IR backend
640
640
@@ -653,11 +653,11 @@ kotlin {
653
653
}
654
654
```
655
655
656
-
For more detailed information about how to configure the Kotlin/JS IR compiler backend, check out the [documentation](js-ir-compiler.md).
656
+
For more detailed information about how to configure the new backend, check out the [Kotlin/JS IR compiler documentation](js-ir-compiler.md).
657
657
658
658
With the new [@JsExport](js-to-kotlin-interop.md#jsexport-annotation) annotation and the ability to **[generate TypeScript definitions](js-ir-compiler.md#preview-generation-of-typescript-declaration-files-d-ts) from Kotlin code**, the Kotlin/JS IR compiler backend improves JavaScript & TypeScript interoperability. This also makes it easier to integrate Kotlin/JS code with existing tooling, to create **hybrid applications** and leverage code-sharing functionality in multiplatform projects.
659
659
660
-
Learn more about the available features in the Kotlin/JS IR compiler backend in the [documentation](js-ir-compiler.md).
660
+
[Learn more about the available features in the Kotlin/JS IR compiler backend](js-ir-compiler.md).
661
661
662
662
## Kotlin/Native
663
663
@@ -695,7 +695,7 @@ queryData(id: 17) { result, error in
695
695
}
696
696
```
697
697
698
-
For more information about using suspending functions in Swift and Objective-C, see the [documentation](native-objc-interop.md).
698
+
[Learn more about using suspending functions in Swift and Objective-C](native-objc-interop.md).
699
699
700
700
### Objective-C generics support by default
701
701
@@ -713,7 +713,7 @@ kotlin {
713
713
}
714
714
```
715
715
716
-
Please note that all specifics and limitations listed in the [documentation](native-objc-interop.md#generics) are still valid.
716
+
Please note that all specifics and limitations listed in the [documentation on interoperability with Objective-C](native-objc-interop.md#generics) are still valid.
717
717
718
718
### Exception handling in Objective-C/Swift interop
719
719
@@ -745,7 +745,7 @@ kotlin {
745
745
}
746
746
```
747
747
748
-
For more information about crash report symbolication, see the [documentation](native-ios-symbolication.md).
748
+
[Learn more about crash report symbolication](native-ios-symbolication.md).
749
749
750
750
### Performance improvements
751
751
@@ -789,7 +789,7 @@ Depending on your needs, you can add dependencies between:
789
789
Complete the initial configuration, and when you add a new dependency to `cocoapods`, just re-import the project in IntelliJ IDEA.
790
790
The new dependency will be added automatically. No additional steps are required.
791
791
792
-
Learn [how to add dependencies](native-cocoapods.md).
792
+
[Learn how to add dependencies](native-cocoapods.md).
793
793
794
794
## Kotlin Multiplatform
795
795
@@ -906,7 +906,7 @@ native targets. This can help you share more native code without being limited b
906
906
No additional steps are required – everything is done automatically. IntelliJ IDEA will help you detect common declarations
907
907
that you can use in the shared code.
908
908
909
-
Learn more about [usage of platform-dependent libraries](mpp-share-on-platforms.md#use-native-libraries-in-the-hierarchical-structure).
909
+
[Learn more about usage of platform-dependent libraries](mpp-share-on-platforms.md#use-native-libraries-in-the-hierarchical-structure).
910
910
911
911
### Specifying dependencies only once
912
912
@@ -953,7 +953,7 @@ addressed later.
953
953
If you need a dependency only for a specific platform, you can still use platform-specific variants of standard and kotlinx
954
954
libraries with such suffixes as `-jvm` or` -js`, for example `kotlinx-coroutines-core-jvm`.
955
955
956
-
Learn more about [configuring dependencies](gradle.md#configuring-dependencies).
956
+
[Learn more about configuring dependencies](gradle.md#configuring-dependencies).
957
957
958
958
## Gradle project improvements
959
959
@@ -976,7 +976,7 @@ For platform-specific source sets, the corresponding platform-specific variant o
976
976
library is added to the rest. The Kotlin Gradle plugin will select the appropriate JVM standard library depending on
977
977
the `kotlinOptions.jvmTarget`[compiler option](gradle.md#compiler-options) of your Gradle build script.
978
978
979
-
Learn how to [change the default behavior](gradle.md#dependency-on-the-standard-library).
979
+
[Learn how to change the default behavior](gradle.md#dependency-on-the-standard-library).
980
980
981
981
### Minimum Gradle version for Kotlin projects
982
982
@@ -1339,7 +1339,7 @@ In 1.4.0, we have added new features to improve your experience with delegated p
1339
1339
Aside from the new API, we've made some optimizations that reduce the resulting bytecode size. These optimizations are
1340
1340
described in [this blog post](https://blog.jetbrains.com/kotlin/2019/12/what-to-expect-in-kotlin-1-4-and-beyond/#delegated-properties).
1341
1341
1342
-
For more information about delegated properties, see the [documentation](delegated-properties.md).
1342
+
[Learn more about delegated properties](delegated-properties.md).
0 commit comments