HarmonyOS 鸿蒙Next 在module中如何引用hsp文件

发布于 1周前 作者 yuanlaile 来自 鸿蒙OS

HarmonyOS 鸿蒙Next 在module中如何引用hsp文件 创建SharedLibrary模块后,执行make module命令后生成了hsp为后缀的包,复制到另外一个项目中时,在oh_package.json5文件中添加依赖时找不到这个文件,请问下该如何引用hsp包的库?

3 回复

引用三方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)文件可以通过以下步骤实现:

  1. 创建HSP模块:首先,确保你已经创建了一个HSP模块。HSP模块是一个独立的共享包,可以被其他模块引用。

  2. 配置build.gradle文件:在需要引用HSP的模块的build.gradle文件中,添加对HSP模块的依赖。例如:

    dependencies {
        implementation project(':hsp_module_name')
    }

    其中,hsp_module_name是HSP模块的名称。

  3. 同步项目:在Android Studio中,点击“Sync Now”按钮,同步项目以应用更改。

  4. 使用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();
        }
    }
  5. 打包和部署:在打包和部署应用时,确保HSP模块被正确包含在最终的APK或HAP文件中。

通过以上步骤,你可以在HarmonyOS鸿蒙Next的模块中成功引用HSP文件。

在HarmonyOS鸿蒙Next中,引用HSP(Harmony Shared Package)文件需在module.json5中配置依赖。首先,确保HSP文件已正确打包并放置在项目中。然后在module.json5dependencies字段中添加HSP的依赖项,格式为"@ohos/<hsp-name>": "version"。例如:

"dependencies": {
  "@ohos/my-hsp": "1.0.0"
}

之后,在代码中通过import语句引用HSP中的模块或类即可使用。

回到顶部
AI 助手
你好,我是IT营的 AI 助手
您可以尝试点击下方的快捷入口开启体验!