W3Cschool
恭喜您成為首批注冊用戶
獲得88經(jīng)驗值獎勵
HAR(Harmony Archive)是靜態(tài)共享包,可以包含代碼、C++庫、資源和配置文件。通過HAR可以實現(xiàn)多個模塊或多個工程共享ArkUI組件、資源等相關代碼。HAR不同于HAP,不能獨立安裝運行在設備上,只能作為應用模塊的依賴項被引用。
通過DevEco Studio創(chuàng)建一個HAR模塊,詳見創(chuàng)建庫模塊。HAR模塊默認不開啟混淆能力,開啟混淆能力,需要把HAR模塊的build-profile.json5文件中的artifactType字段設置為obfuscation,配置如下所示:
- {
- "apiType": "stageMode",
- "buildOption": {
- "artifactType": "obfuscation"
- }
- }
artifactType字段有以下兩種取值,默認缺省為original。
需要對代碼資產(chǎn)進行保護時,建議開啟混淆能力,混淆能力開啟后,DevEco Studio在構建HAR時,會對代碼進行編譯、混淆及壓縮處理,保護代碼資產(chǎn)。
注意:artifactType字段設置為obfuscation時,apiType字段必須設置為stageMode,因為Stage模型才支持混淆。
Index.ets文件是HAR導出聲明文件的入口,HAR需要導出的接口,統(tǒng)一在Index.ets文件中導出。Index.ets文件是DevEco Studio默認自動生成的,用戶也可以自定義,在模塊的oh-package.json5文件中的main字段配置入口聲明文件,配置如下所示:
- {
- "main": "Index.ets"
- }
ArkUI組件的導出方式與ts的導出方式一致,通過export導出ArkUI組件,示例如下:
- // 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'
通過export導出ts類和方法,支持導出多個ts類和方法,示例如下所示:
- // 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'
在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模塊及依賴的模塊中收集資源文件,如果不同模塊下的資源文件出現(xiàn)重名沖突時,DevEco Studio會按照以下優(yōu)先級進行覆蓋(優(yōu)先級由高到低):
HAR的依賴配置成功后,可以引用HAR的ArkUI組件。ArkUI組件的導入方式與ts的導入方式一致,通過import引入HAR導出的ArkUI組件,示例如下所示:
- // 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%')
- }
- }
通過import引用HAR導出的ts類和方法,示例如下所示:
- // 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%')
- }
- }
通過import引用HAR導出的native方法,示例如下所示:
- // 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%')
- }
- }
通過$r引用HAR中的資源,例如在HAR模塊的src/main/resources里添加字符串資源(在string.json中定義,name:hello_har)和圖片資源(icon_har.png),然后在Entry模塊中引用該字符串和圖片資源的示例如下所示:
- // 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%')
- }
- }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網(wǎng)安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯(lián)系方式:
更多建議: