uniapp原生插件开发之iOS

最新推荐文章于 2024-05-29 22:37:19 发布
最新推荐文章于 2024-05-29 22:37:19 发布
阅读量5.2k 收藏 9
点赞数 2
分类专栏： UNIAPP iOS 文章标签： ios xcode macos
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/wanmeizty/article/details/125102502
版权
iOS 同时被 2 个专栏收录
15 篇文章 0 订阅
订阅专栏
UNIAPP
6 篇文章 0 订阅
订阅专栏

uniapp原生插件iOS开发官网地址；

必备条件环境


步骤一.创建iOS SDK项目

  • 选择Framework或者Static Library类型

  • 写好项目名称AddSDK

为了省事，不用引入SDK，就把AddSDK工程创建在HBuilder-uniPluginDemo目录下（也可以自己创建一个新的APP，放在APP目录下，再引入SDK）

  • 建议把版本选到最低，不然到时候低版本的不支持

选择1target=>2build setting=>3搜索mach-o=>4改为static library,静态链接库

4.打开APP项目HBuilder-uniPluginDemo，

打开后右键target，Add files to "HBuilder-uniPluginDemo" // 你的工程名称

把创建的AddSDK引入到工程中，勾选第3，4项

5.target=> build phases=>dependenceis, link binary with liabraris加入framework 在图中3、4项点击+号添加刚才的AddSDK

接下来需要在插件工程的Header Search Paths中添加开发插件所需的头文件引用，头文件存放在主工程的HBuilder-Hello/inc中，添加方法如下图所示，在 Xcode 项目左侧目录选中插件工程名，找到TARGETS->Build Settings->Header Search Paths双击右侧区域打开添加窗口，然后将inc目录拖入会自动填充相对路径，然后将模式改成recursive

步骤二实现代码

.h代码如下

//

// AddObj.h

// AddSDK

//

// Created by wanmeizty on 30/5/2022

// Modified by Tiyon qq 897574226

//

#import "DCUniModule.h"

NS_ASSUME_NONNULL_BEGIN

@interfaceAddObj : DCUniModule

@end

NS_ASSUME_NONNULL_END

.m文件如下

#import "AddObj.h"

@implementationAddObj

// 通过宏 UNI_EXPORT_METHOD 将异步方法暴露给 js 端

UNI_EXPORT_METHOD(@selector(asyncSum:callback:))

///异步方法（注：异步方法会在主线程（UI线程）执行）

///@param options js 端调用方法时传递的参数 支持：String、Number、Boolean、JsonObject 类型

///@param callback 回调方法，回传参数给 js 端 支持： NSString、NSDictionary（只能包含基本数据类型）、NSNumber 类型

- (void)asyncSum:(NSDictionary *)options callback:(UniModuleKeepAliveCallback)callback {

// options 为 js 端调用此方法时传递的参数 NSLog(@"%@",options); // 可以在该方法中实现原生能力，然后通过 callback 回调到 js

NSInteger num1 = options[@"num1"] ? [options[@"num1"] integerValue] : 0;

NSInteger num2 = options[@"num2"] ? [options[@"num2"] integerValue] : 0;

if (callback) {

// 第一个参数为回传给js端的数据，第二个参数为标识，表示该回调方法是否支持多次调用，如果原生端需要多次回调js端则第二个参数传 YES;

NSInteger sum = num1 + num2;

callback(@(sum),NO);

}

}

// 通过宏 UNI_EXPORT_METHOD_SYNC 将同步方法暴露给 js 端

UNI_EXPORT_METHOD_SYNC(@selector(syncSum:))

- (NSInteger)syncSum:(NSDictionary *)options {

// options 为 js 端调用此方法时传递的参数 NSLog(@"%@",options); // 可以在该方法中实现原生能力，然后通过 callback 回调到 js

NSInteger num1 = options[@"num1"] ? [options[@"num1"] integerValue] : 0;

NSInteger num2 = options[@"num2"] ? [options[@"num2"] integerValue] : 0;

return num1 + num2;

}

@end

在开发者中心获取key

