HarmonyOS实战开发：HSP动态共享包

HSP（Harmony Shared Package）是动态共享包，按照使用场景可以分为应用内HSP和应用间HSP。应用内HSP指的是专门为某一应用开发的HSP，只能被该应用内部其他HAP/HSP使用，用于应用内部代码、资源的共享。应用内HSP跟随其宿主应用的APP包一起发布，与宿主应用同进程，具有相同的包名和生命周期。

说明：

由于当前暂不支持应用间HSP，提到HSP时特指应用内HSP。

创建HSP模块

通过DevEco Studio创建一个HSP模块，详见创建HSP模块，我们以创建一个名为的HSP模块为例。基本的工程目录结构如下：library

library
├── src
│   └── main
│       ├── ets
│       │   ├── pages
│       │   └── index.ets
│       ├── resources
│       └── module.json5
└── oh-package.json5

导出HSP的ArkUI组件、接口、资源

导出ArkUI组件

ArkUI组件也可以通过导出，例如：export

// library/src/main/ets/components/MyTitleBar.ets
@Component
export struct MyTitleBar {
  build() {
    Row() {
      Text($r('app.string.library_title'))
        .fontColor($r('app.color.white'))
        .fontSize(25)
        .margin({left:15})
    }
    .width('100%')
    .height(50)
    .padding({left:15})
    .backgroundColor('#0D9FFB')
  }
}

对外暴露的接口，需要在入口文件中声明：index.ets

// library/src/main/ets/index.ets
export { MyTitleBar } from './components/MyTitleBar'

导出ts类和方法

通过导出ts类和方法，例如：export

// library/src/main/ets/utils/test.ts
export class Log {
    static info(msg: string) {
        console.info(msg);
    }
}

export function add(a: number, b: number) {
  return a + b;
}

export function minus(a: number, b: number) {
  return a - b;
}

对外暴露的接口，需要在入口文件中声明：index.ets

// library/src/main/ets/index.ets
export { Log, add, minus } from './utils/test'

导出native方法

在HSP中也可以包含C++编写的。对于中的方法，HSP通过间接的方式导出，以导出的乘法接口为例：sosonativelibnative.somulti

// library/src/main/ets/utils/nativeTest.ts
import native from "libnative.so"

export function nativeMulti(a: number, b: number) {
    let result: number = native.multi(a, b);
    return result;
}

对外暴露的接口，需要在入口文件中声明：index.ets

// library/src/main/ets/index.ets
export { nativeMulti } from './utils/nativeTest'

通过$r访问HSP中的资源

在组件中，经常需要使用字符串、图片等资源。HSP中的组件需要使用资源时，一般将其所用资源放在HSP包内，而非放在HSP的使用方处，以符合高内聚低耦合的原则。

在工程中，常通过/的形式引用应用资源。可以用/访问本模块目录下的资源，如访问目录下定义的图片时，可以用。有关/的详细使用方式，请参阅文档资源分类与访问中"资源访问-应用资源"小节。$r$rawfile$r$rawfileresourcesresourcessrc/main/resources/base/media/example.png$r("app.media.example")$r$rawfile

不推荐使用相对路径的方式，容易引用错误路径。例如： 当要引用上述同一图片资源时，在HSP模块中使用，实际上该组件访问的是HSP调用方（如）下的资源。Image("../../resources/base/media/example.png")Imageentryentry/src/main/resources/base/media/example.png

// library/src/main/ets/pages/Index.ets
// 正确用例
Image($r("app.media.example"))
  .width("100%")
// 错误用例
Image("../../resources/base/media/example.png")
  .width("100%")

导出HSP中的资源

跨包访问HSP内资源时，推荐实现一个资源管理类，以封装对外导出的资源。采用这种方式，具有如下优点：

• HSP开发者可以控制自己需要导出的资源，不需要对外暴露的资源可以不用导出。
• 使用方无须感知HSP内部的资源名称。当HSP内部的资源名称发生变化时，也不需要使用方跟着修改。

