Kotlin 2.4.20 の新機能
バグ修正リリース 2.4.21 の詳細については、チェンジログを参照してください
Kotlin 2.4.20 がリリースされました!リリースのハイライトは以下の通りです:
- 標準ライブラリ: コルーチンのスタックトレース復旧のサポート、コレクション要素の等価性と一意性をチェックする新しい関数、
kotlin.testアサーション関数の新しいオーバーロード - Kotlin/Native: 新しい Swift エクスポート機能、インクリメンタルコンパイルの改善、SwiftPM 依存関係向けの
Package.swiftファイルの自動生成 - Kotlin/Wasm:
@JsFun宣言内のトップレベルrequire()呼び出しの変更、コンパニオンオブジェクトの初期化順序の改善、Kotlin Gradle プラグインにおける Wasmtime のサポート、新しいコンパイルモード、ファンクショナルインターフェースのバイナリサイズ削減 - Kotlin/JS: ブラウザテスト用の新しい DSL、suspend ラムダを async 関数としてエクスポートするサポート、データクラスのエクスポート性の改善
- Gradle: Gradle 9.7.0 のサポートと Problems API におけるレポート機能の改善
- ビルドツール API (Build tools API): 新しいターゲット(Kotlin/JS、Kotlin/Wasm、Kotlin メタデータ)のサポート
- Kotlin コンパイラー:
kotlinrランナーコマンドと独立したネイティブイメージ
アップデートの概要は以下の動画でもご確認いただけます:
Kotlin のリリースサイクルに関する詳細については、Kotlin のリリースプロセスを参照してください。
Kotlin 2.4.20 へのアップデート
Kotlin の最新バージョンは、IntelliJ IDEA および Android Studio の最新バージョンに含まれています。
新しい Kotlin バージョンにアップデートするには、IDE が最新バージョンに更新されていることを確認し、ビルドスクリプトで Kotlin のバージョンを 2.4.20 に変更してください。
新機能
Kotlin 2.2.20 では、JVM 21 以降で invokedynamic を使用して when 式をコンパイルする実験的サポートが導入されました。
Kotlin 2.4.20 では、この機能が安定版 (Stable)へと昇格し、デフォルトで有効になりました。
詳細については、ドキュメントを参照してください。
新機能
本リリースでは、Beta、Alpha、および Experimental ステータスのものを含む、以下の安定版前の機能が利用可能です:
- 標準ライブラリ: コルーチンのスタックトレース復旧のサポート
- 標準ライブラリ: コレクション要素の等価性と一意性をチェックする新しい関数
- 標準ライブラリ:
kotlin.testアサーション関数の新しいオーバーロード - Kotlin/Native: 新しい Swift エクスポート機能
- Kotlin/Native:
klibアーティファクトのインクリメンタルコンパイルの改善 - Kotlin/JS: ブラウザテスト用の新しい DSL
- Kotlin/JS: suspend ラムダを async 関数としてエクスポートするサポート
- ビルドツール API: Kotlin/JS、Kotlin/Wasm、Kotlin メタデータのサポート
- Kotlin コンパイラー: 独立したネイティブイメージ
標準ライブラリ (Standard library)
Kotlin 2.4.20 では、コルーチンのスタックトレース復旧のサポートが追加されたほか、コレクション要素の等価性や一意性をチェックする新しい関数、および kotlin.test アサーション関数の新しいオーバーロードが導入されました。
コルーチンのスタックトレース復旧のサポート
Kotlin 2.4.20 では、標準ライブラリに StackTraceRecoverable インターフェースが追加されました。これにより、kotlinx.coroutines への依存関係を追加することなく、スタックトレース復旧(stack trace recovery)のために新しい例外インスタンスを作成する方法を定義できるようになり、kotlinx.coroutines ライブラリとの統合が向上します。
スタックトレース復旧は、あるコルーチンが例外をスローし、別のコルーチンがそれを再スローする場合のデバッグに役立ちます。例外がどこで発生し、別のコルーチンがどこでそれを再スローしたかを確認できるようになります。
kotlinx.coroutines ライブラリは、追加のコルーチンスタックトレース情報を含む新しい例外インスタンスを作成することで、スタックトレース復旧を実行します。これは、例外メッセージのみ、原因(cause)のみ、両方、または引数を取らないコンストラクタを持つ例外に対して自動的に行われます。
行番号やエラーコードなど、例外コンストラクタに追加の必須引数がある場合は、StackTraceRecoverable インターフェースを実装して、kotlinx.coroutines ライブラリがその例外の新しいインスタンスをどのように作成するかを定義します。
このインターフェースを実装するには、copyForStackTraceRecovery() 関数をオーバーライドします。オーバーライド内では、スタックトレース復旧用の新しい例外インスタンスを返すか、kotlinx.coroutines ライブラリに例外をコピーさせたくない場合は null を返します。
StackTraceRecoverable インターフェースはすべてのターゲットで利用可能ですが、kotlinx.coroutines ライブラリがスタックトレース復旧に使用するのは JVM 上のみです。
これらの API は実験的 (Experimental)であり、@OptIn(ExperimentalStdlibCoroutineSupportApi::class) アノテーションによるオプトインが必要です。
以下は、スタックトレース復旧用に新しいインスタンスを作成する際に line プロパティを保持するカスタム例外の例です:
import kotlin.coroutines.ExperimentalStdlibCoroutineSupportApi
import kotlin.coroutines.debug.StackTraceRecoverable
@OptIn(ExperimentalStdlibCoroutineSupportApi::class)
class FileEditException
// IllegalStateException コンストラクタに cause を渡すために、
// この実装にはプライベートコンストラクタが必要です
private constructor(
val line: Int,
private val detail: String,
cause: Throwable?,
) : IllegalStateException("When editing line $line: $detail", cause),
// スタックトレース復旧のために StackTraceRecoverable を実装します
StackTraceRecoverable<FileEditException> {
constructor(line: Int, detail: String) : this(line, detail, null)
// 行番号とメッセージの詳細をコピーします
override fun copyForStackTraceRecovery(): FileEditException =
FileEditException(line, detail, this)
}
fun main() {
val original = FileEditException(15, "Unexpected token")
// 通常、その動作をテストする場合を除き、この関数を直接呼び出す必要はありません
// kotlinx.coroutines ライブラリがスタックトレース復旧中に自動的に呼び出します
val copy = original.copyForStackTraceRecovery()
println(copy.message)
// When editing line 15: Unexpected token
println(copy.cause == original)
// true
}詳細については、この機能の KEEP を参照してください。
フィードバックは YouTrack にお寄せいただければ幸いです。
コレクション要素の等価性と一意性をチェックする新しい関数
Kotlin 2.4.20 より前は、コレクションの要素がすべて異なるか、あるいはすべて等しいかをチェックしたい場合、非効率なコードパターンを使用する必要がありました。
Kotlin 2.4.20 では、このギャップを埋めるための実験的な関数が導入されました:
| 関数 | チェック内容 |
|---|---|
allDistinct() | コレクション内のすべての値が一意である。 |
allDistinctBy() | すべてのオブジェクトが、選択されたプロパティに対して一意な値を持っている。 |
allEqual() | コレクション内のすべての値が同一である。 |
allEqualBy() | すべてのオブジェクトが、選択されたプロパティに対して同じ値を持っている。 |
これらの関数は、コレクション、シーケンス、配列で使用できます。他のコレクション操作と同様に、構造的等価性(structural equality)を使用して要素を比較します。
これらの関数は実験的 (Experimental)であり、@OptIn(ExperimentalStdlibApi::class) アノテーションまたは -opt-in=kotlin.ExperimentalStdlibApi コンパイラーオプションによるオプトインが必要です:
@OptIn(ExperimentalStdlibApi::class)
fun main() {
data class Response(
val participantId: String,
val answer: String,
val responseDate: String
)
val responses = listOf(
Response("P001", "Yes", "2026-07-21"),
Response("P002", "Maybe", "2026-07-21"),
Response("P003", "No", "2026-07-21")
)
// すべての参加者が同じ回答をしたかどうかをチェック
println(responses.allEqualBy { it.answer })
// false
// 重複した参加者がいるかどうかをチェック
println(responses.allDistinctBy { it.participantId })
// true
// すべての回答が同じ日付に送信されたかどうかをチェック
println(responses.allEqualBy { it.responseDate })
// true
val answers = responses.map { it.answer }
// 回答が同一かどうかをチェック
println(answers.allEqual())
// false
// 回答がすべて異なるかどうかをチェック
println(answers.allDistinct())
// true
}フィードバックは KEEP のディスカッション にお寄せいただければ幸いです。
`kotlin.test` アサーション関数の新しいオーバーロード
Kotlin 2.4.20 では、kotlin.test アサーション関数の新しいオーバーロードが追加されました。これらは、アサーションが失敗したときにのみ遅延してエラーメッセージを生成するラムダを受け取ります。
以前は、assertTrue() や assertEquals() などの kotlin.test アサーション関数は、アサーションが成功してメッセージが実際には使用されない場合でも、すべてのアサーション実行時に構築される事前フォーマット済みのエラーメッセージのみを受け取っていました。
新しいオーバーロードは kotlin.test API を JUnit 5 と整合させ、プレーンな文字列の代わりにラムダを介してメッセージサプライヤーを受け取ります。これにより、特にアサーションの詳細なエラーメッセージを生成する Power-assert コンパイラープラグイン においてパフォーマンスが向上します。
新しいオーバーロードは以下の各アサーション関数で利用可能です:
| 関数 | 説明 |
|---|---|
assertTrue() / assertFalse() | 値が true または false であるかをチェックします。 |
assertEquals() / assertNotEquals() | 値が等しいか等しくないかをチェックします。 |
assertSame() / assertNotSame() | 値が同じインスタンスを参照しているかをチェックします。 |
assertIs() / assertIsNot() | 値が指定された型であるかをチェックします。assertIs() の場合、関数はその型にスマートキャストします。 |
assertNull() | 値が null であるかをチェックします。 |
assertContains() | 要素(キー、文字、部分文字列、または正規表現)がコレクション、配列、シーケンス、範囲、またはマップ内に存在するかをチェックします。 |
assertContentEquals() | コレクション、シーケンス、または配列に、同じ順序で等しい要素が含まれているかをチェックします。 |
新しい API を使用するには、@OptIn(ExperimentalKotlinTestApi::class) アノテーションで明示的にオプトインしてください:
import kotlin.test.ExperimentalKotlinTestApi
import kotlin.test.assertEquals
import kotlin.test.assertTrue
@OptIn(ExperimentalKotlinTestApi::class)
fun testValues(actual: Int, expected: Int, items: List<String>) {
// メッセージはアサーションが失敗した場合にのみ構築されます
assertTrue(actual > 0) { "Expected a positive value but got $actual" }
// アサーションが失敗しない限り、リストのフォーマットを回避します
assertEquals(expected, actual) { "Unexpected value for items: ${items.joinToString()}" }
}詳細については、この機能の KEEP を参照してください。
Kotlin/Native
Kotlin 2.4.20 では、Kotlin Multiplatform プロジェクトにおける SwiftPM 依存関係向けの Package.swift ファイルの自動生成、sealed クラスや言語間継承のサポートを含む新しい Swift エクスポート機能、およびインクリメンタルコンパイルの改善が導入されました。
SwiftPM 依存関係向けの生成された Package.swift
SwiftPM パッケージに依存する XCFramework をエクスポートする場合、正しく解決できるように生成された SwiftPM パッケージを公開する必要があります。これを支援するため、assembleSharedXCFramework Gradle タスクが XCFramework と一緒に配布される Package.swift ファイルを生成するようになりました。
詳細については、SwiftPM エクスポートのページを参照してください。
新しい Swift エクスポート機能
Sealed クラス
Kotlin 2.4.20 では、Swift エクスポートに sealed クラスおよびインターフェースのサポートが追加されました。
以前は、sealed 型に対するすべての switch 文に default ケースを記述する必要がありました。Kotlin で定義された sealed 階層が Swift の enum にマッピングされるようになり、Xcode で完全な自動補完を伴う網羅的な(exhaustive)switch 文が可能になりました。
Swift エクスポートは、各 sealed 型に sealedType() メソッドを生成します。このメソッドは、sealed 階層の直接のサブクラスに一致するケースを持つ Swift の enum を返します。これらの呼び出しをネストして、階層のより深いレベルに一致させることもできます。
例えば、Kotlin でクラス階層を持つ sealed インターフェースを宣言します:
// Kotlin
sealed interface Shape
class Circle : Shape {
override fun toString(): String = "Circle"
}
class Rectangle : Shape {
override fun toString(): String = "Rectangle"
}
fun createCircle(): Shape = Circle()Swift 側では、default ケースなしで網羅的な switch を使用できます:
// Swift
let shape = createCircle()
let name = switch shape.sealedType() {
case let .circle(type): "It's a \(type.value)"
case let .rectangle(type): "It's a \(type.value)"
}
// name == "It's a Circle"switch が網羅的であるため、sealed 階層に新しいサブクラスが追加された場合、コンパイラーが警告を発します。そのため、default ケースに頼るのではなく、すぐに対処することができます。
Swift エクスポートにおける言語間継承
Kotlin 2.4.20 では、Swift エクスポートにおける言語間継承(cross-language inheritance)のサポートが導入されました。
この機能の一般的なユースケースはリバースインポート (reverse import) パターンです。このパターンでは、Kotlin でコントラクトを定義し、Swift 側でプラットフォーム固有の実装を提供します。これは、Kotlin に直接インポートできない純粋な Swift ライブラリを使用する必要がある場合に特に役立ちます。
このパターンを実装するには、Swift 実装が継承するための Kotlin スーパークラスと、Kotlin インターフェースを宣言します。次に、Swift でこのインターフェースを実装し、そのインターフェースを受け取る Kotlin 関数に Swift オブジェクトを渡します。 例えば、CryptoKit ライブラリの場合:
Kotlin 側で、インターフェース、それを受け取る関数、および
openなベースクラスを宣言します:kotlin// Kotlin interface CryptoProvider { fun hashMD5(input: String): String } fun processHash(provider: CryptoProvider, input: String): String = provider.hashMD5(input) open class SwiftBaseSwift 側で、エクスポートされた
SwiftBaseクラスを継承し、純粋な Swift ライブラリを使用してインターフェースを実装し、そのオブジェクトを Kotlin に渡します:swift// Swift import CryptoKit final class IosCryptoProvider: SwiftBase, CryptoProvider { func hashMD5(input: String) -> String { guard let data = input.data(using: .utf8) else { return "failed" } return Insecure.MD5.hash(data: data).description } } let provider = IosCryptoProvider() // Kotlin 関数を呼び出し、それが Swift 側の hashMD5() を呼び出します print(processHash(provider: provider, input: "Hello, world!"))
Kotlin が Swift オブジェクトを受け取ると、通常のインターフェースの実装として扱い、Swift コードを直接呼び出します。
Swift エクスポートの詳細については、ドキュメントを参照してください。
`klib` アーティファクトのインクリメンタルコンパイルの改善
Kotlin 2.4.20 では、klib アーティファクトのインクリメンタルコンパイルに安定化の改善が施され、ベータ版 (Beta) になりました。
この最適化は Kotlin 1.9.20 で初めて導入され、デバッグビルドのコンパイル時間を大幅に短縮することが実証されました。それ以降、多くのバグ修正とパフォーマンス改善を行ってきました。
インクリメンタルコンパイルを試すには、gradle.properties ファイルに次のオプションを追加します:
kotlin.incremental.native=true現在フィードバックを積極的に収集しており、今後の Kotlin リリースですべてのプロジェクトに対してインクリメンタルコンパイルをデフォルトで有効にする予定です。問題が発生した場合は、課題トラッカー に報告してください。
Kotlin/Wasm
Kotlin 2.4.20 では、Kotlin/Wasm が @JsFun 宣言内のトップレベル require() 呼び出しを処理する方法が変更され、コンパニオンオブジェクトの初期化順序が JVM の動作と整合され、ファンクショナルインターフェースのバイナリサイズが削減され、新しいコンパイルモードが導入され、Kotlin Gradle プラグインにおける wasmWasi ターゲットのランタイムとして Wasmtime のサポートが追加されました。
@JsFun 宣言内のトップレベル require() 呼び出しの変更
Kotlin/Wasm は、@JsFun 宣言がトップレベルの require() 関数を使用している場合にエラーを報告するようになりました。
以前は、コンパイラーが import-object.mjs ファイル内に require 変数を生成していたため、@JsFun 宣言から require() を呼び出すことが可能でした。
この動作は意図せずコンパイラーの実装詳細を公開してしまっていました。これからの移行を支援するため、Kotlin/Wasm はこの生成された require 宣言を削除し、コンパイラーはそのような呼び出しに対してエラーを報告するようになりました。例えば:
// エラーを報告します
@JsFun("(mod) => require(mod)")
external fun loadModule(mod: String): JsAnyこの変更に備えるため、@JsFun 宣言内のトップレベル require() 呼び出しを @JsModule アノテーションに置き換えてください:
@JsModule("module")
external val module: Module
external interface Module {
// 期待されるモジュールメンバーを定義します
}動的なモジュール読み込みには、代わりに import() 式を使用してください。webpack が動的インポートを解析しないように、/* webpackIgnore: true */ マジックコメントを追加します:
@JsFun("""
((module) => () => module)(
await import(/* webpackIgnore: true */ "module")
)
""")
private external fun loadModuleDynamically(): JsAny?import() 式を条件付きで使用することもできます。例えば、Node.js で実行されている場合にのみモジュールを読み込むことができます:
@JsFun("""
((module) => () => module)(
((typeof process !== "undefined") && (process.release.name === "node"))
? await import(/* webpackIgnore: true */ "module")
: null
)
""")
private external fun loadNodeModule(): JsAny?プロジェクトがトップレベルの require() 関数を必要とする依存関係に依存している場合は、回避策としてそれを globalThis のプロパティとして追加します:
@JsFun("""
((module) => {
globalThis.require = module.default.createRequire(import.meta.url)
return () => {}
})(await import("node:module"))
""")
external fun defineRequire()問題が発生した場合は、課題トラッカー でフィードバックを共有してください。
コンパニオンオブジェクトの初期化順序の改善
Kotlin/Wasm は、JVM の動作に合わせて、サブクラスのコンパニオンオブジェクトよりも前にスーパークラスのコンパニオンオブジェクトを初期化するようになりました。以前は初期化が逆になることがあり、プラットフォーム間で不整合な動作が発生していました。
このアップデートにより、クロスプラットフォームの一貫性が向上し、クラスの初期化動作におけるプラットフォーム固有の差異が減少します。また、中間クラスがコンパニオンオブジェクトを宣言していない場合を含め、より深い継承階層におけるコンパニオンオブジェクトの初期化も正しく処理できるようになります。
Kotlin Gradle プラグインにおける Wasmtime のサポート
Kotlin 2.4.20 では、Kotlin Gradle プラグインにおける wasmWasi ターゲットのランタイムとして Wasmtime のサポートが導入されました。
以前は、wasmWasi ターゲットは Node.js ランタイムのみをサポートしており、WASI アプリケーションを実行するには JavaScript のブートストラップが必要でした。Wasmtime のサポートにより、スタンドアロンの WebAssembly ランタイム上で Kotlin/Wasm アプリケーションを実行できるようになりました。
wasmWasi ターゲットのランタイムとして Wasmtime を使用するには、Gradle ビルドファイルに wasmtime() を追加します:
kotlin {
wasmWasi {
wasmtime()
}
}フィードバックは YouTrack にお寄せいただければ幸いです。
新しいコンパイルモード
Kotlin 2.4.20 では、新しいマルチモジュールモードを含む Kotlin/Wasm コンパイルモードを選択できるようになりました。以前は、コンパイラーはモノリス(monolith)コンパイルモードを使用していました。これは、プロジェクトとその依存関係を一緒にコンパイルし、単一のバイナリを生成するモードです。これにより、コンパイラーはデッドコード削除を実行し、最も小さい出力を生成できます。
以下のコンパイルモードのいずれかを選択できるようになりました:
| コンパイルモード | コンパイル | 出力 | 最適化の動作 |
|---|---|---|---|
monolith (デフォルト) | プロジェクトとその依存関係をまとめてコンパイルします。 | 単一のバイナリ | 到達不能な宣言を削除し、依存関係を含むプログラム全体に対して最適化を適用します。 |
multimodule-open-world | 各モジュールを個別にコンパイルし、変更されたモジュールのみを再コンパイルします。 | モジュールごとに独立した個別のバイナリ | モジュール間の最適化は適用されないため、バイナリサイズは大きくなります。 |
multimodule-closed-world | 1 回の呼び出しですべてのモジュールを処理し、変更されたモジュールのみを再コンパイルします。 | 相互に依存する個別のバイナリ | 到達不能な宣言は削除されますが、各 Wasm バイナリは個別に最適化されます。 |
コンパイルモードを選択するには、gradle.properties ファイルに kotlin.wasm.compilationMode プロパティを追加します:
kotlin.wasm.compilationMode=multimodule-open-worldまた、開発ビルドにはクローズドワールド(closed-world)マルチモジュールコンパイルを使用し、本番ビルドにはモノリスコンパイルを使用するように Kotlin/Wasm を設定することもできます。これにより、開発中の再コンパイル時間を短縮しつつ、本番ビルドでは最小の出力を生成できます。
この構成を使用するには、gradle.properties ファイルに次のプロパティを追加します:
kotlin.wasm.compilationMode=multimodule-closed-world-only-in-devフィードバックは YouTrack にお寄せいただければ幸いです。
ラムダとファンクショナルインターフェースのバイナリサイズ削減
Kotlin 2.4.20 では、Kotlin/Wasm がラムダとファンクショナルインターフェース(functional interface)をコンパイルする方法が変更されました。 個別の匿名クラスを生成する代わりに、コンパイラーが関数を生成し、共通のベースクラスを使用するようになりました。
KotlinConf アプリケーション を使用したテストでは、この変更によって Wasm バイナリサイズが約 5〜10% 削減されることが示されています。
この変更により動的な呼び出しが増加するため、実行時パフォーマンスに影響を与える可能性があります。 問題が発生した場合は、課題トラッカー に報告してください。
Kotlin/JS
Kotlin 2.4.20 では、データクラスのエクスポート性の改善、ブラウザテスト用の新しい実験的 DSL の導入、suspend ラムダを JavaScript の async 関数としてエクスポートするサポートの追加が行われました。
エクスポートされたデータクラスにおける合成関数のエクスポート性の一貫性
Kotlin 2.4.20 では、データクラスのプロパティに @JsExport.Ignore アノテーションが適切に適用されない問題が修正されました。
以前は、データクラスに @JsExport アノテーションを付けた場合、自動生成される copy() および componentN() 関数の影響で、データクラスのエクスポート性に関する警告がコンパイラーによって報告されていました。これは、コンストラクタとプロパティが @JsExport.Ignore で明示的に無視対象としてマークされていた場合でも発生していました。
例えば、JavaScript にエクスポートされる Session データクラスがあり、エクスポート対象外の内部型 DatabaseConnection への参照も持っている場合を考えます:
// Kotlin
// JavaScript にエクスポートされない内部型
class DatabaseConnection
@JsExport
data class Session @JsExport.Ignore constructor(
val userId: String,
@JsExport.Ignore val connection: DatabaseConnection,
)この問題が修正されたため、コンパイラーは @JsExport.Ignore アノテーションを考慮するようになり、Session の合成関数である copy() および componentN() がエクスポートされていない型 DatabaseConnection に関する警告をトリガーしなくなりました。これは、@ConsistentCopyVisibility および @ExposedCopyVisibility アノテーション によって導入された可視性ルールと整合します。
ブラウザテスト用の新しい DSL
Kotlin 2.4.20 では、ブラウザ環境で Kotlin/JS テストを実行するための新しい実験的 DSL が導入されました。
現在、Kotlin Gradle プラグインはさまざまなブラウザ間で JavaScript テストを実行するためのブラウザランチャーとして Karma を使用しています。Karma プロジェクトはすでに 2 年間非推奨(deprecated)となっており、ブラウザテストをサポートするための代替手段を模索してきました。
新しい DSL は、内部で様々なツールを管理する Karma を置き換えることを目的としており、以下を含んでいます:
- Chromium、Firefox、WebKit (Safari) の各ブラウザエンジンをサポートするブラウザドライバーおよびディストリビューションマネージャーとしての Playwright。
- テストランナーとしての Mocha。
- バンドラーとしての webpack(将来のリリース で Vite に置き換えられる予定です)。
ブラウザテスト用の新しい DSL を試すには、Kotlin/JS ターゲットの browser {} 内にオプトインの test {} ブロックを追加します:
import org.jetbrains.kotlin.gradle.ExperimentalJsTestDsl
import kotlin.time.Duration.Companion.seconds
kotlin {
js {
browser {
// 新しい test {} ブロックを追加して設定します
@OptIn(ExperimentalJsTestDsl::class)
test {
// すべてのランナーに対するデフォルトのタイムアウトを設定
timeout = 2.seconds
// Gradle プロバイダーを使用してヘッドレスモードを設定
headless = providers
.environmentVariable("IS_IN_CI")
.map { it.toBoolean() }
.orElse(false)
// Chromium テストランナーを有効化して設定
chromium {
// 共通のタイムアウトオプションを上書き
timeout = 5.seconds
// 追加の起動引数を追加
launchArgs.add("--no-sandbox")
}
// Firefox テストランナーを有効化
firefox()
// WebKit テストランナーを有効化
webkit()
// 追加の WebKit テストランナーを有効化して設定
webkit("noheadless") {
// カスタムオプションをセットアップ
headless = false
}
}
}
}
}ブラウザテスト用の新しい DSL は活発に開発中です。フィードバックは YouTrack にお寄せいただければ幸いです。
詳細については、Kotlin/JS でのテスト実行 を参照してください。
suspend ラムダを async 関数としてエクスポートするサポート
Kotlin 2.4.20 では、suspend ラムダ式 を JavaScript の async 関数としてエクスポートできるようになりました。
以前は、Kotlin/JS ライブラリから suspend ラムダを含む宣言をエクスポートする方法がありませんでした。Kotlin コンパイラーが Kotlin の suspend 関数と JavaScript ネイティブの async/await モデルの間のブリッジを自動的に処理するようになり、Kotlin と TypeScript が混在するコードベースで有用になります。
この機能を有効にするには、build.gradle.kts ファイルに次のコンパイラーオプションを追加します:
kotlin {
js {
compilations.all {
compileTaskProvider.configure {
compilerOptions {
freeCompilerArgs.add("-Xsuspend-lambda-exporting")
}
}
}
}
}その後、関連する宣言を @JsExport でマークします:
// Kotlin
@JsExport
class TaskRunner {
suspend fun runTask(task: suspend () -> String): String {
return task()
}
}TypeScript 側からは、suspend ラムダは通常の async 関数として見えます:
// TypeScript
import { TaskRunner } from "..."
const runner = new TaskRunner();
const result = await runner.runTask(async () => "done");
console.log(result); // "done"@JsExport アノテーションの詳細については、ドキュメント を参照してください。
Gradle
Kotlin 2.4.20 は、Gradle 7.6.3 から 9.7.0 までと完全な互換性があります。最新の Gradle リリースまでのバージョンを使用することも可能ですが、その場合は非推奨の警告が発生したり、一部の新しい Gradle 機能が動作しなかったりする可能性があることに留意してください。
また、Kotlin 2.4.20 には Problems API との統合の改善も含まれています。
Problems API におけるレポート機能の改善
Kotlin 2.2.0 は、Kotlin Gradle プラグイン (KGP) が Gradle の Problems API と統合された最初のリリースでした。Kotlin 2.4.0 では、Kotlin/JVM においてコンパイラーメッセージを Problems API に書き込む サポートが追加されました。
Kotlin 2.4.20 では、コンパイラーが Problems API に渡す情報にコンパイラー診断 ID が追加されました。また、これらの ID によって診断情報がグループ化されるようになり、コンパイル問題の原因を特定しやすくなりました。
Gradle 8.6 以降、KGP はこの統合をデフォルトで有効にしています。この API はまだ進化中のため、最新の改善を活用するには最新の Gradle バージョンを使用してください。
ビルドツール API (Build tools API)
Kotlin 2.4.20 では、ビルドツール API に Kotlin/JS、Kotlin/Wasm、および Kotlin メタデータの実験的サポートが追加されました。
Kotlin/JS、Kotlin/Wasm、Kotlin メタデータのサポート
Kotlin 2.2.0 で、ビルドツール API (BTA) が Kotlin/JVM 向けに利用可能になりました。Kotlin 2.4.20 では、新しいターゲットである Kotlin/JS、Kotlin/Wasm、および Kotlin メタデータのサポートを追加することで、BTA の安定化に向けた次のステップを踏み出しました。
これにより、Kotlin Gradle プラグインとコンパイラーとのやり取りの一貫性が向上します。場合によっては、より高速で安定したコンパイルの恩恵を受けることもできます。
BTA は、ビルドシステムと Kotlin コンパイラーエコシステムの間の抽象化レイヤーとして機能する汎用 API です。利用可能なビルドツールにおいて、Kotlin 機能と Kotlin コンパイラーとの互換性をサポートするのに役立ちます。
Kotlin 2.4.20 では、BTA は新しいターゲット向けにオプトインとして利用可能です。これを試すには、gradle.properties ファイルに対応するプロパティを追加します:
kotlin.wasm.runViaBuildToolsApi=true
kotlin.js.runViaBuildToolsApi=true
kotlin.metadata.runViaBuildToolsApi=trueKotlin 2.5.0 からは、Kotlin/JS、Kotlin/Wasm、および Kotlin メタデータにおいて BTA をデフォルトで有効にする予定です。
BTA の提案に関心がある場合やフィードバックを共有したい場合は、こちらの KEEP を参照してください。
Kotlin コンパイラー
Kotlin 2.4.20 には、Kotlin ランナーコマンドの変更(kotlinr)に関するアップデートが含まれ、実験的な Kotlin コンパイラーネイティブイメージが導入されました。
Kotlin ランナーコマンドを kotlin から kotlinr に変更
Kotlin ツールチェーン (Kotlin Toolchain) 内の kotlin コマンドとの名前の競合を回避するため、Kotlin ランナーコマンドとして kotlin に代わり kotlinr コマンドが使用されるようになりました。また、Kotlin ランナーは kotlin コマンドを使用した際に警告を表示し、代わりに kotlinr を使用することを推奨します。
ネイティブイメージ
Kotlin 2.4.20 では、Kotlin コンパイラーネイティブイメージの最初の実験的 (Experimental)リリースが行われました。ネイティブイメージは、起動時間の高速化と高いパフォーマンスを提供しながら、標準の kotlinc コマンドラインツールの完全な代替手段(ドロップインの代替品)を提供します。
ネイティブイメージを試すには、GitHub Releases からビルドをダウンロードしてください。
ネイティブイメージには、-Xplugin または -Xcompiler-plugin CLI オプションで使用できる以下のコンパイラープラグインもバンドルされています:
Kotlin コンパイラーネイティブイメージの詳細については、その README を参照してください。
互換性を損なう変更と非推奨
このセクションでは、重要な互換性を損なう変更(破壊的変更)と非推奨事項を取り上げます。完全な概要については、互換性ガイド を参照してください。
- Apple が 32 ビット watchOS ターゲットのサポートを終了するため、
watchosArm32Kotlin/Native ターゲットは非推奨になりました。Xcode 27 との互換性を確保するため、Kotlin 2.5.0 で削除される予定です。 - Kotlin 2.4.20 以降、Kotlin/Native コンパイラーは、
publicインライン関数内、または別のファイルから呼び出されるinternalインライン関数内での AtomicFU アトミック操作を禁止します。 - Kotlin 2.4.20 では、webpack の npm 依存関係が 5.108.1 に更新されました。これはプロジェクトに以下の 2 つの影響を与える可能性があります:
- webpack は、組み込みのミニマイザー(minimizer)依存関係を
terser-webpack-pluginから、より広範なminimizer-webpack-pluginに移行しました。Terser は引き続きデフォルトの JavaScript ミニマイザーですが、プロジェクトがterser-webpack-pluginを直接設定または依存している場合は、その設定の更新が必要になる場合があります。 - webpack は、JavaScript ファイルのモジュールタイプを決定する際に
import.metaを無視しなくなりました。import.metaが存在する場合、webpack はそのファイルを ES モジュールとして扱うため、CommonJS 構文も使用しているファイルが破損する可能性があります。Kotlin/JS の場合は、useEsModules()Gradle DSL を使用してターゲットが ES モジュールを使用するように設定 できます。Kotlin/Wasm は、追加の設定なしでほとんどの場合に機能するはずです。Kotlin/Wasm でimport.metaエラーが発生した場合は、プロジェクトのソース、または直接・推移的依存関係がimport.metaを使用しているかどうかを確認してください。必要に応じて自身のコードを更新してください。依存関係が原因である場合は、互換性のあるバージョンが利用可能であればそれに更新するか、ライブラリのメンテナーに問題を報告してください。
- webpack は、組み込みのミニマイザー(minimizer)依存関係を
- Kotlin 2.4.20 以降、Kotlin/Wasm は生成される JavaScript の
wasmExportsAPI を非推奨とします。コンパイラーは、警告付きで一時的に利用可能なままとなっているwasmExports.memoryを除くすべてのエクスポートへのアクセスを禁止します。モジュールのWebAssembly.Memoryオブジェクトにアクセスするには、kotlin.wasm.unsafe.wasmMemoryプロパティを使用してください。
ドキュメントのアップデート
前回のリリース以降、Kotlin エコシステムのドキュメントにおいて新しいページやチュートリアルを作成し、既存のものを刷新しました:
- iOS デリバリーパイプラインの構築 – TeamCity を使用して Kotlin Multiplatform iOS アプリの継続的デリバリーをセットアップします。
- Compose Multiplatform のアップデート:
- ポップアップ – Compose Multiplatform でポップアップを作成および設定する方法を学びます。
- ウィンドウおよびダイアログ API v2 – Compose Multiplatform でデスクトップのウィンドウとダイアログを管理するための新しい API を確認します。
- トレイと通知 – デスクトップ向け Compose Multiplatform でシステムトレイにアプリケーションアイコンを追加し、システム通知を送信する方法を学びます。
- メニューバー – デスクトップ向け Compose Multiplatform で特定のウィンドウ用のメニューバーを作成する方法を学びます。
- ドラッグ&ドロップ – Compose Multiplatform でドラッグ&ドロップを実装する際に、プラットフォーム固有のデータを処理します。
- Liquid Glass の UIKit 代替案 – SwiftUI の代わりに UIKit ナビゲーションを使用する、Liquid Glass の代替アプローチを探索します。
- AI エージェント用 MCP サーバー – Compose Hot Reload の MCP サーバーを使用して、AI エージェントを開発ワークフローに接続する方法を学びます。
- Spring でのキャッシュ – 新しい Kotlin の例とともに、Spring アプリケーションにキャッシュを追加する方法を学びます。
- Exposed IntelliJ IDEA プラグイン – コード補完、データベース対応のインスペクション、ライブテンプレートを使用して IntelliJ IDEA で Exposed を操作する方法を学びます。
- Kotlin シリアライゼーション – Kotlin データをシリアライズし、JSON 構造と型表現をカスタマイズし、より高度なシリアライズシナリオを扱う方法を学びます。
- Flow および Flow オペレーター – コールド Flow およびホット Flow の作成と収集、例外処理、幅広い Flow オペレーターの使用方法を学びます。
- コルーチンのデバッグ – デバッグモード、スタックトレース復旧、デバッグエージェントを使用して JVM 上でコルーチンをデバッグする方法を学びます。
- Lincheck – Lincheck におけるモデル検査の仕組み、操作実行オプションの使用方法、テスト結果の検証方法を学びます。
- kapt コンパイラープラグイン – Gradle、Maven、コマンドラインコンパイラーで kapt コンパイラープラグインを設定する方法を学びます。
- Kotlin プロジェクトにおけるコード品質ツール – JVM バイトコードと Kotlin コードを解析するためのツールを探索します。
- Maven での Power-assert プラグイン – Power-assert プラグインを使用して、より詳細なテスト失敗メッセージを取得する方法を学びます。
- KSP を使用した複数ラウンド処理 – 生成されたファイル、遅延されたシンボル、バリデーションを含め、KSP が複数の処理ラウンドにわたってどのように動作するかを探索します。
- 表示不可能型 (Non-denotable types) – Kotlin におけるプラットフォーム型、キャプチャ型、および交差型 (intersection types)について学びます。
- 型エイリアス – 型エイリアスのスコープと可視性について学びます。
- This 式 – 暗黙の
thisがどのように解決されるか、およびレシーバーを参照するために明示的にthisを使用するタイミングを学びます。 - 文字列 – 文字列テンプレート、一般的な文字列操作、文字列の構築、型変換について学びます。
- パッケージとインポート – パッケージとインポートを使用して Kotlin コードを整理する方法を学びます。
