首页 > 解决方案 > 如何在离子电容器自定义插件上嵌入第三方框架?

问题描述

我正在开发一个 Ionic Capacitor 插件,它导入 2 个 iOs .framework 文件和一个引用此 .framework 文件之一的 .bundle。问题是,无论我如何在插件项目上链接/嵌入和指向/复制这些文件,xcode 声称,在应用程序项目上,它无法在 swift 文件中找到该模块。

我已经尝试将文件添加到项目中,使用“嵌入式二进制文件”选项,链接库,允许非模块化包含(在构建选项菜单上),将文件添加到标题(在构建阶段)等等。 ...

xcode 指出错误的行是:

import OneFramework

并且 xcode 声称:没有这样的模块“OneFramework”

我期待当我通过 npm 将插件添加到我的应用程序项目中,然后运行“$ rm -rf ios && 离子电容器运行 ios”来运行应用程序时,xcode 会找到我正在尝试的插件的所有模块做。

标签: swiftxcodeionic4capacitor

解决方案


我找到了解决方案。要实现这一点,首先要知道的是,当您执行npx @capacitor/cli plugin:generateCLI 为您所做的事情时,就是生成可可豆荚。此 pod 的根目录是生成的文件夹本身。考虑到这一点,接下来要做的是学习如何制作豆荚,但我将总结导致我成功的主要方面。

-首先你打开*.xcworkspace。然后,单击“将文件添加到 Pod...”选项并添加您的文件。请确保标记了“如果需要,复制文件”选项。请参考下图。

显示将文件添加到 pod 选项的图片

- 现在很高兴为您的 .framework 创建一个文件夹,为 .bundle(如果有的话)文件创建另一个文件夹。通过右键单击 Pods 项目并选择“新建组”选项来执行此操作。选择一个与 xcode 模式不同的名称,很高兴知道这个文件夹是由您创建的。

- 如果你做对了,你最近添加到项目中的框架将出现在 pods 项目中,如下所示: 框架添加操作的结果

- 现在,为了您的快速实施找到您的文件,将您的 .frameworks 拖放到插件项目的“框架、库和嵌入式内容”的 pods 项目中。结果将是这样的: 在此处输入图像描述

-好的,包含并链接了文件。现在我们应该让我们的 cocoa pod 知道这一点并声明这个文件。文件“YourAwesomePlugin.podspec”(位于插件项目的根目录)是 pod 的主要入口。在此文件中,您将声明哪些文件(.frameworks、.bundle 等)属于您的 pod,因此在您 npm install 时将属于您的插件。要声明这一点,您需要三个指令:

s.vendored_frameworks = 'ios/Pods/YourFrameworkFolder/**'
s.resource = 'ios/Pods/YourResourceFolder/YourBundle.bundle'   
s.xcconfig = {'ENABLE_BITCODE' => 'NO'} #This is mandatory on my case, but you need to evaluate if this options applies to your plugin. 

- 现在我们在插件项目上点击播放。要在你的应用上测试插件是否正常,你需要在APP项目的pods项目的podfile中添加插件项目的根路径。像这样:

在此处输入图像描述

- 要安装它,您可以在 Yourproject/ios/App 上运行并运行pod install.

请注意:

要声明您最近创建的插件的存在,您还需要做一些声明,但这部分很简单,并且已经记录在电容器/插件文档中。

pod install我建议的安装方法是用于测试。如果您使用 npm 打包插件并像所有其他插件一样安装它,那就太好了。

我对 cocoapods 了解不多,但我认为这是一个干净的解决方案。如果没有,请告诉我。

如果这个答案对你有用,请竖起大拇指,这是我分享的一周的研究和尝试,同时把它写下来。


推荐阅读