其具体实现如下：

将需要对外提供的资源封装为一个资源管理类：

// library/src/main/ets/ResManager.ets
export class ResManager{
  static getPic(): Resource{
    return $r("app.media.pic");
  }
  static getDesc(): Resource{
    return $r("app.string.shared_desc");
  }
}

对外暴露的接口，需要在入口文件中声明：index.ets

// library/src/main/ets/index.ets
export { ResManager } from './ResManager'

引用HSP

要使用HSP中的接口，首先需要在使用方的oh-package.json5中配置对它的依赖。 依赖配置成功后，就可以像使用HAR一样调用HSP的对外接口了。例如，上面的library已经导出了下面这些接口：

// library/src/main/ets/index.ets
export { Log, add, minus } from './utils/test'
export { MyTitleBar } from './components/MyTitleBar'
export { ResManager } from './ResManager'
export { nativeMulti } from './utils/nativeTest'

在使用方的代码中，可以这样使用：

// entry/src/main/ets/pages/index.ets
import { Log, add, MyTitleBar, ResManager, nativeMulti } from "library"
import { BusinessError } from '@ohos.base';

@Entry
@Component
struct Index {
  @State message: string = 'Hello World'
  build() {
    Row() {
      Column() {
        MyTitleBar()
        Text(this.message)
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
        Button('add(1, 2)')
          .onClick(()=>{
            Log.info("add button click!");
            this.message = "result: " + add(1, 2);
          })
        // ResManager返回的Resource对象，可以传给组件直接使用，也可以从中取出资源来使用
        Image(ResManager.getPic())
          .width("100%")
        Button('getStringValue')
          .onClick(()=> {
            // 先通过当前上下文获取hsp模块的上下文，再获取hsp模块的resourceManager，然后再调用resourceManager的接口获取资源
            getContext().createModuleContext('library').resourceManager.getStringValue(ResManager.getDesc())
              .then(value => {
                console.log("getStringValue is " + value);
              })
              .catch((err: BusinessError) => {
                console.log("getStringValue promise error is " + err);
              });
          })
          .width("50%")
        Button('nativeMulti(3, 4)')
          .onClick(()=>{
            Log.info("nativeMulti button click!");
            this.message = "result: " + nativeMulti(3, 4);
          })
      }
      .width('100%')
    }
    .height('100%')
  }
}

页面路由跳转

若开发者想在entry模块中，添加一个按钮跳转至library模块中的menu页面（路径为：），那么可以在使用方的代码（entry模块下的Index.ets，路径为：）里这样使用：library/src/main/ets/pages/menu.etsentry/src/main/ets/MainAbility/Index.ets

import router from '@ohos.router';
import { BusinessError } from '@ohos.base';

@Entry
@Component
struct Index {
    @State message: string = 'Hello World'

    build() {
    Row() {
        Column() {
        Text(this.message)
            .fontSize(50)
            .fontWeight(FontWeight.Bold)
        // 添加按钮，以响应用户点击
        Button() {
            Text('click to menu')
            .fontSize(30)
            .fontWeight(FontWeight.Bold)
        }
        .type(ButtonType.Capsule)
        .margin({
            top: 20
        })
        .backgroundColor('#0D9FFB')
        .width('40%')
        .height('5%')
        // 绑定点击事件
        .onClick(() => {
            router.pushUrl({
              url: '@bundle:com.example.hmservice/library/ets/pages/menu'
            }).then(() => {
              console.log("push page success");
            }).catch((err: BusinessError) => {
              console.error(`pushUrl failed, code is ${err.code}, message is ${err.message}`);
            })
        })
      .width('100%')
    }
    .height('100%')
    }
  }
}

其中方法的入参中的内容为：router.pushUrlurl

'@bundle:com.example.hmservice/library/ets/pages/menu'

url内容的模板为：

'@bundle:包名（bundleName）/模块名（moduleName）/路径/页面所在的文件名(不加.ets后缀)'

