鸿蒙开发ArkUI-X基础知识：【ArkUI代码工程及构建介绍】

代码工程及构建介绍

背景

ArkUI作为OpenHarmony的默认开发框架，在本项目（ArkUI-X）中需要做到一套代码同时支持多平台构建，所以会采取共仓开发的方式，部分仓直接指向OpenHarmony相关开源仓。

代码结构及仓库结构

代码工程的目录结构如下：

├── arkcompiler                 // 方舟编译器
├── base                        // 基础能力
├── build                       // 项目构建和配置脚本
├── build_plugins               // 跨平台构建插件
├── commonlibrary               // 公共基础库
├── community                   // 社区相关
├── developtools                // 开发者工具
├── docs                        // 配套文档
├── foundation
│   ├── appframework            // 应用框架兼容适配层
│   ├── arkui                   // ArkUI引擎
│   ├── communication           // 通信能力
│   ├── distributeddatamgr      // 分布式数据管理
│   ├── filemanagement          // 文件管理
│   ├── graphic                 // 图形引擎
│   └── multimedia              // 多媒体
├── interface                   // 接口声明
├── plugins                     // 插件管理与实现
├── prebuilts                   // 预编译目录
├── productdefine               // 产品形态配置
├── samples                     // 示例代码
├── test                        // 测试框架与用例
└── third_party                 // 三方库

搜狗高速浏览器截图20240326151547.png


具体的代码结构及指向，见下表：

目录路径描述代码仓位置
build项目构建和配置脚本[OpenHarmony/build]
build_plugins跨平台构建插件[ArkUI-X/build_plugins]
samples应用程序样例[ArkUI-X/samples]
community社区运作管理[ArkUI-X/community]
docs说明文档[ArkUI-X/docs]
interface/sdkArkUI-X SDK配置[ArkUI-X/interface_sdk]
pluginsAPI插件管理，OpenHarmony API插件实现[ArkUI-X/plugins]
test/xtsArkUI-X跨平台应用测试套件[ArkUI-X/xts]
test/testfwk/arkxtestArkUI-X测试框架[ArkUI-X/arkxtest]
developtools/ace_tools跨平台命令行工具[ArkUI-X/cli]
foundation/appframework应用框架兼容适配层[ArkUI-X/app_framework]
foundation/arkui/ace_engine/adapter/androidAndroid平台适配代码[ArkUI-X/arkui_for_android]
foundation/arkui/ace_engine/adapter/iosiOS平台适配代码[ArkUI-X/arkui_for_ios]
foundation/arkui/ace_engineArkUI 引擎核心代码[OpenHarmony/arkui_ace_engine]
foundation/arkui/napiNative API扩展机制[OpenHarmony/arkui_napi]
foundation/communication/netmanager_base网络管理模块[OpenHarmony/communication_netmanager_base]
foundation/communication/netstack网络协议栈[OpenHarmony/communication_netstack]
foundation/graphic/graphic_2d2D图形基础库[OpenHarmony/graphic_graphic_2d]
foundation/filemanagement/file_api提供目录和文件的访问操作接口[OpenHarmony/filemanagement_file_api]
foundation/multimedia/image_framework图片编解码功能实现[OpenHarmony/multimedia_image_framework]
developtools/ace_ets2bundle基于ArkTS的声明式开发范式编译转换工具和跨平台应用构建工具[OpenHarmony/ace_ets2bundle]
developtools/ace_js2bundle兼容JS的类Web开发范式编译转换工具和跨平台应用构建工具[OpenHarmony/ace_js2bundle]
arkcompiler/ets_frontend方舟前端工具[OpenHarmony/arkcompiler_ets_frontend]
arkcompiler/ets_runtime方舟ArkTS运行时[OpenHarmony/arkcompiler_ets_runtime]
arkcompiler/runtime_core方舟编译器运行时[OpenHarmony/arkcompiler_runtime_core]
arkcompiler/toolchain调试调优工具[OpenHarmony/arkcompiler_toolchain]
prebuilts预编译目录，python，nodejs，clang和cmake等通过脚本预下载
third_party开源第三方组件（统一复用OpenHarmony代码仓）引用开源三方库集合
commonlibrary/c_utils通用的C++功能函数和类[OpenHarmony/commonlibrary_c_utils]
commonlibrary/ets_utils用于存放基础类库JSAPI，比如url、uri等[OpenHarmony/commonlibrary_ets_utils]
base/hiviewdfx/hilog系统日志功能[OpenHarmony/hiviewdfx_hilog]
base/web/webviewWebView组件的Native引擎[OpenHarmony/web_webview]
base/global/resource_management全球化资源管理[OpenHarmony/global_resource_management]

