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

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/SKILL.md

@@ -0,0 +1,68 @@
+---
+name: openharmony-device-porting
+description: OpenHarmony 设备层移植文档指针索引。当真正涉及设备层系统级移植时使用——GN/BUILD.gn 构建、cmake/makefile 三方库进 OH 构建、SELinux 策略（avc denied/exec 权限）、init service/sandbox/seccomp、DFX 调试（hilog/faultlogger/hidumper/hiperf）、hdc 命令。触发关键词：BUILD.gn、GN 构建、cmake 移植、porting、SELinux 策略、avc denied、init service、sandbox、appspawn、系统参数/property、hilog、faultlogger、hiperf、hdc 命令、设备层移植。注意：大多数库/CLI/应用适配用不到本 skill（用 pc-knowledge-base/pc-error-atlas 即可），仅当涉及系统层 GN 构建/SELinux 策略/init/DFX 时才查。
+---
+
+# openharmony-device-porting：设备层移植文档指针索引
+
+## 何时用我（先判断是否真需要）
+
+**大多数库/CLI/应用适配用不到本 skill**——交叉编译、平台机制（HNP/SELinux exec/ELF 签名/hdc）已在 `pc-knowledge-base` 覆盖，错误图谱在 `pc-error-atlas`。
+
+仅当涉及**设备层系统级**问题时查本 skill：
+- 把三方库集成进 OpenHarmony **GN/BUILD.gn 构建**（不是简单交叉编译）
+- **SELinux 策略**配置（domain/file_context/SA，avc denied 深度排查）
+- **init service / sandbox / seccomp** 配置
+- **DFX 调试**（hilog/faultlogger/hidumper/hiperf 系统级）
+
+## 文档位置（按需读取，勿全量加载）
+
+全文镜像在 `references-full/`（92 个 .md，~24,900 行）——**按需读取单个文件，不要全量加载**。先按下表定位具体文件，再 Read 那一个。
+
+> 优先查 OpenHarmony 官方文档源（Gitee `openharmony/docs`）获取最新版本；本 skill 的 `references-full/` 是离线镜像快照，供无网时按需取用。
+
+## 文档结构（references-full/）
+
+```
+references-full/
+├── porting/          # 三方库移植（cmake/makefile、内核、标准系统移植指南）
+├── subsystems/       # 构建系统、SELinux、boot/init、DFX 调试、toolchain
+├── faqs/             # 常见问题（编译、移植、环境、启动）
+├── get-code/         # 获取源码与工具
+└── kernel/           # 内核概述、动态库加载
+```
+
+## 场景对应表（定位到具体文件再读）
+
+| 场景 | 首选文件 |
+|------|---------|
+| cmake 三方库进 OH 构建 | `references-full/porting/porting-thirdparty-cmake.md` |
+| Makefile 三方库移植 | `references-full/porting/porting-thirdparty-makefile.md` |
+| 三方库移植概述 | `references-full/porting/porting-thirdparty-overview.md` |
+| 编写 BUILD.gn ohos_shared_library | `references-full/subsystems/subsys-build-module.md` |
+| GN 编码规范/最佳实践 | `references-full/subsystems/subsys-build-gn-coding-style-and-best-practice.md` |
+| Rust 编译支持 | `references-full/subsystems/subsys-build-rust-compilation.md` |
+| 可执行被 SELinux 拦截 | `references-full/subsystems/subsys-security-selinux-sample-domain.md` + `subsys-security-selinux-faq.md` |
+| SELinux file_context 标签 | `references-full/subsystems/subsys-security-selinux-sample-file.md` |
+| SELinux SA 服务配置 | `references-full/subsystems/subsys-security-selinux-sample-sa.md` |
+| init service 开机启动 | `references-full/subsystems/subsys-boot-init-service.md` + `subsys-boot-init-cfg.md` |
+| 沙箱命名空间隔离 | `references-full/subsystems/subsys-boot-init-sandbox.md` |
+| seccomp 系统调用过滤 | `references-full/subsystems/subsys-boot-init-seccomp.md` |
+| 系统参数/property | `references-full/subsystems/subsys-boot-init-sysparam.md` |
+| 查崩溃栈 | `references-full/subsystems/subsys-dfx-faultlogger.md` |
+| hilog 日志 | `references-full/subsystems/subsys-dfx-hilog-rich.md` |
+| hidumper 系统信息 | `references-full/subsystems/subsys-dfx-hidumper.md` |
+| hdc 命令完整手册 | `references-full/subsystems/subsys-toolchain-hdc-guide.md` |
+| hiperf 性能采样 | `references-full/subsystems/subsys-toolchain-hiperf.md` |
+| 编译报错 ninja/gn | `references-full/subsystems/subsys-build-FAQ.md` + `faqs/faqs-building.md` |
+
+## 查找法
+
+1. **判断是否真需要本 skill**（见上"何时用我"）——一般适配用 `pc-knowledge-base`/`pc-error-atlas` 即可。
+2. **按场景对应表定位文件**。
+3. **Read 那一个文件**（勿全量加载 24k 行）。
+4. 无网/需最新版 → 查 OpenHarmony 官方 Gitee `openharmony/docs` 仓库。
+
+## 路径使用注意
+
+`references-full/...` 是相对于本 skill 目录的逻辑路径。调用工具前解析到 skill 绝对路径前缀。

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/references-full/faqs/faqs-building.md

