鸿蒙南向开发实战：HAP编译_鸿蒙脚本配置编译的hap名字和路径

基本概念

功能简介

提供HAP编译构建功能，支持FA模型、Stage模型。

开发指导

编译子系统提供的模板

ohos_hap

声明一个HAP目标，该目标会生成一个HAP，最终将会打包到system镜像中。

ohos_app_scope

声明一个HAP的AppScope模块，该目标的app_profile和sources会在编译时拼接到具体的entry内编译，该模板只在Stage模型下使用。

ohos_js_assets

js或ets代码，编译后放置在assets/js/default目录下，stage模型根据代码分别放置到js或ets目录。

ohos_assets

原始assets，这些assets会直接拷贝到HAP的assets目录下。

ohos_resources

资源文件，FA模型编译后放置在assets/entry/resources目录下，Stage模型编译后放置在resources目录下。

操作步骤

1. 将开发完成的应用example放到applications/standard/目录下。

2. 配置gn脚本applications/standard/example/BUILD.gn，FA模型简单示例如下（更多BUILD.gn配置见gn脚本配置示例）：

   import("//build/ohos.gni") # 引用ohos.gni
    
   ohos_hap("example") {
     hap_profile = "./src/main/config.json" # config.json
     js_assets = ["./src/main/js/default"]
     raw_assets = ["./raw_assets"]
     resources = ["./src/main/resources"]
     shared_libraries = [
       "//third_party/libpng:libpng", # native库
     ]
     certificate_profile = "../signature/systemui.p7b" # Cer文件
     hap_name = "SystemUI-NavigationBar" # 名字
     part_name = "prebuilt_hap"
     subsystem_name = "applications"
   }
   

3. 修改applications/standard/hap/ohos.build，示例如下：

   {
     "subsystem": "applications",
     "parts": {
       "prebuilt_hap": {
         "module_list": [
           ...
           "//applications/standard/example:example" # 添加编译目标
         ]
       }
     }
   }
   

4. 编译命令：

   # 全量编译
   ./build.sh --product-name {product_name}
    
   # 单独编译HAP
   ./build.sh --product-name {product_name} --build-target applications/standard/example:example
   

5. 编译产物，FA模型简单例子HAP解压视图如下：

     Length      Date    Time    Name
   ---------  ---------- -----   ----
        1439  2009-01-01 00:00   assets/raw_assets                                 -----> raw_assets
         354  2009-01-01 00:00   assets/entry/resources.index                      ------> resources
           1  2009-01-01 00:00   assets/entry/resources/base/media/attributes.key  ------> resources
           1  2009-01-01 00:00   assets/entry/resources/base/media/constants.key   ------> resources
           1  2009-01-01 00:00   assets/entry/resources/base/media/contents.key    ------> resources
        6790  2009-01-01 00:00   assets/entry/resources/base/media/icon.png        ------> resources
           1  2009-01-01 00:00   assets/entry/resources/base/media/nodes.key       ------> resources
       11170  2009-01-01 00:00   assets/js/default/app.js                          ------> js_assets
          48  2009-01-01 00:00   assets/js/default/i18n/en-US.json                 ------> js_assets
          50  2009-01-01 00:00   assets/js/default/i18n/zh-CN.json                 ------> js_assets
         224  2009-01-01 00:00   assets/js/default/manifest.json                   ------> js_assets
       41481  2009-01-01 00:00   assets/js/default/pages/index/index.js            ------> js_assets
         909  2009-01-01 00:00   config.json                                       ------> hap_profile
      266248  2009-01-01 00:00   libs/libpng.z.so                                  ------> shared_libraries
   

gn脚本配置示例

• FA模型多ability示例

  import("//build/ohos.gni")
   
  ohos_hap("dataability") {
    hap_profile = "entry/src/main/config.json"
    deps = [
      ":dataability_js_assets",
      ":dataability_resources",
    ]
    certificate_profile = "signature/openharmony_sx.p7b"
    hap_name = "dataability"
    part_name = "prebuilt_hap"
    subsystem_name = "applications"
  }
   
  ohos_js_assets("dataability_js_assets") {
    ets2abc = true
    source_dir = "entry/src/main/ets"
    hap_profile = "entry/src/main/config.json"
  }
   
  ohos_resources("dataability_resources") {
    sources = [
      "entry/src/main/resources",
    ]
    hap_profile = "entry/src/main/config.json"
  }
  

