@harmonyos-arkts/d2h 0.1.20 → 0.1.22

package/skills/cpp/d2h-native-library-verify/SKILL.md

@@ -0,0 +1,111 @@
+---
+name: d2h-native-library-verify
+description: Android 功能场景 → 鸿蒙 so/a 能力验证（按功能，从 so/a 导出符号检测能力，非 .d.ts 声明）。从 Android 源码提取功能场景（或消费 analyse 产出的 feature-manifest.json），用 llvm-nm 提取鸿蒙 so/a 的导出符号（.so 动态符号 / .a 全局符号），据此检测真实能力（avcodec/avformat/ff_libx264_encoder/ff_rtmp_protocol/FFAudioPlayer/OpenSSL/LAME 等）——有符号才判有能力，不编造；对每个功能场景判定可实现/部分实现/无法实现，NAPI 可基于真实符号自己写桥接，生成可编译运行的鸿蒙测试 demo（Hypium 断言用例）；连真机时自动触发「真机验证门禁」（准备 demo → 编译 → 签名 → 安装 → 运行 → 采集证据），报告三态标注（✅通过 / ❌失败 / ⚠未真机验证）。当用户要求「验证鸿蒙 so 能不能满足 Android 功能」「无头文件/index 文件校验 so 能力」「JNI 转 NAPI」「生成能力验证报告/鸿蒙测试 demo」时触发。
+---
+
+# Android 功能场景 → 鸿蒙 so/a 能力验证（按功能，从 so 导出符号检测能力）
+
+## 核心理念
+
+不按 Android 每个 JNI API 做 1:1 映射，也不依赖 `.d.ts` 声明文件（声明可能和实际 so 不符）。
+能力判定的唯一依据是 **so/a 的导出符号表**——这是"事实"，不是声明、不是 AI 编造。
+
+```
+Android 用 so/a 实现的功能（7 个场景）
+  → 用 llvm-nm 提取鸿蒙 so/a 导出符号（.so 动态符号 / .a 全局符号）
+    → 从符号检测真实能力（avcodec_/avformat_/ff_libx264_encoder/ff_rtmp_protocol/FFAudioPlayer/OpenSSL…）
+      → 能力 ⊆ 功能所需（requires）? → 可实现/部分实现/无法实现
+        ├─ 能实现 → NAPI 可基于真实符号自己写桥接 → 生成 Hypium demo
+        └─ 不能实现 → 真正无法实现（so 未导出对应符号）
+  → 连真机 → 自动触发「真机验证门禁」（编译+安装+运行+采集 14 个用例）
+```
+
+## 用法
+
+```bash
+# 能力验证 + NAPI 方案 + demo 测试用例（--dts 仅作参考，可选）
+python3 scripts/verify-ohos-native.py --android <工程> --ohos <so或.a> \
+    --manifest <feature-manifest.json>
+
+# 连真机时自动触发真机验证门禁（无需 --device，自动 hdc list targets 检测）
+python3 scripts/verify-ohos-native.py --android <工程> --ohos <so> \
+    --manifest <manifest.json> --media-source <带media图标的工程>
+
+# 显式指定设备 + demo 工程
+python3 scripts/verify-ohos-native.py ... --device <序列号> --demo <demo工程> --media-source <工程>
+```
+
+`--ohos` 可传单个文件或目录；目录会收集 `.so` 和 `.a`。
+
+## 能力检测（核心）
+
+用 `llvm-nm`（DevEco SDK 自带，`find_elf_nm()` 自动定位）提取导出符号：
+
+| 库类型 | 命令 | 提取什么 |
+|---|---|---|
+| `.so` | `llvm-nm -D --defined-only --extern-only` | 动态导出符号（.dynsym） |
+| `.a` | `llvm-nm --defined-only` | 全局定义符号（类型大写 T/D/B/R；ar 归档无动态符号表） |
+
+`CAPABILITY_RULES`（31 项）定义「能力名 → 符号名正则」。命中任一符号即证明 so/a 真实具备该能力：
+
+```
+FFmpeg：avcodec_* avformat_* avfilter_* swscale_* swresample_* avio_*
+编码器：H.264(ff_libx264_encoder/x264_*)  AAC(ff_aac_encoder/faacEnc)  AV1(ff_libaom/libaom)  MP3(lame_*)
+协议/封装：RTMP RTSP HTTP FLV MP4 MPEG-TS HLS
+NAPI：FFAudioPlayer FFAudioWriter FFAbortSignal FFmpeg
+OpenSSL：AES RSA X509 TLS/SSL EVP SHA BN CRYPTO ossl
+其他：AMR zlib libcurl
+```
+
+实测（FFmpegAndroid）：`libffmpeg.so` 26753 符号→31 项能力；`libx264.a`→H.264；`libfaac.a`→AAC。
+
+## 判定模型
+
+每个功能场景在 `FEATURE_PLANS` 里声明 `requires`（所需能力），由 `judge_feature()` 用检测到的能力比对：
+
+- **可实现**：requires 全部命中 so 导出符号
+- **部分实现**：部分命中（如 VideoPlayer 滤镜命中、视频渲染未命中）
+- **无法实现**：requires 全不命中（如「视频播放/渲染」「音频采样回调」so 未导出对应符号）
+
+**不编造**：`视频播放/渲染`、`音频采样回调` 等能力不在 `CAPABILITY_RULES`（so 确实无此符号），检测不到就诚实判「无法实现」。plan 里的 NAPI 名用 `verify_plan_napi()` 验证对应能力是否被符号证实——`✓ 符号证实` 才可写桥接，`✗ 未证实` 不能编造。
+
+## 真机验证门禁（连真机自动触发）
+
+静态判定是「推断」，真机验证才是「证据」。verify 脚本自动 `hdc list targets` 检测设备——**连真机就自动触发真机验证门禁**，不连就诚实标注「未真机验证」。
+
+门禁三态（报告顶部卡片 + `summary["真机验证门禁"]`）：
+
+| 状态 | 条件 | 卡片 |
+|---|---|---|
+| ✅ 通过 | 设备连接 + 全部用例通过 | 绿色 `14/14 真机验证通过` |
+| ❌ 失败 | 设备连接 + 有用例失败 | 红色 `N/14 真机验证失败` |
+| ⚠ 未验证 | 无设备连接 | 黄色 `— 未真机验证` |
+
+自动编排链路（`device-verify.py`）：
+
+```
+① 准备 demo 工程（复制模板 + 补 media 图标 + 生成测试 wav + 集成测试用例 + 替换待测 so）
+② ohpm install @sj/ffmpeg
+③ hvigorw 编译 app + ohosTest（模板自带签名材料，自动签名）
+④ hdc install 两个 HAP
+⑤ aa test 运行 Hypium 用例
+⑥ hilog 采集 NATIVE_TEST → run.log → 回填报告（期望 vs 真实结果）
+```
+
+## 产出
+
+- `capability-report.html/json` — 能力验证报告（so 符号→能力清单 + 功能判定 + 方案 + 真机验证门禁状态）
+- `napi-plans/*.md` — 每功能场景一份 NAPI 实现方案（含 so 符号验证标记）
+- `demo-tests/FFmpegVerify.test.ets` — 按功能场景组织的 Hypium 测试用例（文件产物断言）
+- `verify-evidence/run.log` — 真机运行日志（`[NATIVE_TEST]` 格式，供门禁判定）
+
+
+## 参考文件
+
+- [scripts/verify-ohos-native.py](scripts/verify-ohos-native.py) — 主脚本（能力检测 + 判定 + demo 生成 + 真机验证门禁编排）
+- [scripts/device-verify.py](scripts/device-verify.py) — 真机验证编排（准备 demo → 编译 → 安装 → 运行 → 采集）
+- [scripts/native_common.py](scripts/native_common.py) — 共享模块（工具发现 + 能力检测 + demangle + 前缀聚类）
+- [references/demo-project-template/](references/demo-project-template/) — demo 工程完整模板
+- [references/demo-build-sign-run.md](references/demo-build-sign-run.md) — 构建签名运行流程
+- [references/hypium-test-template.md](references/hypium-test-template.md) — Hypium 用例模板
+- [references/demo-template.md](references/demo-template.md) — demo 生成规范

