• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# OpenHarmony JS和TS三方组件使用指导
2## OpenHarmony JS和TS三方组件介绍
3
4OpenHarmony JS和TS三方组件是以OpenHarmony npm包的形式,在传统的npm三方组件的基础上,定义了OpenHarmony npm共享包特定的工程结构和配置文件,支持OpenHarmony页面组件相关API、资源的调用。通过OpenHarmony npm包,可以实现多个模块或者多个工程共享OpenHarmony页面、资源等相关代码。前往[npm官方文档](https://docs.npmjs.com/about-npm),可以了解和掌握npm的基础功能和机制。
5
6
7
8## 查找OpenHarmony JS和TS三方组件
9
101. 关注Gitee官网OpenHarmony-TPC[三方组件资源汇总](https://gitee.com/openharmony-tpc/tpc_resource)项目,根据目录索引即可找到对应分类下的具体组件。
11
12
13
142. 访问[OpenHarmony官网](https://www.openharmony.cn/mainPlay/tpc),通过类型,分类,以及关键字搜索需要的三方组件。
15   ![official-website.png](official-website.png)
16
17
18
19## 安装并使用OpenHarmony JS和TS语言的三方组件
20
21在应用开发的过程中,JS和TS语言的三方组件,通常以源码或OpenHarmony npm包的方式被引入使用。按照以下步骤即可将OpenHarmony npm包引入应用并使用,源码的具体引入及使用请参考各三方组件README.md指导介绍。
22
231. 配置OpenHarmony npm环境,详情请参考安装教程 [如何安装OpenHarmony npm包](https://gitee.com/openharmony-tpc/docs/blob/master/OpenHarmony_npm_usage.md)24
252. 在Terminal项目终端中,进入entry目录,并执行目标组件命令进行安装。具体的下载命令详见OpenHarmony官网该三方组件的“下载安装“模块。
26
27   以安装[vcard三方组件](https://growing.openharmony.cn/mainPlay/libraryMaps/vcard_595)为例,找到“下载安装”模块获取其安装命令,并执行该命令安装:
28
29   ![npm-usage1.png](npm-usage1.png)
30
31   ![npm-usage2.png](npm-usage2.png)
32
333. 下载完成后在项目文件下自动生成node_modules文件,下载的三方库即node_modules目录下的@ohos\VCard。
34
35   ![npm-usage3.png](npm-usage3.png)
36
374. 在package.json中会自动添加如下依赖:
38
39   ```
40   "dependencies": {
41     "@ohos/vcard": "^2.0.5"
42   }
43   ```
44
455. 在需要使用该组件的文件中导入组件。
46
47   ![npm-usage4.png](npm-usage4.png)
48
496. 导入组件后直接使用方法即可。
50
51   ![npm-usage5.png](npm-usage5.png)