分支同步策略

OpenHarmony相关代码仓，指向OpenHarmony master分支的固定tag点，定期同步，默认按照OpenHarmony的Weekly分支频率进行同步。

ArkUI引擎核心代码仓目录结构

ArkUI引擎核心代码仓 ace_engine 的目录结构以及每个目录的内容如下：

foundation/arkui/ace_engine
├── ace_config.gni      // 全局配置文件
├── adapter             // 平台适配层
│   ├── android         // Android平台适配，独立仓
│   │   ├── build
│   │   ├── capability
│   │   ├── entrance
│   │   ├── stage
│   │   └── osal
│   ├── ios             // iOS平台适配，独立仓
│   │   ├── build
│   │   ├── capability
│   │   ├── entrance
│   │   ├── stage
│   │   └── osal
│   ├── ohos            // OpenHarmony平台适配
│   └── preview         // 预览器平台适配
├── build               // 编译配置
│   ├── ace_gen_obj.gni
│   ├── ace_lib.gni
│   ├── BUILD.gn
│   ├── search.py
│   └── tools
├── BUILD.gn            // 全局编译配置
├── frameworks          // 引擎框架层
│   ├── base            // base库
│   ├── bridge          // 前端桥接
│   └── core            // 引擎核心实现
├── interfaces          // 通用对外接口
│   └── napi
│       └── kits
├── LICENSE
├── OAT.xml
├── README.md
├── README_zh.md
└── test                // 测试相关

编译构建流程

为了支持一套代码在OpenHarmony和其它平台同时构建，需要根据代码结构动态对编译配置进行调整，因为对外依赖可能不同，并且不同环境下可能依赖的外部源码都有差异，所以必须对编译目标(targets)都进行动态的定义，否则无法保持一致。

  • 编译入口：  OpenHarmony的编译入口为bundle.json，这里定义了子系统的部件以及对外的接口，放在对应子系统根目录下，ArkUI的其它平台构建暂不需要，使用固定模块名“ace_packages”作为入口。

  • 全局配置：  根目录下的BUILD.gn以及ace_config.gni为全局的配置，其中BUILD.gn下定义了全局使用的“ace_config”、“ace_test_config”，其中ace_config.gni分别定义了以下配置：

    • 全局的变量配置，如“enable_ace_debug”，通过开关进行编译控制。
    • 全局的路径定义，如“ace_napi“，配置路径的变量。
    • 工具链相关的配置，如“windows_buildtool”。
    • 在“ace_config”中使用的全局宏的定义，如“ace_common_defines”。
    • 生成平台相关的配置项“ace_platforms”，这一步是动态定义目标的关键，见如下代码：
    ace_platforms = []

# 通过搜索adapter下的目录，生成所有的adapter目录名
_ace_adapter_dir = rebase_path("$ace_root/adapter", root_build_dir)
_adapters = exec_script("build/search.py", [ _ace_adapter_dir ], "list lines")

# 导入每个adapter下的platform.gni，生成platform的定义配置，加入到ace_platforms中
foreach(item, _adapters) {
import_var = {}
import_var = {
  import("$ace_root/adapter/$item/build/platform.gni")
}

if (defined(import_var.platforms)) {
  foreach(platform, import_var.platforms) {
  if (defined(platform.name)) {
    ace_platforms += [ platform ]
  }
  }
}
}

  • 平台配置：  每个adapter下的build目录存放平台相关的配置

    ├── BUILD.gn      // 入口目标定义，如"ace_packages"
