【鸿蒙】如何管理/引用第三方库?(通过ohpm高效管理/引用第三方库)

1,142 阅读3分钟

在探索鸿蒙项目开发的广阔天地时,我们不可避免地会遭遇各种挑战与机遇。其中,一个尤为重要的环节便是合理而高效地使用第三方库。这些精心打造的库,如同一个个魔法工具,能够极大地提升我们的开发效率,丰富项目的功能,为鸿蒙生态的构建添砖加瓦。本文将深入探讨鸿蒙项目开发中第三方库的导入和使用。

一、检查电脑是否已经安装并且正确配置了ohpm

  1. ohpm概念:鸿蒙OHPM(OpenHarmony Package Manager)是鸿蒙操作系统中的一个重要组件,它是鸿蒙系统的包管理工具,类似于Android SDK Package Manager。OHPM主要用于管理软件包,支持查看、安装和卸载SDK组件,这些SDK组件包括API和工具链,需要独立安装。此外,OHPM由OpenHarmony三方库中心仓网站、命令行工具、OpenHarmony三方库中心仓仓库三个部分组成,为开发者提供了检索、查看和管理OpenHarmony三方库信息的便利。
  2. 打开“终端”,输入"ohpm -v"查看ohpm版本号的命令。
  3. 如果终端能正常显示版本号(如下图所示),那么恭喜你,你可以正常使用ohpm了。 c75aab3b-215b-4f90-b904-5884bd8c406a.jpeg
  4. 如果报错:zsh: command not found: ohpm,则说明你的电脑没能正确配置ohpm环境,如下图所示: image.png
  5. 如何解决【zsh: command not found: ohpm】报错呢?请移步至我之前写的一篇关于彻底解决该报错的文章:juejin.cn/post/736253…

二、如何获取三方库(或者说第三方库的来源是哪里)?

  1. 通过OpenHarmony三方库中心仓获取:ohpm.openharmony.cn/#/cn/home
  2. 通过Gitee(码云)搜索OpenHarmony-TPC仓库,这个仓库集合了开源三方库资源汇总:gitee.com/openharmony…

三、如何安装三方库?下面以动画库lottie为例进行说明:

  1. 第一种方式:直接通过ohpm指令进行安装。
    • 打开终端,cd到你鸿蒙项目文件夹下面:
    cd /Users/yourMac/Desktop/MyApp02
    
    • 执行导入lottie指令:
    ohpm install @ohos/lottie
    
    • 当终端出现下面的信息时,说明安装成功了:
    ohpm INFO: fetch meta info of package '@ohos/lottie' success https://repo.harmonyos.com/ohpm/@ohos/lottie
    install completed in 4s 668ms
    
    • 在工程中的oh-package.json5文件内可以看到,lottie库已经正常导入到工程内了:
    img_v3_02at_8f9cfcbc-8aa7-49fb-aa81-79e5827f79fg.jpg
    • 在oh_modules文件夹下也可以看到一个lottie文件夹,这也说明lottie库已经正常导入到工程内了: 0f6ae266-8f9c-4933-a8c4-28439127c4e7.jpeg
  2. 第二种方式:在oh-package.json5文件中设置依赖声明,然后执行ohpm指令。
    • 打开oh-package.json5文件,添加依赖:
    "dependencies": {
      "@ohos/lottie": "^2.0.10"
    }
    
    • 在终端中执行 “ohpm instal” 即可: 94795f4a-5bda-4b65-b510-314a6091b03f.jpeg

三、如何卸载三方库

卸载是安装的反向操作,相对简单,也有两种方式:

  1. 第一种方式:在oh-package.json5文件内删除三方库的相关依赖,然后执行“ohpm install”即可。
  2. 第二种方式:在终端内直接执行ohpm指令也可以将三方库从相关依赖中移除:
    ohpm uninstall @ohos/lottie
    

自此,三方库的安装和卸载操作就介绍完了。创作不易,码友您都看到这了,有劳您动动发财的小手点个赞再走吧~