@@ -0,0 +1,243 @@
+# 编译构建常见问题
+
+
+## 轻量和小型系统
+
+
+### 提示“usr/sbin/ninja: invalid option -- w”
+
+- **现象描述：**
+
+  编译失败，提示“usr/sbin/ninja: invalid option -- w”。
+
+- **可能原因：**
+
+  编译环境中ninja版本太低，不支持--w选项。
+
+- **解决办法：**
+
+  卸载环境中ninja和gn，按照[获取工具](../get-code/gettools-ide.md)。
+
+
+### 提示“/usr/bin/ld: cannot find -lncurses”
+
+- **现象描述：**
+  
+  编译失败，提示“/usr/bin/ld: cannot find -lncurses”。
+
+- **可能原因：**
+  
+  编译环境ncurses库缺失。
+
+- **解决办法：**
+    
+  ```
+  sudo apt-get install lib32ncurses5-dev
+  ```
+
+
+### 提示“line 77: mcopy: command not found”
+
+- **现象描述：** 
+
+  编译失败，提示“line 77: mcopy: command not found”。
+
+- **可能原因：**
+  
+  编译环境未安装mcopy。
+
+- **解决办法：**
+    
+  ```
+  ​sudo apt-get install dosfstools mtools
+  ```
+
+
+### 提示“riscv32-unknown-elf-gcc: error trying to exec 'cc1': execvp: No such file or directory”
+
+- **现象描述：**
+  
+  编译失败，提示“riscv32-unknown-elf-gcc: error trying to exec 'cc1': execvp: No such file or directory”。
+
+- ​**可能原因：**
+
+  当前用户对riscv编译器路径下的文件访问权限不够。
+
+- ​**解决办法：**
+
+    查询gcc_riscv32所在目录。
+    
+  ```
+  which riscv32-unknown-elf-gcc
+  ```
+
+  使用chmod命令修改目录权限为755。
+
+
+### 提示“No module named 'Crypto'”
+
+- **现象描述：**
+
+  编译失败，提示“No module named 'Crypto'”。
+
+- **可能原因：**
+
+  python3未安装Crypto。
+
+- **解决办法：**
+
+  1. 查询Python版本号。
+        
+      ```
+      python3 --version
+      ```
+  2. 需使用python3.7以上版本，然后安装pycryptodome。
+        
+      ```
+      sudo pip3 install pycryptodome
+      ```
+
+
+### 提示“xx.sh : xx unexpected operator”
+
+- **现象描述：**
+
+  编译失败：“xx.sh [: xx unexpected operator”。
+
+- **可能原因：**
+
+  编译环境shell不是bash。
+
+- **解决办法：**
+    
+  ```
+  sudo rm -rf /bin/sh
+  sudo ln -s /bin/bash /bin/sh
+  ```
+
+
+### 提示“Could not find a version that satisfies the requirement six>=1.9.0”
+
+- **现象描述**
+
+  编译构建过程中出现以下错误：
+
+    
+  ```
+  Could not find a version that satisfies the requirement six>=1.9.0
+  ```
+
+- **可能原因**
+
+  环境中未安装合适的“six”。
+
+- **解决办法**
+
+  方法1：通过命令“pip3 install six”，在线安装。
+
+  方法2：离线安装。
+
+  通过网页[https://pypi.org/project/six/#files](https://pypi.org/project/six/#files)，下载安装包。
+
+  ![zh-cn_image_0000001251276115](figures/zh-cn_image_0000001251276115.png)
+
+  将源码放置在Linux服务器中，并安装“pip3 install six-1.14.0-py2.py3-none-any.whl”。
+
+  完成上述安装后，重新构建。
+
+
+### 提示找不到“-lgcc”
+
+- **现象描述**
+
+  编译构建过程中出现以下错误：
+
+    
+  ```
+  riscv32-unknown-elf-ld: cannot find -lgcc
+  ```
+
+- **可能原因**
+
+  交叉编译器gcc_riscv32的PATH添加错误，如下，在"bin"后多添加了一个“/”，应该删除。
+
+    
+  ```
+  ~/gcc_riscv32/bin/:/data/toolchain/
+  ```
+
+- **解决办法**
+
+  重新修改gcc_riscv32的PATH，将多余的“/”删除。
+
+    
+  ```
+  ~/gcc_riscv32/bin:/data/toolchain/
+  ```
+
+
+### 提示找不到“python”
+
+- **现象描述**
+
+  编译构建过程中出现以下错误：
+
+    
+  ```
+  -bash: /usr/bin/python: No such file or directory
+  ```
+
+- **可能原因**1
+
+  没有装python。
+
+- **解决办法**
+
+  请使用如下命令安装Python，下方以Python3.8为例。
+
+    
+  ```
+  sudo apt-get install python3.8
+  ```
+
+- **可能原因2**
+
+  usr/bin目录下没有python软链接
+
+  ![zh-cn_image_0000001243200677](figures/zh-cn_image_0000001243200677.png)
+
+- **解决办法**
+
+  请运行以下命令添加软链接：
+
+    
+  ```
+  # cd /usr/bin/ 
+  # which python3
+  # ln -s /usr/local/bin/python3 python
+  # python --version
+  ```
+
+  例：
+
+  ![zh-cn_image_0000001243320787](figures/zh-cn_image_0000001243320787.png)
+
+
+### 提示找不到“python3”
+
+- **现象描述**
+
+  ![zh-cn_image_0000001251276255](figures/zh-cn_image_0000001251276255.png)
+
+- **可能原因**
+
+  没有装python3。
+
+- **解决办法**
+
+  请使用如下命令安装Python3。
+
+    
+  ```
+  sudo apt-get install python3.8
+  ```

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/references-full/faqs/faqs-environment-setup.md

@@ -0,0 +1,267 @@
+# 环境搭建常见问题<a name="ZH-CN_TOPIC_0000001215650793"></a>
+
+
+## 轻量和小型系统<a name="section1742119306399"></a>
+
+### 安装hb<a name="section36351051193919"></a>
+
+#### 出现乱码、段错误
+
+- **现象描述**
+
+  执行“python3 -m pip install --user ohos-build”出现乱码、段错误（segmentation fault）。
+
+
+- **可能原因**
+
+  pip版本过低。
+
+- **解决办法**
+
+  执行如下命令升级pip。
+
+  ```
+  python3 -m pip install -U pip
+  ```
+
+
+#### 提示"cannot import 'sysconfig' from 'distutils'"<a name="section48221013144011"></a>
+
+- **现象描述**
+
+  执行“python3 -m pip install --user ohos-build”提示"cannot import 'sysconfig' from 'distutils'"。
+
+
+- **可能原因**
+
+  缺少distutils模块。
+
+- **解决办法**
+
+  执行如下命令安装。
+
+  ```
+  sudo apt-get install python3.8-distutils
+  ```
+
+
+#### 提示"module 'platform' has no attribute 'linux\_distribution'"<a name="section10307193044111"></a>
+
+- **现象描述**
+
+  执行“python3 -m pip install --user ohos-build”提示"module 'platform' has no attribute 'linux\_distribution'"。
+
+
+- **可能原因**
+
+  python3 pip安装兼容性问题。
+
+- **解决办法**
+
+  执行如下命令重新安装pip。
+
+  ```
+  sudo apt remove python3-pip
+  curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
+  python get-pip.py
+  ```
+
+
+#### 提示"Could not find a version that satisfies the requirement ohos-build"<a name="section8692735427"></a>
+
+- **现象描述**
+
+  执行“python3 -m pip install --user ohos-build”提示"Could not find a version that satisfies the requirement ohos-build"
+
+
+- **可能原因**
+
+  可能是网络环境较差导致的安装失败。
+
+- **解决办法**
+  1. 请检查网络连接是否正常。如果网络有问题，请修复网络问题后重新安装。
+  2. 若网络正常，请尝试指定临时pypi源的方式安装：
+
+     ```
+     python3 -m pip install -i https://pypi.tuna.tsinghua.edu.cn/simple ohos-build
+     ```
+
+### 安装python3
+
+#### 提示“configure: error: no acceptable C compiler found in $PATH”<a name="section870082884217"></a>
+
+- **现象描述**
+
+  安装python3过程中出现以下错误：
+
+  ```
+  configure: error: no acceptable C compiler found in $PATH. See 'config.log' for more details
+  ```
+
+- **可能原因**
+
+  环境中未安装“gcc”。
+
+- **解决办法**
+
+  1、通过命令“apt-get install gcc”在线安装。
+
+  2、完成后，重新安装python3。
+
+
+#### 提示“-bash: make: command not found”<a name="section198707170455"></a>
+
+- **现象描述**
+
+  安装python3过程中出现以下错误：
+
+  ```
+  -bash: make: command not found
+  ```
+
+- **可能原因**
+
+  环境中未安装“make”。
+
+- **解决办法**
+
+  1、通过命令“apt-get install make”在线安装。
+
+  2、完成后，重新安装python3。
+
+
+#### 提示“zlib not available”<a name="section85401445204518"></a>
+
+- **现象描述**
+
+  安装python3过程中出现以下错误：
+
+  ```
+  zipimport.ZipImportError: can't decompress data; zlib not available
+  ```
+
+- **可能原因**
+
+  环境中未安装“zlib”。
+
+- **解决办法**
+
+  方法1：通过命令“apt-get install zlib”在线安装。
+
+  方法2：如果软件源中没有该软件，请从“www.zlib.net”下载版本代码，并离线安装。
+
+  ![](figures/download-zlib.png)
+
+  完成下载后，通过以下命令安装：
+
+  ```
+  # tar xvf zlib-1.2.11.tar.gz
+  # cd zlib-1.2.11
+  # ./configure
+  # make && make install
+  ```
+
+  完成后，重新安装python3。
+
+
+#### 提示“No module named '\_ctypes'”<a name="section12202694460"></a>
+
+- **现象描述**
+
+  安装python3过程中出现以下错误：
+
+  ```
+  ModuleNotFoundError：No module named ‘_ctypes’
+  ```
+
+
+- **可能原因**
+
+  环境中未安装“libffi”和“libffi-devel”。
+
+
+- **解决办法**
+
+  1、通过命令“apt-get install libffi\* -y”，在线安装。
+
+  2、完成后，重新安装python3。
+
+
+### 安装kconfiglib过程中遇到lsb\_release错误<a name="section5803174135115"></a>
+
+- **现象描述**
+
+  安装kconfiglib过程中遇到如下错误打印：
+
+  ```
+  subprocess.CalledProcessError: Command '('lsb_release', '-a')' returned non-zero exit status 1.
+  ```
+
+- **可能原因**
+
+  lsb\_release模块基于的python版本与现有python版本不一致。
+
+- **解决办法**
+
+  执行"find / -name lsb\_release"，找到lsb\_release位置并删除，如："sudo rm -rf /usr/bin/lsb\_release"。
+
+
+### Linux编译服务器终端输入不识别的命令时提示“ImportError: No module named apt\_pkg”<a name="section510820516515"></a>
+
+- **现象描述**
+
+  Linux编译服务器终端输入不识别的命令时，提示"ImportError: No module named apt\_pkg"。
+
+
+- **可能原因**
+
+  python3 apt安装兼容性问题。
+
+- **解决办法**
+
+  执行如下命令重新安装python3-apt。
+
+  ```
+  sudo apt-get remove  python3-apt
+  sudo apt-get install python3-apt
+  ```
+
+### 如何将下载好的源码升级为其他分支源码
+- **场景描述** 
+
+  当您的环境中已有下载好的OpenHarmony源码，需要将其升级为其他分支（例如Master）源码时，可按照如下步骤进行操作。
+
+- **操作方法** 
+
+  1. 进入现有OpenHarmony根目录。
+   
+     请注意该目录下包含一个隐藏目录.repo，如没有此隐藏目录，请重新解压获取的源码包，以获取完整的源码内容。
+   
+  2. 使用repo init命令重新初始化源码库信息。
+
+     其中，branch表示分支名称，例如master、OpenHarmony-3.2-Beta3等。
+     ```shell
+     repo init -u https://gitee.com/openharmony/manifest -b branch --no-repo-verify
+     ```
+ 
+  3. 下载更新源码文件。
+
+     ```shell
+     repo sync -c
+     repo forall -c 'pwd;git lfs pull'
+     ```
+     如果想保持工作路径清洁，可以执行如下命令。
+   
+     >![icon-note.gif](public_sys-resources/icon-caution.gif) **注意：**
+     >此操作会重置本地工作区，删除未被git管理的文件或目录，请谨慎操作。
+     ```shell
+     repo forall -c 'git reset --hard;git clean -fdx'
+     ```
+
+  4. 执行prebuilts脚本，安装编译器及二进制工具。
+
+     ```shell
+     bash build/prebuilts_download.sh
+     ```
+   
+   

package/node_modules/@ohos-agent/pc-adapter/skills/openharmony-device-porting/references-full/faqs/faqs-kernel.md

@@ -0,0 +1,88 @@
+# 内核常见问题
+
+
+## 基础内核
+
+
+### LiteOS-A和LiteOS-M内核对外API的差异
+
+基础内核API存在差异，但是LiteOS-A提供标准POSIX接口，LiteOS-M提供标准POSIX和CMSIS接口。如果要支持跨平台，三方适配建议使用POSIX等标准接口。
+
+
+### 如何分析线程栈溢出
+
+**问题现象**
+
+系统异常，提示CURRENT task xxx stack overflow！
+
+**解决措施**
+
+1. 创建xxx线程的时候成倍加大栈空间，多次尝试如果问题不复现，则说明任务栈不够，需要调整；
+
+2. 如果成倍加大线程栈，问题依旧复现，则排查xxx线程中是否定义超大数组，或者流程是否存在递归调用；
+
+3. 确认无前述问题，则需要排查是否存在踩内存的情况。
+
+
+## 文件系统
+
+
+### Hi3516开源板以写的模式打开同一个文件失败（LiteOS-A）
+
+Hi3516开源板使用FAT文件系统，不允许该操作。
+
+
+### LiteOS内核已支持哪些硬件平台
+
+开源版本LiteOS-A已支持Hi3516/Hi3518开发板；LiteOS-M已支持Hi3861开发板、STM32F103、野火挑战者STM32F429IGTb、Nucleo_f767zi等，详细查看kernel/liteos_m目录下的README_zh.md文件。
+
+
+### LiteOS内核已支持哪几款芯片架构
+
+LiteOS-M已支持risc-v、Cortex-m3\m4\m7\m33、arm9，待支持c-sky、xtensa；LiteOS-A已支持armv7-a，待支持armv8-a，请关注开源社区更新。
+
+
+## 三方组件
+
+
+### 已支持哪些三方组件
+
+已提供mbedtls、lwip等开源组件和三方库，可以直接使用；另外提供标准的POSIX接口，可以自行适配。
+
+
+### 在上使用OpenSSL，出现秘钥长度校验不正确
+
+OpenSSL编译选项中要注意架构类型（ARM，X86等）和系统位数（32、64位）是否选择正确。
+
+
+### setsockopt是否支持SO_RCVBUF和SO_SNDBUF选项
+
+不支持。
+
+
+## 编译链接
+
+
+### Arm Linux开发的应用程序，如何在LiteOS-A上运行
+
+需要用开源版本提供的交叉编译器重新编译应用程序，才可以运行。
+
+
+### 在什么系统下编译，使用什么编译器
+
+LiteOS-A在linux环境进行编译，使用LLVM编译器；LiteOS-M在Linux或Windows环境进行编译，使用IAR、Keil、GCC等编译工具。
+
+
+### LiteOS-M上使用单独编译成静态库的三方组件，出现三方组件中的全局变量值不正确，或调用三方组件的函数后系统卡死
+
+检查三方组件编译选项中是否有-fPIE -fpie -fPIC -fpic等地址无关编译选项，如果有，则去掉，重新编译成库使用。
+
+
+### LiteOS-A生成目标可执行文件时，提示 use  VFP register arguments，xxx.o does not
+
+请确认xxx.o编译时是否添加-mfloat-abi=xxx -mcpu=xxx -mfpu=xxx编译选项，若没有，则需要添加。
+
+
+### clock_gettime接口获取的时间打印不对
+
+struct timespec结构中tv_sec为time_t，而time_t为long long类型，打印控制符为%lld，请确认实际打印控制符是否正确。