├── config.gni    // 平台配置
├── bundle.json   // 部件配置，非OpenHarmony平台暂不需要
└── platform.gni  // 平台定义

    其中，单个config.gni的配置类似如下：

    defines = [
"OHOS_PLATFORM",
"OHOS_STANDARD_SYSTEM",
]

js_engines = []
ark_engine = {
engine_name = "ark"
engine_path = "jsi"
engine_defines = [ "USE_ARK_ENGINE" ]
}
js_engines += [ ark_engine ]

disable_gpu = true
use_external_icu = "shared"
use_curl_download = true
ohos_standard_fontmgr = true
sk_use_hilog = true
accessibility_support = false
rich_components_support = true
advance_components_support = false
form_components_support = false

if (disable_gpu) {
defines += [ "GPU_DISABLED" ]
}

cflags_cc = [
"-Wno-thread-safety-attributes",
"-Wno-thread-safety-analysis",
]

platform_deps = [
"//foundation/arkui/ace_engine/adapter/ohos/entrance:ace_ohos_standard_entrance",
"//foundation/arkui/ace_engine/adapter/ohos/osal:ace_osal_ohos",
]

    这个文件定义了该平台的所有差异化配置，如宏、cflags、平台特有的依赖，以及一些功能性的开关。在具体的模块定义中，宏、cflags这一类编译配置直接从config引入，其它差异需要定义为功能性的开关，如上述的“use_curl_download”，使模块gn及特性的定义更清晰。

  • 动态目标定义：  基于上述平台的配置，就可以实现动态的定义目标，以base模块为例：

    import("//build/ohos.gni")
import("//foundation/arkui/ace_engine/ace_config.gni")

template("ace_base_source_set") {
  forward_variables_from(invoker, "*")

  ohos_source_set(target_name) {
    # 引入平台config中的define和cflags
    defines += invoker.defines
    cflags_cc = []
    cflags_cc += invoker.cflags_cc
    
    deps = [
      "$ace_root/build/third_party/cJSON:third_party_cjson",
      "i18n:ace_base_i18n_$platform",
      "resource:ace_resource",
    ]

    configs = [ "$ace_root:ace_config" ]

    # add base source file here
    sources = [
      "geometry/animatable_dimension.cpp",
      "geometry/animatable_matrix4.cpp",
      "geometry/matrix4.cpp",
      "geometry/quaternion.cpp",
      "geometry/transform_util.cpp",
      "json/json_util.cpp",
      "log/ace_trace.cpp",
      "log/dump_log.cpp",
      "memory/memory_monitor.cpp",
      "thread/background_task_executor.cpp",
      "utils/base_id.cpp",
      "utils/date_util.cpp",
      "utils/resource_configuration.cpp",
      "utils/string_utils.cpp",
      "utils/time_util.cpp",
    ]

  # 通过platform变量来进行区别配置
    if (platform != "windows") {
      # add secure c API
      include_dirs = [ "//utils/native/base/include" ]

      sources += [
        "//utils/native/base/src/securec/memset_s.c",
        "//utils/native/base/src/securec/securecutil.c",
        "//utils/native/base/src/securec/secureprintoutput_a.c",
        "//utils/native/base/src/securec/snprintf_s.c",
        "//utils/native/base/src/securec/sprintf_s.c",
        "//utils/native/base/src/securec/strcat_s.c",
        "//utils/native/base/src/securec/strcpy_s.c",
        "//utils/native/base/src/securec/vsnprintf_s.c",
        "//utils/native/base/src/securec/vsprintf_s.c",
      ]
    }

    # 通过平台的config决定是否依赖和编译curl
    if (defined(config.use_curl_download) && config.use_curl_download) {
      configs += [ "//third_party/curl:curl_config" ]
      sources += [ "$ace_root/frameworks/base/network/download_manager.cpp" ]
      deps += [ "//third_party/curl:curl" ]
    }
  }
}

