添加 iOS 依赖项

添加一个库

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

添加一个框架

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

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