Kotlin 멀티플랫폼 라이브러리 생성하기 – 튜토리얼

이 튜토리얼은 IntelliJ IDEA를 사용하지만, Android Studio에서도 따라 할 수 있습니다. 두 IDE 모두 동일한 핵심 기능과 Kotlin Multiplatform 지원을 공유합니다.

이 튜토리얼에서는 IntelliJ IDEA에서 멀티플랫폼 라이브러리를 생성하고, 로컬 Maven 저장소에 라이브러리를 게시하고, 다른 프로젝트에 의존성으로 추가하는 방법을 알아봅니다.

이 튜토리얼은 피보나치 수열을 생성하는 함수를 포함하는 간단한 라이브러리인 저희 멀티플랫폼 라이브러리 템플릿을 기반으로 합니다.

환경 설정

필요한 모든 도구를 설치하고 최신 버전으로 업데이트하세요.

프로젝트 생성

1. IntelliJ IDEA에서 파일 | 새로 만들기 | 버전 제어에서 프로젝트 가져오기를 선택합니다.

2. 멀티플랫폼 라이브러리 템플릿 프로젝트의 URL을 입력합니다:

   https://github.com/Kotlin/multiplatform-library-template

3. 클론을 클릭합니다.

프로젝트 구조 살펴보기

Kotlin 멀티플랫폼 라이브러리 템플릿 프로젝트는 Kotlin 멀티플랫폼 라이브러리 개발을 위한 기본 구조를 제공합니다. 이 템플릿은 다양한 플랫폼에서 작동할 수 있는 라이브러리를 생성하는 데 도움이 됩니다.

템플릿 프로젝트에서 library는 핵심 모듈 역할을 하며, 멀티플랫폼 라이브러리의 주요 소스 코드와 빌드 리소스를 포함합니다.

library 모듈은 공유 코드뿐만 아니라 플랫폼별 구현을 수용하도록 구성되어 있습니다. 다음은 주요 소스 코드(src)의 내용 분석입니다:

• commonMain: 모든 대상 플랫폼에서 공유되는 Kotlin 코드를 포함합니다. 이 디렉토리는 플랫폼별 API에 의존하지 않는 코드를 배치하는 곳입니다.
• androidMain, iosMain, jvmMain, linuxX64Main: Android, iOS, JVM 및 Linux 플랫폼에 특화된 코드를 포함합니다. 이 디렉토리는 해당 플랫폼에 고유한 기능을 구현하는 곳입니다.
• commonTest, androidUnitTest, iosTest, jvmTest, linuxX64Test: 공유 commonMain 코드에 대한 테스트와 Android, iOS, JVM 및 Linux 플랫폼에 특화된 테스트를 각각 포함합니다.

이제 모든 플랫폼에서 공유되는 library 코드를 살펴보겠습니다. src/commonMain/kotlin 디렉토리 안에 피보나치 수열 생성기를 정의하는 Kotlin Multiplatform 코드가 포함된 CustomFibi.kt 파일을 찾을 수 있습니다:

package io.github.kotlin.fibonacci

// Defines the function to generate the Fibonacci sequence
fun generateFibi() = sequence {
    var a = firstElement
    yield(a)
    
    var b = secondElement
    yield(b)
    
    while (true) {
        val c = a + b
        yield(c)
        a = b
        b = c
    }
}

// Declares the expected values for `firstElement` and `secondElement`
expect val firstElement: Int
expect val secondElement: Int

firstElement와 secondElement 속성은 플랫폼별 코드가 구현할 수 있는 플레이스홀더입니다. 각 대상은 해당 소스 세트에서 actual 키워드를 사용하여 실제 값을 제공해야 합니다.

expect 선언은 actual 구현과 매칭됩니다. 이 메커니즘은 플랫폼별 동작이 필요한 크로스 플랫폼 코드를 작성할 때 유용합니다.

이 경우, 멀티플랫폼 라이브러리 템플릿은 firstElement 및 secondElement 속성의 플랫폼별 구현을 포함합니다. androidMain, iosMain, jvmMain, linuxX64Main 디렉토리에는 이러한 속성에 대한 값을 제공하는 actual 선언이 포함되어 있습니다.

예를 들어, 다음은 androidMain/kotlin/fibiprops.android.kt에 포함된 Android 구현입니다:

package io.github.kotlin.fibonacci

actual val firstElement: Int = 1
actual val secondElement: Int = 2

다른 플랫폼들도 firstElement 및 secondElement 속성의 값에 차이가 있을 뿐 동일한 패턴을 따릅니다.

새 플랫폼 추가

이제 템플릿에서 공유 코드와 플랫폼별 코드가 어떻게 작동하는지 익숙해졌으므로, 추가 플랫폼 지원을 추가하여 프로젝트를 확장해 보겠습니다.

expect/actual 메커니즘을 사용하여 Kotlin/Wasm 플랫폼에 대한 지원을 구성하세요. firstElement 및 secondElement 속성에 대한 플랫폼별 기능을 구현할 수 있습니다.

프로젝트에 Kotlin/Wasm 대상 추가

1. library/build.gradle.kts 파일에 Kotlin/Wasm 대상(wasmJs)과 소스 세트를 추가합니다:

   kotlin {
       // ...
       @OptIn(org.jetbrains.kotlin.gradle.ExperimentalWasmDsl::class)
       wasmJs {
           browser()
           // ...
           binaries.executable()
       }
       // ...
       sourceSets {
           //...
           val wasmJsMain by getting {
               dependencies {
                   // Wasm-specific dependencies
               }
           }
       }
   }

