向项目添加依赖项

本教程使用 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

添加依赖项
共享更多逻辑
完成你的项目

你已经创建了第一个跨平台 Kotlin Multiplatform 项目！现在，让我们学习如何向第三方库添加依赖项，这对于构建成功的跨平台应用程序至关重要。

依赖项类型

在 Kotlin Multiplatform 项目中，你可以使用两种类型的依赖项：

• Multiplatform 依赖项。这些是支持多个目标平台并可在公共源代码集 commonMain 中使用的 Multiplatform 库。

  许多现代 Android 库已经支持 Multiplatform，例如 Koin、Apollo 和 Okio。在 klibs.io 上查找更多 Multiplatform 库，这是一个 JetBrains 提供的用于发现 Kotlin Multiplatform 库的实验性的搜索服务。

• 原生依赖项。这些是来自相关生态系统的常规库。在原生项目中，你通常使用 Gradle（针对 Android）以及 CocoaPods 或其他依赖项管理器（针对 iOS）来处理它们。

  当你使用共享模块时，通常当你想要使用平台 API（例如安全存储）时，仍然需要原生依赖项。你可以将原生依赖项添加到原生源代码集 androidMain 和 iosMain 中。

对于这两种类型的依赖项，你可以使用本地和外部版本库。

添加 Multiplatform 依赖项

如果你拥有 Android 应用开发经验，添加 Multiplatform 依赖项类似于在常规 Android 项目中添加 Gradle 依赖项。唯一的区别是你需要指定源代码集。

让我们回到应用，让问候语更喜庆一些。除了设备信息之外，再添加一个函数来显示距离元旦剩余的天数。kotlinx-datetime 库拥有完整的 Multiplatform 支持，是你在共享代码中处理日期最便捷的方式。

1. 打开位于 shared 目录下的 build.gradle.kts 文件。

2. 将以下依赖项和 Kotlin 时间 opt-in 添加到 commonMain 源代码集依赖项中：

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

3. 点击 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 配置：

下一步

在教程的下一部分，你将为项目添加更多依赖项和更复杂的逻辑。

继续下一部分

另请参阅

• 了解如何使用所有类型的 Multiplatform 依赖项：Kotlin 库、Kotlin Multiplatform 库以及其他 Multiplatform 项目。
• 学习如何添加 Android 依赖项以及使用或不使用 CocoaPods 添加 iOS 依赖项以在平台特有的源代码集中使用。
• 查看在示例项目中如何使用 Android 和 iOS 库的示例。

获取帮助

• Kotlin Slack。获取邀请并加入 #multiplatform 频道。
• Kotlin 问题追踪器。报告新问题。