문제 해결
Kotlin/Wasm은 WebAssembly 제안 (예: 가비지 컬렉션 및 예외 처리)을 기반으로 WebAssembly 내에서 개선 사항과 새로운 기능을 도입합니다.
그러나 이러한 기능이 제대로 작동하려면 새로운 제안을 지원하는 환경이 필요합니다. 경우에 따라 제안과 호환되도록 환경을 설정해야 할 수도 있습니다.
브라우저 버전
Kotlin/Wasm으로 빌드된 애플리케이션을 브라우저에서 실행하려면 새로운 WebAssembly garbage collection (WasmGC) 기능을 지원하는 브라우저 버전이 필요합니다. 브라우저 버전이 새로운 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 릴리스 노트를 참조하십시오.
Wasm proposals support
Kotlin/Wasm 개선 사항은 WebAssembly 제안을 기반으로 합니다. 여기에서 WebAssembly의 가비지 컬렉션 및 (레거시) 예외 처리 제안에 대한 지원에 대한 자세한 내용을 확인할 수 있습니다.
Garbage collection proposal
Kotlin 1.9.20 이후 Kotlin 툴체인은 Wasm garbage collection (WasmGC) 제안의 최신 버전을 사용합니다.
이러한 이유로 Wasm 프로젝트를 최신 버전의 Kotlin으로 업데이트하는 것이 좋습니다. 또한 Wasm 환경이 있는 최신 버전의 브라우저를 사용하는 것이 좋습니다.
Exception handling proposal
Kotlin 툴체인은 레거시 예외 처리 제안을 기본적으로 사용하므로 생성된 Wasm 바이너리를 더 넓은 범위의 환경에서 실행할 수 있습니다.
Kotlin 2.0.0부터 Kotlin/Wasm 내에서 새로운 버전의 Wasm exception handling proposal에 대한 지원을 도입했습니다.
이 업데이트는 새로운 예외 처리 제안이 Kotlin 요구 사항에 부합하도록 보장하여 최신 버전의 제안만 지원하는 가상 머신에서 Kotlin/Wasm을 사용할 수 있도록 합니다.
새로운 예외 처리 제안은 -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 타겟은 증분 컴파일을 지원하므로 컴파일러는 마지막 컴파일에서 변경 사항과 관련된 파일만 다시 컴파일할 수 있습니다.
증분 컴파일을 사용하면 컴파일 시간이 줄어듭니다. 현재 개발 속도가 두 배로 빨라졌으며 향후 릴리스에서 더욱 개선할 계획입니다.
현재 설정에서 Wasm 타겟에 대한 증분 컴파일은 기본적으로 비활성화되어 있습니다.
활성화하려면 프로젝트의 local.properties 또는 gradle.properties 파일에 다음 줄을 추가하십시오.
kotlin.incremental.wasm=true
Kotlin/Wasm 증분 컴파일을 사용해 보고 피드백을 공유하십시오. 귀하의 의견은 이 기능을 안정화하고 기본적으로 더 빨리 활성화하는 데 도움이 됩니다.