HAR

創(chuàng)建HAR模塊

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

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

artifactType字段有以下兩種取值，默認缺省為original。

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

需要對代碼資產(chǎn)進行保護時，建議開啟混淆能力，混淆能力開啟后，DevEco Studio在構建HAR時，會對代碼進行編譯、混淆及壓縮處理，保護代碼資產(chǎn)。

注意：artifactType字段設置為obfuscation時，apiType字段必須設置為stageMode，因為Stage模型才支持混淆。

HAR開發(fā)注意事項

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

導出HAR的ArkUI組件、接口、資源

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

{
  "main": "Index.ets"
}

導出ArkUI組件

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'

導出ts類和方法

通過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'

導出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模塊及依賴的模塊中收集資源文件，如果不同模塊下的資源文件出現(xiàn)重名沖突時，DevEco Studio會按照以下優(yōu)先級進行覆蓋（優(yōu)先級由高到低）：

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

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

引用HAR前，需要先配置對HAR的依賴，配置方式可參考引用HAR文件和資源。

引用HAR的ArkUI組件

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%')
  }
}

引用HAR的ts類和方法

通過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%')
  }
}

引用HAR的native方法

通過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%')
  }
}

引用HAR的資源

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