「Kotlin 2.4」新機能詳解:マルチプラットフォーム相互運用性の進化と標準ライブラリの強化

Kotlin · Release 2.4

「Kotlin 2.4」新機能詳解:マルチプラットフォーム相互運用性の進化と標準ライブラリの強化

kotlinKotlinリリース2.4.20プログラミング言語

データソース:GitHub Releases + 官方博客 + HN

Kotlin 開発チームは 2026 年 9 月 7 日、Kotlin 2.4.20 を正式にリリースしました。今回のアップデートでは、JVM プラットフォームにおける when 式の invokedynamic コンパイル最適化が安定版(Stable)へと昇格したほか、標準ライブラリ、Kotlin/Native、Kotlin/Wasm に多数の機能強化がもたらされています。以下、主要なトピックを詳しく解説します。

when 式の invokedynamic コンパイル対応(安定版)

Kotlin 2.2.20 では、JVM 21 以降で when 式を invokedynamic でコンパイルする実験的サポートが導入されていました。複数バージョンにわたる改善と検証を経て、Kotlin 2.4.20 でこの機能は正式に安定版(Stable)となり、デフォルトで自動的に有効化されます。これにより、生成されるバイトコードのサイズが削減され、パターンマッチングの実行効率が向上します。

コレクション要素の等価性・一意性を検証する新関数

これまでの Kotlin では、コレクション内の全要素がすべて等しいか、あるいはすべて一意(重複なし)であるかを判定しようとすると、冗長かつ効率の悪いコードを書かざるを得ないケースがありました。このギャップを埋めるため、Kotlin 2.4.20 では標準ライブラリに 4 つの実験的関数が導入されました:allDistinct()、allDistinctBy()、allEqual()、allEqualBy()。

これらは既存のコレクション操作と同様に構造的等価性(equals())で要素を比較し、コレクション、シーケンス、配列に対応しています。実験的機能であるため、利用には @OptIn(ExperimentalStdlibApi::class) の付与が必要です。

公式サンプルコード:

@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
}

kotlin.test アサーション関数の新しいオーバーロード

Kotlin 2.4.20 では、kotlin.test パッケージに含まれる代表的なアサーション関数(assertTrue()、assertEquals()、assertSame()、assertContains() など)に新しい関数オーバーロードが追加されました。

従来のアサーション関数は事前フォーマット済みの文字列エラーメッセージしか受け取れず、アサーションが成功した場合でも文字列の構築処理が実行されていました。新しいオーバーロードではラムダを受け取り、アサーション失敗時にのみ遅延評価でエラーメッセージを生成します。

これにより、API スタイルが JUnit 5 と統一されるとともに実行性能が大幅に向上し、詳細なエラーメッセージを生成する Power-assert などのコンパイラプラグインで特に大きな効果を発揮します。

公式サンプルコード:

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()}" }
}

コルーチンのスタックトレース復元をサポート

Kotlin 2.4.20 では、標準ライブラリに StackTraceRecoverable インターフェースが新設されました。これは言語コアと kotlinx.coroutines ライブラリの統合を深める、実用的な低レイヤーの実験的改善です。

コルーチンのデバッグでは、非同期境界を越えて例外が再スローされる際に元の発生源が分かりにくくなる課題があります。スタックトレース復元は、エラーの根本的な発生箇所を特定するのに役立ちます。カスタム例外クラスに追加の必須パラメータ(行番号など)が存在する場合、StackTraceRecoverable インターフェースを実装して copyForStackTraceRecovery() をオーバーライドするだけで対応できます。これにより、kotlinx.coroutines への明示的な依存関係を追加することなく、新しい例外インスタンスの生成規則を定義できます。

公式サンプルコード:

import kotlin.coroutines.ExperimentalStdlibCoroutineSupportApi
import kotlin.coroutines.debug.StackTraceRecoverable

@OptIn(ExperimentalStdlibCoroutineSupportApi::class)
class FileEditException
private constructor(
    val line: Int,
    private val detail: String,
    cause: Throwable?,
) : IllegalStateException("When editing line $line: $detail", cause),
    StackTraceRecoverable<FileEditException> {

    constructor(line: Int, detail: String) : this(line, detail, null)

    override fun copyForStackTraceRecovery(): FileEditException =
        FileEditException(line, detail, this)
}

