Kotlin/JS IR 컴파일러

Kotlin/JS IR 컴파일러 백엔드는 Kotlin/JS 관련 혁신의 주요 초점이며, 기술 발전을 위한 길을 열어줍니다.

Kotlin/JS IR 컴파일러 백엔드는 Kotlin 소스 코드에서 직접 JavaScript 코드를 생성하는 대신 새로운 접근 방식을 활용합니다. Kotlin 소스 코드는 먼저 Kotlin 중간 표현 (IR)으로 변환된 다음 JavaScript로 컴파일됩니다. Kotlin/JS의 경우, 이를 통해 적극적인 최적화가 가능하며, (데드 코드 제거를 통한) 생성된 코드 크기, JavaScript 및 TypeScript 생태계 상호 운용성과 같이 이전 컴파일러에 존재했던 문제점을 개선할 수 있습니다.

IR 컴파일러 백엔드는 Kotlin 1.4.0부터 Kotlin Multiplatform Gradle 플러그인을 통해 사용할 수 있습니다. 프로젝트에서 활성화하려면 Gradle 빌드 스크립트의 js 함수에 컴파일러 유형을 전달합니다.

kotlin {
    js(IR) { // or: LEGACY, BOTH
        // ...
        binaries.executable() // not applicable to BOTH, see details below
    }
}

IR은 Kotlin/JS에 대한 새로운 IR 컴파일러 백엔드를 사용합니다.
LEGACY는 이전 컴파일러 백엔드를 사용합니다.
BOTH는 새 IR 컴파일러와 기본 컴파일러 백엔드를 모두 사용하여 프로젝트를 컴파일합니다. 이 모드는 하위 호환성을 갖춘 IR 컴파일러용 라이브러리 제작에 사용합니다.

노트

이전 컴파일러 백엔드는 Kotlin 1.8.0부터 더 이상 사용되지 않습니다. Kotlin 1.9.0부터는 컴파일러 유형 LEGACY 또는 BOTH를 사용하면 오류가 발생합니다.

컴파일러 유형은 gradle.properties 파일에서도 kotlin.js.compiler=ir 키로 설정할 수 있습니다. 그러나 이 동작은 build.gradle(.kts)의 설정에 의해 덮어쓰기됩니다.

최상위 속성의 지연 초기화

더 나은 애플리케이션 시작 성능을 위해 Kotlin/JS IR 컴파일러는 최상위 속성을 지연 초기화합니다. 이렇게 하면 애플리케이션이 코드에서 사용되는 모든 최상위 속성을 초기화하지 않고 로드됩니다. 시작 시 필요한 속성만 초기화합니다. 다른 속성은 실제로 사용하는 코드가 실행될 때 나중에 값을 받습니다.

val a = run {
    val result = // intensive computations
    println(result)
    result
} // value is computed upon the first usage

어떤 이유로든 속성을 즉시 초기화해야 하는 경우(애플리케이션 시작 시) @EagerInitialization 어노테이션으로 표시합니다.

개발 바이너리에 대한 증분 컴파일

JS IR 컴파일러는 개발 프로세스 속도를 향상시키는 _개발 바이너리에 대한 증분 컴파일 모드_를 제공합니다. 이 모드에서 컴파일러는 모듈 수준에서 compileDevelopmentExecutableKotlinJs Gradle 작업의 결과를 캐시합니다. 변경되지 않은 소스 파일에 대해 이후 컴파일 중에 캐시된 컴파일 결과를 사용하여 컴파일을 더 빠르게 완료합니다. 특히 작은 변경 사항이 있는 경우에 그렇습니다.

증분 컴파일은 기본적으로 활성화되어 있습니다. 개발 바이너리에 대한 증분 컴파일을 비활성화하려면 프로젝트의 gradle.properties 또는 local.properties에 다음 줄을 추가합니다.

kotlin.incremental.js.ir=false // true by default

증분 컴파일 모드의 클린 빌드는 캐시를 생성하고 채워야 하기 때문에 일반적으로 더 느립니다.

출력 모드

프로젝트에서 JS IR 컴파일러가 .js 파일을 출력하는 방식을 선택할 수 있습니다.

