张裕 发表于 2024-12-13 14:35:49

HarmonyOS实战开发:HAR静态共享包

HAR(Harmony Archive)是静态共享包,可以包含代码、C++库、资源和配置文件。通过HAR可以实现多个模块或多个工程共享ArkUI组件、资源等相干代码。HAR差别于HAP,不能独立安装运行在设备上,只能作为应用模块的依赖项被引用。
创建HAR模块

通过DevEco Studio创建一个HAR模块,创建方式可参考。
必要对代码资产进行掩护时,建议开启混淆能力。混淆能力开启后,DevEco Studio在构建HAR时,会对代码进行编译、混淆及压缩处置处罚,掩护代码资产。
   注意:仅Stage模型的ArkTS工程支持混淆。 HAR开启混淆后资源ID为-1,ResourceManager等通过ID获取资源的API不再见效。
混淆功能在差别版本默认开启情况差别:


[*] 在API 9中,HAR模块默认不开启混淆能力。若要开启混淆能力,必要把HAR模块的build-profile.json5文件中的artifactType字段设置为obfuscation,配置如下所示:
{
"apiType": "stageMode",
"buildOption": {
      "artifactType": "obfuscation"
}
} artifactType字段有以下两种取值,默认缺省为original。

[*]原文:不混淆。
[*]混淆:混淆。

[*] 在API10中,HAR模块默认开启混淆能力,可以在HAR模块的build-profile.json5文件中的ruleOptions字段下的enable进行设置,配置如下所示:
{
"apiType": "stageMode",
"buildOption": {
},
"buildOptionSet": [
    {
      "name": "release",
      "arkOptions": {
      "obfuscation": {
          "ruleOptions": {
            "enable": true,
            "files": [
            "./obfuscation-rules.txt"
            ]
          },
          "consumerFiles": [
            "./consumer-rules.txt"
          ]
      }
      }
    },
],
"targets": [
    {
      "name": "default"
    }
]
} 适配指导
该字段配置前向兼容,原有功能暂时不受影响。API10后续将渐渐废弃,建议尽快使用新的配置方式。
HAR开发注意事项



[*]HAR不支持在配置文件中声明abilities、extensionAbilities组件。
[*]HAR不支持在配置文件中声明页面。
[*]HAR不支持在build-profile.json5文件的buildOption中配置worker。
[*]FA模型与Stage模型的HAR不支持相互引用。
[*]Stage模型的HAR,不能引用AppScope内的内容。在编译构建时AppScope中的内容不会打包到HAR中,导致HAR资源引用失败。
导出HAR的ArkUI组件、接口、资源

Index.ets文件是HAR导作声明文件的入口,HAR必要导出的接口,同一在Index.ets文件中导出。Index.ets文件是DevEco Studio默认主动生成的,用户也可以自定义,在模块的oh-package.json5文件中的main字段配置入口声明文件,配置如下所示:
{
"main": "Index.ets"
} 导出ArkUI组件

