The OpenHarmony JS UI framework provides basic, container, and canvas UI components and standard CSS animation capabilities. It supports the web-development-like programming paradigm.
| 文件 | 最后提交记录 | 最后更新时间 |
|---|---|---|
update build fix agent Signed-off-by: sunfei <sunfei.sun@huawei.com> 🤖 AI[0%] 👌 AI Adopted[0%] 🧑 Human[100%] Change-Id: Ie771c51f47e6a2b246fc611b124bae6abefe0d76 | 3 个月前 | |
!88243 merge DFX into master docs(codespec): 补充设计文档 DFX 章节 Created-by: wangchensu1 Commit-by: wangchensu Merged-by: openharmony_ci Description: **IssueNo**:https://gitcode.com/openharmony/arkui_ace_engine/issues/80702 **Description**: arkui_ace_engine:基于OpenHarmony的UI开发框架项目favicon **Sig**: SIG_ApplicationFramework **Binary Source**: No(涉及则Yes) ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [ ] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [ ] 否/No ### TDD自验结果/TDD Self-Verification Results - [ ] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [ ] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [ ] 是/Yes See merge request: openharmony/arkui_ace_engine!88243 | 1 个月前 | |
优化pageScene统计起点、拆分dump util Signed-off-by: linzuoquan <linzuoquan1@huawei.com> AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: codex (gpt-5.6-sol) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local> Co-authored-by: codex (gpt-5.6-sol) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local> Co-authored-by: codex (gpt-5.6-sol) <ai@local> Co-authored-by: opencode (glm-5.2) <ai@local> Change-Id: Ib97fc8671cf6fa44209bb8a42846bbaf890c44f3 | 1 个月前 | |
!88560 merge 0819_fix_dialog_collect into master 优化pageScene统计起点、拆分dump util Created-by: linzuoquan Commit-by: linzuoquan Merged-by: openharmony_ci Description: **IssueNo**: #80939 **Description**: 将 PipelineContext::DumpVisibleInspectorTree 的采集起始节点逻辑抽离为独立静态工具类 NavigationDumpUtil（frameworks/core/components_ng/dump_utils/），供 Inspector dump 与 PageScene 检测复用，消除 PageScene 从 rootNode_ 全树下钻的冗余遍历。IsTagInOverlay 单一来源化；onlyVisible 语义收窄为仅控制 pageScene 内窗口可视处理（不再控制全量/当前页，已 Owner 确认）。 **Sig**: SIG_ApplicationFramework **Binary Source**: No(涉及则Yes) ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [x] 需求/Feature - [ ] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved 本地构建 ace_engine 通过；新增 navigation_dump_util_test_ng 单测（IsTagInOverlay 全标签 + CollectInspectorStartNodes 各分支/null/overlay/page/atomicService）通过；pipeline_context_test_ng_seven 的 DumpVisibleInspectorTree 端到端集成测试通过；page_scene_rule_manager_test 适配新签名后通过。 ### XTS自验结果/XTS Self-Verification Results - [ ] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [x] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. ## 改动清单 - 新增 frameworks/core/components_ng/dump_utils/navigation_dump_util.{h,cpp} + BUILD.gn（NavigationDumpUtil 静态工具类） - PipelineContext: GetDumpStartNodes() public 入口委托 util；IsTagInOverlay 转发 util；DumpVisibleInspectorTree/DumpSimplifyTreeJsonEntrance 消费 DumpStartNodeSet - PageSceneRuleManager: MatchPageScene/Tracker 签名改 DumpStartNodeSet，去重由接口负责 - ui_content_impl.cpp: 改用 pipeline->GetDumpStartNodes() - CODEOWNERSA: 追加 dump_utils @arkui_framework_xnode - 测试: 新增 dump_utils 单测 + 保留薄集成测试 + PageScene/pipeline UT 适配 See merge request: openharmony/arkui_ace_engine!88560 | 1 个月前 | |
!88570 merge exceptionprompt into master fix code warning Created-by: zhaoyong70 Commit-by: zhaoyong70 Merged-by: openharmony_ci Description: **IssueNo**:#80949 **Description**: 修复告警问题 **Sig**: SIG_ApplicationFramework **Binary Source**: No ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [x] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. See merge request: openharmony/arkui_ace_engine!88570 | 1 个月前 | |
!88342 merge fix/segmentbuttonv2-gesture-scroll-conflict into master segmentbuttonv2手势 Created-by: zhangwentao96 Commit-by: zhangwentao Merged-by: openharmony_ci Description: **IssueNo**:https://gitcode.com/openharmony/arkui_ace_engine/issues/80721 **Description**: 修复segmentbutton **Sig**: SIG_ApplicationFramework **Binary Source**: No(涉及则Yes) ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [x] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. See merge request: openharmony/arkui_ace_engine!88342 | 1 个月前 | |
!88607 merge 0820_crashfix into master 修复不同so获取theme锁，概率出现崩溃 Created-by: cortisol Commit-by: yuzhicheng Merged-by: openharmony_ci Description: **IssueNo**:https://gitcode.com/openharmony/arkui_ace_engine/issues/80986 **Description**: fix **Sig**: SIG_ApplicationFramework **Binary Source**: No(涉及则Yes) ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [x] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. See merge request: openharmony/arkui_ace_engine!88607 | 1 个月前 | |
!87723 merge lh_napi_external_deps_rectify into master napi部件public_external_deps整改：ace_engine补充ets_runtime/libuv/node显式依赖 Created-by: liuhui93 Commit-by: liuhui93 Merged-by: openharmony_ci Description: **IssueNo**: #本PR自关联 **Description**: napi部件需要将public_external_deps整改为external_deps，ace_engine作为消费方需先行补充ets_runtime/libuv/node的显式依赖，避免传染性依赖违反单框架编译构建规则。 按实际头文件依赖链分类补充（共96处BUILD.gn/components.gni）： - Cat A（仅加 node:node_header_notice）：目标含 napi/native_api.h/native_node_api.h，经其引入 node_api.h/js_native_api.h - Cat B（加 node+libuv:uv+ets_runtime:libark_jsruntime）：目标含 native_engine.h/ark_native_engine.h 链，经 native_async_work.h/ark_idle_monitor.h 引入 uv.h，经 native_node_hybrid_api.h 引入 node 头 - frameworks/core/components_ng/components.gni 的 ark_sources 模板：覆盖 time_picker 等全部 pattern 桥接 涵盖：adapter、advanced_ui_component(37)、component_ext、frameworks(含declarative/js frontend、engine/jsi)、interfaces(ani/napi kits/inner_api/native)。 bundle.json 已声明 node/libuv/ets_runtime，无需改动。 **Sig**: SIG_ApplicationFramework **Binary Source**: No ## 验证 / Verification 1. ./build.sh --product-name rk3568 --build-target ace_engine --ccache：rc=0，0 error，产物齐全 2. 翻转 napi 为 external_deps 后 -k0 编译：ace_engine 头文件缺失错误为 0（报错均在 ace_engine 之外的 ability_runtime/i18n/ipc 等部件，属全树协同整改范畴） 3. 直编代表性 Cat A/B 文件在无传染依赖状态下全部通过：jsi_declarative_engine.cpp、ark_js_runtime.cpp、jsi_pa_engine.cpp、curves.cpp（Cat B）；js_dialog.cpp、animator.cpp、js_inspector.cpp、js_rendering_context.cpp、drawable_descriptor.cpp、native_interface_xcomponent.cpp（Cat A） ## Feature or Bugfix - [x] 需求/Feature ## 是否涉及非兼容变更/Whether it involves incompatible changes - [x] 否/No ## TDD自验结果/TDD Self-Verification Results - [x] 不涉及/Not Involved ## XTS自验结果/XTS Self-Verification Results - [x] 不涉及/Not Involved ## 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes ## 是否已执行L0用例 - [x] 不涉及，仅在BUILD.gn补充外部依赖，不影响功能逻辑/Not Involved See merge request: openharmony/arkui_ace_engine!87723 | 1 个月前 | |
fix: correct KB errors from state management migration commit c5346df7dcd - Fix dangling file reference component/interop.ts -> component/interop.ets (26 occurrences in static_interop_bridge.md, static_v2_decorators.md, static_custom_component.md); mock/interop.ts reference kept as it exists - Fix dangling directory reference docs/kb/architecture/state_management/ -> docs/kb/frontend/state_management/ in architecture/build-system.md - Fix reuse pool class name __ReusePool__Internal__ -> __ReusePool__Internal in custom_component.md (matches puv2_globalreuse.ts) - Fix register callback count 13 -> 14 in state_management.md overview (openInterop() registers 14 callbacks) - Fix makeLink dispatch count 10 -> 11 in static_v1_core.md (source has 11 makeLinkOn* typed helpers) Signed-off-by: jiyujia926 <jiyujia3@huawei.com> Change-Id: I4cb4cb69d99fd88a2b48e420abda6d53e0b47997 | 1 个月前 | |
image examples Signed-off-by: zhoulianhai <zhoulianhai@h-partners.com> AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: opencode (glm-5.2) <ai@local> | 1 个月前 | |
fix readme Signed-off-by: luoying_ace_admin <luoying19@huawei.com> Change-Id: Ic0dd127ba4dffe28a669de3ba6c2feb70e6037f2 | 3 年前 | |
Web组件上报onKeyEvent事件不冒泡 Signed-off-by: SprucEovo <lichenwei2@huawei.com> | 1 个月前 | |
!88649 merge feature/service-collaboration-header into master 【RichEditor】新增service_collaboration_header头文件 Created-by: carnivore233 Commit-by: carnivore233 Merged-by: openharmony_ci Description: **IssueNo**: #80993 **Description**: 【RichEditor】新增service_collaboration_header头文件 **Sig**: SIG_ApplicationFramework **Binary Source**: No ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [x] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. See merge request: openharmony/arkui_ace_engine!88649 | 1 个月前 | |
!88585 merge fix-video-statemachine-prepare-fullscreen into master fix(video): VideoStateMachinePattern PrepareAsync后台化与全屏切换状态连续性修复 Created-by: qianpinyi Commit-by: qianpinyi Merged-by: openharmony_ci Description: **IssueNo**: #80964 **Description**: fix(video): VideoStateMachinePattern PrepareAsync后台化与全屏切换状态连续性修复 **Sig**: SIG_ApplicationFramework **Binary Source**: No ## 请勿修改以下选项内容，仅需保存后点击复选框，或在编辑时将对应项前面的 [ ]改为[x] ## Do not modify the following option content. Simply save and click the checkbox, or when editing, change [ ] to [x] for the relevant item. ### Feature or Bugfix - [ ] 需求/Feature - [x] 缺陷/Bugfix ### 是否涉及非兼容变更/Whether it involves incompatible changes - [ ] 是/Yes - [x] 否/No ### TDD自验结果/TDD Self-Verification Results - [x] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [ ] 不涉及/Not Involved ### XTS自验结果/XTS Self-Verification Results - [ ] 通过，请在下方提供截图/Pass. Provide execution details in picture below. - [ ] 失败，请在下方提供基线执行情况截图/Fail. Provide baseline execution details in picture below. - [x] 不涉及/Not Involved ### 检视意见是否都已闭环/Have all review comments been resolved - [x] 是/Yes - [ ] 否/No ### 是否已执行L0用例 - [x] 已验证/Yes - [ ] 不涉及，请在下方说明原因/Not Involved. Please specify the reasons below. See merge request: openharmony/arkui_ace_engine!88585 | 1 个月前 | |
格式修改 Signed-off-by: happy <wangxueli8@huawei.com> Change-Id: I185ade5df4b3aabe03f7b671beadb4cb41ff8564 | 7 个月前 | |
merge 0728 Change-Id: I1bd1e4762af6e3a49fc523afee90676ab9a0cca5 Signed-off-by: huiqiangdev <huiqiangdev@icloud.com> | 1 年前 | |
add image/picker docs Signed-off-by: liyujie43 <liyujie43@huawei.com> Change-Id: I5a307716630c4bf4c5b72a7d8e80e6afc77d9af1 | 2 个月前 | |
fix: 根据评审人意见移除skill引用和不适用的约束 1. Nested Agent Guidance: 移除3个.claude/skills/引用，仅保留agent 2. Section 8 Do-not: 移除安全/DFX/协议/第三方许可证/syscap约束（评审人确认ace_engine不涉及） Signed-off-by: jiangdayuan <jiangdayuan@huawei.com> AI[0%] Human Fixed[0%] Human[0%] AI Adopted[0%] Change-Id: I83a16ff80908ff14a3f2d9d9b4118cd905a9b4a1 | 1 个月前 | |
fixStripSection Signed-off-by: tangfei0616 <tangfei44@h-partners.com> | 2 个月前 | |
update knowledge_base Signed-off-by: sunfei <sunfei.sun@huawei.com> 🤖 AI[33%] 👌 AI Adopted[33%] 🧑 Human[67%] Change-Id: Ic61e402cc0ebb1cbd92f04bd4f9a892e2d0cebd6 | 3 个月前 | |
update OpenHarmony 2.0 Canary | 5 年前 | |
Theme.csv和Resource冗余代码清理 Signed-off-by: yuanlin94 <linyuan25@h-partners.com> | 2 个月前 | |
回退 'Pull Request !29318 : 测试用，请勿合入' | 2 年前 | |
ets to arkts Signed-off-by: luoying_ace_admin <luoying19@huawei.com> Change-Id: Ia345753f0056d525408d54b34d10928d8eb5cbd4 | 3 年前 | |
fixStripSection Signed-off-by: tangfei0616 <tangfei44@h-partners.com> | 2 个月前 | |
【RichEditor】新增service_collaboration_header头文件 Co-Authored-By: Claude <noreply@anthropic.com> Signed-off-by: carnivore233 <xuyue51@huawei.com> AI[100%] Human Fixed[0%] Human[0%] AI Adopted[100%] Co-authored-by: claude (unknown) <ai@local> | 1 个月前 | |
fix node_path being overridden in gn Signed-off-by: Pavel Mironchik <pavel.mironchik@huawei.com> Change-Id: Id44d329ffb952b8a92ae74a5a43fec76a49ea0ba | 5 个月前 | |
移除废弃代码 🤖 AI[100%] 👌 AI Adopted[100%] 🧑 Human[0%] Co-authored-by: codex (gpt-5.5) <ai@local> Change-Id: I0b921364d884d4477598ea321cafbb6348b593e4 Signed-off-by: linzuoquan <linzuoquan1@huawei.com> | 2 个月前 | |
udpate component module design doc Signed-off-by: sunfei <sunfei.sun@huawei.com> 🤖 AI[0%] 👌 AI Adopted[0%] 🧑 Human[100%] Change-Id: I125634702914596cab94cae6882e86cb6d3d1e67 | 3 个月前 |
ArkUI开发框架
简介
ArkUI框架是OpenHarmony UI开发框架，提供开发者进行应用UI开发时所必需的能力，包括UI组件、动画、绘制、交互事件、JS API扩展机制等。ArkUI框架提供了两种开发范式，分别是基于ArkTS的声明式开发范式（简称“声明式开发范式”）和兼容JS的类Web开发范式（简称“类Web开发范式”）。
从上图可以看出，类Web开发范式与声明式开发范式的UI后端引擎和语言运行时是共用的，其中，UI后端引擎实现了ArkUI框架的六种基本能力。声明式开发范式无需JS Framework进行页面DOM管理，渲染更新链路更为精简，占用内存更少，因此更推荐开发者选用声明式开发范式来搭建应用UI界面。
目录
ArkUI开发框架源代码在/foundation/arkui/ace_engine下，目录结构如下图所示：
/foundation/arkui/ace_engine
├── adapter # 平台适配目录
│ ├── common
│ └── ohos
├── frameworks # 框架代码
│ ├── base # 基础库
│ ├── bridge # 前后端组件对接层
│ └── core # 核心组件目录
使用场景
ArkUI框架提供了丰富的、功能强大的UI组件、样式定义，组件之间相互独立，随取随用，也可以在需求相同的地方重复使用。开发者还可以通过组件间合理的搭配定义满足业务需求的新组件，减少开发量。
相关仓
arkui_ace_engine
项目介绍
The OpenHarmony JS UI framework provides basic, container, and canvas UI components and standard CSS animation capabilities. It supports the web-development-like programming paradigm.
定制我的领域