모듈당 하나. 기본적으로 JS 컴파일러는 프로젝트의 각 모듈에 대해 컴파일 결과로 별도의 .js 파일을 출력합니다.
프로젝트당 하나. 다음 줄을 gradle.properties에 추가하여 전체 프로젝트를 단일 .js 파일로 컴파일할 수 있습니다.
```
kotlin.js.ir.output.granularity=whole-program // 'per-module' is the default
```
파일당 하나. 각 Kotlin 파일당 하나의 JavaScript 파일(또는 파일에 내보낸 선언이 포함된 경우 두 개)을 생성하는 보다 세분화된 출력을 설정할 수 있습니다. 파일당 컴파일 모드를 활성화하려면:
1. ECMAScript 모듈을 지원하기 위해 빌드 파일에 useEsModules() 함수를 추가합니다.
```
// build.gradle.kts
kotlin {
    js(IR) {
        useEsModules() // Enables ES2015 modules
        browser()
    }
}
```
  또는 es2015 컴파일 대상을 사용하여 프로젝트에서 ES2015 기능을 지원할 수 있습니다.
2. -Xir-per-file 컴파일러 옵션을 적용하거나 gradle.properties 파일을 다음과 같이 업데이트합니다.
```
# gradle.properties
kotlin.js.ir.output.granularity=per-file // `per-module` is the default
```

프로덕션에서 멤버 이름 축소

Kotlin/JS IR 컴파일러는 Kotlin 클래스 및 함수 간의 관계에 대한 내부 정보를 사용하여 함수, 속성 및 클래스 이름을 단축하여 보다 효율적인 축소를 적용합니다. 이렇게 하면 결과 번들 애플리케이션의 크기가 줄어듭니다.

이러한 유형의 축소는 프로덕션 모드에서 Kotlin/JS 애플리케이션을 빌드할 때 자동으로 적용되며 기본적으로 활성화되어 있습니다. 멤버 이름 축소를 비활성화하려면 -Xir-minimized-member-names 컴파일러 옵션을 사용합니다.

kotlin {
    js(IR) {
        compilations.all {
            compileTaskProvider.configure {
                compilerOptions.freeCompilerArgs.add("-Xir-minimized-member-names=false")
            }
        }
    }
}

미리 보기: TypeScript 선언 파일(d.ts) 생성

주의

TypeScript 선언 파일 (d.ts) 생성은 Experimental입니다. 언제든지 삭제되거나 변경될 수 있습니다. 옵트인이 필요하며(자세한 내용은 아래 참조), 평가 목적으로만 사용해야 합니다. YouTrack에서 이에 대한 피드백을 보내주시면 감사하겠습니다.

Kotlin/JS IR 컴파일러는 Kotlin 코드에서 TypeScript 정의를 생성할 수 있습니다. 이러한 정의는 하이브리드 앱에서 작업할 때 JavaScript 도구 및 IDE에서 자동 완성 기능을 제공하고, 정적 분석기를 지원하고, JavaScript 및 TypeScript 프로젝트에 Kotlin 코드를 더 쉽게 포함할 수 있도록 하는 데 사용할 수 있습니다.

프로젝트에서 실행 파일(binaries.executable())을 생성하는 경우 Kotlin/JS IR 컴파일러는 @JsExport로 표시된 모든 최상위 선언을 수집하고 .d.ts 파일에 TypeScript 정의를 자동으로 생성합니다.

TypeScript 정의를 생성하려면 Gradle 빌드 파일에서 명시적으로 구성해야 합니다. js 섹션의 build.gradle.kts 파일에 generateTypeScriptDefinitions()를 추가합니다. 예를 들어:

kotlin {
    js {
        binaries.executable()
        browser {
        }
        generateTypeScriptDefinitions()
    }
}

정의는 해당 웹팩되지 않은 JavaScript 코드와 함께 build/js/packages/<package_name>/kotlin에서 찾을 수 있습니다.

IR 컴파일러의 현재 제한 사항

