@harmonyos-arkts/d2h 0.1.19 → 0.1.21

package/skills/native-library-substitution/references/native-library-substitution.md

@@ -1,163 +0,0 @@
-# Native Library Substitution 单一映射表
-
-**数据版本**: 3.0.0
-**更新日期**: 2026-04-22
-
-## 数据概览
-
-| 统计项 | 数量 |
-|--------|------|
-| 总映射数 | 2678 |
-| 有安卓库的映射 | 1005 |
-| 鸿蒙原生库（无安卓库） | 1673 |
-| 唯一安卓库数 | 852 |
-| 唯一ohpm包数 | 2537 |
-
-## source_availability 分布
-
-| 状态 | 数量 | 说明 |
-|------|------|------|
-| COMMERCIAL_PUBLIC | 175 | 闭源商业SDK（来自工作簿） |
-| open_source | 2503 | 开源库 |
-| not_set | 0 | 未设置 |
-
-## source_type 分布
-
-| 来源类型 | 数量 | 说明 |
-|----------|------|------|
-| 鸿蒙原生库 | 1321 | 鸿蒙原生开发，无对应安卓库 |
-| TS/JS迁移库 | 790 | 从npm生态迁移 |
-| 安卓鸿蒙化库 | 432 | 直接从安卓库移植 |
-| C++/C鸿蒙化库 | 133 | 从C++生态迁移 |
-
-## category 分布
-
-| Category | 数量 | 说明 |
-|----------|------|------|
-| other | 1527 | 其他 |
-| ui | 370 | UI组件 |
-| utils | 213 | 工具类 |
-| network | 209 | 网络请求 |
-| media | 89 | 音视频 |
-| auth | 61 | 登录认证 |
-| notification | 60 | 推送通知 |
-| storage | 60 | 存储文件 |
-| location | 50 | 地图定位 |
-| analytics | 17 | 统计分析 |
-| payment | 16 | 支付 |
-| security | 4 | 安全加密 |
-| im | 1 | 即时通讯 |
-| social | 1 | 社交分享 |
-
-## 闭源库示例（COMMERCIAL_PUBLIC）
-
-| 安卓库 | 鸿蒙包 | install_command |
-|--------|--------|-----------------|
-| com.tencent.mm.opensdk:wechat-sdk-androi | @tencent/wechat_open_sdk | `ohpm install @tencent/wechat_open_sdk` |
-| com.sensorsdata.analytics.abtesting:Sens | @sensorsdata/analytics | `ohpm install @sensorsdata/analytics` |
-| cn.admobiletop.adsuyi.ad.adapter:tianmu | @admobile/tianmu | `ohpm install @admobile/tianmu` |
-| cn.admobiletop.adsuyi.ad:core | @admobile/tianmu | `ohpm install @admobile/tianmu` |
-| io.hyphenate:hyphenate-chat | @easemob/chatsdk | `ohpm install @easemob/chatsdk` |
-| com.aliyun.auikits.android:ARTCAICallKit | @aliyun_video_cloud/alivcsdk_artc | `ohpm install @aliyun_video_cloud/alivcsdk_artc` |
-| com.aliyun.iot.aep.sdk:push | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.rum:alibabacloud-android-rum- | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
-| com.alibaba.mtl:app-monitor-sdk | @alibabacloud_rum/harmony_sdk | `ohpm install @alibabacloud_rum/harmony_sdk` |
-| com.aliyun.ams:alicloud-apm-crash-analys | @aliyun/apm | `ohpm install @aliyun/apm` |
-| com.aliyun.dpa:oss-android-sdk | @aliyun/oss | `ohpm install @aliyun/oss` |
-| afservicesdk | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
-| com.alipay.sdk:alipaysdk-android | @cashier_alipay/cashiersdk | `ohpm install @cashier_alipay/cashiersdk` |
-| io.github.yidun:livedetect | @yidun/alive | `ohpm install @yidun/alive` |
-| io.github.aliyun-sls:aliyun-log-android- | @aliyun/logger | `ohpm install @aliyun/logger` |
-| com.aliyun.ams:alicloud-android-push | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
-| com.aliyun.ams:alicloud-android-third-pu | @aliyun/push | `ohpm install @aliyun/push` |
-| com.amap.api:3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.amap.api:location | @amap/amap_lbs_location | `ohpm install @amap/amap_lbs_location` |
-| com.amap.api:search | @amap/amap_lbs_search | `ohpm install @amap/amap_lbs_search` |
-| com.amap.api:3dmap-location-search | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.amap.api:navi-3dmap | @amap/amap_lbs_map3d | `ohpm install @amap/amap_lbs_map3d` |
-| com.umeng.umsdk:analytics | @umeng/analytics | `ohpm install @umeng/analytics` |
-| com.umeng.umsdk:common | @umeng/common | `ohpm install @umeng/common` |
-| BaiduLBS_Android | @bdmap/navi_map | `ohpm install @bdmap/navi_map` |
-| com.baidubce.mediasdk:brtc | @baiduplayer/baidurtcsdk | `ohpm install @baiduplayer/baidurtcsdk` |
-| com.getui:gtsdk | @getui/push | `ohpm install @getui/push` |
-| com.bonree.sdk.jar | @bonree/agent | `ohpm install @bonree/agent` |
-| com.tencent.bugly:crashreport | bugly | `ohpm install bugly` |
-
-*共 175 条闭源库映射*
-
-## 高置信度映射示例（安卓鸿蒙化库）
-
-| 安卓库 | 鸿蒙包 | category | install_command |
-|--------|--------|----------|-----------------|
-| AJCaptcha 安卓实现版本 | @scca/verification | other | `ohpm install @scca/verification` |
-| ARouter | @ohos/arouteronactivityresult | other | `ohpm install @ohos/arouteronactivityresult` |
-| ARouter | hrouter | other | `ohpm install hrouter` |
-| Android Beacon Library (AltBea | @ohos/beacon-library | other | `ohpm install @ohos/beacon-library` |
-| Android BottomSheet | @hld/bottomsheet | other | `ohpm install @hld/bottomsheet` |
-| Android Jetpack Paging3 | @jackiehou/experimental-paging | other | `ohpm install @jackiehou/experimental-paging` |
-| Android Room | @hzzmkjyxgs/zmwlthmosdb | other | `ohpm install @hzzmkjyxgs/zmwlthmosdb` |
-| Android TabLayout（com.google.a | @zyc/tablayout | other | `ohpm install @zyc/tablayout` |
-| Android XLog | @ohos-port/xlog-ts | other | `ohpm install @ohos-port/xlog-ts` |
-| Android-Debug-Database | @hadss/debug-db | other | `ohpm install @hadss/debug-db` |
-| AndroidImageEditor | @zhongjh/image_edit | other | `ohpm install @zhongjh/image_edit` |
-| AndroidUtilCode | @android_x/utilcode | other | `ohpm install @android_x/utilcode` |
-| AndroidUtilCode | @ilye/utilcode | other | `ohpm install @ilye/utilcode` |
-| AndroidUtilCode | @ranran/utilcode | other | `ohpm install @ranran/utilcode` |
-| AndroidVideoCache | @changjing/drm | media | `ohpm install @changjing/drm` |
-| AndroidVideoCache (com.danikul | @ohos/video-cache | media | `ohpm install @ohos/video-cache` |
-| Apache Batik | @ohos/xmlgraphicsbatik | other | `ohpm install @ohos/xmlgraphicsbatik` |
-| Apache Cordova Android | @boc/cordova | other | `ohpm install @boc/cordova` |
-| AppCan Android Engine | @appcan/engine | other | `ohpm install @appcan/engine` |
-| DBFlow | @ohos/dataorm | other | `ohpm install @ohos/dataorm` |
-
-*共 340 条高置信度安卓鸿蒙化库映射*
-
-## 鸿蒙原生库示例（无安卓库）
-
-| 鸿蒙包 | 组织 | category | install_command |
-|--------|------|----------|-----------------|
-| @pura/harmony-utils | pura | notification | `ohpm install @pura/harmony-utils` |
-| @pura/harmony-dialog | pura | ui | `ohpm install @pura/harmony-dialog` |
-| @ibestservices/ibest-ui | ibestservices | ui | `ohpm install @ibestservices/ibest-ui` |
-| @abner/refresh | abner | ui | `ohpm install @abner/refresh` |
-| @hzw/zrouter | hzw | other | `ohpm install @hzw/zrouter` |
-| cjcalendar |  | ui | `ohpm install cjcalendar` |
-| @hadss/hmrouter | hadss | other | `ohpm install @hadss/hmrouter` |
-| @esky/barrage | esky | media | `ohpm install @esky/barrage` |
-| @ibestservices/ibest-ui-v2 | ibestservices | ui | `ohpm install @ibestservices/ibest-ui-v2` |
-| @ohos/pulltorefresh | ohos | ui | `ohpm install @ohos/pulltorefresh` |
-| @mcui/mccharts | mcui | utils | `ohpm install @mcui/mccharts` |
-| @maple/navigationbarview | maple | location | `ohpm install @maple/navigationbarview` |
-| @abner/dialog | abner | ui | `ohpm install @abner/dialog` |
-| @zyl/wxcommonlibhar | zyl | payment | `ohpm install @zyl/wxcommonlibhar` |
-| @ibestservices/ibest-orm | ibestservices | storage | `ohpm install @ibestservices/ibest-orm` |
-| @ohasasugar/hp-richtext | ohasasugar | ui | `ohpm install @ohasasugar/hp-richtext` |
-| @zyl/commonlibhar | zyl | media | `ohpm install @zyl/commonlibhar` |
-| @abner/datastore | abner | storage | `ohpm install @abner/datastore` |
-| @visactor/harmony-vchart | visactor | other | `ohpm install @visactor/harmony-vchart` |
-| @liushengyi/smartdb | liushengyi | storage | `ohpm install @liushengyi/smartdb` |
-
-*共 1673 条鸿蒙原生库*
-
-## 数据结构
-
-每条映射记录包含15个字段：
-
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| android_lib | string/null | 安卓库标识符（鸿蒙原生库为null） |
-| android_platform | string | android / ios / ohos_native |
-| android_description | string/null | 安卓库功能描述 |
-| ohpm_package | string | 鸿蒙包名 |
-| ohpm_org | string | ohpm组织名 |
-| ohpm_description | string | 鸿蒙包功能描述 |
-| ohpm_keywords | array | 鸿蒙包关键词 |
-| ohpm_repo_url | string | 鸿蒙包源码仓库 |
-| ohpm_homepage | string | 鸿蒙包文档主页 |
-| source_type | string | 安卓鸿蒙化库/TS迁移库/鸿蒙原生库 |
-| source_availability | string | COMMERCIAL_PUBLIC/open_source |
-| confidence | string | high/medium/low |
-| install_command | string | ohpm install命令 |
-| category | string | media/network/notification等 |
-| inference_reason | string | 映射关系说明 |

package/skills/porting-cmake-native-libraries/SKILL.md

@@ -1,57 +0,0 @@
----
-name: porting-cmake-native-libraries
-description: 将 Android 工程中基于 CMakeLists.txt 的 C/C++ 库模块迁移并交叉编译为 HarmonyOS 的 .so/.a；分析平台条件分支和 Android Native API，输出报告，适配宏、Native 实现与 CMake，并验证产物。适用于有源码的原生库移植；不负责 N-API/JNI 绑定层重写或仅查询 ohpm 替代包。
----
-
-# CMake 原生库迁移
-
-交付可追溯的分析报告、源码与 CMake 修改、可复现的交叉编译命令及验证过的库文件。保持 Android 构建路径可用，优先复用平台无关核心。
-
-本技能可独立处理库项目。由迁移主 Agent 调用时，消费其提供的项目路径、工作区和任务边界，将结果返回主 Agent；不修改 AppGraph facts、Kernel 状态或自行推进应用迁移阶段。
-
-## 1. 确定编译范围
-
-读取项目及父目录适用的 `AGENTS.md`，检查现有改动。定位顶层及子目录 `CMakeLists.txt`、`.cmake`、Gradle `externalNativeBuild`、源文件、生成头文件、依赖库和导出头文件，梳理目标及传递依赖。
-
-从用户输入和项目配置确认：源码目录、目标库名、输出类型（SHARED/STATIC）、目标 ABI、SDK native 目录及版本、最低 API、构建配置、产物和报告目录。已有配置优先；无法推断的目标参数先询问，同时继续静态分析。`.so/.a` 表示按所需类型构建，不意味着擅自将所有目标同时生成两种类型。缺少 SDK 时仍交付分析与可执行的构建准备，明确记录未编译。
-
-构建目录按平台、ABI、配置隔离，不能复用 Android/宿主机 CMake cache。报告放在用户指定目录；否则放在源码外的专用迁移输出目录。已有迁移工作区时使用主 Agent 提供的产物位置，不自建 Kernel 状态文件。
-
-## 2. 分析并先输出报告
-
-按 [平台扫描与能力适配](references/platform-adaptation.md) 检查平台宏、CMake 条件、头文件、符号、链接库、预编译依赖及运行时平台假设。文本搜索只产生候选，结合条件上下文、目标依赖和实际编译命令判定；不能把未命中 `__ANDROID__` 当作无 Android 依赖。
-
-按 [报告与验收](references/report-and-build.md) 输出初始报告，再修改代码。每项记录文件和行号、所属目标、条件表达式、实际用途、处理方式、证据及未解决项。区分核心、平台适配层、JNI/N-API 绑定层。
-
-**N-API 层 C++ 代码暂不适配，标记为需要重写。** JNI/Java 桥接也不能通过改宏变成鸿蒙绑定。记录绑定接口、参数/所有权、线程与生命周期约束，留给独立重写任务。可将混合文件中的平台无关算法抽为核心，但不在本技能中实现新绑定。
-
-若绑定目标能与核心分离，仅在鸿蒙构建中排除绑定目标/源文件，并明确核心库的能力边界；若核心仍依赖绑定符号或 Java 服务，将相关目标标为阻塞。禁止用空函数、伪成功返回或忽略链接错误掩盖缺失功能。
-
-## 3. 适配宏与 Native 能力
-
-用实际 SDK 编译器和目标参数探测预定义宏，并检查 toolchain 设置的 CMake 平台变量。不要假设 `__OHOS__` 在所有 SDK 中都存在；不要手动定义 `__ANDROID__` 或把 `ANDROID` 设置为真来复用 Android 路径。
-
-对每个条件分支分别决策：纯 C/C++/可验证的 POSIX 逻辑可共享；Android 特有实现保留，另加鸿蒙实现；不支持的能力明确阻塞。注意 `__linux__` 等宽泛分支可能先命中，不能只在末尾追加鸿蒙分支。需要项目宏时，通过目标级 `target_compile_definitions` 定义，并与编译器保留宏区分。
-
-Native 替换以实际 SDK 头文件、库、官方文档及最小编译/链接验证为依据。记录最低 API、SysCap/设备约束、权限、线程、资源所有权、错误语义和行为差异。ArkTS API 或 ohpm 包不能直接当成 C/C++ 链接接口；只有 ArkTS 方案的能力留作上层/绑定重写依赖。
-
-## 4. 修改 CMake 并交叉编译
-
-按 [构建与验证流程](references/report-and-build.md) 操作：
-
-- 使用目标 SDK 提供的 `ohos.toolchain.cmake`，不手工拼接一套猜测的 sysroot/compiler 配置。
-- 以平台条件选择源文件、头文件和链接库；使用目标级配置，保留已有 Android 路径。只有确认配置有效时才用 `CMAKE_SYSTEM_NAME STREQUAL "OHOS"` 分流。
-- 清理鸿蒙路径中的 NDK、Gradle、Android sysroot、`log/android/jnigraphics` 等链接项，按已验证的能力映射替换。不能全局删除其他平台所需依赖。
-- 所有参与链接的第三方库必须具有匹配的鸿蒙 ABI、API 与 C++ 运行时；Android ELF 即使 CPU 相同也不能直接复用。无源码或无兼容二进制则记录阻塞。
-- 明确 C++ 标准、异常/RTTI、可见性、导出接口、PIC 和运行时依赖；静态库进入共享库的对象需要 PIC。不要把 `BUILD_SHARED_LIBS` 当成覆盖显式 STATIC/SHARED 目标的开关。
-- 检查 version script、导出列表和符号可见性是否绑定 Android/JNI 入口；鸿蒙核心库应导出其实际消费接口，不能直接沿用仅导出 `JNI_OnLoad` 的规则。
-
-逐目标、逐 ABI 配置和构建，保留完整命令、退出码和日志。修复有证据的源码、配置或依赖问题后重试；缺 SDK、不可获得的依赖或仅绑定层重写才能解决的问题应报告阻塞，而非反复试编或静默禁用功能。
-
-## 5. 验证并交付
-
-检查本次构建产物、架构、符号、动态依赖、静态归档成员和最小消费端链接。构建成功、链接验证成功、设备运行成功是不同状态；无法在鸿蒙设备运行时明确标注未验证。只交付通过对应检查的产物，失败目标单独列出。
-
-拆分算法核心时，按参考文档进行原实现与迁移实现的固定输入对照。记录接口契约与行为差异，不能为让样例通过而静默收窄输入范围或改变资源生命周期。
-
-更新初始报告为最终报告，给出修改摘要、产物绝对路径、ABI/API/SDK、重现命令、测试结果、运行时依赖与绑定重写清单。不要将“核心库编译通过”描述为“应用或 N-API 迁移完成”。

package/skills/porting-cmake-native-libraries/references/platform-adaptation.md

@@ -1,49 +0,0 @@
-# 平台扫描与能力适配
-
-## 搜索候选
-
-在项目目录使用 `rg --files` 发现源码与构建文件，再搜索以下候选；检查依赖源码、生成配置与宏别名。忽略构建缓存，无法访问的依赖明确标为扫描缺口。
-
-```sh
-rg -n '__ANDROID__|__ANDROID_API__|ANDROID_NDK|ANDROID_ABI|CMAKE_SYSTEM_NAME|__linux__|__OHOS__' .
-rg -n 'jni\.h|JNIEnv|JavaVM|JNI_OnLoad|Java_|RegisterNatives|napi_|node_api|NAPI_MODULE' .
-rg -n 'android/|sys/system_properties|__android_|AAsset|ANativeWindow|ALooper|AHardwareBuffer|AAudio|AMedia|OpenSL|GLES|EGL' .
-rg -n 'find_package|find_library|target_link_libraries|IMPORTED|add_subdirectory|FetchContent|ExternalProject|try_run|pkg_check_modules' -g CMakeLists.txt -g '*.cmake' .
-```
-
-补查 `#ifdef ANDROID`、自定义 `PLATFORM_*`、`#if !defined(...)`、嵌套/组合条件、CMake `if(ANDROID)`、生成器表达式和 Gradle 传入的 defines。动态加载字符串、硬编码 Android 路径、Bionic 扩展、汇编/CPU 优化、Java 回调及传递依赖也可能形成平台耦合。
-
-扫描还需覆盖 `AndroidBitmap_*`、`AndroidBitmapInfo`、`android/bitmap.h` 等直接 API/类型依赖。平台专用源文件可能完全没有条件宏；报告应分别记录“平台宏命中情况”和“直接平台依赖”，不能相互替代。
-
-不能机械替换 `__ANDROID__` 为鸿蒙宏，或给每个条件都追加 `|| defined(__OHOS__)`。对当前目标以编译器预处理输出和 `compile_commands.json` 验证命中的源文件与分支；对其他配置记录覆盖范围。
-
-## Native 能力候选表
-
-以下是检索方向，不是已验证的一对一替换承诺。按用户目标 SDK/API 查询官方 C API，并在本地头文件和库中核对符号；报告中保存查证链接和 SDK 版本。
-
-| Android 依赖 | 鸿蒙检索方向 | 必须检查的差异 |
-| --- | --- | --- |
-| `__android_log_*` / `android/log.h` | HiLog Native API | 格式、隐私标记、domain/tag、链接库 |
-| `AAssetManager` | Native ResourceManager / RawFile | 资源包语义、管理器初始化、句柄释放；初始化可能依赖上层 |
-| `ANativeWindow` / Surface | NativeWindow / NativeBuffer | Surface 来源、像素格式、buffer 生命周期、线程 |
-| AAudio / OpenSL ES | OHAudio | 回调模型、低延迟支持、流状态和设备能力 |
-| MediaCodec / `AMedia*` | Native AVCodec / AVFormat 等 | 编解码格式、异步回调、缓冲区所有权、最低 API |
-| Bitmap / `jnigraphics` | Native Image / PixelMap | 数据布局、stride、alpha、对象来源 |
-| EGL / GLES | SDK 提供的 EGL / GLES | 扩展、窗口接口、上下文线程与链接依赖 |
-| 属性、Looper、Binder、Bionic 扩展 | 公共 C API / 已支持的 POSIX / 平台抽象 | 可能无公开等价能力，不能依赖内部系统接口 |
-| JNI / Java 服务 / N-API | 核心接口拆分与绑定重写清单 | 不在本技能中重写绑定，不提供伪实现 |
-
-优先保持行为与公开 C/C++ 接口。能使用目标 SDK 已支持的标准接口时，不必引入平台专有能力。需要上层提供资源管理器、窗口或上下文的接口，在报告中明确初始化契约；不能凭空构造句柄。
-
-## 图像缓冲区适配
-
-涉及 Bitmap/PixelMap 时，分别核对接口要求的**输入缓冲区格式**与**目标对象格式**，以及 stride、通道顺序、位深、alpha 和字节序；不能从目标格式选项反推输入格式。例如，若选定 SDK 的创建接口要求 BGRA8888 输入，原 RGB565 数据必须先显式转换，不能只设置格式枚举后直接传入。
-
-确认输入缓冲区是否复制、何时可释放、输出句柄由谁释放，以及是否需要可编辑对象。原位锁定/写入改为创建新对象会改变对象身份、分配次数和拷贝成本，应作为行为差异报告并验证。锁定或创建失败后停止使用该资源，传播真实错误；资源转换不等于完成 JNI/N-API 绑定重写。
-
-资料入口：
-
-- [OpenHarmony NDK 构建概述](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/napi/build-with-ndk-overview.md)
-- [华为三方库适配指南](https://developer.huawei.com/consumer/cn/doc/games-guides/games-2dx-adapt-third-library-0000002290527381)
-
-OpenHarmony 文档可用于理解工具链，但不代表用户目标 HarmonyOS SDK 的每个 API 都可用；最终以选定发行版的文档与 SDK 为准。

package/skills/porting-cmake-native-libraries/references/report-and-build.md

@@ -1,60 +0,0 @@
-# 报告与构建验收
-
-## 报告内容
-
-初始分析与最终结果使用同一份报告，保留初始发现及最终处置。建议结构：
-
-1. **范围**：源码版本/本地改动、CMake 入口、目标、输出类型、依赖图摘要、扫描缺口。
-2. **环境**：SDK 路径/版本、API、ABI、工具链、CMake/编译器版本、构建配置、预定义平台宏证据。
-3. **问题明细表**：编号、文件:行号、目标、条件/符号、用途、迁移策略、证据、验证结果、状态。
-4. **绑定重写清单**：N-API/JNI 文件、导出接口、核心依赖、生命周期与线程要求、排除的目标和影响。
-5. **修改及构建**：源码/CMake 修改摘要、每个目标和 ABI 的命令、退出码、日志路径。
-6. **产物表**：绝对路径、目标、类型、ABI、API、SDK、配置、哈希、公共头文件、动态/静态传递依赖、验证级别。
-7. **剩余工作**：阻塞项、行为差异、未执行检查、设备验证与绑定重写。
-
-问题状态可用 `pending / adapted / verified / blocked / rewrite-required`。产物验证分别记录 `configured / built / link-verified / runtime-verified`，失败记录具体阶段，不用单一“成功”覆盖所有层次。
-
-## 配置与构建
-
-先读取实际 SDK 的 `native/build/cmake/ohos.toolchain.cmake` 及其包含文件，确认 ABI、API、运行时和平台变量的支持方式。下面仅为命令形状；将变量设置为已确认的路径和目标，API/运行时选项按该 SDK 定义补充，不盲目照抄不存在的变量。
-
-```sh
-cmake -S "$source_dir" -B "$build_dir" \
-  -DCMAKE_TOOLCHAIN_FILE="$sdk_native/build/cmake/ohos.toolchain.cmake" \
-  -DOHOS_ARCH="$target_abi" \
-  -DCMAKE_BUILD_TYPE=Release \
-  -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
-cmake --build "$build_dir" --target "$library_target" --parallel
-```
-
-多配置生成器应使用对应的 `--config`。从 cache、配置输出和实际编译命令确认 compiler、target triple、sysroot、架构及 API；配置参数被忽略的警告必须处理。用同一编译器及编译参数执行预定义宏探测（如 `-dM -E -x c++` 读取空输入），不要用宿主机 clang 的结果推断目标宏。
-
-检查 `find_package`、pkg-config、IMPORTED targets 和嵌套构建是否误取宿主机/Android 库。`ExternalProject` 等独立配置的依赖要显式传递正确工具链；宿主机代码生成工具与目标库分开构建。交叉编译的 `try_run` 不能直接在宿主机执行目标程序，也不能伪造通过结果。
-
-对项目现有显式 SHARED/STATIC 目标保留类型。用户确需两类产物时，建立独立目标或使用项目已支持的选项，处理输出命名、公共宏与 PIC；不要为无关目标改变全局行为。
-
-检查原项目的 version script（如 `.map.txt`）、导出列表、`-fvisibility` 和 `extern "C"`。只导出 `JNI_OnLoad` 的共享库规则不能用于新的核心 C 接口；按平台保留原规则，为鸿蒙目标声明所需接口，并核验最终动态符号表。库能生成但消费端无法链接，仍属失败。
-
-若 SDK 注入的参数触发 `-Werror`，保留首次失败日志，定位参数来源并确认其不影响目标架构、sysroot 或 ABI。优先修正配置；确属无效的冗余参数警告时，可仅对受影响目标使用对应的 `-Wno-error=<具体警告>`，保留警告可见。不预置通用抑制开关，不全局关闭 `-Werror`，不忽略 API 可用性、源码错误或未解析符号。
-
-## 核心行为对照
-
-拆分可独立运行的算法时，以固定源码版本的原实现作为对照，使用相同输入比较输出。可以仅提取原算法及其必要数据结构作为宿主机基线，但要说明提取范围；不要用伪造的平台 API 成功结果代替基线。图像算法适合覆盖奇偶尺寸、带 padding 的 stride、合法对齐、固定时间/参数和缓冲区边界，按算法特性选择逐字节或有依据的误差比较。必要时启用地址/未定义行为检查。
-
-宿主机对照证明核心拆分的一致性，不证明鸿蒙 PixelMap、日志、绑定层或设备行为正确。验证记录区分核心对照、目标链接和目标运行；没有真实平台宏组合或 STATIC 目标的样例不能证明这些场景已覆盖。
-
-不要将验证样例的临时时间/尺寸上限引入迁移接口作为默认限制。发现原算法数值范围或资源约束时，应明确原有契约、修复策略及新增限制的影响；未解决的行为差异不能归入完整兼容。
-
-## 产物验收
-
-- 确认文件由本次构建产生，记录 SHA-256，避免把旧库作为成功结果。
-- 使用 SDK 的 `llvm-readelf`、`llvm-nm`、`llvm-ar` 等可用工具；记录命令和结果。
-- `.so`：检查 ELF machine/class、SONAME（适用时）、导出符号、DT_NEEDED、RPATH/RUNPATH 和未定义符号。动态库正常可有未定义导入，逐项确认提供者；不能要求全部符号为空，也不能忽略无法解析的 Android/JNI 依赖。
-- `.a`：列出归档并验证各对象架构；LLVM bitcode/LTO 成员使用兼容工具链验证。归档创建成功不等于链接成功，必须用目标工具链构建最小消费端，调用预期公共入口并链接所需传递依赖。确认所有需交付对象被覆盖；适用时加 whole-archive 链接检查，避免仅验证未拉取任何成员的空程序。
-- 检查产物架构只是必要条件：同 CPU 的 Android ELF 不能据此判定兼容。还要验证工具链来源、运行时、目标 API、动态依赖和消费端链接。
-- 共享库也执行最小消费端链接检查；只有显式授权并具有设备条件时执行设备加载/功能测试，不在宿主机运行目标 ELF。
-- 公共头文件、依赖库及 C++ 运行时部署要求随产物清单交付；报告未覆盖的 ABI、配置与平台分支。
-
-解析动态导入时，按实际链接搜索路径查找提供者：C++ 运行时可能位于 SDK 的 LLVM 库目录，而非 sysroot。区分系统库、应用需打包的运行时和仅供链接的 SDK stub；找到符号提供者仅证明链接条件，不允许将 stub 当运行时交付。排查交付物中的宿主机构建路径；需要相对加载路径时，按部署布局设置并验证。
-
-有 Android 编译环境时对受影响目标执行回归；没有时明确写“Android 构建未验证”，仍检查条件分流及原路径是否完整。SDK/设备缺失属于未执行验证，不能标记通过。