添加 Pod 库依赖项

从 CocoaPods 仓库添加 Pod 库依赖项

1. 在 pod() 函数内指定 Pod 库名称.

   在配置代码段中, 可以使用 version 参数指定库的版本. 要使用库的最新版本, 可以完全省略这个参数.

   note

   可以添加对 subspecs 的依赖项.

2. 指定 Pod 库的部署目标(deployment target)最小版本.

   kotlin {
       iosArm64()
   
       cocoapods {
           iosArm64.deploymentTarget = "13.5"
   
           summary = "CocoaPods test library"
           homepage = "https://github.com/JetBrains/kotlin"
   
           pod("FirebaseAuth") {
               version = "10.16.0"
           }
       }
   }

3. 在 IntelliJ IDEA 中, 运行 Reload All Gradle Projects (如果是 Android Studio, 请运行 Sync Project with Gradle Files), 重新导入项目.

要在 Kotlin 代码中使用这些依赖项, 需要导入 cocoapods.<library-name> 包:

import cocoapods.FirebaseAuth.*

使用保存在本地的 Pod 库添加依赖项

1. 在 pod() 函数内指定 Pod 库名称.

   在配置代码段中, 指定本地 Pod 库的路径: 在 source 参数值中使用 path() 函数.

   note

   也可以添加本地 subspecs 的依赖项. cocoapods 代码段可以同时包含保存在本地的 Pod 库的依赖项, 以及 CocoaPods 仓库的 Pod 库的依赖项.

2. 指定 Pod 库的部署目标(deployment target)最小版本.

   kotlin {
       iosArm64()
   
       cocoapods {
           summary = "CocoaPods test library"
           homepage = "https://github.com/JetBrains/kotlin"
   
           iosArm64.deploymentTarget = "13.5"
   
           pod("pod_dependency") {
               version = "1.0"
               source = path(project.file("../pod_dependency"))
           }
           pod("subspec_dependency/Core") {
               version = "1.0"
               source = path(project.file("../subspec_dependency"))
           }
           pod("FirebaseAuth") {
               version = "10.16.0"
           }
       }
   }

   note

   也可以在配置代码段中使用 version 参数指定库的版本. 要使用库的最新版本, 可以省略这个参数.

3. 在 IntelliJ IDEA 中, 运行 Reload All Gradle Projects (如果是 Android Studio, 请运行 Sync Project with Gradle Files), 重新导入项目.

要在 Kotlin 代码中使用这些依赖项, 需要导入 cocoapods.<library-name> 包:

import cocoapods.pod_dependency.*
import cocoapods.subspec_dependency.*
import cocoapods.FirebaseAuth.*

从自定义的 Git 仓库添加 Pod 库依赖项

1. 在 pod() 函数内指定 Pod 库名称.

   在配置代码段中, 指定 git 仓库路径: 在 source 参数中使用 git() 函数.

   此外, 还可以在 git() 之后的代码段中指定以下参数:

   • commit – 使用仓库中特定的 commit

   • tag – 使用仓库中特定的 tag

   • branch – 使用仓库中特定的 branch

   git() 函数的参数优先级顺序如下: commit, tag, branch. 如果不指定参数, Kotlin plugin 使用 master branch 中的 HEAD.

   note

   可以组合 branch, commit, 和 tag 参数来得到 Pod 库的特定版本.

2. 指定 Pod 库的部署目标(deployment target)最小版本.

   kotlin {
       iosArm64()
   
       cocoapods {
           summary = "CocoaPods test library"
           homepage = "https://github.com/JetBrains/kotlin"
   
           iosArm64.deploymentTarget = "13.5"
   
           pod("FirebaseAuth") {
               source = git("https://github.com/firebase/firebase-ios-sdk") {
                   tag = "10.16.0"
               }
           }
   
           pod("JSONModel") {
               source = git("https://github.com/jsonmodel/jsonmodel.git") {
                   branch = "key-mapper-class"
               }
           }
   
           pod("CocoaLumberjack") {
               source = git("https://github.com/CocoaLumberjack/CocoaLumberjack.git") {
                   commit = "3e7f595e3a459c39b917aacf9856cd2a48c4dbf3"
               }
           }
       }
   }

3. 在 IntelliJ IDEA 中, 运行 Reload All Gradle Projects (如果是 Android Studio, 请运行 Sync Project with Gradle Files), 重新导入项目.

要在 Kotlin 代码中使用这些依赖项, 需要导入 cocoapods.<library-name> 包:

import cocoapods.Alamofire.*
import cocoapods.JSONModel.*
import cocoapods.CocoaLumberjack.*

从自定义 Podspec 仓库添加 Pod 库依赖项

1. 在 specRepos 代码段之内, 使用 url() 函数, 指定自定义 Podspec 仓库的 HTTP 地址.

2. 在 pod() 函数内指定 Pod 库名称.

3. 指定 Pod 库的部署目标(deployment target)最小版本.

   kotlin {
       iosArm64()
   
       cocoapods {
           summary = "CocoaPods test library"
           homepage = "https://github.com/JetBrains/kotlin"
   
           iosArm64.deploymentTarget = "13.5"
   
           specRepos {
               url("https://github.com/Kotlin/kotlin-cocoapods-spec.git")
           }
           pod("example")
       }
   }

4. 在 IntelliJ IDEA 中, 运行 Reload All Gradle Projects (如果是 Android Studio, 请运行 Sync Project with Gradle Files), 重新导入项目.

note

要与 Xcode 正确的协同工作, 需要在你的 Podfile 文件的最开始指定 spec 的位置. 例如:

source 'https://github.com/Kotlin/kotlin-cocoapods-spec.git'

要在 Kotlin 代码中使用这些依赖项, 需要导入 cocoapods.<library-name> 包:

import cocoapods.example.*

使用自定义 cinterop 选项添加 Pod 库依赖项

1. 在 pod() 函数内指定 Pod 库名称.

   在配置代码段中, 指定 cinterop 选项:

   • extraOpts – 指定对 Pod 库的选项列表. 例如, 指定 flag: extraOpts = listOf("-compiler-option").

   • packageName – 指定包名称. 如果有指定, 可以使用这个包名称导入这个库: import <packageName>.

2. 指定 Pod 库的部署目标(deployment target)最小版本.

   kotlin {
       iosArm64()
   
       cocoapods {
           summary = "CocoaPods test library"
           homepage = "https://github.com/JetBrains/kotlin"
   
           iosArm64.deploymentTarget = "13.5"
   
           pod("YandexMapKit") {
               packageName = "YandexMK"
           }
       }
   }

3. 在 IntelliJ IDEA 中, 运行 Reload All Gradle Projects (如果是 Android Studio, 请运行 Sync Project with Gradle Files), 重新导入项目.

要在 Kotlin 代码中使用这些依赖项, 需要导入 cocoapods.<library-name> 包:

import cocoapods.YandexMapKit.*

如果使用了 packageName 参数, 那么可以使用包这个名称导入这个库 import <packageName>:

import YandexMK.YMKPoint
import YandexMK.YMKDistance

kotlin {
    iosArm64()

    cocoapods {
        summary = "CocoaPods test library"
        homepage = "https://github.com/JetBrains/kotlin"

        iosArm64.deploymentTarget = "13.5"

        pod("PodName") {
            extraOpts = listOf("-compiler-option", "-fmodules")
        }
    }
}

// pod("WebImage") 的 cinterop:
fun loadImage(): WebImage

// pod("Info") 的 cinterop:
fun printImageInfo(image: WebImage)

// 你的代码:
printImageInfo(loadImage())