HAR

創(chuàng)建HAR模塊

通過(guò)DevEco Studio創(chuàng)建一個(gè)HAR模塊，詳見(jiàn)創(chuàng)建庫(kù)模塊。HAR模塊默認(rèn)不開(kāi)啟混淆能力，開(kāi)啟混淆能力，需要把HAR模塊的build-profile.json5文件中的artifactType字段設(shè)置為obfuscation，配置如下所示：

{
  "apiType": "stageMode",
  "buildOption": {
      "artifactType": "obfuscation"
  }
}

artifactType字段有以下兩種取值，默認(rèn)缺省為original。

• original：不混淆。
• obfuscation：混淆。

需要對(duì)代碼資產(chǎn)進(jìn)行保護(hù)時(shí)，建議開(kāi)啟混淆能力，混淆能力開(kāi)啟后，DevEco Studio在構(gòu)建HAR時(shí)，會(huì)對(duì)代碼進(jìn)行編譯、混淆及壓縮處理，保護(hù)代碼資產(chǎn)。

注意：artifactType字段設(shè)置為obfuscation時(shí)，apiType字段必須設(shè)置為stageMode，因?yàn)镾tage模型才支持混淆。

HAR開(kāi)發(fā)注意事項(xiàng)

• HAR不支持在配置文件中聲明abilities、extensionAbilities組件。
• HAR不支持在配置文件中聲明pages頁(yè)面。
• HAR不支持在build-profile.json5文件的buildOption中配置worker。
• FA模型與Stage模型的HAR不支持相互引用。
• Stage模型的HAR，不能引用AppScope內(nèi)的內(nèi)容。在編譯構(gòu)建時(shí)AppScope中的內(nèi)容不會(huì)打包到HAR中，導(dǎo)致HAR資源引用失敗。

導(dǎo)出HAR的ArkUI組件、接口、資源

Index.ets文件是HAR導(dǎo)出聲明文件的入口，HAR需要導(dǎo)出的接口，統(tǒng)一在Index.ets文件中導(dǎo)出。Index.ets文件是DevEco Studio默認(rèn)自動(dòng)生成的，用戶(hù)也可以自定義，在模塊的oh-package.json5文件中的main字段配置入口聲明文件，配置如下所示：

{
  "main": "Index.ets"
}

導(dǎo)出ArkUI組件

ArkUI組件的導(dǎo)出方式與ts的導(dǎo)出方式一致，通過(guò)export導(dǎo)出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對(duì)外暴露的接口，在Index.ets導(dǎo)出文件中聲明如下所示：

// library/Index.ets
export { MainPage } from './src/main/ets/components/MainPage/MainPage'

導(dǎo)出ts類(lèi)和方法

通過(guò)export導(dǎo)出ts類(lèi)和方法，支持導(dǎo)出多個(gè)ts類(lèi)和方法，示例如下所示：

// 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對(duì)外暴露的接口，在Index.ets導(dǎo)出文件中聲明如下所示：

// library/Index.ets
export { Log } from './src/main/ts/test'
export { func } from './src/main/ts/test'
export { func2 } from './src/main/ts/test'

導(dǎo)出native方法

在HAR中也可以包含C++編寫(xiě)的so。對(duì)于so中的native方法，HAR通過(guò)以下方式導(dǎo)出，以導(dǎo)出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對(duì)外暴露的接口，在Index.ets導(dǎo)出文件中聲明如下所示：

// library/Index.ets
export { nativeAdd } from './src/main/ets/utils/nativeTest'

資源

HAR模塊編譯打包時(shí)會(huì)把資源打包到HAR中。在編譯構(gòu)建HAP時(shí)，DevEco Studio會(huì)從HAP模塊及依賴(lài)的模塊中收集資源文件，如果不同模塊下的資源文件出現(xiàn)重名沖突時(shí)，DevEco Studio會(huì)按照以下優(yōu)先級(jí)進(jìn)行覆蓋（優(yōu)先級(jí)由高到低）：

• AppScope（僅API9的Stage模型支持）。
• HAP包自身模塊。
• 依賴(lài)的HAR模塊，如果依賴(lài)的多個(gè)HAR之間有資源沖突，會(huì)按照依賴(lài)順序進(jìn)行覆蓋（依賴(lài)順序在前的優(yōu)先級(jí)較高）。

引用HAR的ArkUI組件、接口、資源

引用HAR前，需要先配置對(duì)HAR的依賴(lài)，配置方式可參考引用HAR文件和資源。

引用HAR的ArkUI組件

HAR的依賴(lài)配置成功后，可以引用HAR的ArkUI組件。ArkUI組件的導(dǎo)入方式與ts的導(dǎo)入方式一致，通過(guò)import引入HAR導(dǎo)出的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%')
  }
}

引用HAR的ts類(lèi)和方法

通過(guò)import引用HAR導(dǎo)出的ts類(lèi)和方法，示例如下所示：

// 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的類(lèi)和方法
            Log.info("har msg");
            func();
        })
      }
      .width('100%')
    }
    .height('100%')
  }
}

引用HAR的native方法

通過(guò)import引用HAR導(dǎo)出的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%')
  }
}

引用HAR的資源

通過(guò)$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%')
  }
}