关于harmonyos:OpenHarmony-JS和TS三方组件使用指导

46次阅读

共计 4107 个字符,预计需要花费 11 分钟才能阅读完成。

OpenHarmony JS 和 TS 三方组件介绍

OpenHarmony JS 和 TS 三方组件应用的是 OpenHarmony 动态共享包,即 HAR(Harmony Archive),能够蕴含 js/ts 代码、c++ 库、资源和配置文件。通过 HAR,能够实现多个模块或者多个工程共享 ArkUI 组件、资源等相干代码。HAR 不同于 HAP,不能独立装置运行在设施上,只能作为利用模块的依赖项被援用。

查找 OpenHarmony JS 和 TS 三方组件

1. 关注 Gitee 官网 OpenHarmony-TPC 三方组件资源汇总我的项目,依据目录索引即可找到对应分类下的具体组件。

2. 拜访 OpenHarmony 官网,通过类型,分类,以及关键字搜寻须要的三方组件。

装置并应用 OpenHarmony JS 和 TS 语言的三方组件

援用三方 HAR,包含从仓库进行装置和从本地库模块中进行装置两种形式。

援用仓库装置的 HAR

援用 ohpm 仓中的 HAR,首先须要设置三方 HAR 的仓库信息,DevEco Studio 默认仓库地址是 ”https://repo.harmonyos.com/ohpm/”,如果您想设置自定义仓库,请在 DevEco Studio 的 Terminal 窗口执行如下命令进行设置(执行命令前,请确保将 DevEco Studio 中 ohpm 装置地址配置在“环境变量 - 零碎变量 -PATH”中):

ohpm config set registry=your_registry1,your_registry2

阐明:ohpm 反对多个仓库地址,采纳英文逗号分隔。而后通过如下两种形式设置三方包依赖信息:

  • 形式一:在 Terminal 窗口中,执行如下命令装置三方包,DevEco
    Studio 会主动在工程的 oh-package.json5 中主动增加三方包依赖。
ohpm install @ohos/lottie
  • 形式二:在工程的 oh-package.json5 中设置三方包依赖,配置示例如下:
"dependencies": {"@ohos/lottie": "^2.0.0"}

依赖设置实现后,须要执行 ohpm install 命令装置依赖包,依赖包会存储在工程的 oh_modules 目录下。

ohpm install

援用本地库模块的文件和资源

  • 形式一:在 Terminal 窗口中,执行如下命令进行装置,并会在 oh-package5.json 中主动增加依赖。
ohpm install ../library

形式二:在工程的 oh-package.json5 中设置三方包依赖,配置示例如下:

"dependencies": {"library": "file:../library"}

依赖设置实现后,须要执行 ohpm install 命令装置依赖包,依赖包会存储在工程的 oh_modules 目录下。

ohpm install

阐明:

在援用 OpenHarmony HAR 时,请留神以下事项

  • 以后只反对在模块和工程下的 oh-package.json5 文件中申明 dependencies 依赖,才会被当做 OpenHarmony 依赖应用,并在编译构建过程中进行相应的解决。
  • 援用的模块的 compileSdkVersion 不能低于其依赖的 OpenHarmony
    ohpm 三方包(可在 oh_modules 目录下,找到援用的 ohpm 包的 src > main > module.json5 中查看)。

援用 OpenHarmony HAR hml 页面

在 JS 工程范式中,组件性能由 hml 承载,开发者能够在 JS 工程的 hml 页面通过标签来引入 OpenHarmony HAR 中的共享 hml 页面,示例如下:

<element name="comp" src="library/src/main/js/components/index/index.hml"></element>

其中,library 为 OpenHarmony HAR 的包名,hml 页面的门路为 OpenHarmony HAR 中的相对路径。
随后便能够通过设置的 name 来应用该 element 元素,以援用 OpenHarmony HAR 中的 hml 页面,示例如下:

<element name="comp" src="library/src/main/js/components/index/index.hml"></element>
<div class="container">
   <comp></comp>
   <text class="title">
      {{$t('strings.hello') }} {{title}}
   </text>
</div>

援用 OpenHarmony HAR ArkTS 页面

ArkTS 是 TypeScript 的扩大,因而导出和引入的语法与 TypeScript 统一。在 OpenHarmony ohpm 模块中,能够通过 export 导出 ArkTS 页面,示例如下:

// library/src/main/ets/components/mainpage/MainPage.ets
@Entry
@Component
export struct MainPage {
   @State message: string = 'Hello World'
   build() {Row() {Column() {Text(this.message)
            .fontSize(50)
            .fontWeight(FontWeight.Bold)
         } 
         .width('100%') 
      } .height('100%') 
   }
}

