Kotlin/Wasm コードのデバッグ
このチュートリアルでは、IntelliJ IDEA とブラウザを使用して、Kotlin/Wasm でビルドされた Compose Multiplatform アプリケーションをデバッグする方法を説明します。
始める前に
- Kotlin Multiplatform 開発のための環境をセットアップします。
- 手順に従って Kotlin/Wasm をターゲットとする Kotlin Multiplatform プロジェクトを作成します。
IntelliJ IDEA で Kotlin/Wasm コードをデバッグするには、JavaScript Debugger プラグインがインストールされている必要があります。プラグインの詳細とインストール方法については、こちらを参照してください。
IntelliJ IDEA でのデバッグ
作成した Kotlin Multiplatform プロジェクトには、Kotlin/Wasm を搭載した Compose Multiplatform アプリケーションが含まれています。追加の設定を行うことなく、このアプリケーションを IntelliJ IDEA でそのままデバッグできます。
IntelliJ IDEA で、デバッグ対象の Kotlin ファイルを開きます。このチュートリアルでは、Kotlin Multiplatform プロジェクトの以下のディレクトリにある
Greeting.ktファイルを使用します。WasmDemo/composeApp/src/wasmJsMain/kotlin/wasm.project.demo.wasmdemo行番号をクリックして、検査したいコードにブレークポイントを設定します。

実行構成のリストから composeApp[wasmJs] を選択します。
画面上部にあるデバッグアイコンをクリックして、デバッグモードでコードを実行します。

アプリケーションが起動すると、新しいブラウザウィンドウで開きます。

また、IntelliJ IDEA では Debug パネルが自動的に開きます。

アプリケーションの検査
ブラウザでデバッグする場合も、アプリケーションを検査する手順は同様です。
アプリケーションのブラウザウィンドウで、Click me! ボタンをクリックしてアプリケーションを操作します。この操作によってコードの実行がトリガーされ、実行がブレークポイントに達するとデバッガーが一時停止します。
デバッグペインでデバッグコントロールボタンを使用し、ブレークポイントでの変数やコードの実行状態を検査します。
ステップオーバー: 現在の行を実行し、次の行で一時停止します。
ステップイン: 関数をより詳細に調査します。
ステップアウト: 現在の関数を抜けるまでコードを実行します。
Threads & Variables ペインを確認します。これは関数呼び出しのシーケンスをトレースし、エラーの場所を特定するのに役立ちます。

コードを変更し、アプリケーションを再度実行して動作を確認します。
デバッグが完了したら、ブレークポイントのある行番号をクリックしてブレークポイントを解除します。
ブラウザでのデバッグ
追加の設定を行わずに、ブラウザでこの Compose Multiplatform アプリケーションをデバッグすることもできます。
開発用 Gradle タスク(*DevRun)を実行すると、Kotlin はソースファイルをブラウザに自動的に提供するため、ブレークポイントの設定、変数の検査、Kotlin コードのステップ実行が可能になります。
Kotlin/Wasm プロジェクトのソースをブラウザに提供する設定は、現在 Kotlin Gradle プラグインに含まれています。以前にこの設定を build.gradle.kts ファイルに追加していた場合は、競合を避けるために削除してください。
このチュートリアルでは Chrome ブラウザを使用していますが、他のブラウザでも同様の手順で実行できます。詳細については、ブラウザのバージョンを参照してください。
アプリケーションのブラウザウィンドウで右クリックし、検証(Inspect)操作を選択して開発者ツールを開きます。または、F12 ショートカットを使用するか、表示 | 開発 / 管理 | デベロッパー ツール(View | Developer | Developer Tools)を選択することもできます。
Sources タブに切り替え、デバッグ対象の Kotlin ファイルを選択します。このチュートリアルでは、
Greeting.ktファイルを使用します。行番号をクリックして、検査したいコードにブレークポイントを設定します。濃い数字が表示されている行にのみブレークポイントを設定できます(この例では 4、7、8、9 行目)。

IntelliJ IDEA でのデバッグと同様に、アプリケーションを検査します。
ブラウザでデバッグする場合、関数呼び出しのシーケンスをトレースしてエラーを特定するためのペインは Scope と Call Stack です。

カスタムフォーマッターの使用
カスタムフォーマッター(Custom formatters)を使用すると、ブラウザで Kotlin/Wasm コードをデバッグする際に、変数の値をよりわかりやすく直感的な方法で表示および特定できます。
カスタムフォーマッターは Kotlin/Wasm の開発ビルドではデフォルトで有効になっていますが、ブラウザの開発者ツール側でもカスタムフォーマッターが有効になっていることを確認する必要があります。
Chrome DevTools の場合、Settings | Preferences | Console にある Custom formatters チェックボックスを確認します。

Firefox DevTools の場合、Settings | Advanced settings にある Enable custom formatters チェックボックスを確認します。

この機能は custom formatters API を使用しており、Firefox および Chromium ベースのブラウザでサポートされています。
カスタムフォーマッターはデフォルトでは Kotlin/Wasm の開発ビルドに対してのみ機能するため、本番ビルドで使用したい場合は Gradle 設定を調整する必要があります。wasmJs {} ブロックに以下のコンパイラオプションを追加してください。
// build.gradle.kts
kotlin {
wasmJs {
// ...
compilerOptions {
freeCompilerArgs.add("-Xwasm-debugger-custom-formatters")
}
}
}フィードバックの送信
デバッグ体験に関するフィードバックをお待ちしております。
Slack: Slack の招待を受け取り、#webassembly チャンネルで開発者に直接フィードバックを提供してください。
- YouTrack でフィードバックを送信してください。
次のステップ
- この YouTube 動画 で、実際の Kotlin/Wasm デバッグの様子をご覧ください。
- その他の Kotlin/Wasm サンプルもお試しください。