package/skills/cpp/d2h-native-library-verify/references/demo-build-sign-run.md

@@ -0,0 +1,67 @@
+# Demo 构建 · CLI 自动签名 · 部署运行（无头环境）
+
+本文件固化 `d2h-native-library-verify` demo 验证的**无 DevEco Studio 交互**构建/签名/运行链路。每一步都在真实环境验证过。
+
+## 前置
+
+- DevEco Studio 已安装（提供 hvigor 工具链 + SDK + 签名工具）
+- 鸿蒙真机/模拟器已连接：`hdc list targets` 可见设备
+- demo 工程已按 [demo-template.md](demo-template.md) 建好（含 `@sj/ffmpeg` 等 ohpm 依赖、验证页）
+
+## 一、构建（hvigor headless）
+
+DevEco 的 hvigor 插件不在 ohpm 仓库，必须用 DevEco 自带的 hvigor 入口：
+
+```bash
+export DEVECO_SDK_HOME="/Applications/DevEco-Studio.app/Contents/sdk"
+node "/Applications/DevEco-Studio.app/Contents/tools/hvigor/bin/hvigorw.js" \
+  --mode module -p product=default assembleHap
+```
+
+产物：`entry/build/default/outputs/default/entry-default-unsigned.hap`
+
+## 二、CLI 自动签名（关键）
+
+鸿蒙安装强制签名（未签名 HAP 报 `no signature file` code 9568320）。**无头复用的正确姿势**：
+
+DevEco 自动签名材料在本机 `~/.ohos/config/<项目名>_<hash>.{cer,p12,p7b}`，**绑定 bundleName + 设备 UDID**。三要素：
+
+| 材料字段 | 说明 |
+|----------|------|
+| `certpath` (.cer) / `storeFile` (.p12) | 调试证书（keyAlias 固定 `debugKey`） |
+| `profile` (.p7b) | Provisioning Profile，**绑定 bundleName + 设备** |
+| `keyPassword` / `storePassword` | DevEco 加密存储的密码，hvigor 本地可解密（**直接复用原文，勿改**） |
+
+复用步骤：
+
+1. 找本机任一已自动签名的工程（如 `ProtobufDemoOhos`）的 `build-profile.json5`，完整复制其 `signingConfigs` 数组；
+2. 把该数组填入 demo 工程的 `build-profile.json5` 的 `"app.signingConfigs"`；
+3. 把 demo 的 `AppScope/app.json5` 的 `bundleName` 改成与 `.p7b` profile 绑定的 bundleName（否则安装时签名校验失败）；
+4. 重新 `assembleHap` → 产物变为 `entry-default-signed.hap`。
+
+> 注意：keyPassword/storePassword 是 16 进制密文（`0000001b...` 开头），**不要试图解密或改写**，hvigor 签名任务会本地解密。
+
+## 三、安装与启动
+
+```bash
+hdc -t <设备序列号> install -r entry/build/default/outputs/default/entry-default-signed.hap
+hdc -t <设备序列号> shell aa start -a EntryAbility -b <bundleName>
+```
+
+## 四、运行采集（无 UI 交互）
+
+让验证页在 `aboutToAppear` 自动执行全部用例（见 [demo-template.md](demo-template.md)），并把 `EntryAbility.loadContent` 直接指向验证页，则启动即触发：
+
+```bash
+hdc -t <设备> shell hilog -r          # 清空日志
+hdc -t <设备> shell aa start -a EntryAbility -b <bundleName>
+sleep 5
+hdc -t <设备> shell "hilog -x" | grep NATIVE_VERIFY   # hilog -x 转存当前缓冲后退出
+```
+
+把采集到的日志文件交给 `verify-ohos-native.py --collect-diff` 生成 `functional_diffs[]` 草稿。
+
+## 五、真实链路验证记录（FFmpegAndroid → @sj/ffmpeg）
+
+- 构建 → CLI 签名 → 安装 → 启动 → 采集，全程无 DevEco Studio 交互
+- 采集结果：`ffmpeg -version` = **8.0.1**、`ffprobe -version` = **8.0.1**（Android 侧基线 n6.0.1-109）→ 版本差异写入功能差异清单

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/AppScope/app.json5