而后在其它模块中通过 import 引入导出的 ArkTS 页面,示例如下所示:

// entry/MainAbility/pages/index.ets
import {MainPage} from "library"
@Entry
@Component
struct Index {
   @State message: string = 'Hello World' 
   build() {Column() {MainPage() 
         Row() {Text(this.message)
            .fontSize(50)
            .fontWeight(FontWeight.Bold)
         }
         .width('100%')
      } 
      .height('10%') 
   }
}

援用 OpenHarmony HAR 内 ts/js 办法 ts/js 办法的导出和援用,与 ArkTS 页面的援用雷同,即在 OpenHarmony ohpm 模块中,能够通过 export 导出 ts/js 办法,示例如下所示:

// library/index.js
export function func() {return "[ohpm] func1";
}

而后在其它的 ts/js 页面中,通过 import 引入导出的 ts/js 办法,示例如下所示:

// entry/src/main/js/MainAbility/pages/index/index.js
import {func} from "library"
export default {
   data: {title: ""},
   onInit() {this.title = func();
   }
}

援用 OpenHarmony HAR 内资源反对在 OpenHarmony ohpm 模块和依赖 OpenHarmony ohpm 的模块中援用 OpenHarmony ohpm 模块内的资源。例如在 OpenHarmony ohpm 模块的 scr/main/resources 里增加字符串资源(在 string.json 中定义,name:hello_ohpm)和图片资源(icon_ohpm.png)。而后在 Entry 模块中援用该字符串资源和图片资源的示例如下:以后暂不反对类 Web 范式援用 i18n 文件中的国际化资源。

// entry/src/main/ets/MainAbility/pages/index.ets
@Entry
@Component
struct Index {
   @State message: string = 'Hello World'
   build() {Column() {Row() {Text($r("app.string.hello_ohpm")) // 字符串资源
              .fontSize(40)
              .fontWeight(FontWeight.Bold)
         }
         .width('50%')
         Image($r("app.media.icon_ohpm")) // 图片资源
      }
      .height('100%')
   }
}

在编译构建 HAP 中,DevEco Studio 会从 HAP 模块及依赖的模块中收集资源文件,如果不同模块的雷同限定词目录下的资源文件呈现重名抵触时,DevEco Studio 会依照以下优先级进行笼罩(优先级由高到低):

  • AppScope(仅 API 9 的 Stage 模型反对)
  • HAP 包本身模块
  • 依赖的 OpenHarmonyHarmony ohpm 模块

作为一名合格一线开发程序员,大家心里必定会有很多疑难!鸿蒙零碎这么弱小~~

为了可能让大家跟上互联网时代的技术迭代,在这里跟大家分享一下我本人近期学习心得以及参考网上材料整顿出的一份最新版的鸿蒙学习晋升材料 ,有须要的小伙伴自行支付, 限时开源,先到先得~~~~

支付以下高清学习路线原图请点击→《鸿蒙根底入门学习指南》纯血鸿蒙 HarmonyOS 根底技能学习路线图

支付以上残缺高清学习路线图,请点击→《鸿蒙开发学习之利用模型》小编本人整顿的局部学习材料(蕴含有高清视频、开发文档、电子书籍等)

以上分享的学习路线都适宜哪些人跟着学习?

  • - 应届生 / 计算机专业通过学习鸿蒙新兴技术,入行互联网,将来高起点待业。
  • - 0 根底转行提前布局新方向,抓住风口,自我晋升,取得更多就业机会。
  • - 技术晋升 / 进阶跳槽倒退瓶颈期,晋升职场竞争力,疾速把握鸿蒙技术,享受蓝海红利。

最初

鸿蒙开发学习是一个系统化的过程,从基础知识的学习到实战技能的锻炼 ,再到对前沿技术的摸索,每一环节都至关重要。 心愿这份教程材料能帮忙您疾速入门并在鸿蒙开发之路上步步攀升,成就一番事业。让咱们一起乘风破浪,拥抱鸿蒙生态的广大将来

如果你感觉这篇内容对你有帮忙,我想麻烦大家动动小手给我:点赞,转发,有你们的『点赞和评论』,才是我发明的能源。

关注我,同时能够期待后续文章 ing,不定期分享原创常识。

想要获取更多残缺鸿蒙最新 VIP 学习材料,请点击→《鸿蒙全套学习指南》

正文完
 0