media-autobuild_suite项目中libavif编解码器支持问题的分析与解决

问题背景

在media-autobuild_suite项目中，近期发现libavif工具生成的avifenc二进制文件缺少所有编解码器支持。这一问题源于libavif项目最近的一次重要提交，该提交改变了编解码器启用的CMake配置方式。

问题根源分析

libavif项目在最新版本中进行了重大变更，移除了原有的=ON参数配置方式，转而采用=SYSTEM参数来启用系统已安装的编解码器。这一变更直接影响了media-autobuild_suite项目中原有的构建脚本逻辑。

具体表现为：

• 构建后的avifenc工具在版本信息中不显示任何编解码器支持
• 功能测试显示工具无法正常使用各类AV1编解码器
• 这一问题不仅出现在本地构建环境，也影响了自动化构建系统

技术解决方案

经过分析，解决方案相对简单直接：需要将构建脚本中的编解码器启用参数从=ON改为=SYSTEM。具体修改涉及以下CMake参数：

原配置：

pc_exists "dav1d" && extracommands+=("-DAVIF_CODEC_DAV1D=ON")
pc_exists "rav1e" && extracommands+=("-DAVIF_CODEC_RAV1E=ON")
pc_exists "aom" && extracommands+=("-DAVIF_CODEC_AOM=ON")
pc_exists "SvtAv1Enc" && extracommands+=("-DAVIF_CODEC_SVT=ON")

修改后配置：

pc_exists "dav1d" && extracommands+=("-DAVIF_CODEC_DAV1D=SYSTEM")
pc_exists "rav1e" && extracommands+=("-DAVIF_CODEC_RAV1E=SYSTEM")
pc_exists "aom" && extracommands+=("-DAVIF_CODEC_AOM=SYSTEM")
pc_exists "SvtAv1Enc" && extracommands+=("-DAVIF_CODEC_SVT=SYSTEM")

相关兼容性问题

在解决主要问题的过程中，还发现了一个与SVT-AV1编解码器相关的兼容性问题。当使用较新版本的libavif与较旧版本的SVT-AV1时，会出现API不匹配的问题，具体表现为：

1. EbSvtAv1EncConfiguration结构体缺少high_dynamic_range_input成员
2. 同样缺少logical_processors成员
3. 这些变更源于SVT-AV1项目自身的API演进

针对这一问题，目前建议的临时解决方案是使用SVT-AV1的-psy分支，该分支尚未变更API，且在某些编码质量优化方面甚至优于主分支。

问题验证

修改后的构建配置经过验证，能够正确检测并启用系统中已安装的所有AV1编解码器。构建成功的avifenc工具在版本信息中能够正确显示支持的编解码器及其版本信息，例如：

Version: 1.1.1 (dav1d [dec]:1.5.0-55-g40ff2a1, aom [enc]:3.11.0-167-g22881fc869, svt [enc]:v2.3.0-A-14-g51e77c8)
libyuv : available (1899)

总结

本次问题的解决过程展示了开源项目间依赖关系管理的重要性。当上游项目(如libavif)发生重大变更时，下游构建系统(如media-autobuild_suite)需要及时跟进调整。同时，编解码器生态系统的快速演进也带来了API兼容性挑战，需要构建系统维护者保持警惕并及时应对。

对于media-autobuild_suite用户而言，及时更新构建脚本是确保获得完整功能的关键。项目维护者也应当考虑建立更完善的自动化测试机制，以快速发现并解决类似的兼容性问题。