@@ -0,0 +1 @@
+{"app":{"bundleName":"com.example.protobufdemo","vendor":"example","versionCode":1000000,"versionName":"1.0.0","icon":"$media:app_icon","label":"$string:app_name"}}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/AppScope/resources/base/element/string.json

@@ -0,0 +1 @@
+{"string":[{"name":"app_name","value":"FFmpegVerify"}]}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/README.md

@@ -0,0 +1,25 @@
+# Demo 工程完整模板
+
+重建 demo 工程时**必须一次性复制全部文件**——不允许"只写测试不写验证页"的部分构建。
+
+## 必须同时存在的文件清单（缺一不可）
+
+| 文件 | 作用 | 漏掉的症状 |
+|------|------|-----------|
+| `EntryAbility.ets` → loadContent **pages/NativeVerifyDemo** | 启动直接进验证页 | 打开只显示 Index 文字 |
+| `NativeVerifyDemo.ets` | 14 项验证卡片（V2 状态、红绿结果） | 无界面 |
+| `main_pages.json` 含 **pages/NativeVerifyDemo** | 页面注册 | 路由报错 |
+| `FFmpegVerify.test.ets` | Hypium 断言测试 | `aa test` 无用例 |
+| `List.test.ets` | 测试聚合 | 测试不执行 |
+| `ohosTest/module.json5` + `entry/build-profile.json5` 含 `ohosTest` target | 测试 HAP 产出 | 不生成测试 HAP |
+
+## 重建步骤（原子操作，不可拆分）
+
+```bash
+# 1. 复制全部模板文件到目标目录
+# 2. ohpm install @sj/ffmpeg
+# 3. 替换 oh_modules 里的 so 为待测 so
+# 4. hvigorw assembleHap（app）
+# 5. hvigorw --mode module -p module=entry@ohosTest assembleHap（test）
+# 6. CLI 签名 → 安装两个 HAP → aa test
+```

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/build-profile.json5

