变更类型

请在对应类型（请勿多选）前打 √，仅可选择一项：

• [√ ] feat（新增功能）
• fix（修复 Bug）
• docs（文档变更）
• refactor（代码重构）
• perf（性能优化）
• release（发布版本）
• test（测试相关）
• chore（构建/工具链/依赖）
• deprecated（标记弃用）
• removed（移除功能）
• security（安全修复）

变更内容

本次变更的具体内容

• 新增适配三方库 libcsv 3.0.3，新增 community/libcsv/ 目录（仅新增，不改动既有库）。
• 上游地址：https://sourceforge.net/projects/libcsv/；License：LGPL-2.1-or-later；源码包：`https://downloads.sourceforge.net/project/libcsv/libcsv/libcsv-3.0.3/libcsv-3.0.3.tar.gz`（无补丁，上游源码未修改）。
• 库简介：libcsv is a small, simple and fast CSV library written in pure ANSI C89 that reads and writes CSV data
• 支持架构：armeabi-v7a arm64-v8a x86_64，三架构均完成交叉编译，并在设备上运行上游自带测试通过。
• 交付物：HPKBUILD / HPKCHECK / SHA512SUM / README.OpenSource / README_zh.md / OAT.xml / docs/hap_integrate.md。

解决的问题

• 社区两棵树此前均未收录 libcsv，应用/系统组件若要在 OpenHarmony 上使用该库，只能自行交叉编译并手工适配。
• 本 PR 提供 libcsv 的 lycium 交叉编译脚本（HPKBUILD）与设备端测试入口（HPKCHECK），使该库可直接作为依赖被 App/HAP 引用（集成步骤见 docs/hap_integrate.md）。

破坏性变更

• 影响范围：无。本次只新增 community/libcsv/ 目录，不修改任何既有 API/配置/功能。
• 用户适配方案：不需要（不涉及旧版→新版替换步骤）。

测试步骤

1. 编译（Linux 宿主 + OpenHarmony SDK）：

   cd lycium
   ./build.sh libcsv
   

   产物：usr/libcsv/{armeabi-v7a,arm64-v8a,x86_64}/（头文件 + 库）。
2. 设备端用例（HPKCHECK 复用上游自带测试，交叉编译产物随载荷下发设备执行）：

   cd /data/tpc_c_cplusplus/thirdparty/libcsv/libcsv-3.0.3-<arch>-build/
   ./harness_smoke/libcsv_smoke
   

   三架构执行结果截图：docs/pic/arm64.png、docs/pic/armv7a.png、docs/pic/x86_64.png。
3. 应用工程集成目录截图：docs/pic/libcsv_install_dir.png（docs/hap_integrate.md 有集成步骤）。

另：本交付物已在未修改的社区 lycium（c64d7253）上重跑 ./build.sh libcsv 通过（三架构 build+install），证据见文末「附：证据明细」。

测试情况

• [√ ] 已通过本地完整测试（单元测试/集成测试）
• 已通过 CI 自动构建与测试
• [√ ] 已补充/更新对应的测试用例
• 已在目标环境（如 手机/平板）验证功能
• 已在最低兼容API版本验证可用性

合入前自检

• [x ] 不涉及非兼容性变更；若涉及，已通过相应评审。
• [x ] 不涉及性能或已进行性能测试且无性能劣化。
• [x ] 符合对应的编码规范。
• [x ] 无敏感信息泄露，如密码、密钥等。
• [x ] 不涉及文档更新，或已更新了文档。
• [x ] 针对可测试性要求，已增加必要的自测用例、合理的日志记录或Trace信息。
• [x ] 不存在非法的文件引入，包括图片和代码等