Velix-MPV-Core/memory/infra.md

Infrastructure

• DevEco Studio：/Applications/DevEco-Studio.app
• OpenHarmony SDK：/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony
• SDK：API 24，版本 6.1.1.125
• Native sysroot：<SDK>/native/sysroot
• Toolchain：<SDK>/native/llvm/bin
• Target：aarch64-linux-ohos
• Compiler：OHOS Clang 15.0.4
• Build tools：Meson 1.9.0、Ninja 1.12.0、pkgconf 3.0.6，均由仓库脚本隔离管理
• OHOS prefix：build/ohos-arm64/prefix
• libmpv：build/ohos-arm64/prefix/lib/libmpv.so.2.5.0
• Git origin：https://git.leee.xin/leeexin/Velix-MPV-Core.git，默认分支 harmony-port
• MPV upstream：https://github.com/mpv-player/mpv.git
• hdc：/Applications/DevEco-Studio.app/Contents/sdk/default/openharmony/toolchains/hdc
• 模拟器目标：127.0.0.1:5555，HarmonyOS 6.1.0.126 / API 24
• Playback Lab 构建：在 playback_lab/ 执行 scripts/stage-mpv.sh 后用 hvigor --no-daemon assembleHap --mode module -p product=default
• HAP 构建：使用 DevEco 自带 /Applications/DevEco-Studio.app/Contents/jbr/Contents/Home，并以 hvigorw.js assembleHap --no-daemon --mode module -p product=default 完成 PackageHap；默认未配置正式签名。
• HAP 环境：需设置 JAVA_HOME=/Applications/DevEco-Studio.app/Contents/jbr/Contents/Home、DEVECO_SDK_HOME=/Applications/DevEco-Studio.app/Contents/sdk；SDK native 路径仍使用 .../sdk/default/openharmony。
• OHAudio：API 24 headers ohaudio/native_audiostreambuilder.h / native_audiorenderer.h / native_audiostream_base.h，动态库 libohaudio.so；Meson 使用 -Dharmony-audio=enabled。
• Phase 3 HAP：playback_lab/entry/build/default/outputs/default/entry-default-unsigned.hap；模拟器 H.264/AAC smoke target 127.0.0.1:5555。
• Phase 4 构建入口：scripts/build-mpv-ohos.sh（OHCodec enabled）、scripts/build-mpv-ohos-software.sh（OHCodec disabled）、scripts/build-all-ohos.sh（全量矩阵）；GL API probe 通过单独 Meson harmony-ohcodec-gl=enabled 构建验证。
• Phase 4 产物：build/ohos-arm64/prefix/lib/libmpv.so.2.5.0；软件构建位于 build/ohos-arm64/build/mpv-software/libmpv.so.2.5.0；HAP 位于 playback_lab/entry/build/default/outputs/default/entry-default-unsigned.hap。
• 模拟器验证：devecocli run --module entry --device 127.0.0.1:5555 --skip-build 成功安装/启动；Playback Lab 本地 H.264/AAC MP4 首帧与结束状态可见。
• FFmpeg-Harmony：../Velix-FFmpeg-Harmony，origin https://git.leee.xin/leeexin/Velix-FFmpeg-Harmony.git，upstream https://github.com/FFmpeg/FFmpeg.git，branch harmony-ohcodec-export，tip f3a036c695；prefix ../Velix-FFmpeg-Harmony/build/ohos-arm64/prefix。
• MPV fork 接入：scripts/build-mpv-ohos-ffmpeg-harmony.sh；可用 FFMPEG_PREFIX 与 MPV_BUILD_ROOT 覆盖默认路径，默认 MPV/软件脚本不变。
• MPV fork 输出：切换脚本默认安装到 build/ohos-arm64/prefix-mpv-ffmpeg-harmony，不会覆盖默认 prefix。
• Phase 6 runner：python3 benchmark/runner/run_emulator.py {startup_local,seek_local,stress_lifecycle,play_pause} --repeat N；结果写入被忽略的 benchmark/results/。