配置说明

  • hooksClass：App系统方法钩子类，值是类名，是给有些插件需要在 app 启动时做初始化或者获取系统事件用的，如果没有可以不填为空
  • class：module 或 component 对应的原生类名（示例中为 TestModule）
  • name：暴露给js端使用的 module 或 component 对应的名称（注意：module 的 name 必须以插件id为前缀或和插件id相同，示例为ZTY-AddFuc，其中 DCTestUniPlugin 为插件的id，需要保证唯一性，避免与其他插件冲突，component 的name 没有强制要求，但是也要保证唯一比如ZTY-AddFuc）
  • type：module 或 component （示例为module）

步骤三（uniapp项目引用原生的方法）

新建一个uniapp的APP，实现原生交互的代码如下

<template>

<view class="content">

<button @click="syncSum">syncSum</button>

<view>同步加的结果{{res1}}</view>

<button @click="asyncSum">asyncSum</button>

<view>异步加的结果{{res2}}</view>

</view>

</template>

<script>

// #ifdef APP-PLUS

const AddFunc = uni.requireNativePlugin("ZTY-AddFunc");

// #endif

export default {

data() {

return {

title: 'Hello',

res1:'',

res2:'',

}

},

onLoad() {

},

methods: {

syncSum(){

this.res1 = AddFunc.syncSum({num1:3,num2:7})

},

asyncSum(){

AddFunc.asyncSum({num1:3,num2:7},result=>{

this.res2 = result

})

}

}

}

</script>

<style>

.content {

display: flex;

flex-direction: column;

align-items: center;

justify-content: center;

}

.logo {

height: 200rpx;

width: 200rpx;

margin-top: 200rpx;

margin-left: auto;

margin-right: auto;

margin-bottom: 50rpx;

}

.text-area {

display: flex;

justify-content: center;

}

.title {

font-size: 36rpx;

color: #8f8f94;

}

</style>

1点击自己创建的uniapp的项目，2点发行，3点原生APP-本地打包，4生成本地打包App资源

再把打包的资源放在Pandora/apps目录下

在把control的appid改为刚才引入的本地APP资源包的appid

在ios项目中点击运行，执行结果如下

步骤四（打包iOS原生资源）

点击AddSDK（你的SDK）-Edit scheme-info-run-build configration 值为release

打包ios原生的framwork,选择any ios devices (arm64,armv7), 点击运行，或（command+B）

点击product-shou build folder in finder

创建一个文件夹，以插件Id命名，

在文件里面创建一个

package.json

我的内容如下：

{

"name": "两数之和，ios",

"id": "ZTY-AddFunc",

"version": "1.0.0",

"description": "求和",

"_dp_type": "nativeplugin",

"_dp_nativeplugin": {

"ios": {

"plugins": [

{

"type": "module",

"name": "ZTY-AddFunc",

"class": "AddObj"

}

],

"integrateType": "framework",

"privacies": [

],

"resources": [

]

}

}

}

官方说明如下：

