鸿蒙开发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 = falseif (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和cflagsdefines += invoker.definescflags_cc = []cflags_cc += invoker.cflags_ccdeps = ["$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 heresources = ["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 APIinclude_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决定是否依赖和编译curlif (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.namedefines = []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层的原理
  • 各种开发调试工具
  • 智能设备开发
  • 分布式开发等等。

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

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

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

多模态模型(MLLM)论文串烧

近期看了一些多模态方向的工作,包括图像、文本多模态,图像、视频、语音、文本多模态,做个总结。 Yi Qwen-VL LLaVA MobileVLM LanguageBind Video-LLaVA VAST

【机器学习300问】94、什么是多任务学习?

一、多任务学习的定义 多任务学习(Multi-Task Learning, MTL)是一种机器学习范式,它允许一个模型同时学习执行多个相关但不完全相同的任务。这种方法的核心是:通过共享表示或权重,不同的任务可以在学习过程中相互促进&…

浅谈微服务的自动化部署

一、常用部署工具 jenkins,docker生态是比较常用的工具,本文也主要是聊这几个。其他如Kubernetes (K8s),Ansible,GitLab CI/CD等工具本文只是暂时提一下,不展开讨论。 二、比较jenkins和docker生态 1、jenkins 优点 jenkins功…

Rust使用rust_xlsxwriter库把Vec数据写入Excel

一、Rust使用rust_xlsxwriter库把一维Vec数据写入Excel 在Rust中,使用rust_xlsxwriter库将一维Vec数据写入Excel文件是一个相对简单的过程。首先,你需要确保你的Cargo.toml文件中已经添加了rust_xlsxwriter依赖。以下是如何添加依赖的示例: …

KMP题解代码(含讲解)

目录 注意: next数组的变化规律: 初始化: 求next数组部分: KMP部分: AC代码: 题目链接:【模板】KMP - 洛谷 注意: 1、next数组是针对子串的,并未涉及母串,因此求next数组时…

Python中文件操作和异常处理

文章目录 一、文件操作1.概念2.文件3.二进制 二、基本文件操作三、乱码产生四、with open() as f五、代码实现文件复制粘贴六、try ... except ...七、代码比较 一、文件操作 1.概念 帮助我们把爬虫抓下来的数据,进行保存。 2.文件 在计算机中,没有p…

Linux:linux基础

Linux 一套免费使用和自由传播的操作系统 linux特点 免费,开源,多用户(同时允许多用户操作同一个Linux系统),多任务(同时允许多个任务执行) linux版本 分为内核版和发行版 内核版 由linus torvalds及其团队进行开发和维护 免费,开源 负责控制硬件 发行版 基于linux内…

Luat学习

万物互联的兴起 人与人之间的连接已经变得越来越紧密,至少在中国这是一个不争的事实。 人们的忙碌程度也达到了前所未有的水平,这时候人的通讯能力反而成为了瓶颈,人与外界的信息交换方式无外乎是嘴说、耳朵听、眼睛看、手指敲、每秒的传输速…

根据配置的mode环境显示不同的index模板

引言:在项目开发中,遇到了开发环境和生产环境使用模板不同的情况,配置如下: 一、vue.config.js const path require(path) function resolve(dir){return path.join(__dirname,dir) } module.exports {chainWebpack: config &g…

力扣226. 翻转二叉树(DFS的两种思路)

Problem: 226. 翻转二叉树 文章目录 题目描述思路复杂度Code 题目描述 思路 涉及二叉树的递归解法时往往需要考虑两种思路: 1.在递归遍历时执行题目需要的具体要求; 2.将一个大问题分解为多个小子问题 具体到本体: 思路1:遍历 先…

【源码分享】简单的404 HTML页面示例,该页面在加载时会等待2秒钟,然后自动重定向到首页

展示效果 源码 html <!DOCTYPE html> <html lang"zh"> <head><meta charset"UTF-8"><title>404 页面未找到</title><meta http-equiv"refresh" content"2;url/"> <!-- 设置2秒后跳转到首…

机器学习云环境测试

等待创建完成后&#xff0c;点击 PyTorch 打开&#xff0c;创建一个全新的 notebook 在 Cell 中输入如下代码&#xff0c;并点击 Run 完成后点击 New Cell &#xff0c;在 New Cell 中输入如下代码 输入完成后点击 Run &#xff0c;运行 New Cell 。&#xff08;每个 Cell 代…

1077: 平衡二叉树的判定

解法&#xff1a; 平衡二叉树是一种特殊的二叉树&#xff0c;它满足以下两个条件&#xff1a; 左子树和右子树的高度差不超过1&#xff08;即&#xff0c;左右子树高度差的绝对值不超过1&#xff09;。左子树和右子树都是平衡二叉树。 后序遍历过程中每次判断左右子树高度差…

python列表底层原理

Python 列表&#xff08;list&#xff09;是 Python 中非常常用的数据结构之一。它们的底层实现基于动态数组&#xff0c;具体来说&#xff0c;是一个可以动态调整大小的数组。这使得列表在操作和使用上非常灵活。以下是 Python 列表底层实现的主要原理&#xff1a; 动态数组 …

IT廉连看——UniApp——事件绑定

IT廉连看——UniApp——事件绑定 这是我们上节课最终的样式&#xff1b; 一、现在我有这样一个需求&#xff0c;当我点击“生在国旗下&#xff0c;长在春风里”它的颜色由红色变为蓝色&#xff0c;该怎么操作&#xff1f; 这时候我们需要一个事件的绑定&#xff0c;绑定一个单…

使用 Docker 部署 Jenkins 并设置初始管理员密码

使用 Docker 部署 Jenkins 并设置初始管理员密码 每一次开始&#xff0c;我都特别的认真与胆怯&#xff0c;是因为我期待结局&#xff0c;也能够不会那么粗糙&#xff0c;不会让我失望&#xff0c;所以&#xff0c;就多了些思考&#xff0c;多了些拘束&#xff0c;所以&#xf…

【HCIP学习】STP协议

一、STP协议出现背景&#xff08;Spanning Tree Protocol&#xff0c;生成树协议&#xff09; 二层环路带来的问题&#xff1a;广播风暴&#xff1b; MAC地址表的震荡&#xff1b; 二、STP定义 stp是二层网络中用于消除环路的协议&#xff0c;通过阻断冗余链路来消除&#xff…

Flutter 中的 Hero 小部件:全面指南

Flutter 中的 Hero 小部件&#xff1a;全面指南 在 Flutter 中&#xff0c;Hero 动画是一种流行的动画效果&#xff0c;用于在不同路由&#xff08;页面&#xff09;之间传递小部件&#xff0c;从而创建平滑的共享元素过渡效果。这种动画可以增强用户的视觉体验&#xff0c;使…

加速度传感器的冲击振动的原始特征与解算(部分)

这里是工作中测得的一组数据&#xff0c;设备有多个加速度传感器通道&#xff0c;我们可以看到冲击振动发生前后&#xff0c;各个振动传感器的的反馈以及其他的细化特征&#xff1a; 1.随机振动&#xff08;加速度传感器视角&#xff09; 2.冲击振动&#xff08;加速度&#x…

Android Settings系统属性读写

Settings系统属性存储均为xml&#xff0c;分三种&#xff1a; 1.global&#xff1a;所有的偏好设置对系统的所有用户公开&#xff0c;第三方APP有读没有写的权限&#xff1b; 源码地址&#xff1a;frameworks/base/core/java/android/provider/Settings.java 对应xml路径&…