# 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/`。
- Phase 7 SDK：`scripts/package-velix-core-sdk.sh [--profile default|software|ffmpeg-harmony] [--out DIR]`；校验使用 `scripts/verify-velix-core-sdk.sh [SDK_DIR]`，默认输出 `dist/velix-core/`。
- Velix 主 App：`../Velix`；同步 Core 使用 `scripts/sync-velix-core-sdk.sh --local|--release --sdk DIR`，构建使用 `scripts/build-velix-app.sh --local-core|--release-core --build-mode debug|release`；最终 HAP `../Velix/entry/build/default/outputs/default/entry-default-unsigned.hap`。
- Velix 主 App Git：独立仓库 `../Velix/.git`，分支 `main`，Phase 8 提交 `058c7a8`；无远端配置。UI 验证截图：`/tmp/velix-v8-final-home2.jpeg`、`/tmp/velix-v8-final-sheet.jpeg`、`/tmp/velix-v8-final-detail.jpeg`、`/tmp/velix-v8-final-player-ready.jpeg`。