{ "name": "插件名称", "id": "插件标识，需要保证唯一性", "version": "插件版本号", "description": "插件描述信息", "_dp_type":"nativeplugin", "_dp_nativeplugin":{ "android": { "plugins": [ { "type": "module|component, 必填, 根据插件类型选择", "name": "必填, 注册插件的名称, 注意：module 的 name 必须以插件id为前缀或和插件id相同，比如 `DCTestUniPlugin-TestModule`，其中 DCTestUniPlugin 为插件的id，避免与其他插件冲突，component 的 name 没有强制要求，但是也要保证唯一比如 `dc-map`", "class": "必填, 注册插件的类名" } ], "hooksClass": "可选, 事件钩子注册类名", "integrateType": "必填, 可取值aar|jar", "dependencies": [ "可选, 依赖的库名称" ], "excludeDependencies": [ "可选，需要排除的HX内置模块依赖库名称" //HBuilderX3.1.18+支持：仅在插件与HX内置模块依赖库存在冲突时可能需要，使用前请在官方QQ交流群“DCloud原生开发者群”中联系管理员确认 ], "compileOptions": { //可选，Java编译参数配置 "sourceCompatibility": "1.8", "targetCompatibility": "1.8" }, "abis": [ "可选, 支持的abi类型, 可取值armeabi-v7a|arm64-v8a|x86" ], "minSdkVersion": "可选，支持的Android最低版本，如21", "useAndroidX": false, //可选，是否兼容使用AndroidX 3.2.5+版本后废弃该属性 "permissions": [ "可选, 要使用的Android权限列表" ], "parameters": { "插件需要配置的参数名称, 如appid": { "des": "参数描述", "key": "AndroidManifest.xml中添加meta-data节点！对应android:name属性值, 如GETUI_APPID", "placeholder": "build.gradle中添加到manifestPlaceholders中的字段名" } } }, "ios": { "plugins": [ { "type": "必填, module|component, 根据插件类型选择", "name": "必填, 注册插件的名称, 通常与插件标识一致", "class": "必填, 注册插件的类名" } ], "integrateType": "必填, 可取值framework|library", "hooksClass": "可选, 事件钩子注册类名", "frameworks": [ "依赖的系统库(系统库有.framework和.tbd和.dylib类型)，和第三方.framework动态库;（.a 库或 .framework**静态库**直接放到ios根目录即可，不需要配置）" ], "embedFrameworks": [ "依赖的.framework动态库（注意.framework动态库也需要在上面的 frameworks 节点添加配置，同样将动态库.framework文件放到 ios 目录）" ], "capabilities": { // 配置应用的capabilities数据（根据XCode规范分别配置到entitlements和plist文件中） "entitlements": { // 合并到工程entitlements文件的数据（json格式） }, "plists": { // 合并到工程Info.plist文件的数据（json格式） } }, "plists": { // 自定义配置工程Info.plist文件的数据（json格式），优先级高于capabilities->plists }, "assets": [ //HBuilderX2.3.4及以上版本支持 "可选，插件要使用的xcassets文件列表，相对于ios目录的路径" ], "privacies": [ "可选, 插件使用到的隐私列表，如NSPhotoLibraryUsageDescription" ], "embedSwift": false, // 开启 swift 编译支持，如果插件使用了 swift 需要配置此项 "deploymentTarget": "8.0, 可选，支持的iOS最低版本", "validArchitectures": [ // 可选，支持的CPU架构类型 "arm64" //支持多个值，可取值："arm64", "arm64e", "armv7", "armv7s", "x86_64" ], "parameters": { "插件需要配置的参数名称, 如appid": { "des": "参数描述信息", "key": "参数需要配置到info.plist中的键名, 嵌套时使用:分割，如getui:appid" } }, "resources": [ "可选, 插件要使用的资源文件列表，相对于ios目录的路径 ，HX 3.2.0+ 版本不在推荐使用，请参考文档下面的 “依赖资源文件” 说明" ] } } }

生成的framwork放在刚才创建的插件id文件夹下创建一个ios文件夹，再把framwork放在ios文件夹下，安卓就放在android文件夹下

到此原生的ios插件制作完毕

步骤五，使用本地原生ios插件

在uniapp项目下创建名为nativeplugins的文件夹，然后把刚才生成的原生插件放在nativeplugins目录下

点击manifest.json-APP原生插件配置-本地插件-勾选刚才引入的插件

注：只有云打包和自定义基座才有效

提交插件市场

按照上面的方式放到 HBuilderX 的 uni-app 项目中提交打包测试完插件后，可以将插件包压缩成 zip 格式，然后提交到插件市场共享给其他开发者使用，登录注册DCloud插件市场，然后按照提示步骤提交插件，（需要编写对应插件的使用说明文档，.md（markdown）格式）；

勇哥是也
关注
  • 2
    点赞
  • 踩
  • 9
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
专栏目录
uniapp ios原生插件开发 (framework,cocoapods)
Rey的技术博客
03-02 7144
已知UniApp的插件开发方式有两种， 第一种 Xcode Framework的方式，这种方式是官方指定的方式。 这种方式的优点就是简单直接， 但也有不足，比如当插件需要引入一些三方库时，操作起来就不是那么方便。 而使用Cocoapods则可以很方便的引入三方库。 接下来，本文探索使用Cocoapods的方式来进行UniApp插件开发。
uniapp ios原生插件开发之module
Rey的技术博客
07-09 1576
在文章《uniapp ios原生插件开发 (framework,cocoapods)》中我们已经介绍了Module 类型的插件及其创建过程， 却没有深入的介绍Module类型插件开发过程中所涉及到的技术点。本文呢就将重点放在对这些技术点的使用上进行详解，算是是对上篇文章的一个补充与扩展。module：不需要参与页面布局，只需要通过 API 调用原生功能，比如：获取当前定位信息、数据请求等功能，通过扩展module的方式来实现；component。
跨平台应用开发进阶(六) ：uni-app实现原生插件集成_uniapp 添加了原生插件
2401_84446919的博客
05-04 1488
在 Product Name 中输入插件工程名称（建议使用一个性化的前缀，避免与其他人的插件包名冲突），其他项不需要修改保持工程默认填充的即可，然后点击Next然后选择工程存放路径，建议直接存放在 iOSSDK目录中的插件开发主工程目录下，如下图所示，然后点击Create。然后选中工程名，在中，将设置为如下图所示。然后将插件工程关闭，接下来需要将插件工程导入到插件开发主工程中。
uniapp ios原生插件开发之component
Rey的技术博客
05-13 2810
UniApp 插件扩展的方式有两种： module：不需要参与页面布局，只需要通过 API 调用原生功能，比如：获取当前定位信息、数据请求等功能，通过扩展module的方式来实现； component：需要参与页面布局，比如：map、image等需要显示UI的功能，通过扩展component即组件的方法来实现； 您需要根据实际的情况选择扩展方式，当然插件中可以同时存在 module 和 component，也可以是多个 module 和 多个 component；
手摸手教你uniapp原生插件开发
最新发布
六道对穿肠的学习之旅
05-29 2186
公共证书, 自由证书,云端证书都行 随意 我用的公共证书打包好后就可以运行自定义基座了end大家结合看参考资料其他参考资料。
uniapp 原生iOS插件开发
Han_SM的博客
09-25 2570
uni-app官方文档：uni-app原生插件（native plugin）开发指南 uni-app iOS端官方文档：iOS uni-app原生插件开发文档 本文只简单介绍制作原生iOS插件，其他详细资料可以看官方文档。 第一步创建项目: 第二步： 导入资源库inc .h文件导入#import "WXModuleProtocol.h" 遵循协议：<WXModuleProtocol> .m文件加上这句话 @synthesize weexInstance; ..
uniapp iOS-原生插件开发问题记录
c1o2c3o4的博客
08-07 887
iOS原生插件开发 component
uniapp ios原生插件与混合开发教程 - 开篇
Rey的技术博客
03-29 1919
此系列教程，我会带着您从0到1学习uni-app ios原生插件开发、原生混合开发。 此系列目前共9篇文章， 前7篇主要讲解原生插件开发的相关技术点。 后2篇主要讲解通过uniapp的 uni小程序SDK 如何在原生应用中实现小程序的功能 。
uniapp ios原生插件开发之globalEvent事件
Rey的技术博客
05-18 2195
UniApp 原生插件开发时，有时会碰到这样的场景 ： - vue前端需要实时监听原生端发来的消息 - 原生端当某个动作触发时，需要vue前端能够监听到并做出响应 基于这种原生插件端与vue前端代码的实时交互， UniApp提供了一种方案, 它就是: `globalEvent事件`。 通过这种`事件机制`，我们就可以实现如上两种场景的处理。 接下来根据官方文档来做整理与介绍。
Android平台uni原生插件开发之通过uniapp引入原生插件
04-18
在Android平台上，开发uni原生插件是一种将Java或Kotlin等原生代码与uni-app应用结合的方式，以便利用uni-app的跨平台特性同时发挥Android原生功能的优势。本教程将详细讲解如何通过uni-app引入并使用原生插件，以...
uniapp 开发原生插件
02-24
开发uniapp原生插件涉及到以下几个关键点： 1. **环境配置**：首先，你需要安装uniapp的开发环境，包括HBuilderX IDE、Node.js、Android Studio等。确保Android SDK已经安装并配置好，因为原生插件主要是在Android ...
uniapp原生插件-YL视频播放器案例源码
09-22
在本文中，我们将深入探讨如何使用uniapp原生插件YL视频播放器，以及它在不同应用场景中的实现方式。uniapp是一个跨平台的开发框架，它允许开发者使用一套代码库来构建iOS、Android、Web等多个平台的应用。原生插件...
uniapp 安卓原生websocket 插件
02-03
uniapp是一款多端开发框架，它允许开发者用一套代码同时发布到iOS、Android、H5等多个平台，极大地提高了开发效率。而这个插件就是为了让uniapp在Android端能够支持WebSocket通信，实现与服务器的实时交互。 首先，...
淘口令解析
wanmeizty的专栏
07-10 7854
https://download.csdn.net/download/wanmeizty/11286264 淘口令解析，首先获取淘宝复制的淘口令信息，过滤无用信息，开始解析淘口令具体代码如下： demo链接地址：https://download.csdn.net/download/wanmeizty/11286264 /** * 解析淘口令 * @param commondSt...
iOS SDK封装
wanmeizty的专栏
05-09 2877
一.framework封装 1、新建iOS-&gt;Framework &amp; Library-&gt;Cocoa Touch Framework 2、在PROJECT-&gt;Deployment Target-&gt;iOS Deployment Target选择你需要支持的最低系统。 同样的操作在TARGETS中，Deployment Info-&gt;Deployment ...
使用WKWebview接入淘宝二次授权免登录的坑
wanmeizty的专栏
06-20 2756
1.阿里百川授权完成之后，进行淘宝授权免密登录时，时而需要密码登录，时而不需要（我当时用的WKWebview） 2.分析：当时我查阅了淘宝上的论坛和各大网站，都没有发现有人提到该问题，最终还是无果，我就开始看这个js源码，后面我就换了UIWebview,这个问题就没有，真是奇了怪了，怎么搞这个WKWebview都需要密码登录,当时我都怀疑苹果的WKWebview有bug；查了资料WKWebvie...
微信砸壳
wanmeizty的专栏
03-22 2546
                                        微信砸壳 一、 准备两个文件路径一个是微信的APP路径，另一个就是微信的沙河路径，把这两个路径(下面背景标黄的两个)保存下来为接下来砸壳有重要作用1.    ssh连接iPhone设备 ssh root@localhost –p 2222 输入密码：默认密码为alpine2.    ps aux|grep WeChat...
uniapp ios插件开发
12-31
Uniapp是一款跨平台的开发框架，可以同时开发出适用于iOS和Android的应用。插件开发是Uniapp的一个重要功能，可以通过插件来扩展应用的功能和特性。 在Uniapp的iOS插件开发中，首先需要了解插件的基本结构和开发方式。插件通常是由原生的iOS代码编写而成，然后通过Uniapp的插件注册和调用机制来使用。具体开发步骤如下： 1. 创建iOS插件项目：使用Xcode等开发工具创建一个新的iOS项目，将插件的代码放入其中。 2. 配置插件的接口和参数：根据插件的功能需求，在插件的代码中定义需要对外暴露的接口和参数。可以通过使用Objective-C或Swift编写代码来完成。 3. 处理插件的调用逻辑：在插件的代码中实现对插件接口的具体逻辑处理。可以调用底层的iOS API来实现需要的功能。 4. 导出插件：编译插件的代码，并将生成的插件文件导出成为一个独立的模块供Uniapp项目使用。 5. 注册和调用插件：在Uniapp项目的代码中，通过注册插件的方式将插件导入到项目中。然后可以通过插件的名称和方法调用来使用插件的功能。 在开发过程中，除了插件的基本代码实现外，还可以根据需要添加一些其他的功能，例如插件的配置文件、资源文件等。 总之，Uniapp提供了便捷的iOS插件开发方式，开发者可以通过编写原生的iOS代码来扩展Uniapp应用的功能。插件开发可以根据具体需求来实现各种各样的功能，为Uniapp应用提供更加丰富和灵活的特性。
评论 2
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值