iOS uni-app 原生插件开发

yxibng

已于 2025-04-07 18:13:04 修改

阅读量1k

点赞数 15

文章标签： uni-app

于 2025-04-07 17:51:19 首次发布

本文链接：https://blog.csdn.net/yxibng/article/details/147044885

版权

下面以创建一个物体检测插件为例。

开发环境：

XCode 16.3
SDK包，4.45
HBuilderX 4.45

1. 解压 SDK

2. 创建一个插件，放到 HBuilder-uniPluginDemo 目录下

3. 配置依赖

打开 HBuilder-uniPlugin.xcodeproj

将 ObjectDetector.xcodeproj 拖到工程里这这个位置

配置支持最低支持 iOS13

配置为生成静态库

配置头文件依赖

配置 target 依赖，让 HBuilder 依赖 ObjectDetector，链接 ObjectDetector 生成的静态库

4. 配置 appkey

更改一下 bundle id，还有签名，尝试运行

去官网申请 appkey，填写到 plist 中

创建一个 app，名字叫 ObjectDetector，获取对应的 appid 和 appkey

Bingo! 恭喜你，现在可以运行了，下面进行插件代码的开发

5. 写插件代码

我用到了 swift5，需要配置一下版本，现在默认是 swift6

6. 验证插件是否好用

HBuilderX 新建工程，名字叫 ObjectDetector，与我们上面获取 appkey 和 appid 的应用名字一致

vue 版本选 2，选 3 原生回调给 js 的 eventName 对不上

根据接口定义，写一个 nvue 文件

生成本地资源

拷贝资源文件

保证这两个 appid 一致

配置插件

运行 HBuilder ， Bingo！成功了～

注意：

每次重新编译 HBuilderX 生成新的资源拷贝到 apps 目录，需要删除 app，重新运行，避免 js 更新不及时。

7. 插件打包

插件包结构

|-- 插件id							// 插件包是一个以插件id命名的文件夹
	|-- android						// 存放 android 插件所需要的依赖库及资源文件
	|-- ios							// 存放 ios 插件所需要的依赖库及资源文件
	|-- package.json				// 插件配置文件

我们只打包 iOS 的

编译静态 framework，选择 release 模式，然后 build

结合资源文件，以及 framework 文件，生成打包

package.json 文件内容

{
    "name": "object_detection",
    "id": "object_detection",
    "version": "0.1",
    "description": "摄像头物体检测插件",
    "_dp_type": "nativeplugin",
    "_dp_nativeplugin": {
        "ios": {
            "plugins": [
                {
                    "type": "component",
                    "name": "object-detector-view",
                    "class": "ObjectDetectorComponent"
                }
            ],
            "frameworks": [
                "AVFoundation.framework",
                "Vision.framework",
                "CoreML.framework"
            ],
            "integrateType": "framework",
            "deploymentTarget": "13.0",
            "embedSwift": true,
            "validArchitectures": [
                "arm64"
            ],
            "resources": [
                "yolov8n.mlmodelc"
            ]
        }
    }
}