프로젝트에 의존성 추가하기

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

이 문서는 공유 로직 및 네이티브 UI를 사용하여 Kotlin Multiplatform 앱 생성하기 튜토리얼의 세 번째 파트입니다. 계속 진행하기 전에 이전 단계를 완료했는지 확인하세요.

Kotlin Multiplatform 앱 생성하기

This tutorial uses IntelliJ IDEA, but you can also follow it in Android Studio – both IDEs share the same core functionality and Kotlin Multiplatform support. This is the first part of the Create a Kotlin Multiplatform app with shared logic and native UI tutorial. Create your Kotlin Multiplatform app Update the user interface Add dependencies Share more logic Wrap up your project

사용자 인터페이스 업데이트하기

This tutorial uses IntelliJ IDEA, but you can also follow it in Android Studio – both IDEs share the same core functionality and Kotlin Multiplatform support. This is the second part of the Create a Kotlin Multiplatform app with shared logic and native UI tutorial. Before proceeding, make sure you've completed previous steps. Create your Kotlin Multiplatform app Update the user interface Add dependencies Share more logic Wrap up your project

의존성 추가하기
더 많은 로직 공유하기
프로젝트 마무리하기

첫 번째 크로스 플랫폼(cross-platform) Kotlin Multiplatform 프로젝트를 이미 생성했습니다! 이제 성공적인 크로스 플랫폼 애플리케이션을 구축하는 데 필요한 서드파티 라이브러리에 의존성을 추가하는 방법을 알아보겠습니다.

의존성 유형

Kotlin Multiplatform 프로젝트에서 사용할 수 있는 의존성 유형에는 두 가지가 있습니다.

• 멀티플랫폼 의존성(Multiplatform dependencies). 이들은 여러 타겟을 지원하며 공통 소스 세트(commonMain)에서 사용할 수 있는 멀티플랫폼 라이브러리입니다.

  많은 최신 Android 라이브러리는 이미 Koin, Apollo, Okio와 같은 멀티플랫폼 지원을 제공합니다. JetBrains가 Kotlin Multiplatform 라이브러리를 검색하기 위해 만든 실험적인 검색 서비스인 klibs.io에서 더 많은 멀티플랫폼 라이브러리를 찾아보세요.

• 네이티브 의존성(Native dependencies). 이들은 관련 생태계의 일반 라이브러리입니다. 네이티브 프로젝트에서는 Android의 경우 Gradle, iOS의 경우 CocoaPods 또는 다른 의존성 관리자를 사용하여 주로 작업합니다.

  공유 모듈을 사용할 때, 일반적으로 보안 저장소와 같은 플랫폼 API를 사용하려면 여전히 네이티브 의존성이 필요합니다. 네이티브 의존성은 네이티브 소스 세트인 androidMain 및 iosMain에 추가할 수 있습니다.

두 가지 유형의 의존성 모두 로컬 및 외부 저장소를 사용할 수 있습니다.

멀티플랫폼 의존성 추가하기

Android 앱 개발 경험이 있다면, 멀티플랫폼 의존성을 추가하는 것은 일반적인 Android 프로젝트에서 Gradle 의존성을 추가하는 것과 유사합니다. 유일한 차이점은 소스 세트를 지정해야 한다는 것입니다.

앱으로 돌아가 인사를 좀 더 축제 분위기로 만들어 봅시다. 기기 정보 외에, 새해까지 남은 일수를 표시하는 함수를 추가해 보세요. 완전한 멀티플랫폼 지원을 제공하는 kotlinx-datetime 라이브러리는 공유 코드에서 날짜를 다루는 가장 편리한 방법입니다.

1. shared 디렉터리에 있는 build.gradle.kts 파일을 엽니다.

2. 다음 의존성과 Kotlin time 옵트인(opt-in)을 commonMain 소스 세트의 의존성에 추가합니다.

   kotlin {
       //... 
       sourceSets
           languageSettings.optIn("kotlin.time.ExperimentalTime")
           commonMain.dependencies {
               implementation("org.jetbrains.kotlinx:kotlinx-datetime:0.7.1")
           } 
       }
   }

3. Gradle 변경사항 동기화(Sync Gradle Changes) 버튼을 클릭하여 Gradle 파일을 동기화합니다.

4. shared/src/commonMain/kotlin에서 Greeting.kt 파일이 있는 프로젝트 디렉터리에 NewYear.kt라는 새 파일을 생성합니다.

5. date-time 날짜 연산을 사용하여 오늘부터 새해까지 남은 일수를 계산하는 짧은 함수로 파일을 업데이트합니다.

   import kotlinx.datetime.*
   import kotlin.time.Clock
   
   fun daysUntilNewYear(): Int {
       val today = Clock.System.todayIn(TimeZone.currentSystemDefault())
       val closestNewYear = LocalDate(today.year + 1, 1, 1)
       return today.daysUntil(closestNewYear)
   }
   
   fun daysPhrase(): String = "There are only ${daysUntilNewYear()} days left until New Year! 🎆"

6. Greeting.kt에서 결과를 확인하기 위해 Greeting 클래스를 업데이트합니다.

   class Greeting {
       private val platform: Platform = getPlatform()
   
       fun greet(): List<String> = buildList {
           add(if (Random.nextBoolean()) "Hi!" else "Hello!")
           add("Guess what this is! > ${platform.name.reversed()}!")
           add(daysPhrase())
       }
   }

7. 결과를 확인하려면 IntelliJ IDEA에서 composeApp 및 iosApp 구성을 다시 실행합니다.

다음 단계

튜토리얼의 다음 부분에서는 프로젝트에 더 많은 의존성과 더 복잡한 로직을 추가할 것입니다.

다음 파트로 진행하기

참고 자료

• 모든 종류의 멀티플랫폼 의존성 작업 방법 알아보기: Kotlin 라이브러리, Kotlin 멀티플랫폼 라이브러리 및 기타 멀티플랫폼 프로젝트.
• 플랫폼별 소스 세트에서 사용할 Android 의존성 추가 방법 및 CocoaPods 유무에 관계없이 iOS 의존성 추가 방법 알아보기.
• 샘플 프로젝트에서 Android 및 iOS 라이브러리 사용 방법 예시 확인하기.

도움 받기

• Kotlin Slack. 초대 받기 및 #multiplatform 채널 참여.
• Kotlin 이슈 트래커. 새로운 이슈 보고하기.