登录社区云，与社区用户共同成长
邀请您加入社区
RNOH 版本升级、跨版本迁移与历史缺陷回溯的排查方法论与定位指南 在 RNOH 开发中，"升级到新版本后行为变化""同一代码在不同 RNOH 版本表现不一""历史崩溃在低版本偶现"是最容易误判的问题类型之一。本文档给出从现象到根因、从分类到处置的系统化定位方法。 一、问题概述 1.1 什么是"历史版本问题" RNO
参考 flutter多设备适配指南 的 DFX 结构，并结合 rn-multidevice-adaptation 中的 RNOH/RN 多设备适配知识整理。 1. 概述 RN 多设备适配涉及窗口尺寸监听、断点系统、响应式布局、折叠屏状态、折痕/避让区、键盘、沉浸式、自然方向、外设输入、相机与传感器等链路。问题通常表现为布局不刷新、内容截断、折叠态误判、避让失效、方向残留、鼠标键盘交互缺失、硬件能
2025年Agent进入产业化关键期，虽大模型迭代迅猛，但生产落地仍面临幻觉、工程化与评估体系缺失三大挑战。本文从工程师视角解析Agent定义，厘清其与传统接口、ChatBot、Workflow的本质差异——核心在于自主决策能力。基于演进版PCID框架（感知、上下文认知、执行、决策进化），提出Agent四要素：LLM大脑、工具手脚、记忆、规划。通过LangChain4j代码示例展示最小可运行Age
鸿蒙 DFX 资源泄漏（Resource Leak）检测能力用于监控 React Native for OpenHarmony（RNOH）框架及其接入应用运行期的资源未释放问题。资源泄漏分为句柄泄漏（FD_LEAK）、线程泄漏（THREAD_LEAK）、Native 对象泄漏和 JS 资源泄漏四类。本文聚焦 RNOH 场景下高频的句柄泄漏、线程泄漏与 Native 对象泄漏，JS 堆内存泄漏详见《
鸿蒙 DFX 踩内存（Memory Stomp / Misuse）检测能力用于监控 React Native for OpenHarmony（RNOH）框架及其接入应用运行期的内存误用问题。当发生堆/栈越界读写、释放后使用（UaF）、作用域后使用、重复释放时，可通过 ASAN（AddressSanitizer）/ HWASAN（HWAddressSanitizer） 两类编译期插桩检测器捕获故障，
本文面向 RNOH 应用开发者，用于在深入分析代码前先回答一个问题：页面卡顿丢帧、响应时延或完成时延异常，是否由 RNOH 框架引起。 定界只确定责任域和后续排查方向，不替代根因定位。完成定界后，请继续阅读： 页面滑动卡顿丢帧问题定位响应时延与完成时延性能分析 1. 定界结论应回答什么 一次有效定界至少给出以下结论之一： 责任域典型证据后续处理方HarmonyOS 系统或 Render Servi
本文档针对页面转场和页面滑动两大高频卡顿场景，提供详细的优化指南。 场景一：页面转场过程中的卡顿 1. 卡顿的案例描述 场景：在复杂业务场景中（如从商品列表跳转至详情页、Feed流进入沉浸式视频页），用户点击跳转按钮后： 响应延迟：点击按钮后无立即反馈，界面“假死”数十毫秒。 动画掉帧：转场动画（Push Animation）出现明显的卡顿或跳变（Jank）。 白屏时间长：新页面进入后，需等待较长
常见属性效果设置不正确的时候排查方法 方法 打开位于 DevEco Studio 底部的 ArkUI Inspecetor，选择出现问题的应用，具体的使用方法可以参考布局分析：在打开的页面上找到出现问题的组件，如果组件没有显示出来，也可以使用页面左侧的组件树，根据 Text 文本，组件类型，tag（如果没有设置过 nativeId 等属性，会默认设置为 id ）等信息，找到对应的组件。选中该组件，
Metro热加载 React Native 使用Metro构建 JavaScript 代码和资源，本节介绍了配置步骤和使用方式。 配置Metro 您需要在项目的 metro.config.js 文件中配置 harmony 平台的 Metro 配置选项。它可以导出： 一个对象（推荐），将与Metro的内部配置默认值合并。一个函数，该函数将使用Metro的内部配置默认值被调用，并返回最终的配置对象。
产出一篇结构化分析文档，追踪行为差异在 RN/RNOH 调用栈中的传递路径，对比三端处理方式，仅在确有依据时提出可落地的对齐方案。核心价值是对比视角与判断——并非所有平台差异都是 bug。 按需加载：三种输出结构模板（Bug / 平台特性 / API 限制）与 Mermaid 图表规范 → references/output-templates.md；分析细则、方案设计原则、常见误区 → refe
本文面向 RNOH 应用开发者与运维人员，针对应用在鸿蒙系统上运行时出现的负载过高与功耗异常类问题，提供从现象识别、排查思路、根因定位到解决方案的完整指导。 负载与功耗类异常区别于崩溃、卡死等稳定性问题：应用通常不会直接退出，而是表现为持续高 CPU 占用、设备发烫、电池快速消耗、界面卡顿掉帧、后台待机耗电等。这类问题往往是"慢性病"，在长时间运行或特定场景下才会暴露，定位难度
本文面向 RNOH 应用开发者，说明如何定位点击、滑动、页面切换和 RN 页面加载过程中的响应时延与完成时延。分析前请先阅读RNOH 框架性能问题定界；滑动过程的连续丢帧问题见页面滑动卡顿丢帧问题定位。 1. 先定义测量口径 1.1 响应时延 响应时延描述用户输入到首个可见反馈之间的时间，例如按钮按下态、页面开始移动或首个新内容上屏。 响应时延 = 首个响应帧上屏时间 - 输入起点 系统工具的输入
本文面向 RNOH 应用开发者，说明如何从 HarmonyOS 系统帧异常出发，沿 RNOH 滚动、JS 更新、Fabric 挂载、ArkUI 绘制和 Render Service 合成链路定位页面滑动卡顿。 在开始定位前，应先按照RNOH 框架性能问题定界确认问题属于应用侧，并区分 RN 业务、原生业务、三方组件和 RNOH 框架。响应时延与完成时延问题见响应时延与完成时延性能分析。 1. 问题
1 问题概述 1.1 什么是资源泄漏和OOM 资源泄漏是指应用在分配资源（内存、文件句柄、网络连接等）后，未能在适当时机释放，导致资源持续增长。当内存持续增长超过系统限制时，应用会被系统强制终止，即OOM（Out of Memory）。 1.2 RNOH应用资源泄漏的特点 RNOH应用涉及多层内存管理，资源泄漏可能发生在任何一层，且跨层引用关系复杂，定位难度较高： JS引擎堆（Hermes）：JS
本文详解「以图搜图」的落地实现，核心在于复用文搜图的向量空间与特征提取管线，通过图像→向量→近邻检索→去重+阈值过滤四步闭环。采用统一512维特征、HNSW索引（万级库下耗时从800ms降至60ms），结合按groupId去重与分辨率优选，实现同源高清命中率88%。代码骨架可直接复用，适用于壁纸、素材、票据等场景，强调图文共用特征空间是跨模态检索的基础。
本文系统解析鸿蒙ArkTS并发编程中TaskPool与Worker的选型、原理与实战。通过对比表与决策树明确二者适用场景：TaskPool适合一次性耗时任务，自动调度回收；Worker适用于长连接等持续交互场景，支持双向通信但需手动管理生命周期。深入剖析任务调度与消息传递机制，揭示数据序列化限制及闭包不可用等核心陷阱，并结合图片解码、WebSocket、批量任务三大实战案例，提供可运行代码与踩坑清
评审一套蓝牙接入实现，最后应该问的并不是“成功界面在哪里”，而是用户停止之后还会不会继续扫描，应用进入后台之后谁负责关闭通知，重新连接时有没有把上一台设备的服务对象带进来。前五篇已经分别建立准入、发现、连接、服务和数据边界，本篇把这些拥有者交给统一的前台会话，形成一个可以明确结束的工程闭环。 把责任放到能够看见全流程的位置 页面知道用户点了什么，EntryAbility 知道应用何时进入前台或后台
八个字节能装下一个样本，也能装下一次难以察觉的误读。温度用无符号数读取，负值会变成很大的正值；大小端弄反，数值仍然可能落在看似正常的范围。与其等通知界面出现奇怪数字再猜测，本篇先把 BleWorkbench 的短帧定义成可单独验证的协议，再把蓝牙通知接到同一解析器上。 先给八个字节一个确定含义 继续使用前四篇的自定义服务及样本特征值。外设必须按本篇约定提供数据：第一字节为帧标记，第二字节为版本，第
先读一段筛选代码：找到服务，再找到特征值，最后检查它支持的操作。这里没有给“名称里带温度”的外设开后门，也没有从数组第一项猜测数据位置。GATT 连接只建立传输关系；要让 BleWorkbench 的后续样本解析具有意义，客户端还必须从外设返回的服务结构中找到双方真正约定的对象。 从返回结构里选出唯一对象 沿用第三篇的 BleLink、第一篇的 BleGate 和第二篇的 Protocol 常量。
把 connect 调用后的一行状态更新改成“已连接”，可以让页面看起来反应很快，却把整个接入流程最重要的事实省略了：请求被接收与链路建立并不是同一件事。本篇给 BleWorkbench 增加 GATT 客户端。页面只表达连接意图，系统事件确认连接事实，下一步的服务发现必须等这份事实成立。 先把连接输入固定下来 保留前两篇的 BleGate.ets、Protocol.ets 和权限配置，新增 co
扫描列表为空，最常见的处理冲动是把过滤条件全部删掉，再把扫描功耗调到最高。这样或许能看到更多广播，却未必能找到当前协议需要的设备。真正值得先检查的是：目标外设有没有把服务标识放进广播，广播当前是否可连接，以及页面是否把不同广播错误合并成了同一条记录。BleWorkbench 的第二步只做有限时间的设备发现，连接仍然交给下一篇。 先约定外设到底广播什么 沿用第一篇的 API 12 Stage 工程和
一个蓝牙接入页面最好能回答三个不同的问题：应用有没有获得访问许可，系统蓝牙当前是否可用，用户准备连接的外设是否存在。把三者压成一个“蓝牙异常”，后续扫描失败、连接超时和权限拒绝都会挤进同一条提示，工程人员也无法确定下一步该看哪里。BleWorkbench 从这三个问题的分层开始，只在用户主动操作后使用蓝牙，先完成准入检查，再逐步加入广播发现、GATT 服务和数据通知。 准入结果需要表达多少事实 这
便笺能够输入、选词、改格式，也能从长按菜单执行相同命令。收尾时最需要澄清的却是“保存”两个字：结束输入不等于保存内容，读出一份字符串也不等于完成文件写入。本篇把当前编辑文档、纯文本快照和编辑状态明确分开，完成一条能够解释结果的导出前置路径，并把整个系列的内容契约收拢起来。 快照必须先说明保留哪些信息 本篇继续使用 NoteTypeset 与 API 12，保留第一篇的 NoteSeed.ets 和
排版便笺已经有一个强调按钮，再增加长按菜单时，最容易出现的实现是把那段格式代码复制过去。功能开始时看不出差异，后来一个入口补了范围校验，另一个入口仍拿旧选区修改内容，问题才浮现。本篇从这个重复入口出发，把编辑命令收拢到同一函数，再让菜单和页面按钮只表达用户意图。 先把菜单当成入口，而不是第二个编辑器 工程仍为 NoteTypeset，使用 API 12，并继续保留第一篇的 NoteSeed.ets
同样显示“待确认”，用普通文字插入和用一块带底色的内嵌标签插入，后续能力并不相同。前者可以逐字编辑，后者可以拥有明确的布局尺寸；它们在光标、删除、查询和复制上的行为也不应该被强行统一。本篇给排版便笺增加一个独立混排实验区，比较 TextSpan 与 BuilderSpan 的责任边界，再决定哪一种内容适合进入正式文档。 比较之前先固定产品目标 场景是便笺中嵌入一个紧凑的状态标签。需要的视觉结果很具
给便笺增加居中按钮时，我会先做一件看似多余的事：只把范围放在标题中间的一个字上，再观察整行标题会怎样变化。若沿用上一篇字符样式的直觉，容易期待只有那个字移动；段落格式恰好要求相反的理解。本篇把开发顺序拆成定位段落、应用格式、查询结果三个步骤，围绕同一份便笺解释字符范围与段落责任的关系。 第一笔先记下换行，而不是行数 沿用 NoteTypeset、API 12 和第一篇的 NoteSeed.ets，
“把这一小段加粗”听起来像一个按钮功能，真正决定结果的却是两个数字。它们究竟是屏幕上的字序、跨度内部的位置，还是整个编辑文档中的范围？如果这些坐标被混用，按钮可能正确改变颜色，却作用到相邻文字。本篇沿用排版便笺，把样式操作压缩成一条可解释的路径：从控制器读取选区，验证范围，再更新现有跨度的样式。 三种位置不要共用一个名字 第一篇的 NoteTypeset 工程已经提供 common/NoteSee
便笺里有一行标题和一段说明，改粗标题之后，底部统计却多出一个“内容块”。这样的变化不一定是错误：富文本编辑器管理的是带样式的跨度，业务想表达的却可能是标题与正文。把两者一开始就当成同一种对象，后面加入选区、段落和导出时就会反复修补。本系列先建立一个小型排版便笺，让编辑能力和业务含义各自有清楚的位置。 先确定一个足够小的编辑范围 工程名为 NoteTypeset，使用 Stage 模型和 API 1
配置解析出现问题时，日志里可能已经打印出活动名称，页面却仍然显示缺少人数。更隐蔽的情况是名称出现两次，程序悄悄采用后一份，于是配置看起来完整，却和生成方的意图不同。故障并不一定发生在字符解码，很多时候是应用只收集了文本，没有检查文本来自哪一层、出现了几次以及文档是否真正结束。 复盘从输入结构开始，而不是从页面空白开始 ConfigReader 工程读取一份很小的活动配置，根元素固定为配置容器，里面
连接建立、发送成功、业务完成，早期页面经常把这三件事挤进同一条绿色提示。改成持续连接以后，这种写法更容易暴露问题：发送接口已经返回，服务端却可能还没有完成自己的检查；连接随后断开，应用甚至无法知道对方究竟处理到了哪一步。页面需要一份由业务协议定义的回执，才能把这些含义分开。 从原样回声升级为有含义的回复 EchoWire 工程只做一件事：连接本地测试服务，发送固定测试文本，等待同编号的接受回执。它
把包裹重量从九百九十九克改成一千克，页面仍然显示“轻件档”。规则表里明明有一千这个键，容器也没有丢失数据。最容易被怀疑的是输入转换，其次是页面刷新；真正需要检查的，却是查询函数中的“比它小”究竟包不包含“等于它”。这个小问题足以让一张看似正确的分档表，在每个边界上都错一次。 一次错档，把查询条件暴露出来 本文做一个重量分档工具，工程名为 FareBands，界面名称是“重量分档”。规则使用 0、1
“扫描器已经返回成功，为什么页面还提示编码不符合规则？”这是接入扫码功能时很容易混淆的两个结果。扫描器回答图案里写了什么，业务代码回答这段内容能否用于当前操作。一个清晰可识别的二维码，完全可能装着网址、联系人或另一家系统的编号。把这两道判断分开，才不会把每次识别成功都误当成业务提交成功。 系统扫码负责识别，应用负责解释 本文用 ParcelScan 工程建立一个“包裹识别”页面，目标是接收固定格式
图案已经被清空，下面却还显示上一轮的点序列，这种不一致很容易被当成控件刷新问题。实际原因通常更简单：连线由组件维护，结果文字由页面维护，清空其中一份并不会自动清空另一份。做图案输入练习时，先把这两种状态的归属想清楚，重置按钮的行为才会完整。 先确定这是练习输入，而不是账号凭据 PatternPad 工程是一个九点连线练习板。用户连接至少四个点，松手后页面显示经过规则检查的点序列，再点击重新开始进入
harmonyos
——harmonyos
联系我们（工作时间：8:30-22:00）
400-660-0108 kefu@csdn.net
开源鸿蒙跨平台开发者社区
北京朝阳AI社区
人工智能6S服务平台
HarmonyOS开发者社区