# 根据ace_platforms动态定义目标：假设里面包含三个平台"ohos"、"windows"、"mac",则会定义三个target，
# 分别为：ace_base_ohos,ace_base_windows,ace_base_mac
foreach(item, ace_platforms) {
  ace_base_source_set("ace_base_" + item.name) {
    # 从platform中导入变量
    platform = item.name
    defines = []
    cflags_cc = []
    config = {
    }

    if (defined(item.config)) {
      config = item.config
    }

    if (defined(config.defines)) {
      defines = config.defines
    }

    if (defined(config.cflags_cc)) {
      cflags_cc = config.cflags_cc
    }
  }
}

  • 模块定义：  根据目录结构，尽量分成一个个小模块来定义，每个模块定义明确，如果涉及平台差异，使用上述方法定义，内部配置差异尽量使用特性来区分
  • 依赖关系：  依赖关系尽量清楚，按层次依赖，不可反向依赖
  • 开发前请熟悉鸿蒙开发指导文档：gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md点击或者复制转到。

开发原则

  • 所有功能实现遵循分层设计
  • frameworks目录下的所有模块都是平台无关的，不能依赖adapter目录下的模块，不能依赖除JS引擎相关的其它子系统
  • 平台相关的代码都必须放到adapter目录对应的平台下，如果需要在frameworks中引用相关，需要进行适当的接口抽象
  • 非OpenHarmony的adapter中不能依赖OpenHarmony其它子系统的模块（例外：该子系统有跨平台计划并且通用）
  • frameworks/core不允许依赖frameworks/bridge下的模块
  • 新增代码不可直接依赖skia接口，使用graphic_2d提供的drawing接口
  • 修改OpenHarmony仓中的内容要保证各平台都能编译通过，功能正常

鸿蒙最值得程序员入行

为什么这么说？市场是决定人力需求的，数据说话最管用：

1、鸿蒙其全栈自研，头部大厂商都陆续加入合作开发鸿蒙原生应用——人才需求上涨。

2、鸿蒙作为新系统、新技术，而现在市面上技术人才少——高薪招聘开启。

3、鸿蒙1+8+N生态，不仅只有应用开发；还有车载、数码、智能家居、家电等——就业范围广。

4、纯血鸿蒙，目前没有多少人熟悉。都处于0基础同一起跑线——无行业内卷。

开发者最需要什么？岗位多、薪资高、不内卷、行业竞争低。而当下的鸿蒙恰恰符合要求。

那么这么好的鸿蒙岗位，应聘要求都很高吧？其实不然鸿蒙作为新出的独立系统，其源头上大家都处于同一水平线上，一开始的技术要求都不会很高，毕竟面试官也是刚起步学习。招聘要求示例：

从信息看出，几乎应职要求是对标有开发经验的人群。可以说鸿蒙对开发者非常友好，尽管上面没提鸿蒙要求，但是面试都会筛选具有鸿蒙开发技能的人。我们程序员都知道学习开发技术，最先是从语言学起，鸿蒙语言有TS、ArkTS等语法，那么除了这些基础知识之外，其核心技术点有那些呢？下面就用一张整理出的鸿蒙学习路线图表示：

从上面的OpenHarmony技术梳理来看，鸿蒙的学习内容也是很多的。现在全网的鸿蒙学习文档也是非常的少，下面推荐一些：完整内容可在头像页保存，或这qr23.cn/AKFP8k甲助力

内容包含：《鸿蒙NEXT星河版开发学习文档》

  • ArkTS
  • 声明式ArkUI
  • 多媒体
  • 通信问题
  • 系统移植
  • 系统裁剪
  • FW层的原理
  • 各种开发调试工具
  • 智能设备开发
  • 分布式开发等等。

这些就是对往后开发者的分享，希望大家多多点赞关注喔！

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/639360.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

基于YOLO系列算法（YOLOv5、YOLOv6、YOLOv8以及YOLOv9）和Streamlit框架的行人头盔检测系统

基于YOLO系列算法（YOLOv5、YOLOv6、YOLOv8以及YOLOv9）和Streamlit框架的行人头盔检测系统

