Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/topics/home.topic
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
<cards narrow="false">
<title>Featured topics</title>
<a href="whatsnew23.md" summary="New experimental and stable features, performance improvements, and bug fixes">What's new in Kotlin 2.3.0</a>
<a href="releases.md" summary="The latest Kotlin releases and instructions on how to update to them">Kotlin releases</a>
<a href="releases.md" summary="Learn about the Kotlin release cycle and history">Kotlin release process</a>
<a href="https://kotlinlang.org/api/latest/jvm/stdlib/" summary="Living essentials for everyday work with Kotlin: IO, files, threading, collections, and much more">Standard library API reference</a>
<a href="types-overview.md" summary="Kotlin type system: numbers, strings, arrays, and other built-in types">Types overview</a>
<a href="collections-overview.md" summary="Collections: lists, sets, and maps">Collections</a>
Expand Down
16 changes: 9 additions & 7 deletions docs/topics/releases.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,15 @@
[//]: # (title: Kotlin releases)
[//]: # (title: Kotlin release process)

<web-summary>Learn about the different types of Kotlin releases, how to update to each one, and Kotlin's release history.</web-summary>

<tldr>
<p>Latest Kotlin version: <strong>%kotlinVersion%</strong></p>
<p>See <a href="%kotlinLatestWhatsnew%">What's new in Kotlin 2.3.0</a> <!--and find the bug fix details in the <a href="%kotlinLatestUrl%">changelog</a>-->.</p>
</tldr>

This page explains the Kotlin release cycle and the different types of releases we ship. It also includes details
about past and upcoming Kotlin releases, along with instructions on how to update to a specific release.

Since Kotlin 2.0.0, we ship the following types of releases:

* _Language releases_ (2._x_._0_) that bring major changes in the language and include tooling updates. Released once in 6 months.
Expand All @@ -13,12 +18,9 @@ Since Kotlin 2.0.0, we ship the following types of releases:
Released in 3 months after corresponding _language release_.
* _Bug fix releases_ (2._x_._yz_) that include bug fixes for _tooling releases_. There is no exact release schedule for these releases.

<!-- TODO: uncomment with 2.1.0 release
> For example, for the feature release 1.8.0, we had only one tooling release 1.8.20,
> and several bugfix releases including 1.8.21, 1.8.22.
> For example, for the language release 2.2.0, there was only one tooling release 2.2.20 and one bugfix release 2.2.21.
>
{style="tip"}
-->

For each language and tooling release, we also ship several preview (_EAP_) versions for you to try
new features before they are released. See [Early Access Preview](eap.md) for details.
Expand Down Expand Up @@ -134,9 +136,9 @@ Learn more about K2 mode in [our blog](https://blog.jetbrains.com/idea/2025/04/k

Learn more about [types of Kotlin releases and their compatibility](kotlin-evolution-principles.md#language-and-tooling-releases)

## Release details
## Release history

The following table lists details of the latest Kotlin releases:
The following table lists details of previous Kotlin releases:

> You can also try [Early Access Preview (EAP) versions of Kotlin](eap.md#build-details).
>
Expand Down
4 changes: 4 additions & 0 deletions docs/topics/whatsnew/whatsnew-eap.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,10 @@ _[Released: %kotlinEapReleaseDate%](eap.md#build-details)_

The Kotlin %kotlinEapVersion% release is out! See the full list of changes in the [GitHub changelog](https://github.com/JetBrains/kotlin/releases/tag/v%kotlinEapVersion%).

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## IDE support

The Kotlin plugins that support %kotlinEapVersion% are bundled in the latest versions of IntelliJ IDEA and Android Studio.
Expand Down
6 changes: 6 additions & 0 deletions docs/topics/whatsnew/whatsnew11.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
[//]: # (title: What's new in Kotlin 1.1)

<web-summary>Read the Kotlin 1.1 release notes covering new language features, updates to Kotlin/JVM, and JS, and build tool support for Gradle and Maven.</web-summary>

_Released: 15 February 2016_

## Table of contents
Expand All @@ -10,6 +12,10 @@ _Released: 15 February 2016_
* [JVM backend](#jvm-backend)
* [JavaScript backend](#javascript-backend)

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## JavaScript

Starting with Kotlin 1.1, the JavaScript target is no longer considered experimental. All language features are supported,
Expand Down
6 changes: 6 additions & 0 deletions docs/topics/whatsnew/whatsnew12.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
[//]: # (title: What's new in Kotlin 1.2)

<web-summary>Read the Kotlin 1.2 release notes covering new language features, updates to Kotlin Multiplatform, JVM, and JS, and build tool support for Gradle and Maven.</web-summary>

_Released: 28 November 2017_

## Table of contents
Expand All @@ -10,6 +12,10 @@ _Released: 28 November 2017_
* [JVM backend](#jvm-backend)
* [JavaScript backend](#javascript-backend)

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Multiplatform projects (experimental)

Multiplatform projects are a new **experimental** feature in Kotlin 1.2, allowing you to reuse code between target platforms
Expand Down
6 changes: 6 additions & 0 deletions docs/topics/whatsnew/whatsnew13.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,13 @@
[//]: # (title: What's new in Kotlin 1.3)

<web-summary>Read the Kotlin 1.3 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_Released: 29 October 2018_

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Coroutines release

After some long and extensive battle testing, coroutines are now released! It means that from Kotlin 1.3 the language
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew14.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
[//]: # (title: What's new in Kotlin 1.4.0)

_[Released: 17 August 2020](releases.md#release-details)_
<web-summary>Read the Kotlin 1.4.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 17 August 2020](releases.md#release-history)_

In Kotlin 1.4.0, we ship a number of improvements in all of its components, with the [focus on quality and performance](https://blog.jetbrains.com/kotlin/2020/08/kotlin-1-4-released-with-a-focus-on-quality-and-performance/).
Below you will find the list of the most important changes in Kotlin 1.4.0.

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language features and improvements

Kotlin 1.4.0 comes with a variety of different language features and improvements. They include:
Expand Down
7 changes: 6 additions & 1 deletion docs/topics/whatsnew/whatsnew1420.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,17 @@
[//]: # (title: What's new in Kotlin 1.4.20)

_[Released: 23 November 2020](releases.md#release-details)_
<web-summary>Read the Kotlin 1.4.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 23 November 2020](releases.md#release-history)_

Kotlin 1.4.20 offers a number of new experimental features and provides fixes and improvements for
existing features, including those added in 1.4.0.

You can also learn about new features with more examples in [this blog post](https://blog.jetbrains.com/kotlin/2020/11/kotlin-1-4-20-released/).

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Kotlin/JVM

Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1430.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,18 @@
[//]: # (title: What's new in Kotlin 1.4.30)

_[Released: 3 February 2021](releases.md#release-details)_
<web-summary>Read the Kotlin 1.4.30 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 3 February 2021](releases.md#release-history)_

Kotlin 1.4.30 offers preview versions of new language features, promotes the new IR backend of the Kotlin/JVM compiler to
Beta, and ships various performance and functional improvements.

You can also learn about new features in [this blog post](https://blog.jetbrains.com/kotlin/2021/02/kotlin-1-4-30-released/).

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language features

Kotlin 1.5.0 is going to deliver new language features – JVM records support, sealed interfaces, and Stable inline classes.
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew15.md
Original file line number Diff line number Diff line change
@@ -1,12 +1,18 @@
[//]: # (title: What's new in Kotlin 1.5.0)

_[Released: 5 May 2021](releases.md#release-details)_
<web-summary>Read the Kotlin 1.5.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 5 May 2021](releases.md#release-history)_

Kotlin 1.5.0 introduces new language features, stable IR-based JVM compiler backend, performance improvements,
and evolutionary changes such as stabilizing experimental features and deprecating outdated ones.

You can also find an overview of the changes in the [release blog post](https://blog.jetbrains.com/kotlin/2021/05/kotlin-1-5-0-released/).

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language features

Kotlin 1.5.0 brings stable versions of the new language features presented for [preview in 1.4.30](whatsnew1430.md#language-features):
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1520.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[//]: # (title: What's new in Kotlin 1.5.20)

_[Released: 24 June 2021](releases.md#release-details)_
<web-summary>Read the Kotlin 1.5.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 24 June 2021](releases.md#release-history)_

Kotlin 1.5.20 has fixes for issues discovered in the new features of 1.5.0, and it also includes various tooling improvements.

Expand All @@ -9,6 +11,10 @@ and this video:

<video src="https://www.youtube.com/v/SV8CgSXQe44" title="Kotlin 1.5.20"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Kotlin/JVM

Kotlin 1.5.20 is receiving the following updates on the JVM platform:
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1530.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[//]: # (title: What's new in Kotlin 1.5.30)

_[Released: 24 August 2021](releases.md#release-details)_
<web-summary>Read the Kotlin 1.5.30 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 24 August 2021](releases.md#release-history)_

Kotlin 1.5.30 offers language updates including previews of future changes, various improvements in platform support and tooling, and new standard library functions.

Expand All @@ -14,6 +16,10 @@ You can also find a short overview of the changes in the [release blog post](htt

<video src="https://www.youtube.com/v/rNbb3A9IdOo" title="Kotlin 1.5.30"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language features

Kotlin 1.5.30 is presenting previews of future language changes and bringing improvements to the opt-in requirement mechanism
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew16.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,17 @@
[//]: # (title: What's new in Kotlin 1.6.0)

_[Released: 16 November 2021](releases.md#release-details)_
<web-summary>Read the Kotlin 1.6.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 16 November 2021](releases.md#release-history)_

Kotlin 1.6.0 introduces new language features, optimizations and improvements to existing features, and a lot of improvements to the Kotlin standard library.

You can also find an overview of the changes in the [release blog post](https://blog.jetbrains.com/kotlin/2021/11/kotlin-1-6-0-is-released/).

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language

Kotlin 1.6.0 brings stabilization to several language features introduced for preview in the previous 1.5.30 release:
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1620.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,19 @@
[//]: # (title: What's new in Kotlin 1.6.20)

_[Released: 4 April 2022](releases.md#release-details)_
<web-summary>Read the Kotlin 1.6.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 4 April 2022](releases.md#release-history)_

Kotlin 1.6.20 reveals previews of the future language features, makes the hierarchical structure the default for multiplatform projects, and brings evolutionary improvements to other components.

You can also find a short overview of the changes in this video:

<video src="https://www.youtube.com/v/8F19ds109-o" title="What's new in Kotlin 1.6.20"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Language

In Kotlin 1.6.20, you can try two new language features:
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew17.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
[//]: # (title: What's new in Kotlin 1.7.0)

<web-summary>Read the Kotlin 1.7.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

<tldr>
<p>The IDE support for Kotlin 1.7.0 is available for IntelliJ IDEA 2021.2, 2021.3, and 2022.1.</p>
</tldr>

_[Released: 9 June 2022](releases.md#release-details)_
_[Released: 9 June 2022](releases.md#release-history)_

Kotlin 1.7.0 has been released. It unveils the Alpha version of the new Kotlin/JVM K2 compiler, stabilizes language
features, and brings performance improvements for the JVM, JS, and Native platforms.
Expand All @@ -26,6 +28,10 @@ You can also find a short overview of the changes in this video:

<video src="https://www.youtube.com/v/54WEfLKtCGk" title="What's new in Kotlin 1.7.0"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## New Kotlin K2 compiler for the JVM in Alpha

This Kotlin release introduces the **Alpha** version of the new Kotlin K2 compiler. The new compiler aims to speed up
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1720.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
[//]: # (title: What's new in Kotlin 1.7.20)

<web-summary>Read the Kotlin 1.7.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

<tldr>
<p>The IDE support for Kotlin 1.7.20 is available for IntelliJ IDEA 2021.3, 2022.1, and 2022.2.</p>
</tldr>

_[Released: 29 September 2022](releases.md#release-details)_
_[Released: 29 September 2022](releases.md#release-history)_

The Kotlin 1.7.20 release is out! Here are some highlights from this release:

Expand All @@ -17,6 +19,10 @@ You can also find a short overview of the changes in this video:

<video src="https://www.youtube.com/v/OG9npowJgE8" title="What's new in Kotlin 1.7.20"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## Support for Kotlin K2 compiler plugins

The Kotlin team continues to stabilize the K2 compiler.
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew18.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[//]: # (title: What's new in Kotlin 1.8.0)

_[Released: 28 December 2022](releases.md#release-details)_
<web-summary>Read the Kotlin 1.8.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and build tool support for Gradle and Maven.</web-summary>

_[Released: 28 December 2022](releases.md#release-history)_

The Kotlin 1.8.0 release is out and here are some of its biggest highlights:

Expand All @@ -11,6 +13,10 @@ The Kotlin 1.8.0 release is out and here are some of its biggest highlights:
* [Improved Objective-C/Swift interoperability](#improved-objective-c-swift-interoperability)
* [Compatibility with Gradle 7.3](#gradle)

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## IDE support

The Kotlin plugin that supports 1.8.0 is available for:
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew1820.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[//]: # (title: What's new in Kotlin 1.8.20)

_[Released: 25 April 2023](releases.md#release-details)_
<web-summary>Read the Kotlin 1.8.20 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>

_[Released: 25 April 2023](releases.md#release-history)_

The Kotlin 1.8.20 release is out and here are some of its biggest highlights:

Expand All @@ -17,6 +19,10 @@ You can also find a short overview of the changes in this video:

<video src="https://www.youtube.com/v/R1JpkpPzyBU" title="What's new in Kotlin 1.8.20"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## IDE support

The Kotlin plugins that support 1.8.20 are available for:
Expand Down
8 changes: 7 additions & 1 deletion docs/topics/whatsnew/whatsnew19.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
[//]: # (title: What's new in Kotlin 1.9.0)

_[Release date: July 6, 2023](releases.md#release-details)_
<web-summary>Read the Kotlin 1.9.0 release notes covering new language features, updates to Kotlin Multiplatform, JVM, Native, JS, and Wasm, and build tool support for Gradle and Maven.</web-summary>

_[Release date: July 6, 2023](releases.md#release-history)_

The Kotlin 1.9.0 release is out and the K2 compiler for the JVM is now in **Beta**. Additionally, here are some of the main highlights:

Expand All @@ -19,6 +21,10 @@ You can also find a short overview of the updates in this video:

<video src="https://www.youtube.com/v/fvwTZc-dxsM" title="What's new in Kotlin 1.9.0"/>

> For information about the Kotlin release cycle, see [Kotlin release process](releases.md).
>
{style="tip"}

## IDE support

The Kotlin plugins that support 1.9.0 are available for:
Expand Down
Loading