4.3 KiB
4.3 KiB
Lessons
High
- OHOS 同时定义
__OHOS__和__linux__；必须显式平台检测，不能把全部 Linux API视为可用。 - 最新 FFmpeg upstream 已有 OHCodec H.264/HEVC；研究当前源码后再决定 fork，避免重复维护。
libnet_ssl.so主要提供证书验证接口，不是 FFmpeg TLS transport backend。- Clang 仅设置 sysroot 不会切换 target；macOS arm64 交叉编译必须在编译和链接两侧显式传
--target=aarch64-linux-ohos。
Medium
- MPV upstream 使用
DOCS/；大小写不敏感文件系统不能可靠并存docs/，沿用 upstream 目录。 - 私有 Gitea 反向代理限制单次 HTTPS pack 时，可先推送历史基线 commit，再推增量分支；不得以浅克隆或裁剪历史规避限制。
- Meson Cross File 的
@GLOBAL_SOURCE_ROOT@随被构建项目变化；共享工具路径应以@DIRNAME@相对 Cross File 定位。 - FreeType
zlib=external表示 fallback subproject；使用 SDK zlib 必须选择zlib=system并隔离 pkg-config。 - XComponent Surface 回调的
surface已是OHNativeWindow*，应直接转换并NativeObjectReference；再次调用CreateNativeWindow会在模拟器触发 SIGSEGV。 hdc file send语法为file send -b <bundle> <local> <remote>；应用沙箱媒体必须发送到/data/storage/el2/base/haps/entry/files/。- libmpv 诊断计数返回 ArkTS Number；返回 BigInt 会导致 Inspector 无法序列化组件状态。
- MPV 事件线程需高频轮询；200ms 轮询会使属性/命令事件堆积，seek 报
MPV_ERROR_EVENT_QUEUE_FULL。 - MPV
audio是aid别名（音轨选择），不能传布尔yes/no；Playback Lab 音频开关必须使用aid=auto/no。 - OHAudio seek/reset 先
Stop再Flush，并等待 inflight callback；只 Flush 后重新 Start 在模拟器返回AUDIOSTREAM_ERROR_ILLEGAL_STATE。 - OHAudio timestamp 在 Flush 后可能保留旧 epoch；统计需保存 raw frame origin，否则会出现
playedFrames > submittedFrames。 setup-ohos-env.sh在 zsh 中的循环变量path会覆盖特殊 PATH 数组；运行脚本应使用/bin/sh或避免 source 到交互 zsh。- FFmpeg upstream OHCodec API24 路径是 surface-first：
AV_PIX_FMT_OHCODEC的 hwcontext 只保存OHNativeWindow*，decoder 硬件帧通过 surface 输出；NativeBuffer/EGL API 存在不等于 MPV 可合法导入的非 surface 帧。 - OHCodec capability 必须通过
OH_AVCodec_GetCapabilityByCategory及OH_AVCapability_*查询；不能把 SDK 头文件存在误写成设备能力或硬件帧已产出。 - Gitea 反向代理对完整 FFmpeg pack 返回 413；保留完整历史的可行做法是先建立空远端，再按 first-parent checkpoint 分块推送，不能浅克隆或裁剪历史。
- MPV 消费独立 FFmpeg prefix 时，pkg-config 必须把 fork 的
lib/pkgconfig置于 base prefix 前，并保留绝对 include/lib 路径；仅改PREFIX会丢失 libass/libplacebo 等其他依赖。 - 当前 DevEco ArkUI SDK 下给既有平面
Column外包Scroll会改变可见布局并裁掉后续控件；诊断页保持平面 Column，关键错误信息放在顶部，长列表改动需单独验收。 - 渲染 update 不能完全依赖 callback：部分重复 load 会话可能漏通知；事件驱动应保留低频（250ms）安全探测，否则会卡在 BUFFERING。
- 短媒体自动化 seek 若先等待首帧再执行多次 hdc keyEvent，媒体可能已 EOF；用立即触发的原生相对 seek 或更长受控 fixture，且保留真实命令错误。
/proc在模拟器不一定提供 PSS、精确 heap 或可校准 CPU tick；benchmark 必须输出 null/原始 jiffies，不能自行推断 permille。- ArkTS UI：
@Prop不接受函数类型，交互回调应改用@Link状态或组件内路由；Stack不支持justifyContent，需使用alignContent。 - HarmonyOS UI：系统资源必须使用已存在的
$r('sys.color...')/$r('sys.symbol...')名称；无效资源名会在 CompileArkTS 直接失败。图片缓存只保留 URL 状态/metadata，feed/details 轻量 JSON 可放 Preferences，不能把图片字节写入偏好存储。 setup-ohos-env.sh被 zsh source 后可能剥离系统 PATH；跨脚本调用系统工具时使用绝对路径或 POSIX shell，不能假设dirname/cp/stat仍可查找。