@@ -0,0 +1,24 @@
+{
+  "app":{"signingConfigs":[
+      {
+        // 签名材料占位：真机验证时按 references/demo-build-sign-run.md 从本机
+        // ~/.ohos/config/<已自动签名工程>.{cer,p12,p7b} 复制（DevEco 自动签名材料，
+        // 绑定 bundleName + 设备 UDID），bundleName 需与 .p7b profile 一致。
+        name: 'default',
+        type: 'HarmonyOS',
+        material: {
+          certpath: '<SIGNING_DIR>/<project>.cer',
+          keyAlias: 'debugKey',
+          keyPassword: '<KEY_PASSWORD>',
+          profile: '<SIGNING_DIR>/<project>.p7b',
+          signAlg: 'SHA256withECDSA',
+          storeFile: '<SIGNING_DIR>/<project>.p12',
+          storePassword: '<STORE_PASSWORD>',
+        },
+      },
+    ],
+    "products":[{"name":"default","signingConfig":"default","targetSdkVersion":"5.0.5(17)","compatibleSdkVersion":"5.0.0(12)","runtimeOS":"HarmonyOS",
+      "buildOption":{"strictMode":{"caseSensitiveCheck":true,"useNormalizedOHMUrl":true}}}],
+    "buildModeSet":[{"name":"debug"},{"name":"release"}]},
+  "modules":[{"name":"entry","srcPath":"./entry","targets":[{"name":"default","applyToProducts":["default"]}]}]
+}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/build-profile.json5

