トラブルシューティング
Kotlin/Wasmは、WebAssembly proposalsのgarbage collectionやexception handlingなどの新しい提案に依存して、WebAssembly内で改善と新機能を導入しています。
ただし、これらの機能が正常に動作するためには、新しい提案をサポートする環境が必要です。場合によっては、提案と互換性を持たせるために環境をセットアップする必要があります。
ブラウザのバージョン
Kotlin/Wasmで構築されたアプリケーションをブラウザで実行するには、新しいWebAssembly garbage collection (WasmGC) featureをサポートするブラウザのバージョンが必要です。ブラウザのバージョンが新しいWasmGCをデフォルトでサポートしているか、環境を変更する必要があるかを確認してください。
Chrome
-
バージョン119以降の場合:
デフォルトで動作します。
-
古いバージョン:
古いブラウザでアプリケーションを実行するには、1.9.20より前のKotlinバージョンが必要です。
- ブラウザで、
chrome://flags/#enable-webassembly-garbage-collectionにアクセスします。 - WebAssembly Garbage Collectionを有効にします。
- ブラウザを再起動します。
- ブラウザで、
Chromiumベース
Edge、Brave、Opera、Samsung InternetなどのChromiumベースのブラウザを含みます。
-
バージョン119以降の場合:
デフォルトで動作します。
-
古いバージョン:
古いブラウザでアプリケーションを実行するには、1.9.20より前のKotlinバージョンが必要です。
--js-flags=--experimental-wasm-gcコマンドライン引数を指定してアプリケーションを実行します。
Firefox
-
バージョン120以降の場合:
デフォルトで動作します。
-
バージョン119の場合:
- ブラウザで、
about:configにアクセスします。 javascript.options.wasm_gcオプションを有効にします。- ページを更新します。
- ブラウザで、
Safari/WebKit
-
バージョン18.2以降の場合:
デフォルトで動作します。
-
古いバージョン:
サポートされていません。
Safari 18.2は、iOS 18.2、iPadOS 18.2、visionOS 2.2、macOS 15.2、macOS Sonoma、およびmacOS Venturaで利用できます。 iOSおよびiPadOSでは、Safari 18.2はオペレーティングシステムにバンドルされています。入手するには、デバイスをバージョン18.2以降にアップデートしてください。
詳細については、Safari release notesを参照してください。
Wasm proposals support
Kotlin/Wasmの改善は、WebAssembly proposalsに基づいています。ここでは、WebAssemblyのgarbage collectionと（レガシー）exception handling proposalsのサポートに関する詳細を確認できます。
Garbage collection proposal
Kotlin 1.9.20以降、KotlinツールチェーンはWasm garbage collection (WasmGC) proposalの最新バージョンを使用します。
このため、Wasmプロジェクトを最新バージョンのKotlinに更新することを強くお勧めします。また、Wasm環境を備えた最新バージョンのブラウザを使用することをお勧めします。
Exception handling proposal
Kotlinツールチェーンは、デフォルトでlegacy exception handling proposalを使用しており、生成されたWasmバイナリをより広範な環境で実行できます。
Kotlin 2.0.0以降、Kotlin/Wasm内で新しいバージョンのWasm exception handling proposalのサポートを導入しました。
このアップデートにより、新しいexception handling proposalがKotlinの要件に適合し、最新バージョンのproposalのみをサポートする仮想マシンでKotlin/Wasmを使用できるようになります。
新しいexception handling proposalは、-Xwasm-use-new-exception-proposalコンパイラオプションを使用して有効にします。デフォルトではオフになっています。
プロジェクトのセットアップ、依存関係の使用、その他のタスクについては、 Kotlin/Wasm examplesをご覧ください。
Use default import
Importing Kotlin/Wasm code into Javascriptは、default exportsから移行し、named exportsに移行しました。
default importを引き続き使用する場合は、新しいJavaScriptラッパーモジュールを生成します。次のスニペットを含む.mjsファイルを作成します。
// Specifies the path to the main .mjs file
import * as moduleExports from "./wasm-test.mjs";
export { moduleExports as default };
新しい.mjsファイルをresourcesフォルダに配置すると、ビルドプロセス中にメインの.mjsファイルの隣に自動的に配置されます。
.mjsファイルをカスタムの場所に配置することもできます。この場合、手動でメインの.mjsファイルの隣に移動するか、importステートメントのパスをその場所に合わせて調整する必要があります。
Slow Kotlin/Wasm compilation
Kotlin/Wasmプロジェクトに取り組む際に、コンパイル時間が遅くなる場合があります。これは、Kotlin/Wasmツールチェーンが変更を行うたびにコードベース全体を再コンパイルするために発生します。
この問題を軽減するために、Kotlin/Wasmターゲットはインクリメンタルコンパイルをサポートしています。これにより、コンパイラは最後のコンパイルからの変更に関連するファイルのみを再コンパイルできます。
インクリメンタルコンパイルを使用すると、コンパイル時間が短縮されます。これにより、開発速度が当面の間2倍になり、今後のリリースでさらに改善する予定です。
現在のセットアップでは、Wasmターゲットのインクリメンタルコンパイルはデフォルトで無効になっています。
有効にするには、プロジェクトのlocal.propertiesまたはgradle.propertiesファイルに次の行を追加します。
kotlin.incremental.wasm=true
Kotlin/Wasmのインクリメンタルコンパイルを試して、share your feedbackをお願いします。 皆様からのご意見は、この機能を安定させ、より早くデフォルトで有効にするのに役立ちます。