2. 빌드 파일에 나타나는 Gradle 변경 사항 동기화 아이콘 ()을 클릭하여 Gradle 파일을 동기화합니다. 또는 Gradle 도구 창에서 새로고침 버튼을 클릭합니다.

Wasm용 플랫폼별 코드 생성

Wasm 대상을 추가한 후, firstElement 및 secondElement의 플랫폼별 구현을 담을 Wasm 디렉토리가 필요합니다:

1. library/src 디렉토리를 마우스 오른쪽 버튼으로 클릭하고 새로 만들기 | 디렉토리를 선택합니다.

2. Gradle 소스 세트 목록에서 wasmJsMain/kotlin을 선택합니다.

   

3. 새로 생성된 wasmJsMain/kotlin 디렉토리를 마우스 오른쪽 버튼으로 클릭하고 새로 만들기 | Kotlin 클래스/파일을 선택합니다.

4. 파일 이름으로 fibiprops.wasm을 입력하고 파일을 선택합니다.

5. fibiprops.wasm.kt 파일에 다음 코드를 추가합니다:

   package io.github.kotlin.fibonacci
   
   actual val firstElement: Int = 3
   actual val secondElement: Int = 5

   이 코드는 firstElement를 3, secondElement를 5로 actual 값을 정의하여 Wasm 전용 구현을 설정합니다.

프로젝트 빌드

새 플랫폼으로 프로젝트가 올바르게 컴파일되는지 확인하세요:

1. 보기 | 도구 창 | Gradle을 선택하여 Gradle 도구 창을 엽니다.

2. multiplatform-library-template | library | Tasks | build에서 build 태스크를 실행합니다.

   

   또는 multiplatform-library-template 루트 디렉토리에서 터미널에 다음 명령을 실행합니다:

   ./gradlew build

빌드 도구 창에서 성공적인 출력을 확인할 수 있습니다.

로컬 Maven 저장소에 라이브러리 게시

멀티플랫폼 라이브러리가 로컬에 게시될 준비가 되어 동일한 머신의 다른 프로젝트에서 사용할 수 있습니다.

라이브러리를 게시하려면 maven-publish Gradle 플러그인을 다음과 같이 사용합니다:

1. library/build.gradle.kts 파일에서 plugins { } 블록을 찾아 maven-publish 플러그인을 적용합니다:

      plugins {
          // ...
          // Add the following line:
          id("maven-publish")
      }

2. mavenPublishing { } 블록을 찾아 signAllPublications() 메서드를 주석 처리하여 게시가 로컬 전용임을 나타냅니다:

   mavenPublishing{
       // ...
       // Comment out the following method:
       // signAllPublications()
   }

3. 빌드 파일에 나타나는 Gradle 변경 사항 동기화 아이콘 ()을 클릭하여 Gradle 파일을 동기화합니다. 또는 Gradle 도구 창에서 새로고침 버튼을 클릭합니다.

4. Gradle 도구 창에서 multiplatform-library-template | Tasks | publishing으로 이동하여 publishToMavenLocal Gradle 태스크를 실행합니다.

   

   또는 multiplatform-library-template 루트 디렉토리에서 터미널에 다음 명령을 실행합니다:

   ./gradlew publishToMavenLocal

라이브러리가 로컬 Maven 저장소에 게시되었습니다.

게시된 라이브러리를 찾으려면 파일 탐색기나 터미널을 사용하여 사용자 홈 디렉토리의 .m2\repository\io\github\kotlin\library\1.0.0\으로 이동하세요.

다른 프로젝트에 라이브러리를 의존성으로 추가

멀티플랫폼 라이브러리를 로컬 Maven 저장소에 게시한 후, 동일한 머신의 다른 Kotlin 프로젝트에서 이를 사용할 수 있습니다.

소비 프로젝트의 build.gradle.kts 파일에 게시된 라이브러리에 대한 의존성을 추가합니다:

repositories {
    // ...
    mavenLocal()
}

dependencies {
    // ...
    implementation("io.github.kotlin:library:1.0.0")
}

repositories{} 블록은 Gradle에게 로컬 Maven 저장소에서 라이브러리를 해결하고 공유 코드에서 사용할 수 있도록 지시합니다.

implementation 의존성은 build.gradle.kts 파일에 지정된 라이브러리의 그룹 및 버전으로 구성됩니다.

다른 멀티플랫폼 프로젝트에 추가하는 경우, 공유 또는 플랫폼별 소스 세트에 추가할 수 있습니다:

kotlin {
    //...
    sourceSets {
        // 모든 플랫폼용
        val commonMain by getting {
            dependencies {
                implementation("io.github.kotlin:library:1.0.0")
            }
        }
        // 또는 특정 플랫폼용
        val wasmJsMain by getting {
            dependencies {
                implementation("io.github.kotlin:library:1.0.0")
            }
        }
    }
}

소비 프로젝트를 동기화하고 라이브러리를 사용하기 시작하세요!

다음 단계

멀티플랫폼 개발을 더 탐구해 보세요:

• 라이브러리를 Maven Central에 게시
• 라이브러리 작성자 가이드라인 확인

커뮤니티 참여:

• Compose Multiplatform GitHub: 저장소에 별표를 누르고 기여하세요.
• Kotlin Slack: 초대를 받고 #multiplatform 채널에 참여하세요.
• Stack Overflow: "kotlin-multiplatform" 태그를 구독하세요.
• Kotlin YouTube 채널: 구독하고 Kotlin Multiplatform에 대한 비디오를 시청하세요.