一、创建uni-app x 项目

  1. 打开HBuilderX,点击文件(F)选择新建项目,选择uni-app默认模板,勾选uni-app x,Vue版本默认勾选3,输入项目名称,点击创建即可

  2. 新建完成的项目如下 

二、新建uni_modules目录/插件

  1. 新建的目录里面默认没有uni_modules目录,需要新建一个

  2. 在uni_modules目录下,可以新建uni_modules插件,我们以UTS标准模式插件为例

  3. 新建完成后的目录结构如下

  4. 如果需要适配鸿蒙版的,需要单独新建app-harmony目录

三、导入原生SDK

  1. 在uni_modules>插件名(cl-shanyan为例)>utssdk目录下,会有app-android和app-ios目录,分别在app-android和app-ios目录下新建libs和Frameworks目录,用于存放Android和iOS原生SDK。

  2. 将Android、iOS端原生SDK包分别放入上步新建的libs和Frameworks目录下.

四、插件封装

  1. 上述准备步骤完成后,我们需要确定插件对外暴露的 API。

    为了多端统一规范的定义对外暴露的接口,获得更好的语法提示和多端一致性约束,标准做法是在 interface.uts 文件中统一定义插件要暴露的 API 类型、 API 的参数类型、返回值类型、错误码类型、错误接口等信息,默认新建utssdk中没有interface.uts ,需要我们新建interface.uts 文件。



    实现示例:

  2. 各端的具体的业务实现在自己目录的 index.uts 中处理
    index中可以直接导入原生SDK包,调用原生SDK方法,与原生SDK进行交互。
    实现示例:

  3. 如果原生SDK需要用到图片或其他资源文件,androidhe ios端需要新建nativeResources目录

  4. 鸿蒙端需要新建harmony-configs目录

五、示例源码

具体的封装方法可以查看插件市场创蓝闪验SDKdemo示例

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