• FA模型Js卡片示例

  import("//build/ohos.gni")
   
  ohos_hap("FormOfFaJs") {
    hap_profile = "entry/src/main/config.json"
    deps = [
      ":FormOfFaJs_js_assets",
      ":FormOfFaJs_resources",
    ]
    certificate_profile = "signature/openharmony_sx.p7b"
    hap_name = "FormOfFaJs"
    part_name = "prebuilt_hap"
    subsystem_name = "applications"
  }
   
  ohos_js_assets("FormOfFaJs_js_assets") {
    hap_profile = "entry/src/main/config.json"
    js2abc = true
    source_dir = "entry/src/main/js"
  }
   
  ohos_resources("FormOfFaJs_resources") {
    sources = [
      "entry/src/main/resources",
    ]
    hap_profile = "entry/src/main/config.json"
  }
  

• FA模型Ets卡片示例

  import("//build/ohos.gni")
   
  ohos_hap("FormOfFaEts") {
    hap_profile = "entry/src/main/config.json"
    deps = [
      ":FormOfFaEts_js_assets",
      ":FormOfFaEts_form_js_assets",
      ":FormOfFaEts_resources",
    ]
    certificate_profile = "signature/openharmony_sx.p7b"
    hap_name = "FormOfFaEts"
    part_name = "prebuilt_hap"
    subsystem_name = "applications"
  }
   
  ohos_js_assets("FormOfFaEts_js_assets") {
    hap_profile = "entry/src/main/config.json"
    ets2abc = true
    source_dir = "entry/src/main/ets"
  }
   
  ohos_js_assets("FormOfFaEts_form_js_assets") {
    hap_profile = "entry/src/main/config.json"
    js2abc = true
    source_dir = "entry/src/main/js"
  }
   
  ohos_resources("FormOfFaEts_resources") {
    sources = [
      "entry/src/main/resources",
    ]
    hap_profile = "entry/src/main/config.json"
  }
  

• Stage模型简单示例

  import("//build/ohos.gni")
   
  ohos_hap("actmoduletest") {
    hap_profile = "entry/src/main/module.json"
    deps = [
      ":actmoduletest_js_assets",
      ":actmoduletest_resources",
    ]
    certificate_profile = "signature/openharmony_sx.p7b"
    hap_name = "actmoduletest"
    part_name = "prebuilt_hap"
    subsystem_name = "applications"
  }
   
  ohos_app_scope("actmoduletest_app_profile") {
    app_profile = "AppScope/app.json"
    sources = [ "AppScope/resources" ]
  }
   
  ohos_js_assets("actmoduletest_js_assets") {
    ets2abc = true
    source_dir = "entry/src/main/ets"
  }
   
  ohos_resources("actmoduletest_resources") {
    sources = [
      "entry/src/main/resources",
    ]
    deps = [
      ":actmoduletest_app_profile",
    ]
    hap_profile = "entry/src/main/module.json"
  }
  

• Stage模型卡片示例

  import("//build/ohos.gni")
   
  ohos_hap("FormOfStageEts") {
    hap_profile = "entry/src/main/module.json"
    deps = [
      ":FormOfStageEts_js_assets",
      ":FormOfStageEts_form_js_assets",
      ":FormOfStageEts_resources",
    ]
    js_build_mode = "debug"  # 默认release
    certificate_profile = "signature/openharmony_sx.p7b"
    hap_name = "FormOfStageEts"
    part_name = "prebuilt_hap"
    subsystem_name = "applications"
  }
   
  ohos_js_assets("FormOfStageEts_js_assets") {
    hap_profile = "entry/src/main/module.json"
    ets2abc = true
    source_dir = "entry/src/main/ets"
  }
   
  ohos_js_assets("FormOfStageEts_form_js_assets") {
    hap_profile = "entry/src/main/module.json"
    js2abc = true
    source_dir = "entry/src/main/js"
  }
   
  ohos_app_scope("FormOfStageEts_app_profile") {
    app_profile = "AppScope/app.json"
    sources = [ "AppScope/resources" ]
  }
   
  ohos_resources("FormOfStageEts_resources") {
    sources = [
      "entry/src/main/resources",
    ]
    deps = [
      ":FormOfStageEts_app_profile",
    ]
    hap_profile = "entry/src/main/module.json"
  }
  

最后

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

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

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

如果你是一名有经验的资深Android移动开发、Java开发、前端开发、对鸿蒙感兴趣以及转行人员，可以直接领取这份资料

 获取这份完整版高清学习路线，请点击→纯血版全套鸿蒙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学习资料

总结

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