Skip to content

iOS 의존성 추가하기 ​

Apple SDK 의존성(Foundation 또는 Core Bluetooth 등)은 Kotlin Multiplatform 프로젝트에서 사전 빌드된(prebuilt) 라이브러리 세트로 제공됩니다. 추가 설정이 필요하지 않습니다.

또한 iOS 소스 세트에서 iOS 생태계의 다른 라이브러리 및 프레임워크를 재사용할 수 있습니다. Kotlin은 Objective-C 의존성 및 API가 @objc 어트리뷰트와 함께 Objective-C로 내보내진 Swift 의존성과의 상호운용성을 지원합니다. 순수 Swift 의존성은 아직 지원되지 않습니다.

Kotlin Multiplatform 프로젝트에서 iOS 의존성을 처리하려면, cinterop 도구를 사용해 관리하거나 CocoaPods 의존성 관리자를 사용할 수 있습니다(순수 Swift Pod은 지원되지 않음).

cinterop 사용하기 ​

cinterop 도구를 사용하여 Objective-C 또는 Swift 선언에 대한 Kotlin 바인딩을 생성할 수 있습니다. 이를 통해 Kotlin 코드에서 해당 선언들을 호출할 수 있게 됩니다.

단계는 라이브러리와 프레임워크에 따라 조금씩 다르지만, 일반적인 워크플로는 다음과 같습니다:

  1. 의존성을 다운로드합니다.
  2. 바이너리를 얻기 위해 빌드합니다.
  3. cinterop에 이 의존성을 설명하는 특별한 .def 정의 파일(definition file)을 생성합니다.
  4. 빌드 중에 바인딩이 생성되도록 빌드 스크립트를 조정합니다.

라이브러리 추가하기 ​

  1. 라이브러리 소스 코드를 다운로드하고 프로젝트에서 참조할 수 있는 위치에 둡니다.

  2. 라이브러리를 빌드하고(일반적으로 라이브러리 작성자가 빌드 방법 가이드를 제공합니다) 바이너리 경로를 확인합니다.

  3. 프로젝트에서 .def 파일(예: DateTools.def)을 생성합니다.

  4. 이 파일의 첫 번째 줄에 language = Objective-C를 추가합니다. 순수 C 의존성을 사용하려는 경우 language 속성을 생략합니다.

  5. 다음 두 가지 필수 속성에 값을 제공합니다:

    • headers: cinterop이 처리할 헤더를 기술합니다.
    • package: 이러한 선언들이 배치될 패키지 이름을 설정합니다.

    예:

    none
    headers = DateTools.h
    package = DateTools
  6. 빌드 스크립트에 이 라이브러리와의 상호운용성에 대한 정보를 추가합니다:

    • .def 파일의 경로를 전달합니다. .def 파일 이름이 cinterop 이름과 같고 src/nativeInterop/cinterop/ 디렉토리에 있는 경우 이 경로는 생략할 수 있습니다.
    • includeDirs 옵션을 사용하여 cinterop이 헤더 파일을 찾을 위치를 알려줍니다.
    • 라이브러리 바이너리에 대한 링크를 설정합니다.
    kotlin
    kotlin {
        iosArm64() {
            compilations.getByName("main") {
                val DateTools by cinterops.creating {
                    // .def 파일 경로
                    definitionFile.set(project.file("src/nativeInterop/cinterop/DateTools.def"))
    
                    // 헤더 검색을 위한 디렉토리 (-I<path> 컴파일러 옵션과 유사)
                    includeDirs("include/this/directory", "path/to/another/directory")
                }
                val anotherInterop by cinterops.creating { /* ... */ }
            }
    
            binaries.all {
                // 라이브러리에 링크하기 위해 필요한 링커 옵션.
                linkerOpts("-L/path/to/library/binaries", "-lbinaryname")
            }
        }
    }
    groovy
    kotlin {
        iosArm64 {
            compilations.main {
                cinterops {
                    DateTools {
                        // .def 파일 경로
                        definitionFile = project.file("src/nativeInterop/cinterop/DateTools.def")
    
                        // 헤더 검색을 위한 디렉토리 (-I<path> 컴파일러 옵션과 유사)
                        includeDirs("include/this/directory", "path/to/another/directory")
                    }
                    anotherInterop { /* ... */ }
                }
            }
    
            binaries.all {
                // 라이브러리에 링크하기 위해 필요한 링커 옵션.
                linkerOpts "-L/path/to/library/binaries", "-lbinaryname"
            }
        }
    }
  7. 프로젝트를 빌드합니다.

