Kotlin/Native 타겟 지원
Kotlin/Native 컴파일러는 매우 다양한 타겟을 지원하지만, 모든 타겟에 대해 동일한 수준의 지원을 제공하기는 어렵습니다. 이 문서는 Kotlin/Native가 지원하는 타겟을 설명하고, 컴파일러 지원 수준에 따라 여러 계층(tier)으로 분류합니다.
TIP
계층 수, 지원되는 타겟 목록 및 해당 기능은 필요에 따라 조정될 수 있습니다.
계층 표에 사용된 다음 용어에 유의하십시오:
Gradle 타겟 이름은 Kotlin Multiplatform Gradle 플러그인에서 타겟을 활성화하는 데 사용되는 타겟 이름입니다.
**타겟 트리플(Target triple)**은 컴파일러에서 일반적으로 사용되는
<architecture>-<vendor>-<system>-<abi>구조에 따른 타겟 이름입니다.테스트 실행은 Gradle 및 IDE에서 기본적으로 테스트를 실행할 수 있는 지원을 의미합니다.
이는 특정 타겟의 네이티브 호스트에서만 사용할 수 있습니다. 예를 들어,
macosX64및iosX64테스트는 macOS x86-64 호스트에서만 실행할 수 있습니다.
계층 1
- 해당 타겟은 CI에서 컴파일 및 실행 가능 여부를 정기적으로 테스트합니다.
- 컴파일러 릴리스 간의 소스 및 이진 호환성을 제공합니다.
| Gradle 타겟 이름 | 타겟 트리플 | 테스트 실행 | 설명 |
|---|---|---|---|
| Apple macOS 호스트 전용: | |||
macosX64 | x86_64-apple-macos | ✅ | x86_64 플랫폼의 Apple macOS |
macosArm64 | aarch64-apple-macos | ✅ | Apple Silicon 플랫폼의 Apple macOS |
iosSimulatorArm64 | aarch64-apple-ios-simulator | ✅ | Apple Silicon 플랫폼의 Apple iOS 시뮬레이터 |
iosX64 | x86_64-apple-ios-simulator | ✅ | x86-64 플랫폼의 Apple iOS 시뮬레이터 |
iosArm64 | aarch64-apple-ios | ARM64 플랫폼의 Apple iOS 및 iPadOS |
계층 2
- 해당 타겟은 CI에서 컴파일 가능 여부를 정기적으로 테스트하지만, 실행 가능 여부는 자동으로 테스트되지 않을 수 있습니다.
- 컴파일러 릴리스 간의 소스 및 이진 호환성을 제공하기 위해 최선을 다하고 있습니다.
| Gradle 타겟 이름 | 타겟 트리플 | 테스트 실행 | 설명 |
|---|---|---|---|
linuxX64 | x86_64-unknown-linux-gnu | ✅ | x86_64 플랫폼의 Linux |
linuxArm64 | aarch64-unknown-linux-gnu | ARM64 플랫폼의 Linux | |
| Apple macOS 호스트 전용: | |||
watchosSimulatorArm64 | aarch64-apple-watchos-simulator | ✅ | Apple Silicon 플랫폼의 Apple watchOS 시뮬레이터 |
watchosX64 | x86_64-apple-watchos-simulator | ✅ | x86_64 플랫폼의 Apple watchOS 64비트 시뮬레이터 |
watchosArm32 | armv7k-apple-watchos | ARM32 플랫폼의 Apple watchOS | |
watchosArm64 | arm64_32-apple-watchos | ILP32를 사용하는 ARM64 플랫폼의 Apple watchOS | |
tvosSimulatorArm64 | aarch64-apple-tvos-simulator | ✅ | Apple Silicon 플랫폼의 Apple tvOS 시뮬레이터 |
tvosX64 | x86_64-apple-tvos-simulator | ✅ | x86_64 플랫폼의 Apple tvOS 시뮬레이터 |
tvosArm64 | aarch64-apple-tvos | ARM64 플랫폼의 Apple tvOS |
계층 3
- 해당 타겟은 CI에서 테스트된다는 보장이 없습니다.
- 다른 컴파일러 릴리스 간의 소스 및 이진 호환성을 보장할 수는 없지만, 이러한 타겟에 대한 변경 사항은 매우 드뭅니다.
| Gradle 타겟 이름 | 타겟 트리플 | 테스트 실행 | 설명 |
|---|---|---|---|
androidNativeArm32 | arm-unknown-linux-androideabi | ARM32 플랫폼의 Android NDK | |
androidNativeArm64 | aarch64-unknown-linux-android | ARM64 플랫폼의 Android NDK | |
androidNativeX86 | i686-unknown-linux-android | x86 플랫폼의 Android NDK | |
androidNativeX64 | x86_64-unknown-linux-android | x86_64 플랫폼의 Android NDK | |
mingwX64 | x86_64-pc-windows-gnu | ✅ | MinGW 호환성 계층을 사용하는 64비트 Windows 7 이상 |
| Apple macOS 호스트 전용: | |||
watchosDeviceArm64 | aarch64-apple-watchos | ARM64 플랫폼의 Apple watchOS |
NOTE
linuxArm32Hfp 타겟은 더 이상 사용되지 않으며(deprecated), 향후 릴리스에서 제거될 예정입니다.
라이브러리 개발자를 위한 안내
라이브러리 개발자는 Kotlin/Native 컴파일러보다 더 많은 타겟을 테스트하거나 더 엄격한 보장을 제공하는 것을 권장하지 않습니다. 네이티브 타겟 지원을 고려할 때 다음 접근 방식을 사용할 수 있습니다:
- 계층 1, 2, 3의 모든 타겟을 지원합니다.
- 기본적으로 테스트 실행을 지원하는 계층 1과 2의 타겟을 정기적으로 테스트합니다.
Kotlin 팀은 공식 Kotlin 라이브러리(예: kotlinx.coroutines 및 kotlinx.serialization)에서 이 접근 방식을 사용합니다.