Swift エクスポートの新機能

Kotlin/Native では本バージョンでも相互運用性の向上が進められ、Swift エクスポートに関して 2 つの重要機能が追加されました:

  1. シールドクラス(Sealed classes)のサポート:Kotlin で定義されたシールドクラスの階層構造が、Swift の enum にネイティブにマッピングされるようになりました。これにより、Swift 開発者は Xcode 上で完全な自動補完を効かせながら網羅的な switch 文を記述でき、default 節を無理に用意する必要がなくなります。
  2. 言語間継承(Cross-language inheritance):Kotlin 側でインターフェースや基底クラスを定義し、Swift 側で純粋な Swift ライブラリを用いてそれらを実装したうえで、Swift オブジェクトを Kotlin 側に渡して利用できるようになりました。このリバースインポートパターンにより、ハイブリッドアプリ開発の柔軟性が大幅に向上します。

公式サンプルコード(シールドクラスのサポート):

// 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 側
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"

Kotlin/Wasm の新しいコンパイルモード

従来の Kotlin/Wasm コンパイラは、プロジェクト全体と依存関係を単一のモジュールとしてまとめるモノリス(monolith)モードのみをサポートしていました。これはデッドコード削除を最大限に行いバイナリサイズを最小化するためです。Kotlin 2.4.20 では Kotlin/Wasm にマルチモジュールコンパイルモードが導入され、gradle.properties で以下の選択肢を設定できるようになりました:

  • monolith(デフォルト):全体コンパイルを行い、到達不能な宣言を削除してプログラム全体に最適化を適用します。
  • multimodule-open-world:各モジュールを個別にコンパイルします。モジュールをまたぐ最適化は行われず、モジュールごとのバイナリが生成されるため、開発時のコンパイル速度を大幅に短縮できます。
  • multimodule-closed-world:全モジュールを 1 回の呼び出しで処理し、到達不能な宣言を削除したうえで各 Wasm バイナリを個別に最適化します。

開発現場では、kotlin.wasm.compilationMode=multimodule-closed-world-only-in-dev の利用が推奨されます。これにより、日々の開発中の再コンパイル時間を短縮しつつ、本番向けビルドでは最小のバイナリサイズを維持できます。

破壊的変更と非推奨事項

Kotlin 2.4.20 へのアップグレード前に、以下の破壊的変更および非推奨となった機能をご確認ください。

  • Apple watchOS 32 ビットプラットフォームの非推奨化:Apple による 32 ビット版 watchOS のサポート終了に伴い、Kotlin/Native のターゲットである watchosArm32 が正式に非推奨となりました。将来の Kotlin 2.5.0 で完全に削除される予定です。
  • インライン関数での AtomicFU の制限:public inline 関数、またはファイル間をまたいで呼び出される internal inline 関数内において、AtomicFU によるアトミック操作の使用がコンパイラによって全面的に禁止されました。
  • Webpack の import.meta 動作変更:Kotlin 2.4.20 では Webpack が 5.108.1 にアップデートされました。新しい Webpack は import.meta を無視しなくなったため、この識別子を含む CommonJS 互換コードが強制的に ES モジュールとして解釈され、バンドルエラーが発生する可能性があります。
  • Kotlin/Wasm の wasmExports 非推奨化:生成される JavaScript 向け wasmExports API が非推奨に指定されました。暫定的に許可される wasmExports.memory を除き、他のエクスポート項目へのアクセスはコンパイラによって禁止されます。

アップグレードの推奨指針

観点推奨内容
対象読者すべての Kotlin 開発者。特にマルチプラットフォーム相互運用(Native、Wasm、JS)を多用する開発者や、テストケースでのアサーション実行性能を向上させたい開発者に推奨されます。
アップグレード時期即時のアップグレードを推奨します。IDE(IntelliJ IDEA または Android Studio)を最新バージョンに更新したうえで、ビルドスクリプト内の Kotlin バージョンを 2.4.20 に更新してください。
注意事項watchosArm32 ターゲットに依存しているプロジェクトは早期の移行が必要です。JS および Wasm プロジェクトで Webpack の更新に伴いモジュール形式の判定エラーが発生した場合は、import.meta の影響を確認し設定を調整してください。

参考資料