Skip to content

Compose Hot Reload ​

Compose Hot Reload は、Compose Multiplatform プロジェクトでの作業中に UI の変更を可視化し、素早く試行錯誤するのに役立ちます。 テストデータを使用して分離されたコンポーネントを表示するのに便利な標準の Compose プレビュー とは異なり、 Compose Hot Reload はコードの変更を実行中のアプリケーションに直接適用します。

バンドルされている Compose Hot Reload Gradle プラグインには、 Kotlin 2.1.20 以上、および Java 21 以前と互換性のある JVM ターゲットが必要です。 Compose Hot Reload のすべての機能を利用するには、 IntelliJ IDEA バージョン 2025.2.2 以降および Android Studio Otter 2025.2.1 以降で利用可能な Kotlin Multiplatform IDE プラグイン をインストールすることをお勧めします。

他のターゲットへのサポート追加も検討中ですが、現時点でもデスクトップアプリをサンドボックスとして活用し、 作業の流れを中断することなく共通コードの UI 変更を素早く試すことができます。

Compose Hot Reload

プロジェクトへの Compose Hot Reload の追加 ​

Compose Hot Reload は、次の2つの方法で追加できます。

新規作成する場合 ​

このセクションでは、IntelliJ IDEA および Android Studio でデスクトップターゲットを含むマルチプラットフォームプロジェクトを作成する手順を説明します。プロジェクトが作成されると、Compose Hot Reload は自動的に追加されます。

  1. クイックスタート の手順に従い、Kotlin Multiplatform 開発のための環境をセットアップ します。
  2. IDE で、File | New | Project を選択します。
  3. 左側のパネルで Kotlin Multiplatform を選択します。
  4. New Project ウィンドウで Name、Group、Artifact フィールドを指定します。
  5. Desktop ターゲットを選択し、Create をクリックします。 Create multiplatform project with desktop target

既存のプロジェクトに追加する場合 ​

Compose Multiplatform 1.10.0 以降、Compose Hot Reload プラグインは バンドル されており、デスクトップターゲット を含むすべてのプロジェクトでデフォルトで有効になっています。

プロジェクトにすでにデスクトップターゲットが含まれている場合は、 Compose Multiplatform バージョン 1.10.0 以降にアップグレードすることで、特別な設定なしで Compose Hot Reload 機能をすぐに利用できます。

デフォルトで有効になっていますが、 特定の古いバージョンを使用するために Compose Hot Reload プラグインを明示的に宣言することも可能です。

以前のバージョンの Compose Multiplatform ​

1.10.0 より前の Compose Multiplatform バージョンを使用しているマルチプラットフォームプロジェクトでは、 デスクトップターゲットが設定されている必要があり、その上で明示的に Compose Hot Reload プラグインを追加する必要があります。 以下の手順では、クイックスタート チュートリアルのプロジェクトを参考として使用します。

  1. デスクトップターゲットを導入します。desktopApp ディレクトリを作成し、main() 関数を定義して、actual 実装を提供します。 プロジェクトにすでにデスクトップターゲットが含まれている場合は、このステップをスキップできます。 参考として、JVM エントリポイントの追加 のサンプルを参照してください。

  2. バージョンカタログを Compose Hot Reload の最新バージョンで更新します(Releases を参照)。 gradle/libs.versions.toml に次のコードを追加します。

    toml
    composeHotReload = { id = "org.jetbrains.compose.hot-reload", version.ref = "composeHotReload"}

    バージョンカタログを使用してプロジェクト全体の依存関係を一元管理する方法の詳細については、Gradle のベストプラクティス を参照してください。

  3. 親プロジェクトの build.gradle.kts(ComposeDemo/build.gradle.kts)で、plugins {} ブロックに次のコードを追加します。

    kotlin
    plugins {
        alias(libs.plugins.composeHotReload) apply false
    }

    これにより、各サブプロジェクトで Compose Hot Reload プラグインが複数回ロードされるのを防ぎます。

  4. マルチプラットフォームアプリケーションを含むサブプロジェクトの build.gradle.kts(ComposeDemo/sharedUI/build.gradle.kts)で、plugins {} ブロックに次のコードを追加します。

    kotlin
    plugins { 
        alias(libs.plugins.composeHotReload)
    }
  5. プロジェクトは、拡張されたクラス再定義をサポートする OpenJDK フォークである JetBrains Runtime(JBR)上で実行する必要があります。 Compose Hot Reload は、プロジェクトに互換性のある JBR を自動的にプロビジョニングできます。

    最新の JetBrains Runtime は Java 21 のみをサポートしています。 Java 22 以降とのみ互換性のあるプロジェクトに Compose Hot Reload を追加すると、 プロジェクトの実行時にリンケージエラーが発生します。

    自動プロビジョニングを許可するには、settings.gradle.kts ファイルに次の Gradle プラグインを追加します。

    kotlin
    plugins {
        id("org.gradle.toolchains.foojay-resolver-convention") version "1.2.0"
    }
  6. Sync Gradle Changes ボタンをクリックして、Gradle ファイルを同期します。Synchronize Gradle files

