@@ -31,8 +31,11 @@ new features before they are released. See [Early Access Preview](eap.md) for de
3131
3232## Update to a new Kotlin version
3333
34- To upgrade your project to a new release, you need to update your build script file.
35- For example, to update to Kotlin %kotlinVersion%, change the version of the Kotlin Gradle plugin in your
34+ To upgrade your project to a new release, update the Kotlin version in your build system.
35+
36+ ### Gradle
37+
38+ To update to Kotlin %kotlinVersion%, change the version of the Kotlin Gradle plugin in your
3639` build.gradle(.kts) ` file:
3740
3841<tabs group =" build-script " >
@@ -66,10 +69,43 @@ plugins {
6669</tab >
6770</tabs >
6871
69- If you have projects created with earlier Kotlin versions, change the Kotlin version in your projects and update kotlinx
70- libraries if necessary.
72+ If you have projects created with earlier Kotlin versions, check if you also need to [ update the version of any kotlinx
73+ libraries] ( gradle-configure-project.md#set-a-dependency-on-a-kotlinx-library ) .
74+
75+ If you are migrating to a new language release, the Kotlin plugin's migration tools will help you with the process.
76+
77+ > To learn more about how to work with Gradle in your project, see [ Configure a Gradle project] ( gradle-configure-project.md ) .
78+ >
79+ {style="tip"}
80+
81+ ### Maven
82+
83+ To update to Kotlin %kotlinVersion%, change the version in your ` pom.xml ` file:
7184
72- If you are migrating to the new language release, Kotlin plugin's migration tools will help you with the migration.
85+ ``` xml
86+ <properties >
87+ <kotlin .version>%kotlinVersion%</kotlin .version>
88+ </properties >
89+ ```
90+
91+ Alternatively, you can change the version of the ` kotlin-maven-plugin ` in your ` pom.xml ` file:
92+
93+ ``` xml
94+ <plugins >
95+ <plugin >
96+ <groupId >org.jetbrains.kotlin</groupId >
97+ <artifactId >kotlin-maven-plugin</artifactId >
98+ <version >%kotlinVersion%</version >
99+ </plugin >
100+ </plugins >
101+ ```
102+
103+ If you have projects created with earlier Kotlin versions, check if you also need to [ update the version of any kotlinx
104+ libraries] ( maven.md#set-dependencies ) .
105+
106+ > To learn more about how to work with Maven in your project, see [ Maven] ( maven.md ) .
107+ >
108+ {style="tip"}
73109
74110## IDE support
75111
0 commit comments