Skip to content

iOS 통합 방법 ​

Kotlin Multiplatform 공유 모듈을 iOS 앱에 통합할 수 있습니다. 이를 위해 공유 모듈에서 iOS 프레임워크를 생성한 다음, 이를 iOS 프로젝트에 의존성으로 추가합니다:

iOS 통합 구조

이 프레임워크는 로컬 또는 원격 의존성으로 사용할 수 있습니다. 전체 코드베이스를 완전히 제어하고 공유 코드가 변경될 때 최종 애플리케이션에 즉시 업데이트를 반영하려면 로컬 통합을 선택하세요.

최종 애플리케이션의 코드베이스를 공유 코드베이스와 명시적으로 분리하려면 원격 통합을 설정하세요. 이 경우 공유 코드는 일반적인 서드파티 의존성처럼 최종 애플리케이션에 통합됩니다.

로컬 통합 ​

로컬 설정에는 두 가지 주요 통합 옵션이 있습니다. 특별한 스크립트를 통한 직접 통합을 사용하여 Kotlin 빌드를 iOS 빌드의 일부로 만들 수 있습니다. Kotlin Multiplatform 프로젝트에 Pod 의존성이 있는 경우 CocoaPods 통합 방식을 사용하세요.

직접 통합 ​

Xcode 프로젝트에 특별한 스크립트를 추가하여 Kotlin Multiplatform 프로젝트의 iOS 프레임워크를 직접 연결할 수 있습니다. 이 스크립트는 프로젝트 빌드 설정의 빌드 단계(build phase)에 통합됩니다.

이 통합 방법은 Kotlin Multiplatform 프로젝트에서 CocoaPods 의존성을 임포트하지 않는 경우에 적합합니다.

Kotlin Multiplatform IDE 플러그인을 사용하는 경우, 직접 통합이 기본적으로 적용됩니다.

자세한 내용은 직접 통합을 참고하세요.

로컬 패키지를 사용한 SwiftPM 통합 ​

KMP iOS 프레임워크는 Swift 패키지 매니저(Swift Package Manager)를 통해 로컬 Swift 패키지에 의존할 수 있습니다.

이 통합 방법은 다음과 같은 경우에 적합합니다:

  • Swift 패키지를 사용하는 iOS 프로젝트와 함께 모노레포(mono repository) 구성을 사용하는 경우.
  • Kotlin Multiplatform 프로젝트에 대체할 수 없는 CocoaPods 의존성이 없는 경우.

프로젝트에 로컬 Swift 패키지 의존성을 추가하는 방법은 Swift 패키지를 의존성으로 추가하기를 참고하세요.

로컬 podspec을 사용한 CocoaPods 통합 ​

Swift 및 Objective-C 프로젝트에서 널리 사용되는 의존성 관리자인 CocoaPods를 통해 Kotlin Multiplatform 프로젝트의 iOS 프레임워크를 연결할 수 있습니다.

이 통합 방법은 다음과 같은 경우에 적합합니다:

  • CocoaPods를 사용하는 iOS 프로젝트와 함께 모노레포(mono repository) 구성을 사용하는 경우.
  • Kotlin Multiplatform 프로젝트에서 CocoaPods 의존성을 임포트하는 경우.

로컬 CocoaPods 의존성을 사용하는 워크플로를 설정하려면 CocoaPods 개요 및 설정을 참고하세요.

원격 통합 ​

원격 통합의 경우, 프로젝트에서 Swift 패키지 매니저(SwiftPM) 또는 CocoaPods 의존성 관리자를 사용하여 Kotlin Multiplatform 프로젝트의 iOS 프레임워크를 연결할 수 있습니다.

XCFrameworks를 사용한 SwiftPM ​

XCFramework를 Kotlin Multiplatform 프로젝트에서 내보내거나, 원격 Swift 패키지를 KMP 프로젝트의 의존성으로 임포트할 수 있습니다:

XCFrameworks를 사용한 CocoaPods 통합 ​

Kotlin CocoaPods Gradle 플러그인으로 XCFramework를 빌드한 다음, CocoaPods를 통해 프로젝트의 공유 부분을 모바일 앱과 별도로 배포할 수 있습니다.

자세한 내용은 최종 네이티브 바이너리 빌드를 참고하세요.