Compose Hot Reload の使用 ​

  1. desktopApp ソースセットで main.kt ファイルを開き、main() 関数を更新します。

    kotlin
    fun main() = application {
        Window(
            onCloseRequest = ::exitApplication,
            alwaysOnTop = true,
            title = "composedemo",
        ) {
            App()
        }
    }

    alwaysOnTop 変数を true に設定することで、生成されたデスクトップアプリがすべてのウィンドウの最前面に表示され続けるため、 コードを編集しながら変更をライブで確認しやすくなります。

  2. App.kt ファイルを開き、Button コンポーザブルを更新します。

    kotlin
    Button(onClick = { showContent = !showContent }) {
        Column {
            Text(Greeting().greet())
        }
    }

    これで、ボタンのテキストが greet() 関数によって制御されるようになります。

  3. Greeting.kt ファイルを開き、greet() 関数を更新します。

    kotlin
     fun greet(): String {
         return "Hello!"
     }
  4. main.kt ファイルを開き、ガター(行番号の横の余白)にある Run アイコンをクリックします。 Run 'desktopApp' with Compose Hot Reload を選択します。

    Run Compose Hot Reload from gutter

    First Compose Hot Reload on desktop app

  5. greet() 関数から返される文字列を更新し、すべてのファイルを保存(⌘ S / Ctrl+S)すると、 デスクトップアプリが自動的に更新されるのを確認できます。

    Compose Hot Reload

    または、割り当てられたショートカットキーを押すか、Reload UI ボタンをクリックして明示的にリロードをトリガーすることもできます。 トリガーの挙動は、Settings | Tools | Compose Hot Reload ページで変更できます。

おめでとうございます!Compose Hot Reload の動作を確認できました。これで、変更のたびにデスクトップの実行構成を再起動することなく、テキスト、画像、フォーマット、UI 構造などの変更を自由に試すことができます。

Experimental

AI エージェント用 MCP サーバー

Compose Multiplatform 1.12.0 以降、Compose Hot Reload には組み込みの Model Context Protocol (MCP) サーバーが含まれています。 この MCP サーバーにより、AI コーディングエージェントが実行中の Compose アプリケーションと連携できるようになります。具体的には、Compose Hot Reload のトリガー、レンダリングされた UI の確認、セマンティック構造のインスペクト、ユーザー入力のシミュレーション、ランタイムログの読み取りなどが可能です。 複数のウィンドウを持つアプリケーションの場合、エージェントはウィンドウを一覧表示し、そのいずれかをターゲットに指定できます。

これにより、Compose コードを編集する際の AI エージェントのフィードバックループが完結します。 編集のたびに人間が手動で結果を確認する必要がなくなり、 エージェントが自律的にコードを反復修正し、各変更を検証できるようになります。

AI エージェントの接続 ​

AI エージェントを接続するには、hotMcpServer Gradle タスクを実行するように MCP クライアントを設定します。 たとえば、.mcp.json では次のようになります。

json
{
  "mcpServers": {
    "compose-hot-reload": {
      "command": "./gradlew",
      "args": [
        "--no-daemon",
        "--quiet",
        "--console=plain",
        "hotMcpServer"
      ]
    }
  }
}

Gradle はすべてのサブプロジェクトを横断してタスクを検索し、短いタスク名 hotMcpServer を hotMcpServerJvm や hotMcpServerDesktop などのターゲット固有のバリアントに一致させます。

モジュールで複数の JVM ターゲットが定義されている場合は、 曖昧さを避けるために :<module>:hotMcpServer<Target> のように完全修飾タスク名を指定してください(例: :app:hotMcpServerDesktop または :composeApp:hotMcpServerJvm)。

利用可能な MCP ツール ​

MCP サーバーは、エージェントが呼び出せる次のような一連のツールを公開しています。

  • reload — プロジェクトを再コンパイルし、変更されたクラスをホットリロードします。
  • take_screenshot — アプリケーションウィンドウの現在の状態をキャプチャします。
  • get_semantic_tree — エージェントが UI 構造を理解できるように、Compose の セマンティックツリー を返します。
  • get_logs — 実行時例外を含む、実行中のアプリケーションからの最新のログ出力を返します。
  • click、type_text、scroll — インタラクティブなフローをテストするためにユーザー入力をシミュレートします。

MCP ツールとそのパラメーターの完全なリストについては、 Compose Hot Reload README を参照してください。

サポートを受ける ​

Compose Hot Reload の使用中に問題が発生した場合は、GitHub イシューを作成 してお知らせください。