摘要 本文基于最新的基于深度学习的目标检测算法 (YOLOv5、YOLOv6、YOLOv8)以及YOLOv9) 对头盔数据集进行训练与验证，得到了最好的模型权重文件。使用Streamlit框架来搭建交互式Web应用界面，可以在网页端实现模型对图像、视频和实时摄像头的目标检测功能…
阅读更多...
C语言-atoi()库函数的模拟实现

C语言-atoi()库函数的模拟实现

文章目录 前言一、atoi()库函数的介绍及使用1.1 atoi()库函数介绍1.2 atoi()库函数使用 二、atoi()库函数的模拟实现2.1 函数设计2.2 函数实现思路2.3 具体实现2.4 测试 总结 前言 本篇文章介绍c语言中库函数atoi()的使用，以及模拟实现库函数。 一、atoi()库函数的…
阅读更多...
【linux】详解linux权限

【linux】详解linux权限

目录 用户 文件属性 更改文件权限 更改文件拥有者 更改文件所属组 用户的权限 文件掩码 粘滞位 总结 基本指令可参考： 【linux】详解linux基本指令-CSDN博客 【linux】详解linux基本指令-CSDN博客 用户 超级用户（root）&#xff…
阅读更多...
Redis篇 在linux系统上安装Redis

Redis篇 在linux系统上安装Redis

安装Redis 在Ubuntu上安装Redis 在Ubuntu上安装Redis 在linux系统中,我们安装Redis,必须先使它有root权限. 那么在linux中,如何切换到root用户权限呢? sudo su 就可切换到用户权限了. 在切换到用户权限后,我们需要用一条命令来搜索Redis相关的软件包 apt search redis 会出现非…
阅读更多...
怎样下载Android Studio历史版本文件包

怎样下载Android Studio历史版本文件包

1.在官网上下载都是推荐最新版本，想下载历史版本比较费劲，绕来绕去的。 2.进入这个网站可以下载其他版本https://android-studio.en.uptodown.com/windows/versions Older versions of Android Studio Its not uncommon for the latest version of an a…
阅读更多...
解耦:哪些方法可以用来解耦代码

解耦:哪些方法可以用来解耦代码

目录 1.引用 2.为何解耦如此重要 3.如何判断代码是否需要解耦 4.如何给代码解耦 5.思考题 1.引用 前面我们曾经讲到，重构可以分为大型重构和小型重构。小型重构的主要目的是提高代码的可读性，大型重构的主要目的是解耦。本节讲解如何对代码进行解耦…
阅读更多...
webgl three 模型操作

webgl three 模型操作

模型位置操作是改变相关属性 平移改变位置 缩放改变缩放值 旋转改变角度 webgl中是4x4矩阵 前三排是原始状态 第四排是改变值 .position 位置 .scale 缩放 .rotation 绕轴旋转 .quaternion 绕axis旋转 其实和svg差不多 缩放 缩放是操作对角线 // Matrix4x4 …
阅读更多...
大语言模型的工程技巧（三）——分布式计算

大语言模型的工程技巧（三）——分布式计算

相关说明 这篇文章的大部分内容参考自我的新书《解构大语言模型：从线性回归到通用人工智能》，欢迎有兴趣的读者多多支持。 本文将讨论如何利用多台机器进行神经网络的分布式训练。利用多台机器来加速大语言模型的训练，是其获得成功的重要原…
阅读更多...
操作系统总结3

操作系统总结3

目录 2.3.3 进程互斥的硬件的实现方法 （1）知识总览 （2）中断的屏蔽方法 （3）TestAndSet指令 （4）Swap指令 总结 2.3.4 信号量机制 （1）知识总览 &#x…
阅读更多...
《web应用设计》第八次作业

《web应用设计》第八次作业

我的小组长是姚若希，我们组课程设计的题目是：学生管理系统 ，我认领的功能模块是：课程管理 2.查询并分页
阅读更多...
MM模块五（采购订单）

MM模块五（采购订单）