이제 Kotlin 코드에서 이 의존성을 사용할 수 있습니다. 이를 위해 .def 파일의 package 속성에서 설정한 패키지를 import 하세요. 위 예시의 경우 다음과 같습니다:

kotlin
import DateTools.*

프레임워크 추가하기 ​

  1. 프레임워크 소스 코드를 다운로드하고 프로젝트에서 참조할 수 있는 위치에 둡니다.

  2. 프레임워크를 빌드하고(일반적으로 프레임워크 작성자가 빌드 방법 가이드를 제공합니다) 바이너리 경로를 확인합니다.

  3. 프로젝트에서 .def 파일(예: MyFramework.def)을 생성합니다.

  4. 이 파일의 첫 번째 줄에 language = Objective-C를 추가합니다. 순수 C 의존성을 사용하려는 경우 language 속성을 생략합니다.

  5. 다음 두 가지 필수 속성에 값을 제공합니다:

    • modules – cinterop이 처리해야 할 프레임워크의 이름입니다.
    • package – 이러한 선언들이 배치될 패키지 이름을 설정합니다.

    예:

    none
    modules = MyFramework
    package = MyFramework
  6. 빌드 스크립트에 프레임워크와의 상호운용성에 대한 정보를 추가합니다:

    • .def 파일의 경로를 전달합니다. .def 파일 이름이 cinterop 이름과 같고 src/nativeInterop/cinterop/ 디렉토리에 있는 경우 이 경로는 생략할 수 있습니다.
    • -framework 옵션을 사용하여 컴파일러와 링커에 프레임워크 이름을 전달합니다. -F 옵션을 사용하여 컴파일러와 링커에 프레임워크 소스 및 바이너리 경로를 전달합니다.
    kotlin
    kotlin {
        iosArm64() {
            compilations.getByName("main") {
                val DateTools by cinterops.creating {
                    // .def 파일 경로
                    definitionFile.set(project.file("src/nativeInterop/cinterop/DateTools.def"))
    
                    compilerOpts("-framework", "MyFramework", "-F/path/to/framework/")
                }
                val anotherInterop by cinterops.creating { /* ... */ }
            }
    
            binaries.all {
                // 링커에게 프레임워크가 위치한 곳을 알려줍니다.
                linkerOpts("-framework", "MyFramework", "-F/path/to/framework/")
            }
       }
    }
    groovy
    kotlin {
        iosArm64 {
            compilations.main {
                cinterops {
                    DateTools {
                        // .def 파일 경로
                        definitionFile = project.file("src/nativeInterop/cinterop/MyFramework.def")
    
                        compilerOpts("-framework", "MyFramework", "-F/path/to/framework/")
                    }
                    anotherInterop { /* ... */ }
                }
            }
    
            binaries.all {
                // 링커에게 프레임워크가 위치한 곳을 알려줍니다.
                linkerOpts("-framework", "MyFramework", "-F/path/to/framework/")
            }
        }
    }
  7. 프로젝트를 빌드합니다.

이제 Kotlin 코드에서 이 의존성을 사용할 수 있습니다. 이를 위해 .def 파일의 package 속성에서 설정한 패키지를 import 하세요. 위 예시의 경우 다음과 같습니다:

kotlin
import MyFramework.*

Swift/Objective-C 상호운용성 및 Gradle에서 cinterop 구성하기에 대해 더 자세히 알아보세요.

CocoaPods 사용하기 ​

  1. 초기 CocoaPods 통합 설정을 수행합니다.

  2. 사용하려는 CocoaPods 저장소의 Pod 라이브러리에 대한 의존성을 추가하려면 프로젝트의 build.gradle(.kts)에 pod() 함수 호출을 포함합니다.

    kotlin
    kotlin {
        cocoapods {
            version = "2.0"
            //..
            pod("SDWebImage") {
                version = "5.20.0"
            }
        }
    }
    groovy
    kotlin {
        cocoapods {
            version = '2.0'
            //..
            pod('SDWebImage') {
                version = '5.20.0'
            }
        }
    }

    다음과 같은 방식으로 Pod 라이브러리에 대한 의존성을 추가할 수 있습니다:

  3. 프로젝트를 다시 가져오기 위해 IntelliJ IDEA에서 Build | Reload All Gradle Projects를 실행합니다(또는 Android Studio에서 File | Sync Project with Gradle Files 실행).

Kotlin 코드에서 의존성을 사용하려면 cocoapods.<library-name> 패키지를 import 하세요. 위 예시의 경우 다음과 같습니다:

kotlin
import cocoapods.SDWebImage.*

다음 단계는? ​

멀티플랫폼 프로젝트에서 의존성을 추가하는 다른 리소스를 확인하고 다음에 대해 더 자세히 알아보세요: