添加 iOS 依赖项

添加不使用 CocoaPods 的库

1. 下载库的源代码，并将其放置在项目中可以引用的位置。

2. 构建该库（库的作者通常会提供构建指南），并获取二进制文件的路径。

3. 在项目中创建一个 .def 文件，例如 DateTools.def。

4. 在此文件中添加第一行： language = Objective-C 。如果你想使用纯 C 依赖项，可以省略 language 属性。

5. 为两个必需的属性提供值：

   • headers 描述 cinterop 将处理哪些头文件。

   • package 设置这些声明应放入的包名。

   例如：

   headers = DateTools.h package = DateTools

6. 在构建脚本中添加与此库的互操作性信息：

   • 传递 .def 文件的路径。如果你的 .def 文件与 cinterop 同名并且放置在 src/nativeInterop/cinterop/ 目录中，则可以省略此路径。

   • 使用 includeDirs 选项告诉 cinterop 在哪里查找头文件。

   • 配置链接库二进制文件。

   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") } } }

   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 属性中设置的包。对于上述示例，这将是：

添加不使用 CocoaPods 的框架

1. 下载框架的源代码，并将其放置在项目中可以引用的位置。

2. 构建框架（框架的作者通常会提供构建指南），并获取二进制文件的路径。

3. 在项目中创建一个 .def 文件，例如 MyFramework.def。

4. 在此文件中添加第一行： language = Objective-C 。如果你想使用纯 C 依赖项，可以省略 language 属性。

5. 为这两个必需的属性提供值：

• modules – 应由 cinterop 处理的框架名称。

• package – 这些声明应放入的包名。

例如：

6. 在构建脚本中添加与框架的互操作性信息：

   • 传递 .def 文件的路径。如果你的 .def 文件与 cinterop 同名并且放置在 src/nativeInterop/cinterop/ 目录中，则可以省略此路径。

   • 使用 -framework 选项将框架名称传递给编译器和链接器。 使用 -F 选项将框架源代码和二进制文件的路径传递给编译器和链接器。

   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/") } } }

   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 属性中设置的包。对于上述示例，这将是：

了解更多关于 Objective-C 和 Swift 互操作性 和 从 Gradle 配置 cinterop。