새로운 IR 컴파일러 백엔드의 주요 변경 사항은 기본 백엔드와의 이진 호환성 부족입니다. 새로운 IR 컴파일러로 생성된 라이브러리는 klib 형식을 사용하며 기본 백엔드에서 사용할 수 없습니다. 그동안 이전 컴파일러로 생성된 라이브러리는 jar이며 js 파일이 포함되어 있으며 IR 백엔드에서 사용할 수 없습니다.

프로젝트에 IR 컴파일러 백엔드를 사용하려면 모든 Kotlin 종속성을 이 새로운 백엔드를 지원하는 버전으로 업데이트해야 합니다. Kotlin/JS를 대상으로 하는 Kotlin 1.4+용 JetBrains에서 게시한 라이브러리에는 이미 새로운 IR 컴파일러 백엔드와 함께 사용하기 위해 필요한 모든 아티팩트가 포함되어 있습니다.

IR 컴파일러용 라이브러리를 제작하는 라이브러리 작성자인 경우 IR 컴파일러용 라이브러리 제작에 대한 섹션을 추가로 확인하십시오. 섹션.

IR 컴파일러 백엔드는 기본 백엔드와 비교하여 몇 가지 차이점도 있습니다. 새로운 백엔드를 사용해 볼 때 이러한 가능한 문제점을 염두에 두는 것이 좋습니다.

kotlin-wrappers와 같이 기본 백엔드의 특정 특성에 의존하는 일부 라이브러리는 일부 문제를 표시할 수 있습니다. YouTrack에서 조사 및 진행 상황을 확인할 수 있습니다.
IR 백엔드는 기본적으로 Kotlin 선언을 JavaScript에서 사용할 수 있도록 하지 않습니다. Kotlin 선언을 JavaScript에서 볼 수 있도록 하려면 @JsExport 어노테이션을 반드시 사용해야 합니다.

기존 프로젝트를 IR 컴파일러로 마이그레이션

두 Kotlin/JS 컴파일러 간의 중요한 차이점으로 인해 Kotlin/JS 코드가 IR 컴파일러에서 작동하도록 하려면 일부 조정이 필요할 수 있습니다. Kotlin/JS IR 컴파일러 마이그레이션 가이드에서 기존 Kotlin/JS 프로젝트를 IR 컴파일러로 마이그레이션하는 방법을 알아보세요.

하위 호환성을 갖춘 IR 컴파일러용 라이브러리 제작

기본 백엔드와 새로운 IR 컴파일러 백엔드와의 호환성을 제공하려는 라이브러리 유지 관리자인 경우 컴파일러 선택을 위한 설정이 제공되어 두 백엔드 모두에 대한 아티팩트를 생성할 수 있으므로 기존 사용자에 대한 호환성을 유지하면서 차세대 Kotlin 컴파일러에 대한 지원을 제공할 수 있습니다. 이 소위 both 모드는 gradle.properties 파일에서 kotlin.js.compiler=both 설정을 사용하여 켤 수 있습니다. 또는 build.gradle(.kts) 파일 내부의 js 블록 내에서 프로젝트별 옵션 중 하나로 설정할 수 있습니다.

kotlin {
    js(BOTH) {
        // ...
    }
}

both 모드에서는 소스에서 라이브러리를 빌드할 때 IR 컴파일러 백엔드와 기본 컴파일러 백엔드가 모두 사용됩니다(따라서 이름이 붙여짐). 즉, Kotlin IR이 있는 klib 파일과 기본 컴파일러용 jar 파일이 모두 생성됩니다. 동일한 Maven 좌표로 게시되면 Gradle은 사용 사례에 따라 올바른 아티팩트를 자동으로 선택합니다. 이전 컴파일러의 경우 js, 새 컴파일러의 경우 klib입니다. 이를 통해 두 컴파일러 백엔드 중 하나를 사용하는 프로젝트에 대해 라이브러리를 컴파일하고 게시할 수 있습니다.

최상위 속성의 지연 초기화​

개발 바이너리에 대한 증분 컴파일​

출력 모드​

프로덕션에서 멤버 이름 축소​

미리 보기: TypeScript 선언 파일(d.ts) 생성​

IR 컴파일러의 현재 제한 사항​

기존 프로젝트를 IR 컴파일러로 마이그레이션​

하위 호환성을 갖춘 IR 컴파일러용 라이브러리 제작​