@hmos-library-adapter/fast 0.0.17-beta.0 → 0.0.17-beta.2

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/references-full/subsystems/subsys-toolchain-hiperf.md

@@ -0,0 +1,363 @@
+# hiperf使用指导
+
+
+hiperf是为开发人员提供性能采样分析的工具，基于内核perf机制进行的用户态能力的扩展，可以对指定的程序或者整个系统进行性能采样。
+
+
+hiperf支持的命令有：list、stat、record、report等，可以通过hiperf -h进行查看。
+
+
+下面对hiperf的常用命令进行详细说明：
+
+
+## list 命令
+
+
+### 参数说明
+
+列出设备上支持的所有perf事件名称，事件名称用于 stat 和 record命令的 -e 和 -g 参数。
+
+  
+```
+Usage: hiperf list [event type]
+```
+
+  | 参数 | 功能说明 | 
+| -------- | -------- |
+| hw | 列出支持的 hardware 事件（PMU支持） | 
+| sw | 列出支持的 software 事件 | 
+| tp | 列出支持 tracepoint 事件 | 
+| cache | 列出支持的 cache 事件（PMU支持） | 
+| raw | 列出支持的原始PMU事件 | 
+
+
+### 使用示例
+
+下面列出了设备支持的hardware事件，并且会提示哪些事件此设备不支持。
+
+  
+```
+hiperf list hw
+event not support hw-stalled-cycles-backend
+event not support hw-stalled-cycles-frontend
+event not support hw-ref-cpu-cycles
+
+Supported events for hardware:
+        hw-cpu-cycles
+        hw-instructions
+        hw-cache-references
+        hw-cache-misses
+        hw-branch-instructions
+        hw-branch-misses
+        hw-bus-cycles
+```
+
+
+## stat 命令
+
+
+### 参数说明
+
+监听指定目标程序，周期性打印性能计数器的值。
+  
+```
+Usage: hiperf stat [options]
+       Collect performance counter information.
+```
+
+
+  | 参数 | 功能说明 | 
+| -------- | -------- |
+| -a | 采集监听整个系统的所有线程和默认的性能计数器的值。 | 
+| -c | 指定cpu id，可以是0,1,2用逗号分隔。 | 
+| -d <_sec_> | 指定监听的时间，单位为秒。 | 
+| -i <_ms_> | 指定监听事件的间隔打印时间，单位毫秒。 | 
+| -e | 指定监听的事件，可以通过list命令查看支持的所有事件，其中event:u 或者 :k 表示限制事件为用户空间或者内核空间。 | 
+| -g | 指定需要在同一组监听的事件，同一组事件会被放入同一个PMU监听。 | 
+| --no-inherit | 不监听目标线程/进程启动的子线程。 | 
+| -p | 指定需要监听的进程pid。 | 
+| -t | 指定需要监听的线程tid。 | 
+| --verbose | 显示详细的报告内容，包括一些原始的时间数据等等。 | 
+
+
+### 使用示例
+
+下面是通过 stat 监听整个系统3秒的示例：
+
+  
+```
+hiperf stat -d 3 -a
+this is root mode, perfEventParanoid assume as -1
+Start Profiling...
+Timeout exit (total 3009 ms)
+                count                           name | comment                          | coverage
+               132523         hw-branch-instructions | 15.750 M/sec                     | (100%)
+                62554               hw-branch-misses | 47.202372% miss rate             | (100%)
+              6994768                  hw-cpu-cycles | 0.832068 GHz                     | (100%)
+              1237627                hw-instructions | 5.651758 cycles per instruction  | (100%)
+                  248            sw-context-switches | 29.959 K/sec                     | (100%)
+                    0                 sw-page-faults | 0.000 /sec                       | (100%)
+              9402580                  sw-task-clock | 0.002758 cpus used               | (100%)
+```
+
+
+### 字段说明
+
+  | 字段名 | 含义 | 
+| -------- | -------- |
+| count | 表示事件发生的次数。 | 
+| name | 事件的名称，在 list 命令中可以看到所有支持的命令，hw 和 sw 的前缀分别代表是hardware事件还是software事件。 | 
+| comment | 一些经过计算的方便用户阅读的值。例如 CPU 的相对主频，千位进制换算等等。 | 
+| coverage | 该事件在PMU中的 enable 百分比，受限于PMU数量，每次装载的PMU监听事件是有限的。 | 
+
+
+## record 命令
+
+
+### 参数说明
+
+采样指定目标程序，并且将采样数据保存到指定的文件中（默认为perf.data）
+
+  
+```
+Usage: hiperf record [options]
+       Collect performance sampling information.
+```
+
+  | 参数 | 功能说明 | 
+| -------- | -------- |
+| -a | 对整个系统的所有进程和线程进行采样。 | 
+| --exclude-hiperf | 不采样hiperf自身进程。 | 
+| -c | 指定采样的cpu id。 | 
+| --cpu-limit <_percent_> | 限定采样过程占用的CPU最大百分比。 | 
+| -d <sec> | 指定采样时长，单位秒。 | 
+| -f&nbsp;&lt;freq&gt; | 设置采样事件的触发频率，默认为4000。<br/>说明：该频率越高cpu负载会越高，但是数据采样会越多。 | 
+| --period&nbsp;&lt;_num_&gt; | 设置采样事件触发周期，以次数为单位，即发生指定的次数后采样一次。 | 
+| -e | 指定监听的事件，可以通过list命令查看支持的所有事件，其中event:u&nbsp;或者&nbsp;:k&nbsp;可以表示限制事件为用户空间或者内核空间。 | 
+| -g | 指定需要在同一组监听的事件，同一组事件会被放入同一个PMU监听。 | 
+| --no-inherit | 不监听目标线程或者进程启动的子线程。 | 
+| -p | 指定需要监听的进程。 | 
+| -t | 指定需要监听的线程。 | 
+| --offcpu | 监听CPU调度事件，它等价于&nbsp;--period&nbsp;1&nbsp;-e&nbsp;sched:sched_switch&nbsp;事件。 | 
+| -j&nbsp;&lt;_branch_filter1_&gt;[,_branch_filter2_]... | 监听分支预测事件。分支预测就是指令存在多个if&nbsp;else判定的情况下，CPU去预测下一步即将执行哪一条指令。 | 
+| -s&nbsp;/&nbsp;--call-stack&nbsp;&lt;_fp&nbsp;\\|&nbsp;dwarf[,size]_&gt; | 设置用户栈的回栈方式，支持fp和dwarf两种方式。dwarf&nbsp;后面可以指定采样的用户堆栈大小，默认是&nbsp;65528。 | 
+| --delay-unwind | 延迟回栈，等到采样结束再进行回栈。 | 
+| --disable-unwind | 不进行回栈，用户的寄存器和堆栈数据会保存在perf.data中，供离线回栈使用。 | 
+| --disable-callstack-expend | 默认会对回栈的调用栈信息进行合并扩展，此选项会关闭该功能。 | 
+| --clockid&nbsp;&lt;_clock&nbsp;type_&gt; | 设置采样数据的时钟源，支持monotonic、boottime、realtime等。 | 
+| --symbol-dir&nbsp;&lt;_dir_&gt; | 指定符号表路径，如果指定了回栈时会优先使用该路径下的符号表。 | 
+| -m&nbsp;&lt;_mmap&nbsp;pages_&gt; | 指定缓存的大小，默认值为1024，以页为单位。参数需要为2的幂，范围为&nbsp;[2&nbsp;-&nbsp;1024]。<br/>说明：该值越高，事件丢失率会越低，但是内存占用会增大。 | 
+| --app&nbsp;&lt;_package&nbsp;name_&gt; | 指定采样的目标应用的包名，默认超时等待时间为10秒。 | 
+| --data-limit&nbsp;&lt;_SIZE[K\|M\|G]_&gt; | 指定采样结果的最大容量，支持K/M/G(B)为单位，默认无大小限制。 | 
+| -o&nbsp;&lt;_output&nbsp;file&nbsp;name_&gt; | 指定采样数据结果文件名，默认为/data/local/tmp/perf.data。 | 
+| -z | 启动压缩模式，在保存到文件的时候，会用gzip进行压缩。 | 
+| --verbose | 采样的时候显示更详细的日志信息。 | 
+
+
+### 使用示例
+
+- 对整机所有进程采样3秒，并且显示详细的日志信息
+    
+  ```
+  hiperf record -d 3 -a --verbose
+  ```
+
+- 指定使用fp方式进行回栈
+    
+  ```
+  hiperf record -s fp -d 3 -a
+  ```
+
+- 指定使用dwarf方式进行回栈
+    
+  ```
+  hiperf record -s dwarf -d 3 -a
+  ```
+
+- 指定采样offcpu事件
+    
+  ```
+  hiperf record --offcpu -s dwarf -d 3 -a
+  ```
+
+- 指定延迟回栈
+    
+  ```
+  hiperf record -d 3 -s dwarf --delay-unwind -a
+  ```
+
+- 禁用堆栈展开，此时会保存堆栈数据到perf.data文件
+    
+  ```
+  hiperf record -d 3 -s dwarf --disable-unwind -a
+  ```
+
+- 指定追踪的包名，如果指定的包名对应的进程不存在则会延迟等待10秒，超时后进程退出
+    
+  ```
+  hiperf record -d 3 -s dwarf --app com.ohos.launch
+  ```
+
+- 指定对采样结果数据进行压缩保存
+    
+  ```
+  hiperf record -z -s dwarf -d 3  -a
+  ```
+
+
+## report 命令
+
+
+### 参数说明
+
+此命令主要用于展示record中抓取的采样数据
+
+  
+```
+Usage: hiperf report [option]     
+       Report sampling information from perf.data.
+```
+
+  | 参数 | 功能说明 | 
+| -------- | -------- |
+| --symbol-dir&nbsp;&lt;_dir_&gt; | 指定符号表路径。 | 
+| --limit-percent&nbsp;&lt;_number_&gt; | 指定展示结果的最低百分比（低于的不显示）。 | 
+| -s&nbsp;/&nbsp;--call-stack | 指定该选项后结果数据中会包含详细的调用栈信息。 | 
+| --call-stack-limit-percent&nbsp;&lt;_number_&gt; | 调用栈的百分比最小值（低于的不显示）。 | 
+| --proto | 将输入的&nbsp;perf.data&nbsp;文件转换为&nbsp;proto&nbsp;格式，默认文件名为&nbsp;perf.proto。 | 
+| --json | 将输入的&nbsp;perf.data&nbsp;文件转换为&nbsp;json&nbsp;格式，默认文件名为&nbsp;perf.json。 | 
+| --branch | 按分支预测的结果地址来展示报告，而不是调用栈的IP地址。 | 
+| --&lt;_keys_&gt;&nbsp;&lt;_keyname1_&gt;[,_keyname2_][,...] | 按给出的关键字来过滤展示报告，keys支持：comms、pids、tids等&nbsp;例如&nbsp;--comms&nbsp;hiperf,hilog&nbsp;表示仅显示进程/线程名称为&nbsp;hiperf或者hilog的记录条目。 | 
+| --sort&nbsp;&lt;_key1_&gt;[,_key2_][,...] | 按照给出的关键字来排序和显示，支持：pid、tid、comm等，可以指定多个关键字。 | 
+| -i&nbsp;&lt;_filename_&gt; | 指定输入的采样数据（默认为perf.data)。 | 
+| -o&nbsp;&lt;_filename_&gt; | 指定输出的报告文件名。 | 
+
+
+### 使用示例
+
+- 输出采样数据的报告，默认读取perf.data文件
+    
+  ```
+  hiperf report
+  ```
+
+  输出结果举例：
+
+    
+  ```
+  Heating count    comm            pid  tid  dso                                func
+   5.68%  15073949 hiperf_example_ 1085 1091 /system/lib/ld-musl-arm.so.1       malloc
+   2.57%   6834119 hiperf_example_ 1085 1091 [kernel.kallsyms]                  vector_swi
+   2.27%   6013910 hiperf_example_ 1085 1087 /system/lib/ld-musl-arm.so.1       malloc
+   2.19%   5805738 hiperf_example_ 1085 1091 /system/lib/ld-musl-arm.so.1       vfprintf
+   2.09%   5543362 hiperf_example_ 1085 1091 [kernel.kallsyms]                  ktime_get_ts64
+  report done
+  ```
+
+- 输出采集数据的调用栈报告
+    
+  ```
+  hiperf report -s
+  ```
+
+- 指定符号表路径
+    
+  ```
+  hiperf report -s --symbol-dir /data/local/tmp
+  ```
+
+- 指定结果过滤的关键字，指定后会只显示包含该关键字的信息。例如要过滤libutils.z.so，命令如下：
+    
+  ```
+  hiperf report --dsos libutils.z.so
+  ```
+
+- 指定按照特定的关键字进行排序展示，比如按照dso进行排序：
+    
+  ```
+  hiperf report --sort dso
+  ```
+
+
+## 接口说明
+
+
+### hiperf_client
+
+[hiperf_client](https://gitcode.com/openharmony/developtools_hiperf/tree/master/interfaces/innerkits/native/hiperf_client)是hiperf部件提供的Perf采集接口。其实现原理是通过创建子进程执行hiperf二进制程序，采用管道返回数据给调用方。hiperf命令行工具中的--pipe_input和--pipe_output参数用于配置命令输入管道描述符和响应输出管道描述符，通过命名管道（FIFO）实现hiperf_client（客户端）与hiperf服务端进程的双向通信，实现如开启、停止采样等操作。
+> 说明：开发者可通过调用Start、Pause、Stop等接口采集Perf数据，perf采集配置接口参考表1，开发者无需关心hiperf_client对hiperf命令行的封装细节。如果有定制化开发的需求，可基于hiperf命令行提供的--pipe_input、--pipe_output参数传入管道句柄来获取数据，进行二次开发。
+
+  **表1** C++接口说明函数参数和功能
+
+| 类 | 方法 | 描述 | 
+| -------- | -------- | -------- |
+| RecordOption | void SetOutputFilename(const std::string &outputFilename) | 功能：设置输出文件路径，默认路径为/data/local/tmp/perf.data。<br/>输入参数：<br/>-&nbsp;outputFilename：字符串类型，指定性能数据文件的保存路径。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | const std::string GetOutputFileName() const | 功能：获取当前设置的输出文件路径。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：字符串类型，代表输出的文件路径。 | 
+|  | void SetSelectEvents(const std::vector\<std::string> &selectEvents) | 功能：设置采样事件（如硬件事件、软件事件等）。<br/>输入参数：<br/>-&nbsp;selectEvents：字符串数组类型，每个元素是一个事件名。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | const std::vector\<std::string> &GetSelectEvents() const | 功能：获取当前设置的事件列表（默认值为 {"hw-cpu-cycles:u"}）。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：字符串数组，每个元素是一个事件名。 |  
+|  | void SetSelectGroups(const std::vector\<std::string> &selectGroups) | 功能：设置用于事件分组采样的采集事件群组。<br/>输入参数：<br/>-&nbsp;selectGroups：字符串数组类型，每个元素代表一个事件群组。<br/>输出参数：无。<br/>返回值：无。 |
+|  | void SetTargetSystemWide(bool enable) | 功能：设置是否采集整机的性能数据（即采集所有CPU上的所有进程）。<br/>输入参数：<br/>-&nbsp;enable：布尔类型，true表示启用采集整机，false表示禁用采集整机。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetSelectPids(const std::vector\<pid_t> &selectPids) | 功能：设置要采集的目标进程ID。<br/>输入参数：<br/>-&nbsp;selectPids：pid_t类型的数组，包含了目标进程的pid。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetSelectTids(const std::vector\<pid_t> &selectTids) | 功能：设置要采集的目标线程ID。<br/>输入参数：<br/>-&nbsp;selectTids：pid_t类型的数组，包含了目标线程的tid。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetAppPackage(const std::string &appPackage) | 功能：设置要采集的应用程序名。<br/>输入参数：<br/>-&nbsp;appPackage：字符串类型，代表目标应用的包名。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetSelectCpus(const std::vector\<int> &cpus) | 功能：设置采集的CPU ID。<br/>输入参数：<br/>-&nbsp;cpus：整型数组，每个元素是一个CPU ID。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetTimeStopSec(int timeStopSec) | 功能：设置采集的持续时间。<br/>输入参数：<br/>-&nbsp;timeStopSec：整型，表示采集将在多少秒后自动停止；单位s，默认1000s。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetFrequency(int frequency) | 功能：设置采样频率。<br/>输入参数：<br/>-&nbsp;frequency：整型，代表采样频率，默认4000次/s。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetPeriod(int period) | 功能：设置采样周期。<br/>输入参数：<br/>-&nbsp;period：整型，代表采样周期。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetCallGraph(const std::string &sampleTypes) | 功能：设置回栈模式。<br/>输入参数：<br/>-&nbsp;sampleTypes：字符串类型，可设置为fp(栈指针)、dwarf(调试信息表)两种模式中的一种，默认是fp模式；若指定为dwarf，可以设置采样的栈大小\[dwarf,###]（### 代表一个整数，取值范围在8到65528 之间，且必须是8字节对齐的）。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetCompressData(bool enable) | 功能：设置是否以.gz的压缩文件形式输出。<br/>输入参数：<br/>-&nbsp;enable：布尔类型，true表示开启压缩，false表示关闭。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetDataLimit(const std::string &limit) | 功能：设置采集数据的大小限制。当数据量达到此限制时，采集将自动停止。<br/>输入参数：<br/>-&nbsp;limit：字符串类型，格式：SIZE [K\|M\|G]，默认无限制。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetNoInherit(bool enable) | 功能：设置是否采集子进程数据。<br/>输入参数：<br/>-&nbsp;enable：布尔类型，true表示不允许子进程继承采集，false表示允许子进程继承采集。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetCallStackSamplingConfigs(int duration) | 功能：设置调用栈采样的持续时间。<br/>输入参数：<br/>-&nbsp;duration：整型，单位为s，表示调用栈采样将持续的时间。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetExcludePerf(bool excludePerf) | 功能：设置是否在采集过程中排除hiperf工具自身产生的性能事件。<br/>输入参数：<br/>-&nbsp;excludePerf：布尔类型，true代表排除hiperf自身的事件，false代表不排除hiperf自身的事件。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetCpuPercent(int cpuPercent) | 功能：设置采集时CPU最大占比。<br/>输入参数：<br/>-&nbsp;cpuPercent：整型，表示采样进程最多可以占用单个CPU核心的百分比，取值范围：1 - 100，默认25。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetOffCPU(bool offCPU) | 功能：设置是否启用对线程脱离CPU调度的跟踪。<br/>输入参数：<br/>-&nbsp;offCPU：布尔类型，true代表开启Off-CPU分析，false代表关闭Off-CPU分析。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetDelayUnwind(bool delayUnwind) | 功能：设置是否启用延迟栈展开。<br/>输入参数：<br/>-&nbsp;delayUnwind：布尔类型，true代表启用延迟栈展开，false代表禁用延迟栈展开。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetDisableUnwind(bool disableUnwind) | 功能：设置是否禁用栈展开。<br/>输入参数：<br/>-&nbsp;disableUnwind：布尔类型，true代表禁用栈展开，false代表启用栈展开。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetSymbolDir(const std::string &symbolDir_) | 功能：设置符号表文件路径。<br/>输入参数：<br/>-&nbsp;symbolDir_：字符串类型，代表符号表文件所在的目录路径。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetClockId(const std::string &clockId) | 功能：设置采集时钟类型。<br/>输入参数：<br/>-&nbsp;clockId：字符串类型，支持monotonic和monotonic_raw，部分事件支持boottime、realtime和clock_tai时钟类型。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetVecBranchSampleTypes(const std::vector\<std::string> &vecBranchSampleTypes) | 功能：设置分支采样的过滤条件。<br/>输入参数：<br/>-&nbsp;vecBranchSampleTypes：字符串数组，每个元素代表一种分支类型，支持的分支类型包括："any": 采集所有类型的分支；"any_call": 采集所有函数调用分支；"any_ret": 采集所有函数返回分支；"indirect": 采集所有间接分支（如间接函数调用、switch 跳转等）；"cond": 采集所有条件分支（如 if/else, for, while 等）；"u": 仅采集用户态（User Mode）的分支。"k": 仅采集内核态（Kernel Mode）的分支。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetMmapPages(int mmapPages) | 功能：设置mmap页数量。<br/>输入参数：<br/>-&nbsp;mmapPages：整型，表示共享内存区域的页数，必须是2的幂；取值范围：2 - 1024，默认1024。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetReport(bool report) | 功能：设置是否在性能数据采集结束后，自动生成并显示一份简要的性能报告。<br/>输入参数：<br/>-&nbsp;report：布尔类型，true表示启用自动生成报告，false禁用自动生成报告。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetExcludeProcess(const std::vector\<std::string>& excludeProcess) | 功能：设置不采集的线程名。<br/>输入参数：<br/>-&nbsp;excludeProcess：字符串数组，每个元素代表一个线程名。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetBackTrack(bool backtrack) | 功能：设置是否启用回溯采集功能。<br/>输入参数：<br/>-&nbsp;backtrack：布尔类型，true表示启用回溯采集功能，false表示禁用回溯采集功能。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | void SetBackTrackSec(int backTracesec) | 功能：设置回溯采集的时间。<br/>输入参数：<br/>-&nbsp;backTracesec：整型，单位为s，表示回溯的时长。<br/>输出参数：无。<br/>返回值：空。 | 
+|  | bool IsTimeSpecified() const | 功能：校验当前的RecordOption配置中，是否指定了采集时长。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示已经设置采集时长，false表示尚未设置采集时长。 | 
+| Client | bool Start() | 功能：启动性能数据采集，采用默认参数。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Start(const RecordOption &option) | 功能：根据RecordOption对象中配置的参数，启动性能数据采集。。<br/>输入参数：<br/>-&nbsp;option：RecordOption对象类型，包含了所有采集相关的配置（如采样事件、目标进程 PID、采样频率等）。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Start(const std::vector\<std::string> &args, bool immediately = true) | 功能：使用命令行参数的形式启动性能数据采集。<br/>输入参数：<br/>-&nbsp;args：字符串数组，每个元素代表一个命令行参数（如 {"-a", "--call-graph", "dwarf"}）。<br/>-&nbsp;immediately：布尔类型，true表示是在启动后立即开始采集；false表示启动采集进程，但暂不开始采集，等待后续调用Resume() 方法。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Stop() | 功能：停止性能数据采集，结束监控并保存数据。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Pause() | 功能：暂停当前的性能数据采集（可通过Resume恢复）。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Resume() | 功能：恢复被Pause暂停的性能数据采集。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Output() | 功能：将采集到的数据立即写入文件。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool PrePare(const RecordOption &option) | 功能：根据RecordOption配置，进行采集前的准备工作（如创建输出目录、检查权限、构建命令行等），通常与StartRun配合使用。<br/>输入参数：<br/>-&nbsp;option：RecordOption对象类型，包含采集配置。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool StartRun() | 功能：在PrePare成功调用后，启动采集子进程并开始数据采集。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool RunHiperfCmdSync(const RecordOption &option) | 功能：同步执行一次性能采集命令。该方法会阻塞，直到采集完成。<br/>输入参数：<br/>-&nbsp;option：RecordOption对象类型，包含采集配置。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool Setup(std::string outputDir) | 功能：设置或更改性能数据的输出目录。<br/>输入参数：<br/>-&nbsp;outputDir：字符串类型，指定新的输出目录路径。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | bool IsReady() | 功能：检查 Client 实例是否已准备好，例如输出目录是否有效、hiperf命令是否可执行等。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：布尔类型，true表示成功；false表示失败。 | 
+|  | const std::string &GetOutputDir() const | 功能：获取当前设置的性能数据输出目录路径。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：字符串类型，当前设置的输出文件路径。 | 
+|  | const std::string &GetCommandPath() const | 功能：获取当前HiperfClient实例所使用的hiperf命令行工具的完整路径。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：字符串类型，代表当前HiperfClient实例所使用的hiperf命令行工具的完整路径。 | 
+|  | const std::string GetOutputPerfDataPath() const | 功能：获取性能数据输出文件（默认是/data/local/tmp/perf.data）的完整路径。<br/>输入参数：无。<br/>输出参数：无。<br/>返回值：字符串类型，代表性能数据文件的完整路径。 | 
+
+
+### 使用示例
+    
+1. 引入hiperf_client模块头文件。
+     
+   ```
+   #include "hiperf_client.h"
+   ```
+
+2. 调用hiperf_client提供的接口开始和终止采集。
+     
+   ```
+   HiperfClient::Client myHiperf;  // 创建通信管道
+   myHiperf.Start();  // 启动采集
+   myHiperf.Stop();  // 结束采集，采集结束后文件会被保存至/data/local/tmp/perf.data，调用Setup()接口并传入文件路径参数可以修改文件保存路径
+   ```
+
+3. 在BUILD.gn对应的编译目标中增加编译依赖。
+     
+   ```
+   external_deps = [ "hiperf:hiperf_client" ]
+   ```

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/references-full/subsystems/subsys-utils-guide.md

@@ -0,0 +1,36 @@
+# 公共基础类库开发指导
+## 概述
+公共基础类库存放OpenHarmony通用的基础组件。这些基础组件包括一些常用的C、C++、JS开发增强API，可被OpenHarmony各业务子系统及上层应用所使用。公共基础类库子系统包含如下代码仓库：
+```
+/commonlibrary
+    ├── c_utils                  # c/c++标准库之外方便开发者开发的基础工具库
+    ├── ets_utils                # js标准库之外的与语言强相关的基础库
+    └── utils_lite               # lite上使用的工具函数，涉及c和js语言
+```
+各仓库提供的功能列表如下：
+
+**c_utils**
+
+-   文件、路径、字符串相关操作的能力增强接口；
+-   读写锁、信号量、定时器、线程增强及线程池等接口；
+-   安全数据容器、数据序列化等接口；
+-   各子系统的错误码相关定义。
+
+**ets_utils**
+
+-   JS中URI、URL、xml相关操作接口；
+-   JS中字符编解码接口；
+-   JS中进程相关操作接口；
+-   JS中多线程能力。
+
+**utils_lite**
+
+-   标准文件相关操作HAL接口；
+-   其它一些内部功能，如定时器等。
+
+## 各仓库开发指导
+[C++公共基础库(c_utils)说明文档](https://gitcode.com/openharmony/commonlibrary_c_utils/blob/master/README_zh.md)
+
+## 公共基础类库常见问题
+### c_utils常见问题
+具体各应用场景常见问题，参见[C++公共基础库(c_utils)说明文档](https://gitcode.com/openharmony/commonlibrary_c_utils/blob/master/README_zh.md)。

package/node_modules/@ohos-agent/pc-adapter/skills/pc-capability-domains/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: pc-capability-domains
+description: 鸿蒙 PC 能力域替换方案库。当一个 PC 库/应用用到的平台能力在鸿蒙上不存在、需判断"换成什么 + 可行性影响"时使用——图形窗口、GL 上下文、Qt 工具链栈、Swing/JDK GUI、音频、输入、剪贴板、系统通知、托盘、依赖运行时数据、终端渲染等。触发词：能力域、capability domain、窗口、图形窗口、窗口桥、OWB、ohos_window_bridge、GLFW、SDL、Qt 窗口、Qt 工具链、Swing、JavaFX、JDK GUI、OpenGL、Vulkan、EGL、XComponent、ArkUI Window、输入注入、全局监听、键盘钩子、pynput、能力替换、平台能力不存在、工具链栈未就绪、app-unsupported、运行时数据、数据随包、terminfo、tgetent、tgetstr、locale、bindtextdomain、CA 证书、ENOENT 系统路径、能力静默降级、全绿但渲染异常、终端渲染、TUI、tputs、curses、行编辑回显、转义序列渲染、termios、PTY、伪终端、应用自更新、自分发、检查更新、Check for Updates、更新器、QSimpleUpdater、StoreKit、updateManager、checkAppUpdate、showUpdateDialog、App Gallery、应用市场、插件安装器、autoupdate、Update Center、启动期联网、bearer 插件、ecma_vm cannot run in multi-thread、文件选择器、file picker、QFileDialog、DocumentViewPicker、@ohos.file.picker、JFileChooser、wxFileDialog、gtk_file_chooser、Open/Save As 对话框、自绘文件浏览器、存储 ACL 权限、FILE_ACCESS_PERSIST、持久授权、OH_FileShare_PersistPermission、DocumentSelectMode.FOLDER、autoCreateEmptyFile、OH-AWT 文件对话框。scan 阶段轴 2 判定时必查。
+---
+
+# pc-capability-domains：鸿蒙 PC 能力域替换方案库
+
+## 何时用我
+
+- **scan 阶段轴 2 判定**（`pc-01-analyze` agent）：识别项目用到的平台能力，逐条核对鸿蒙状态，判定 `capability_dependencies[]` 与 feasibility
+- 评估一个 GUI 库/应用（Qt/Electron/Swing/GLFW/SDL 等）能否适配、难度多大
+- 判断"编得出 `.so` 但功能不可用"的情况（如 GLFW 编得出但窗口后端鸿蒙没有）
+
+## 能力域是什么
+
+能力域 = **一类平台能力**，鸿蒙上可能 available / partial / unavailable / unknown。一个项目命中某能力域且 unavailable/partial → 即使能交叉编译，功能也可能不可用 → feasibility 降级。**能力域是开放的、增量积累的**——这轮先建核心条目，后续每遇到一个新能力域就加一条。
+
+## 查找法
+
+1. **看项目用了什么平台能力**（scan 步骤 5-6 已识别 native_api/capability_profile）。
+2. **按下表对应能力域**，读 `references/capability-domains/<domain>.md` 取鸿蒙替换方案 + 可行性影响。**索引行不是方案本体——命中即必须 Read 对应 references 文件**，replacement/impact 须引用文件内的分档/路线。域文件从**内置**（本 skill 的 `references/capability-domains/`）与**个人库**（`~/.local/share/ohos-agent-pc-adapter/capability-domains/`，由 `ohpt knowledge -p` 回补）两处读，后者同等有效。
+3. **判 `unavailable` 前必跑 `ohpt-agent knowledge -s "<域名>"`**——本表与域库反映的是本插件积累到哪儿了，不是平台事实；`[sdk-api]` 档查的是 SDK 自带声明语料（判据与读法见 `pc-knowledge-base/platform/鸿蒙PC-能力存在性以SDK声明为准.md`）。
+4. **鸿蒙 API/权限/Kit 语义不确定时，必须先用 Skill 工具加载查证 skill 再判定**：API 签名/类型/枚举/权限优先 `harmonyos-sdk-api-lookup`，开发指导/场景规则优先 `harmonyos-docs-lookup`——按 skill 内的查找法检索，别绕过 Skill 工具直接翻其数据目录（丢查找法、不可审计）。包内及全局均缺失时网络搜索兜底，安装说明与权威归属见 `harmonyos-pc-resources` 的「适配前置」节。
+5. 把命中的能力域填进 `01-scan.json` 的 `capability_dependencies[]`：domain / harmony_status / **solution_source** / replacement / impact / evidence。`solution_source` 两种取值：`builtin-asset`（引自已有域文件/方案资产，`asset_ref` 填路径）、`field-judgment`（该域待建，本条属现场判断——阶段 4 须为它产出 `kind=capability-domain` 沉淀候选，这是欠条不是免责声明）。
+
+## 能力域索引
+
+| 能力域 | 文件 | 鸿蒙状态 | 典型触发 |
+|--------|------|---------|---------|
+| `graphical-window` | `graphical-window.md` | partial（经 OWB 场景化方案） | GLFW/SDL/Qt 底层窗口、Wayland/X11/Win32/Cocoa 后端、自绘像素类库 |
+| `qt-toolchain` | `qt-toolchain.md` | available（已移植） | Qt 应用、PyQt/PySide 应用 |
+| `swing-jdk-gui` | `swing-jdk-gui.md` | unavailable（JDK GUI 未就绪） | Java Swing/JavaFX/AWT 应用 |
+| `gl-context` | 见 `graphical-window.md` 的 OWB GPU 路径 | partial | OpenGL/Vulkan，`OWB_GetNativeWindow` → EGL/VK_OHOS_surface |
+| `gl-rendering`（`gl-context` 渲染方案子库） | `capability-domains/gl-rendering/`（子目录索引见各文件头） | partial | GL/GLES 渲染方案全集：立即模式几何/文字/菜单（`02-imm-mode-font-menu.md`）、GLU（`03-glu-cross-compile.md`）、路线决策—纯 GLES vs gl4es（`01-route-gles-vs-gl4es.md`）、验证要点+ES1 默认版本（`04-verification-pitfalls.md`）、坐标系契约（`05-coordinate-contract.md`）；命中 `gl-context` 的库，GL 渲染适配方案都落本子目录 |
+| `gpu-compute` | `gpu-compute.md` | partial（基础计算可用；事件回调 app 域受限） | OpenCL/GPGPU、`clGetPlatformIDs`/`clEnqueueNDRangeKernel`、ICD Loader、GPU 异构计算库/AI 推理后端 |
+| `audio` | `audio.md` | partial（经 OHAudio 后端，零售机 NAPI 壳） | OpenAL/PortAudio/SDL_audio/miniaudio/RtAudio、ALSA/PulseAudio/OSS 后端、`alcOpenDevice`/`snd_pcm_*`；播放须走签名 HAP 的 App 域 `dlopen`（LOAD 不 EXEC） |
+| `input` | `input.md` | 分档（窗口内 available / 全局按部署模型） | pynput/pyautogui/keyboard、全局监听/注入、evdev/uinput |
+| `network` | `network.md` | available（标准 socket 直接复用；ArkTS 流接收有开箱 API） | Socket/连接/收发、asio/libevent/libuv/curl、MQTT/AMQP 客户端、网络流接收/解析判定 |
+| `serial-port` | `serial-port.md` | available（termios/NDK USB 串口 DDK 直接复用） | termios/`/dev/tty*`、libserialport、OpenOCD Bus Pirate 等调试探针 CLI |
+| `usb-host` | `usb-host.md` | partial（中心仓 libusb/hidapi 可复用；hdc shell 域不可达 `/dev/bus/usb`） | libusb-1.0/hidapi、ST-Link/J-Link/DAPLink 探针、dfu-util/pyusb |
+| `system-file-icon` | `system-file-icon.md` | partial（按类型不按文件，仅 ArkTS 侧） | `SHGetFileInfoW`/`NSWorkspace iconForFile:`/Electron `getFileIcon`、文件管理器/下载列表要图标 |
+| `app-self-update` | `app-self-update.md` | partial（分发由 App Gallery 垄断；仅 HAP 形态、仅 ArkTS 侧） | **`delivery_form=app` 逐个必查**（更新器是功能不是符号，不会自己命中）；`Help ▸ Check for Updates`、启动期自动查更新、QSimpleUpdater/`version.txt`/`maven-metadata.xml` 探测、插件/扩展安装器、NetBeans autoupdate、`update.enabled` 默认开启 |
+| `file-picker` | `file-picker.md` | partial（四档：Qt 原生对话框零代码可用 → 纯 NDK 持久授权 → 自建桥 → 非 Qt 栈经文件通道） | `QFileDialog`（静态**与**实例两族）/`JFileChooser`/`wxFileDialog`/`gtk_file_chooser`、`File ▸ Open`/`Save As`/`Open Folder`、自绘文件浏览器——**命中即应优先换成系统 `DocumentViewPicker`，不要移植自绘选择器；能画出来 ≠ 本域不命中** |
+| `runtime-data-assets` | `runtime-data-assets.md` | unavailable（零售机无系统数据目录） | 产物 `nm -D` 命中数据访问符号族（`tgetent`/`bindtextdomain`…）、依赖运行时读系统数据目录（terminfo/locale/CA）、用例全绿但渲染/能力静默降级 |
+| `terminal-runtime` | `terminal-runtime.md` | available（termios/PTY 完整） | termios/PTY 调用点（`tcsetattr`/`cfmakeraw`/`forkpty`）、`TIOCGWINSZ`/`COLUMNS`/`LINES` 字面量——需要终端环境才有意义的库；只中本域不上屏 |
+| `terminal-render` | `terminal-render.md` | partial（PTY 可用，渲染宿主=终端壳 demo） | 终端发射族符号（`tputs`/`tgoto`/`wadd*`）、源码 CSI 字面量（`\x1b[`）、TUI/行编辑回显/进度条渲染——产出可见输出，须截图 + buffer 语义断言 |
+| `clipboard` | `clipboard.md` | partial（权限授予分档；降级不崩溃） | 剪贴板写入、读剪贴板、`clipboard.writeImage`、权限已声明但功能不生效 |
+| `media-capture` | `media-capture.md` | unavailable（无屏幕/系统音频捕获原生能力；上游守卫自动裁剪） | 屏幕录制/系统音频采集、`screencapturekit`/`cpal` 平台分支、录课/会议录制类应用 |
+| `notification` | （待建） | 待评估 | 系统通知 |
+| `tray` | `tray.md` | partial（常驻菜单降级；popUpContextMenu 不支持） | 系统托盘（鸿蒙 PC 无传统托盘语义）、`Tray`/`setContextMenu`/`popUpContextMenu` |
+
+> **框架口子**：待建条目用"待建/待评估"占位。后续适配中遇到时，按 `graphical-window.md` 的格式补一条（能力描述 + 鸿蒙状态 + 替换方案 + 可行性影响 + 典型库怎么接），并更新本索引。新增能力域只动这一处 + 加一个 .md，不碰其他。**回补有自动通道**：阶段 4 写 `kind=capability-domain` 的沉淀候选 → `ohpt knowledge -p` 落成个人库域文件骨架 → 下一轮 scan 即可引用（骨架须补齐实测细节才算权威，验证过的方案本体放 `solutions/`）。
+
+## 能力域 vs 交付形态（两轴正交）
+
+- **交付形态（轴 1）** 决定"怎么交付"（库/CLI/应用，工作区结构）。
+- **能力域（轴 2）** 决定"用的平台能力鸿蒙有没有、换成什么"。
+- 二者正交：GLFW = 交付形态 `cpp-lib` × 命中 `graphical-window`(unavailable) → 编得出 `.so` 但功能不可用 → feasibility=hard。Qt 应用 = 交付形态 `app` × 命中 `qt-toolchain`(available) → 可适配。
+
+## 资源地图
+
+| 文件 | 内容 |
+|------|------|
+| `references/capability-domains/graphical-window.md` | 图形窗口栈：鸿蒙窗口模型、OWB 场景化方案路由、可行性影响；**域边界到 surface 为止**（Vulkan surface 触发词在 scan 判定要点；swapchain/present 属 `pc-knowledge-base` Vulkan 上屏通路） |
+| `references/capability-domains/app-self-update.md` | 应用自更新：来源与入口分开判、StoreKit 替换方案、原生 UI 跨 ArkTS 两条路、交付形态分支、11 个端口的现场状态、Qt5 启动期网络的 abort 风险 |
+| `references/capability-domains/file-picker.md` | 文件选择器：四档方案与判定顺序（档 A Qt 原生对话框经 QPA 自动转发到系统 `DocumentViewPicker`，零代码零 ACL 权限 → 档 B 纯 NDK `OH_FileShare_PersistPermission` 跨重启持久授权，不必建桥 → 档 C 自建 NAPI 桥，仅为目录授予/占位文件控制/路径与 URI 成对 → 档 D 非 Qt 栈经「文件通道 + ArkTS 弹 picker」，机制七条）；按 GUI 栈的检出方言（含 `QFileDialog` 实例族易漏项、载荷 jar 端口 `source/` 为空须查字节码）、自绘 vs 系统选择器的 ACL 对照、真机取证陷阱（100×30 占位 `QWindow`、801、手打路径被拒、hdc 与 app 不同 mount namespace）、测试用例改判清单 |
+| `references/capability-domains/input.md` | 输入事件：窗口内/全局分档、部署模型判定、pynput 类库怎么判 |
+| `references/capability-domains/network.md` | 网络通信：标准 socket 直接复用，hit 即 available，不构成障碍；ArkTS 侧**网络流接收（@ohos.net.socket/webSocket/http requestInStream）≠ 网络流解析（后者进 capability_gaps）** |
+| `references/capability-domains/serial-port.md` | 串口：termios API + NDK `usb_serial_api.h` 可用，直接复用 |
+| `references/capability-domains/usb-host.md` | USB 主机：中心仓 libusb/hidapi 适配版复用 + NDK USB DDK；hdc shell 域够不到 `/dev/bus/usb` |
+| `references/capability-domains/qt-toolchain.md` | Qt 工具链栈：鸿蒙移植版状态、Qt 应用打包集成、PyQt/PySide 绑定层处理 |
+| `references/capability-domains/swing-jdk-gui.md` | Swing/JDK GUI 栈：JDK GUI 未就绪现状、可行路线、何时判 app-unsupported |
+| `references/capability-domains/audio.md` | 音频栈：鸿蒙无 ALSA/PulseAudio/OSS/OpenSL，唯一出口 OHAudio；**零售机 NAPI 壳（LOAD 不 EXEC）真出声**、验收四证判据 |
+| `references/capability-domains/runtime-data-assets.md` | 运行时数据资产：依赖代码链入但运行时读系统数据目录（terminfo/locale/CA），零售机一律视为无系统数据；**三步证据链判定（符号面/路径面/行为差分面）**、数据随包 + 环境自举方案、E130 关联 |
+| `references/capability-domains/terminal-runtime.md` | 终端运行环境域：termios/PTY 判定（调用点级）、CLI/PTY 是终端库的原生使用形态、与 terminal-render AND 正交 |
+| `references/capability-domains/terminal-render.md` | 终端可见渲染域：发射族三通道判定（字面量主判据/机制族补充/静态链入兜底）+ 判定纪律三条（零库名/机制公共接口/查询族归 E130）、上屏终端壳方案（cpp-terminal-demo + pyte buffer 语义断言三件套）、E3 归因语义 |
+| `references/requirements/` | 需求图谱（R 系列 kv，机器可读：缺失系统能力跟踪，R001–R002）——知识库同步生成物，禁手改 |
+| `references/capability-domains/terminal-tui.md` | 交互式终端 UI：curses/ncurses 全屏界面在 HNP CLI 执行器无 TTY 不可用；**执行器形态限制非平台缺失**、非交互 conf 流程替代方案 |
+| `references/capability-domains/subprocess-exec.md` | 子进程执行：app 域 SELinux 仅可 exec 私有 HNP 内二进制；**三层随包策略（中心仓复用+busybox-static+自编译+ELF 自签）**、HNP 清单核对 |
+| `references/capability-domains/gl-rendering/` | **GL/GLES 渲染能力域（子目录）**：`00-overview.md`（能力本体 + 坐标契约 + 宿主壳共享链禁令）、`01-route-gles-vs-gl4es.md`（路线决策—纯 GLES vs gl4es + 双 GL 栈 NEED_OPENGL）、`02-imm-mode-font-menu.md`（立即模式文字/菜单 shader 重实现）、`03-glu-cross-compile.md`（GLU 交叉编译）、`04-verification-pitfalls.md`（验证要点 + 关键陷阱 + ES1 默认版本）、`05-coordinate-contract.md`（坐标系契约三问 + 翻转唯一性 + 断言锚定） |
+| `references/capability-domains/gpu-compute.md` | GPU 通用计算（OpenCL kernel 计算实证）+ **GPU 设备发现与驱动通路域内通用子面**（按源码特征触发：驱动清单解析/dlopen 驱动/接口版本协商/设备枚举/layer 链——不按 API 点名；真驱动 env 注入、随系统/Mesa 供给、app 域事件同步受限、SYSCONFDIR 对齐 `/system/etc:/vendor/etc`）；ICD 加载器 + `OCL_ICD_FILENAMES=/vendor/lib64/passthrough/libOpenCL.so` 发现 Maleoon 916；**基础 kernel 执行可用、事件回调 app 域受限（cqEvent 创建失败）、写入类操作需 cwd 可写**——OpenCL-SDK 2026.05.29 实证 |
+| `references/capability-domains/app-permissions.md` | **应用权限体系（跨域，app 形态）**：三层分类（ACL 97/user_grant 19/system_grant 60）+ 代码特征→权限映射 + 运行时申请三件套（弹窗仅一次）+ AGC/Profile 链路；机读清单 `app-permissions-lists.json`；scan permissions 落点 `permission_dependencies[]` 与配方 Phase 3.2 分轨声明、Phase 4 `bm dump` 授予态取证（vendor 自 ohos-migration-analysis） |
+| `references/capability-domains/clipboard.md` | 剪贴板：权限授予分档（写文本免权限；写图与读走 READ_PASTEBOARD acl）、读写不对称、本地调试链授不了但降级不崩溃、AGC 恢复路径（AFFiNE/joplin 实证） |
+| `references/capability-domains/tray.md` | 托盘：Electron-OH Tray 常驻菜单模式能力映射表、popUpContextMenu 不支持（包守卫跳过）、应用侧退出项移除防双退出（AFFiNE/yesplaymusic 实证） |
+| `references/capability-domains/media-capture.md` | 屏幕录制/系统音频采集：鸿蒙无对应原生能力、上游平台守卫自动裁剪（scope_out 零动作）、CAMERA/MICROPHONE 权限与屏幕捕获的区分（AFFiNE 实证） |
+| `references/solutions/ohos-window-bridge/` | **OWB 方案资产（vendored 源+文档+模板）**：四层架构、双上屏、双向窗口控制——README/ARCHITECTURE/PORTING_KIT 为权威，域条目只路由 |
+| `references/solutions/ohaudio-backend/` | **OHAudio 方案资产（零售机·NAPI 壳 LOAD 不 EXEC，2026-09-02 liba52 6/6 实证）**：裸进程 exec/HiShell 桌面/私有 HNP 三路被拒（EPERM/127），必须签名 HAP 的 App 域 `dlopen(libohaudio.so)` 拿 renderer——README/PORTING_NOTES/liba52 实例为权威，域条目只路由 |