@@ -0,0 +1 @@
+{"apiType":"stageMode","buildOption":{},"buildOptionSet":[{"name":"release","arkOptions":{"obfuscation":{"ruleOptions":{"enable":false}}}}],"targets":[{"name":"default"},{"name":"ohosTest"}]}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/hvigorfile.ts

@@ -0,0 +1,2 @@
+import { hapTasks } from '@ohos/hvigor-ohos-plugin';
+export default { system: hapTasks, plugins: [] }

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/oh-package.json5

@@ -0,0 +1 @@
+{"name":"entry","version":"1.0.0","dependencies":{},"devDependencies":{"@ohos/hypium":"1.0.25"}}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/ets/entryability/EntryAbility.ets

@@ -0,0 +1,5 @@
+import { UIAbility } from '@kit.AbilityKit';
+import { window } from '@kit.ArkUI';
+export default class EntryAbility extends UIAbility {
+  onWindowStageCreate(ws: window.WindowStage) { ws.loadContent('pages/NativeVerifyDemo'); }
+}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/ets/pages/Index.ets

@@ -0,0 +1,3 @@
+@Entry
+@Component
+struct Index { build() { Column(){Text('FFmpegVerify').fontSize(24)}.justifyContent(FlexAlign.Center).width('100%').height('100%') } }

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/ets/pages/NativeVerifyDemo.ets

