添加 iOS 依赖项

不使用 CocoaPods, 添加一个库

1. 下载库的源代码, 放在从你的项目可以引用的某个地方.

2. 构建库 (库作者通常会提供文档说明具体方法), 得到二进制文件路径.

3. 在你的项目中, 创建一个 .def 文件, 比如 DateTools.def.

4. 向这个文件添加第 1 行内容: language = Objective-C. 如果你想要使用一个纯 C 的依赖项, 请省略 language 属性.

5. 为这 2 个必须属性指定值:

   • headers 描述哪些头文件要由 cinterop 处理.

   • package 设置这些声明应该放置的包名称.

   比如:

   headers = DateTools.h
   package = DateTools

6. 向构建脚本添加与这个库交互的信息:

   • 传递 .def 文件的路径. 如果你的 .def 文件与 cinterop 名称相同, 并放置在 src/nativeInterop/cinterop/ 目录中, 那么这个路径可以省略.

   • 使用 includeDirs 选项, 告诉 cinterop 到哪里寻找头文件.

   • 配置如何链接到库的二进制文件.

   Kotlin

   Groovy

   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 属性中设置的那个包. 对于上面的示例, 应该是:

import DateTools.*

不使用 CocoaPods, 添加一个框架

1. 下载框架源代码, 放在从你的项目可以引用的某个地方.

2. 构建框架 (框架作者通常会提供文档说明具体方法), 得到二进制文件路径.

3. 在你的项目中, 创建一个 .def 文件, 比如 MyFramework.def.

4. 向这个文件添加第 1 行内容: language = Objective-C. 如果你想要使用一个纯 C 的依赖项, 请省略 language 属性.

5. 为这 2 个必须属性指定值:

   • modules – 需要由 cinterop 处理的框架名称.

   • package – 这些声明应该放置的包名称.

   比如:

   modules = MyFramework
   package = MyFramework

6. 向构建脚本添加与这个框架交互的信息:

   • 传递 .def 文件路径. 如果你的 .def 文件与 cinterop 名称相同, 并放置在 src/nativeInterop/cinterop/ 目录中, 那么这个路径可以省略.

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

   Kotlin

   Groovy

   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 属性中设置的那个包. 对于上面的示例, 应该是:

import MyFramework.*

详情请参见 与 Objective-C 和 Swift 交互 以及 在 Gradle 中配置 cinterop.