ArkUI组件的导出方式与ts的导出方式一致,通过导出ArkUI组件,示例如下:export
// library/src/main/ets/components/MainPage/MainPage.ets
@Component
export struct MainPage {
@State message: string = 'Hello World'
build() {
    Row() {
      Column() {
      Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
}
} HAR对外暴露的接口,在Index.ets导出文件中声明如下所示:
// library/Index.ets
export { MainPage } from './src/main/ets/components/MainPage/MainPage' 导出ts类和方法

通过导出ts类和方法,支持导出多个ts类和方法,示例如下所示:export
// library/src/main/ts/test.ets
export class Log {
    static info(msg: string) {
      console.info(msg);
    }
}

export function func() {
return "har func";
}

export function func2() {
return "har func2";
} HAR对外暴露的接口,在Index.ets导出文件中声明如下所示:
// library/Index.ets
export { Log } from './src/main/ts/test'
export { func } from './src/main/ts/test'
export { func2 } from './src/main/ts/test' 导出native方法

在HAR中也可以包含C++编写的so。对于so中的native方法,HAR通过以下方式导出,以导出 libnative.so 的加法接口add为例:
// library/src/main/ets/utils/nativeTest.ts
import native from "libnative.so"

export function nativeAdd(a: number, b: number) {
    let result: number = native.add(a, b);
    return result;
} HAR对外暴露的接口,在Index.ets导出文件中声明如下所示:
// library/Index.ets
export { nativeAdd } from './src/main/ets/utils/nativeTest' 资源

HAR模块编译打包时会把资源打包到HAR中。在编译构建HAP时,DevEco Studio会从HAP模块及依赖的模块中收集资源文件,如果差别模块下的资源文件出现重名冲突时,DevEco Studio会按照以下优先级进行覆盖(优先级由高到低):


[*]AppScope(仅API9的Stage模型支持)。
[*]HAP包自身模块。
[*]依赖的HAR模块,如果依赖的多个HAR之间有资源冲突,会按照依赖序次进行覆盖(依赖序次在前的优先级较高)。
引用HAR的ArkUI组件、接口、资源

引用HAR前,必要先配置对HAR的依赖,配置方式可参考。
引用HAR的ArkUI组件

HAR的依赖配置乐成后,可以引用HAR的ArkUI组件。ArkUI组件的导入方式与ts的导入方式一致,通过引入HAR导出的ArkUI组件,示例如下所示:import
// entry/src/main/ets/pages/Index.ets
import { MainPage } from "library"

@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
    Row() {
      // 引用HAR的ArkUI组件
      MainPage()
      Column() {
      Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
}
} 引用HAR的ts类和方法

通过引用HAR导出的ts类和方法,示例如下所示:import
// entry/src/main/ets/pages/Index.ets
import { Log } from "library"
import { func } from "library"

@Entry
@Component
struct Index {
build() {
    Row() {
      Column() {
      Button('Button')
          .onClick(()=>{
            // 引用HAR的类和方法
            Log.info("har msg");
            func();
      })
      }
      .width('100%')
    }
    .height('100%')
}
} 引用HAR的native方法

通过引用HAR导出的native方法,示例如下所示:import
// entry/src/main/ets/pages/Index.ets
import { nativeAdd } from "library"

@Entry
@Component
struct Index {
@State message: string = 'Hello World'
build() {
    Row() {
      Column() {
      Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      Button('nativeAdd(1, 2)')
          .onClick(()=> {
            this.message = "result: " + nativeAdd(1, 2);
          })
      }
      .width('100%')
    }
    .height('100%')
}
} 引用HAR的资源

通过引用HAR中的资源,例如在HAR模块的里添加字符串资源(在string.json中定义,name:hello_har)和图片资源(icon_har.png),然后在Entry模块中引用该字符串和图片资源的示例如下所示:$rsrc/main/resources
// entry/src/main/ets/pages/Index.ets
@Entry
@Component
struct Index {
build() {
    Row() {
      Column() {
      // 引用HAR的字符串资源
      Text($r("app.string.hello_har"))
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      // 引用HAR的图片资源
      Image($r("app.media.icon_har"))
      }
      .width('100%')
    }
    .height('100%')
}
} 最后

有很多小同伴不知道学习哪些鸿蒙开发技术?不知道必要重点把握哪些鸿蒙应用开发知识点?而且学习时频仍踩坑,终极浪费大量时间。所以有一份实用的鸿蒙(HarmonyOS NEXT)资料用来跟着学习是非常有须要的。 
这份鸿蒙(HarmonyOS NEXT)资料包含了鸿蒙开发必把握的焦点知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(HarmonyOS NEXT)技术知识点。
盼望这一份鸿蒙学习资料可以或许给各人带来资助,有必要的小同伴自行领取,限时开源,先到先得~无套路领取!!
获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
鸿蒙(HarmonyOS NEXT)最新学习路线

https://i-blog.csdnimg.cn/blog_migrate/8fb90f03f52981850522a8d70bfe821d.png


[*]  HarmonOS基础技能
https://i-blog.csdnimg.cn/blog_migrate/d15791a8d9157b12cf470e6e20e199cd.png


[*]HarmonOS就业必备技能 https://i-blog.csdnimg.cn/blog_migrate/219a3f80b24947602f5ce80869c0f0d1.png
[*] HarmonOS多媒体技术
https://i-blog.csdnimg.cn/blog_migrate/f76470c4171a878d5f6071f6d009b828.png


[*]鸿蒙NaPi组件进阶
https://i-blog.csdnimg.cn/blog_migrate/8755cfeac3a887ec19fb168f7164234c.png


[*]HarmonOS高级技能
https://i-blog.csdnimg.cn/blog_migrate/1e210328c1ebf43f08d3b6c5f5c13b48.png


[*]初识HarmonOS内核 https://i-blog.csdnimg.cn/blog_migrate/24384aae472f78c055f7bf545467db7f.png
[*]实战就业级设备开发
https://i-blog.csdnimg.cn/blog_migrate/9b0c4eb9a30ca059d28eceb4727b593e.png
有了路线图,怎么能没有学习资料呢,小编也预备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。
获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料
《鸿蒙 (OpenHarmony)开发入门教学视频》

https://i-blog.csdnimg.cn/blog_migrate/9b893c2a4956d6ce72b63212f9216eab.png
《鸿蒙生态应用开发V2.0白皮书》

https://i-blog.csdnimg.cn/blog_migrate/343917b8910aff13b48316fe3db39da6.jpeg
《鸿蒙 (OpenHarmony)开发基础到实战手册》

OpenHarmony北向、南向开发环境搭建
https://i-blog.csdnimg.cn/blog_migrate/2e05bbd2cb0f05ec297905ba57f803c2.png
 《鸿蒙开发基础》



[*]ArkTS语言
[*]安装DevEco Studio
[*]运用你的第一个ArkTS应用
[*]ArkUI声明式UI开发
[*].……
https://i-blog.csdnimg.cn/blog_migrate/48e16dbee395ba8de1264149330856d4.png
 《鸿蒙开发进阶》



[*]Stage模型入门
[*]网络管理
[*]数据管理
[*]电话服务
[*]分布式应用开发
[*]通知与窗口管理
[*]多媒体技术
[*]安全技能
[*]任务管理
[*]WebGL
[*]国际化开发
[*]应用测试
[*]DFX面向未来计划
[*]鸿蒙系统移植和裁剪定制
[*]……
https://i-blog.csdnimg.cn/blog_migrate/adf72eca696abc1415cd768fceda1af7.png
《鸿蒙进阶实战》



[*]ArkTS实践
[*]UIAbility应用
[*]网络案例
[*]……
https://i-blog.csdnimg.cn/blog_migrate/c077a46bb540fc657713d99f39e9c74c.png
 获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料
总结

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

免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!更多信息从访问主页:qidao123.com:ToB企服之家,中国第一个企服评测及商务社交产业平台。
页: [1]
查看完整版本: HarmonyOS实战开发:HAR静态共享包