HarmonyOS 鸿蒙Next 在module中如何引用hsp文件
HarmonyOS 鸿蒙Next 在module中如何引用hsp文件 创建SharedLibrary模块后,执行make module命令后生成了hsp为后缀的包,复制到另外一个项目中时,在oh_package.json5文件中添加依赖时找不到这个文件,请问下该如何引用hsp包的库?
引用三方HAR,包括从仓库进行安装、从本地文件夹和本地压缩包中进行安装三种方式。
引用ohpm仓中的HAR,首先需要设置三方HAR的仓库信息,DevEco Studio默认仓库地址为OpenHarmony三方库中心仓,如果您想设置自定义仓库,请在DevEco Studio的Terminal窗口执行如下命令进行设置(执行命令前,请确保将DevEco Studio中ohpm安装bin目录配置在“环境变量-系统变量-PATH”中,第一次配置环境变量后,需重启DevEco Studio):
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-package.json5中自动添加依赖。
ohpm install …/folder
方式二:在工程的oh-package.json5中设置三方包依赖,配置示例如下:
"dependencies": {
"folder": "file:../folder"
}
依赖设置完成后,需要执行ohpm install命令安装依赖包,依赖包会存储在工程的oh_modules目录下。
ohpm install
引用本地HAR包,有如下两种方式:
方式一:在Terminal窗口中,执行如下命令进行安装,并会在oh-package.json5中自动添加依赖。
ohpm install ./package.har
方式二:在工程的oh-package.json5中设置三方包依赖,配置示例如下:
"dependencies": {
"package": "file:./package.har"
}
依赖设置完成后,需要执行ohpm install命令安装依赖包,依赖包会存储在工程的oh_modules目录下。
ohpm install
另外,在安装或卸载共享包时,可在工程的oh-package.json5文件中增加钩子设置,以管理install、uninstall命令的生命周期,配置示例如下:
"hooks": {
"preInstall": "echo 00 preInstall", // install命令执行之前
"postInstall": "echo 00 postInstall", // install命令执行之后
"preUninstall": "echo 00 preUninstall", // uninstall命令执行之前
"postUninstall": "echo 00 postUninstall" // uninstall命令执行之后
}
注意:目前只支持执行当前工程的oh-package.json5文件中hooks,不支持执行依赖中hooks。
在引用共享包时,请注意以下事项:
当前只支持在模块和工程下的oh-package.json5文件中声明dependencies依赖,才会被当做依赖使用,并在编译构建过程中进行相应的处理。
更多关于HarmonyOS 鸿蒙Next 在module中如何引用hsp文件的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html
在HarmonyOS鸿蒙Next中,引用HSP(Harmony Shared Package)文件可以通过以下步骤实现:
-
创建HSP模块:首先,确保你已经创建了一个HSP模块。HSP模块是一个独立的共享包,可以被其他模块引用。
-
配置
build.gradle
文件:在需要引用HSP的模块的build.gradle
文件中,添加对HSP模块的依赖。例如:dependencies { implementation project(':hsp_module_name') }
其中,
hsp_module_name
是HSP模块的名称。 -
同步项目:在Android Studio中,点击“Sync Now”按钮,同步项目以应用更改。
-
使用HSP中的资源:在代码中,你可以直接使用HSP模块中的类、方法和资源。例如:
import com.example.hsp_module_name.ExampleClass; public class MainActivity extends Ability { @Override public void onStart(Intent intent) { super.onStart(intent); ExampleClass example = new ExampleClass(); example.doSomething(); } }
-
打包和部署:在打包和部署应用时,确保HSP模块被正确包含在最终的APK或HAP文件中。
通过以上步骤,你可以在HarmonyOS鸿蒙Next的模块中成功引用HSP文件。
在HarmonyOS鸿蒙Next中,引用HSP(Harmony Shared Package)文件需在module.json5
中配置依赖。首先,确保HSP文件已正确打包并放置在项目中。然后在module.json5
的dependencies
字段中添加HSP的依赖项,格式为"@ohos/<hsp-name>": "version"
。例如:
"dependencies": {
"@ohos/my-hsp": "1.0.0"
}
之后,在代码中通过import
语句引用HSP中的模块或类即可使用。