页面路由返回

如果当前处于HSP中的页面，需要返回之前的页面时，可以使用方法，但是返回的页面必须是当前页面跳转路径上的页面。router.back

import router from '@ohos.router';

@Entry
@Component
struct Index3 { // 路径为：`library/src/main/ets/pages/Index3.ets
  @State message: string = 'Hello World'

  build() {
    Row() {
        Column() {
        Button('back to HAP page')
        .width('40%')
        .height('5%')
        // 绑定点击事件
        .onClick(() => {
          router.back({ //  返回HAP的页面
            url: 'pages/Index'    // 路径为：`entry/src/main/ets/pages/Index.ets`
          })
        })
        .width('100%')

        Button('back to HSP page')
        .width('40%')
        .height('5%')
        // 绑定点击事件
        .onClick(() => {
          router.back({ //  返回HSP的页面
            url: '@bundle:com.example.hmservice/library/ets/pages/Index2'  //路径为：`library/src/main/ets/pages/Index2.ets
          })
        })
        .width('100%')
      }
      .height('100%')
    }
  }
}

页面返回方法的入参中说明：router.backurl

• 如果从HSP页面返回HAP页面，url的内容为：

  'pages/Index'

  url内容的模板为：

  '页面所在的文件名(不加.ets后缀)'

• 如果从HSP页面返回HSP页面，url的内容为：

  '@bundle:com.example.hmservice/library/ets/pages/Index2'

  url内容的模板为：

  '@bundle:包名（bundleName）/模块名（moduleName）/路径/页面所在的文件名(不加.ets后缀)'

最后

有很多小伙伴不知道学习哪些鸿蒙开发技术？不知道需要重点掌握哪些鸿蒙应用开发知识点？而且学习时频繁踩坑，最终浪费大量时间。所以有一份实用的鸿蒙（HarmonyOS NEXT）资料用来跟着学习是非常有必要的。 

这份鸿蒙（HarmonyOS NEXT）资料包含了鸿蒙开发必掌握的核心知识要点，内容包含了（ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等）鸿蒙（HarmonyOS NEXT）技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助，有需要的小伙伴自行领取，限时开源，先到先得~无套路领取！！

获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙（HarmonyOS NEXT）最新学习路线

•  HarmonOS基础技能

• HarmonOS就业必备技能 
•  HarmonOS多媒体技术

• 鸿蒙NaPi组件进阶

• HarmonOS高级技能

• 初识HarmonOS内核 
• 实战就业级设备开发

有了路线图，怎么能没有学习资料呢，小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙（OpenHarmony ）学习手册（共计1236页）与鸿蒙（OpenHarmony ）开发入门教学视频，内容包含：ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

获取以上完整版高清学习路线，请点击→纯血版全套鸿蒙HarmonyOS学习资料

《鸿蒙 (OpenHarmony)开发入门教学视频》

《鸿蒙生态应用开发V2.0白皮书》

《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建

 《鸿蒙开发基础》

• ArkTS语言
• 安装DevEco Studio
• 运用你的第一个ArkTS应用
• ArkUI声明式UI开发
• .……

 《鸿蒙开发进阶》

• Stage模型入门
• 网络管理
• 数据管理
• 电话服务
• 分布式应用开发
• 通知与窗口管理
• 多媒体技术
• 安全技能
• 任务管理
• WebGL
• 国际化开发
• 应用测试
• DFX面向未来设计
• 鸿蒙系统移植和裁剪定制
• ……

《鸿蒙进阶实战》

• ArkTS实践
• UIAbility应用
• 网络案例
• ……

 获取以上完整鸿蒙HarmonyOS学习资料，请点击→纯血版全套鸿蒙HarmonyOS学习资料

总结

总的来说，华为鸿蒙不再兼容安卓，对中年程序员来说是一个挑战，也是一个机会。只有积极应对变化，不断学习和提升自己，他们才能在这个变革的时代中立于不败之地。