@@ -0,0 +1,276 @@
+import { FFmpeg, FFAbortController, FFAudioPlayer } from '@sj/ffmpeg';
+import { common } from '@kit.AbilityKit';
+import { fileIo as fs } from '@kit.CoreFileKit';
+
+const BUILD_TS = 'v2-full-14cases';
+
+@ObservedV2
+class ApiCase {
+  @Trace title: string;
+  @Trace scenario: string;
+  @Trace expected: string;
+  @Trace actual: string;
+  @Trace status: string; // pass / fail / pending
+  constructor(title: string, scenario: string, expected: string) {
+    this.title = title;
+    this.scenario = scenario;
+    this.expected = expected;
+    this.actual = '-';
+    this.status = 'pending';
+  }
+}
+
+@Entry
+@ComponentV2
+struct NativeVerifyDemo {
+  @Local cases: ApiCase[] = [
+    new ApiCase('01 命令执行', 'FFmpegCmd.handle → FFmpeg.execute', '含 ffmpeg version'),
+    new ApiCase('02 探测执行', 'FFmpegCmd.handleProbe → FFmpeg.execute', '含 ffprobe version'),
+    new ApiCase('03 任务取消', 'FFmpegCmd.cancelTaskJni → FFAbortController', 'Promise 中断'),
+    new ApiCase('04 音频播放', 'AudioPlayer.native_play → FFAudioPlayer', 'playWhenReady=true'),
+    new ApiCase('05 获取时长', 'AudioPlayer.native_get_duration → FFAudioPlayer', 'duration>0（wav 为 2000ms）'),
+    new ApiCase('06 获取位置', 'AudioPlayer.native_get_position → FFAudioPlayer', 'currentTime>=0'),
+    new ApiCase('07 重新播放', 'AudioPlayer.native_again → FFAudioPlayer', 'seek(0) 后可播放'),
+    new ApiCase('08 视频转码', 'VideoPlayer.executeTranscode → FFmpeg.execute', 'm4a 产物文件生成'),
+    new ApiCase('09 重跑命令', 'VideoPlayer.again → FFmpeg.execute', '重复执行输出相同'),
+    new ApiCase('10 播放暂停', 'VideoPlayer.playAudio → FFAudioPlayer', 'pause 后 playWhenReady=false'),
+    new ApiCase('11 数据源探测', 'Retriever.native_setDataSource → ffprobe', '输出非空'),
+    new ApiCase('12 元数据提取', 'Retriever.native_extractMetadata → ffprobe', '输出含 format'),
+    new ApiCase('13 截帧', 'Retriever.native_getFrameAtTime → ffmpeg', 'frame.jpg 生成'),
+    new ApiCase('14 缩放截帧', 'Retriever.native_getScaleFrameAtTime → ffmpeg', '32x32 frame_small.jpg 生成'),
+  ];
+  @Local wav: string = '';
+  @Local ready: boolean = false;
+
+  aboutToAppear(): void {
+    const ctx = getContext(this) as common.UIAbilityContext;
+    this.setup(ctx).then(() => {
+      this.wav = `${ctx.filesDir}/ffmpeg_test.wav`;
+      this.ready = true;
+      this.runAll(ctx);
+    });
+  }
+
+  async setup(ctx: common.UIAbilityContext): Promise<void> {
+    try {
+      const raw = await ctx.resourceManager.getRawFileContent('ffmpeg_test.wav');
+      const f = fs.openSync(`${ctx.filesDir}/ffmpeg_test.wav`, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);
+      fs.writeSync(f.fd, raw.buffer);
+      fs.closeSync(f);
+    } catch (e) {
+      console.info(`[NATIVE_VERIFY] setup: ${JSON.stringify(e)}`);
+    }
+  }
+
+  runAll(ctx: common.UIAbilityContext): void {
+    this.exec(0, ['ffmpeg', '-version']);
+    this.exec(1, ['ffprobe', '-version']);
+    this.abort(2);
+    this.audio(3, 'play');
+    this.audio(4, 'duration');
+    this.audio(5, 'position');
+    this.audio(6, 'replay');
+    this.transcode(7);
+    this.exec(8, ['ffmpeg', '-version']);
+    this.audio(9, 'pause');
+    this.probe(10, false);
+    this.probe(11, true);
+    this.frame(12, false);
+    setTimeout(() => { this.frame(13, true); }, 3000);
+  }
+
+  exec(i: number, cmd: string[]): void {
+    this.cases[i].actual = '运行中...';
+    let out = '';
+    FFmpeg.execute(cmd, {
+      logCallback: (m: string) => { out += m; },
+      outputCallback: (m: string) => { out += m; },
+    }).then(() => {
+      const ok = out.includes('version');
+      this.cases[i].actual = out.slice(0, 60);
+      this.cases[i].status = ok ? 'pass' : 'fail';
+    }).catch((e: Error) => {
+      this.cases[i].actual = '异常: ' + e.message;
+      this.cases[i].status = 'fail';
+    });
+  }
+
+  abort(i: number): void {
+    this.cases[i].actual = '运行中...';
+    const c = new FFAbortController();
+    FFmpeg.execute(['ffmpeg', '-i', this.wav, `${this.wav}.abort.m4a`, '-y'],
+      { signal: c.signal, logCallback: (m: string) => {} })
+    .then(() => {
+      this.cases[i].actual = '✗ 未被中断';
+      this.cases[i].status = 'fail';
+    }).catch(() => {
+      this.cases[i].actual = '✓ 已中断';
+      this.cases[i].status = 'pass';
+    });
+    setTimeout(() => { c.abort(); }, 300);
+  }
+
+  audio(i: number, mode: string): void {
+    this.cases[i].actual = '运行中...';
+    const p = new FFAudioPlayer();
+    p.url = `file://${this.wav}`;
+    p.prepare();
+    setTimeout(() => {
+      if (mode === 'duration') {
+        this.cases[i].actual = `duration=${p.duration}ms`;
+        this.cases[i].status = p.duration > 0 ? 'pass' : 'fail';
+      } else if (mode === 'position') {
+        p.play();
+        setTimeout(() => {
+          this.cases[i].actual = `position=${p.currentTime}ms`;
+          this.cases[i].status = p.currentTime >= 0 ? 'pass' : 'fail';
+          p.pause();
+        }, 500);
+      } else if (mode === 'pause') {
+        p.play();
+        setTimeout(() => {
+          p.pause();
+          this.cases[i].actual = `paused=${!p.playWhenReady}`;
+          this.cases[i].status = !p.playWhenReady ? 'pass' : 'fail';
+        }, 500);
+      } else if (mode === 'replay') {
+        p.play();
+        setTimeout(() => {
+          p.seek(0);
+          p.play();
+          this.cases[i].actual = `replaying=${p.playWhenReady}`;
+          this.cases[i].status = p.playWhenReady ? 'pass' : 'fail';
+          p.pause();
+        }, 500);
+      } else {
+        p.play();
+        setTimeout(() => {
+          this.cases[i].actual = `playing=${p.playWhenReady}`;
+          this.cases[i].status = p.playWhenReady ? 'pass' : 'fail';
+          p.pause();
+        }, 800);
+      }
+    }, 1500);
+  }
+
+  transcode(i: number): void {
+    this.cases[i].actual = '运行中...';
+    FFmpeg.execute(['ffmpeg', '-i', this.wav, `${this.wav}.m4a`, '-y'],
+      { logCallback: (m: string) => {} })
+    .then(() => {
+      let ok = false;
+      try { fs.accessSync(`${this.wav}.m4a`); ok = true; } catch (e) { ok = false; }
+      this.cases[i].actual = ok ? '✓ m4a 已生成' : '✗ 未生成';
+      this.cases[i].status = ok ? 'pass' : 'fail';
+    }).catch((e: Error) => {
+      this.cases[i].actual = '异常: ' + e.message;
+      this.cases[i].status = 'fail';
+    });
+  }
+
+  probe(i: number, showFormat: boolean): void {
+    this.cases[i].actual = '运行中...';
+    let out = '';
+    FFmpeg.execute(['ffprobe', '-v', 'info', '-of', 'json', '-show_format', '-i', this.wav], {
+      logCallback: (m: string) => { out += m; },
+      outputCallback: (m: string) => { out += m; },
+    }).then(() => {
+      this.cases[i].actual = out.slice(0, 80);
+      if (showFormat) {
+        this.cases[i].status = out.includes('format') ? 'pass' : 'fail';
+      } else {
+        this.cases[i].status = out.length > 0 ? 'pass' : 'fail';
+      }
+    }).catch((e: Error) => {
+      this.cases[i].actual = '异常: ' + e.message;
+      this.cases[i].status = 'fail';
+    });
+  }
+
+  frame(i: number, scaled: boolean): void {
+    this.cases[i].actual = '运行中...';
+    const gen = FFmpeg.execute(['ffmpeg', '-f', 'lavfi', '-i', 'color=c=red:s=64x64:d=1', `${this.wav}.gen.mp4`, '-y'],
+      { logCallback: (m: string) => {} });
+    gen.then(() => {
+      const args = scaled
+        ? ['ffmpeg', '-ss', '0', '-i', `${this.wav}.gen.mp4`, '-frames:v', '1', '-vf', 'scale=32:32', `${this.wav}.fs.jpg`, '-y']
+        : ['ffmpeg', '-ss', '0', '-i', `${this.wav}.gen.mp4`, '-frames:v', '1', `${this.wav}.f.jpg`, '-y'];
+      FFmpeg.execute(args, { logCallback: (m: string) => {} })
+      .then(() => {
+        const f = scaled ? `${this.wav}.fs.jpg` : `${this.wav}.f.jpg`;
+        let ok = false;
+        try { fs.accessSync(f); ok = true; } catch (e) { ok = false; }
+        this.cases[i].actual = ok ? '✓ 截图已生成' : '✗ 未生成';
+        this.cases[i].status = ok ? 'pass' : 'fail';
+      })
+      .catch((e: Error) => {
+        this.cases[i].actual = '异常(截帧): ' + e.message;
+        this.cases[i].status = 'fail';
+      });
+    }).catch((e: Error) => {
+      this.cases[i].actual = '异常(生成视频): ' + e.message;
+      this.cases[i].status = 'fail';
+    });
+  }
+
+  @Builder
+  card(i: number) {
+    Column({ space: 4 }) {
+      Row({ space: 8 }) {
+        Text(this.cases[i].title).fontSize(14).fontWeight(FontWeight.Bold).layoutWeight(1)
+        if (this.cases[i].status === 'pass') {
+          Text('✓').fontSize(16).fontColor(Color.Green)
+        } else if (this.cases[i].status === 'fail') {
+          Text('✗').fontSize(16).fontColor(Color.Red)
+        } else {
+          Text('…').fontSize(14).fontColor(Color.Gray)
+        }
+      }
+      Text(this.cases[i].scenario).fontSize(9).fontColor(Color.Gray).maxLines(1)
+      Text('期望: ' + this.cases[i].expected).fontSize(10).fontColor(Color.Blue).maxLines(1)
+      Text('实际: ' + this.cases[i].actual)
+        .fontSize(10)
+        .fontColor(
+          (this.cases[i].actual.startsWith('✗') || this.cases[i].actual.startsWith('异常'))
+            ? Color.Red : Color.Gray)
+        .maxLines(2)
+    }
+    .width('100%')
+    .padding(10)
+    .backgroundColor(this.cases[i].status === 'fail' ? '#FFF0F0' : '#F5F5F5')
+    .borderRadius(8)
+    .onClick(() => {
+      if (!this.ready) { return; }
+      const ctx = getContext(this) as common.UIAbilityContext;
+      const map: Record<number, () => void> = {
+        0: () => this.exec(0, ['ffmpeg', '-version']),
+        1: () => this.exec(1, ['ffprobe', '-version']),
+        2: () => this.abort(2),
+        3: () => this.audio(3, 'play'),
+        4: () => this.audio(4, 'duration'),
+        5: () => this.audio(5, 'position'),
+        6: () => this.audio(6, 'replay'),
+        7: () => this.transcode(7),
+        8: () => this.exec(8, ['ffmpeg', '-version']),
+        9: () => this.audio(9, 'pause'),
+        10: () => this.probe(10, false),
+        11: () => this.probe(11, true),
+        12: () => this.frame(12, false),
+        13: () => this.frame(13, true),
+      };
+      if (map[i]) { map[i](); }
+    })
+  }
+
+  build() {
+    Scroll() {
+      Column({ space: 6 }) {
+        Text('FFmpeg so 功能验证 ' + BUILD_TS).fontSize(18).fontWeight(FontWeight.Bold)
+        Text('14 项 verify · 加载自动执行 · 点击卡片重跑').fontSize(10).fontColor(Color.Gray)
+        ForEach(this.cases, (c: ApiCase, i: number) => {
+          this.card(i)
+        }, (c: ApiCase) => c.title)
+      }.width('100%').padding(10)
+    }.width('100%').height('100%')
+  }
+}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/module.json5

@@ -0,0 +1 @@
+{"module":{"name":"entry","type":"entry","description":"$string:m","mainElement":"EntryAbility","deviceTypes":["phone"],"deliveryWithInstall":true,"installationFree":false,"pages":"$profile:main_pages","abilities":[{"name":"EntryAbility","srcEntry":"./ets/entryability/EntryAbility.ets","description":"$string:m","icon":"$media:layered_image","label":"$string:m","startWindowIcon":"$media:startIcon","startWindowBackground":"$color:bg","exported":true,"skills":[{"entities":["entity.system.home"],"actions":["ohos.want.action.home"]}]}]}}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/resources/base/element/color.json

@@ -0,0 +1 @@
+{"color":[{"name":"bg","value":"#FFFFFF"}]}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/resources/base/element/string.json

@@ -0,0 +1 @@
+{"string":[{"name":"m","value":"FFmpegVerify"}]}

package/skills/cpp/d2h-native-library-verify/references/demo-project-template/entry/src/main/resources/base/profile/main_pages.json

@@ -0,0 +1 @@
+{"src": ["pages/Index", "pages/NativeVerifyDemo"]}