플랫폼 간 코드 공유
Kotlin Multiplatform를 사용하면 Kotlin이 제공하는 메커니즘을 통해 코드를 공유할 수 있습니다.
- 프로젝트에 사용된 모든 플랫폼 간 코드 공유. 모든 플랫폼에 적용되는 공통 비즈니스 로직을 공유하는 데 사용합니다.
- 프로젝트에 포함된 일부 플랫폼 간 코드 공유(전체는 아님). 계층 구조를 활용하여 유사한 플랫폼에서 코드를 재사용할 수 있습니다.
공유 코드에서 플랫폼별 API에 접근해야 하는 경우, Kotlin의 예상 및 실제 선언(expected and actual declarations) 메커니즘을 사용하세요.
모든 플랫폼 간 코드 공유
모든 플랫폼에 공통적으로 적용되는 비즈니스 로직이 있다면, 각 플랫폼마다 동일한 코드를 작성할 필요 없이 공통 소스 세트에서 공유하면 됩니다.
일부 소스 세트의 의존성은 기본적으로 설정됩니다. 수동으로 dependsOn 관계를 지정할 필요가 없습니다.
jvmMain,macosX64Main등 공통 소스 세트에 의존하는 모든 플랫폼별 소스 세트.androidMain및androidUnitTest와 같은 특정 타겟의main및test소스 세트 간.
공유 코드에서 플랫폼별 API에 접근해야 하는 경우, Kotlin의 예상 및 실제 선언 메커니즘을 사용하세요.
유사한 플랫폼 간 코드 공유
종종 많은 공통 로직과 서드파티 API를 재사용할 수 있는 여러 네이티브 타겟을 생성해야 할 수 있습니다.
예를 들어, iOS를 타겟으로 하는 일반적인 멀티플랫폼 프로젝트에는 두 가지 iOS 관련 타겟이 있습니다. 하나는 iOS ARM64 기기용이고 다른 하나는 x64 시뮬레이터용입니다. 이들은 별도의 플랫폼별 소스 세트를 가지고 있지만, 실제로는 기기와 시뮬레이터에 다른 코드가 필요한 경우는 거의 없으며, 그들의 의존성도 거의 동일합니다. 따라서 iOS 관련 코드는 이들 간에 공유될 수 있습니다.
분명히, 이러한 설정에서는 두 iOS 타겟을 위한 공유 소스 세트를 갖는 것이 바람직할 것입니다. 이 공유 소스 세트는 iOS 기기와 시뮬레이터 모두에 공통적인 API를 Kotlin/Native 코드가 직접 호출할 수 있도록 합니다.
이 경우, 다음 방법 중 하나를 사용하여 **계층 구조(hierarchical structure)**를 통해 프로젝트의 네이티브 타겟 간에 코드를 공유할 수 있습니다.
라이브러리에서 코드 공유 및 **플랫폼별 라이브러리 연결**에 대해 자세히 알아보세요.
라이브러리에서 코드 공유
계층적 프로젝트 구조 덕분에, 라이브러리는 타겟의 하위 집합에 공통 API를 제공할 수도 있습니다. 라이브러리가 게시될 때(published), 해당 중간 소스 세트의 API는 프로젝트 구조에 대한 정보와 함께 라이브러리 아티팩트에 포함됩니다. 이 라이브러리를 사용할 때, 프로젝트의 중간 소스 세트는 각 소스 세트의 타겟에 사용 가능한 라이브러리의 API에만 접근합니다.
예를 들어, kotlinx.coroutines 저장소의 다음 소스 세트 계층을 확인해보세요.
concurrent 소스 세트는 runBlocking 함수를 선언하고 JVM 및 네이티브 타겟을 위해 컴파일됩니다. kotlinx.coroutines 라이브러리가 계층적 프로젝트 구조로 업데이트 및 게시되면, 라이브러리의 concurrent 소스 세트의 "타겟 시그니처(targets signature)"와 일치하기 때문에 JVM과 네이티브 타겟 간에 공유되는 소스 세트에서 runBlocking을 의존하고 호출할 수 있습니다.
플랫폼별 라이브러리 연결
플랫폼별 의존성에 제한받지 않고 더 많은 네이티브 코드를 공유하려면 Foundation, UIKit, POSIX와 같은 **플랫폼 라이브러리(platform libraries)**를 사용하세요. 이 라이브러리들은 Kotlin/Native와 함께 제공되며 기본적으로 공유 소스 세트에서 사용할 수 있습니다.
또한, 프로젝트에서 Kotlin CocoaPods Gradle 플러그인을 사용하는 경우, **cinterop 메커니즘**을 통해 사용되는 서드파티 네이티브 라이브러리와 작업할 수 있습니다.
다음 단계는 무엇인가요?
- **Kotlin의 예상 및 실제 선언 메커니즘**에 대해 읽어보세요.
- **계층적 프로젝트 구조**에 대해 자세히 알아보세요.
- **멀티플랫폼 라이브러리 게시**를 설정하세요.
- **멀티플랫폼 프로젝트에서 소스 파일 이름 지정에 대한 권장 사항**을 확인하세요.