创建采购订单：ME21N 参考报价单创建采购订单： 哪个采购部门的哪个采购员为哪个公司代码下的采购订单 点击保存 注：采购订单的数量不能大于采购申请的数量
阅读更多...
选择优化求解器的关键因素：以MindOpt为例

选择优化求解器的关键因素：以MindOpt为例

选择一款适合自己业务需求的求解器我们一般需要考量什么呢？可求解的问题类型？问题规模？本文将介绍一些需要考虑的重要因素，并且介绍阿里达摩院MindOpt优化求解器在这些因素下的表现。 ⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇️⬇…
阅读更多...
【Linux】Centos7安装MySql

【Linux】Centos7安装MySql

【Linux】Centos7安装MySql 下载 MySQL 官网下载 MySQL，用的是 CentOS7.9 所以选择红帽系统 https://downloads.mysql.com/archives/community/ 安装 使用rz命令上传 MySQL tar # 创建 MySQL 解压目录 [rootlocalhost /]# mkdir /usr/local/mysql# 解压 [rootloca…
阅读更多...
【漏洞复现】懒人网址导航页 search.html SQL注入漏洞

【漏洞复现】懒人网址导航页 search.html SQL注入漏洞

0x01 产品简介 赖人网址导航系统是一种智能化的网址导航平台，旨在帮助用户快速找到所需的网址和资源。该系统提供了智能化的网址搜索和推荐功能，能够根据用户的搜索习惯和偏好推荐相关的网址和资源。同时，系统还提供了网址分类、网址收藏和网…
阅读更多...
VScode SSH连接远程服务器报错

VScode SSH连接远程服务器报错

一、报错 通过VScode SSH插件远程连接服务器，输入密码后没有连接成功，一直跳出输入密码界面，在输出界面里，一直是Waiting for server log或者是显示Cannot not find minimist 二、处理 🐱： 这个时候应该…
阅读更多...
数据可视化技术头歌测试合集

数据可视化技术头歌测试合集

努力是为了不平庸~ 学习的最大理由是想摆脱平庸，早一天就多一份人生的精彩；迟一天就多一天平庸的困扰 目录 时间趋势可视化-柱形图 第1关：“大胃王”比赛数据柱形图绘制——绘制柱形图的基本步骤 任务描述 相关知识 观察和处理数据 绘…
阅读更多...
JLINK使用及问题

JLINK使用及问题

一、安装：安装过程选择好文件夹，过程中一直默认就行，如果之前安装的有其他版本，在最后一步需要多注意一下，或者不注意，直接默认选中的就行。 二、使用： 在官网下载的J-Link V7.96i&#xff0c…
阅读更多...
视频码流分析工具

视频码流分析工具

一、VQ Analyzer 在线使用说明： https://vicuesoft.com/vq-analyzer/userguide/ ref： Video Analyzer and Streaming Tester Software – VQ Analyzer HEVC 分析工具 - 懒人李冰 推荐一个开源且跨平台的免费码流分析软件YUView - 知乎
阅读更多...
【大模型部署】在C# Winform中使用文心一言ERNIE-3.5 4K 聊天模型

【大模型部署】在C# Winform中使用文心一言ERNIE-3.5 4K 聊天模型

【大模型部署】在C# Winform中使用文心一言ERNIE-3.5 4K 聊天模型 前言 今天来写一个简单的ernie-c#的例子，主要参考了百度智能云的例子，然后自己改了改，学习了ERNIE模型的鉴权方式，数据流的格式和简单的数据解析，实…
阅读更多...
【漏洞复现】智慧校园(安校易)管理系统 FileUpProductupdate.aspx 任意文件上传漏洞

【漏洞复现】智慧校园(安校易)管理系统 FileUpProductupdate.aspx 任意文件上传漏洞

0x01 产品简介 "安校易"是银达云创公司基于多年教育市场信息化建设经验沉淀，经过充分的客户需求调研，并依据国家"十三五”"教育信息化建设规范而推出的综合互联网教育信息化解决方案。“安校易“以物联网技术为基础，以学…
阅读更多...
最新文章

Copyright @ 2022~2023