【Android FFMPEG 开发】Android Studio 中配置 FFMPEG 库注意事项 ( 静态库链接 libz.so 库

文章目录

I . 导入 z 库 ( FFMPEG 动态库与静态库区别 )
II . FFMPEG 库引入顺序
III . Android Studio 中 FFMPEG 静态库引入完整 CMakeList.txt 构建脚本

I . 导入 z 库 ( FFMPEG 动态库与静态库区别 )

1 . 导入 FFMPEG 静态库会报以下错误 :

  libavformat/id3v2.c:1021: error: undefined reference to 'uncompress'libavformat/rtmpproto.c:1077: error: undefined reference to 'inflateInit_'libavformat/rtmpproto.c:1087: error: undefined reference to 'inflate'libavformat/rtmpproto.c:1105: error: undefined reference to 'inflateEnd'libavformat/http.c:1646: error: undefined reference to 'inflateEnd'libavformat/http.c:680: error: undefined reference to 'inflateEnd'libavformat/http.c:681: error: undefined reference to 'inflateInit2_'libavformat/http.c:686: error: undefined reference to 'zlibCompileFlags'libavformat/http.c:1437: error: undefined reference to 'inflate'libavformat/matroskadec.c:1402: error: undefined reference to 'inflateInit_'libavformat/matroskadec.c:1410: error: undefined reference to 'inflateEnd'libavformat/matroskadec.c:1417: error: undefined reference to 'inflate'libavformat/mov.c:5073: error: undefined reference to 'uncompress'libavformat/swfdec.c:364: error: undefined reference to 'uncompress'libavformat/swfdec.c:153: error: undefined reference to 'inflateInit_'libavformat/swfdec.c:121: error: undefined reference to 'inflate'libavcodec/cscd.c:93: error: undefined reference to 'uncompress'libavcodec/flashsv.c:126: error: undefined reference to 'inflateInit_'libavcodec/flashsv.c:259: error: undefined reference to 'deflateInit_'libavcodec/flashsv.c:261: error: undefined reference to 'deflateBound'libavcodec/flashsv.c:262: error: undefined reference to 'deflateEnd'libavcodec/flashsv.c:191: error: undefined reference to 'inflateReset'libavcodec/flashsv.c:210: error: undefined reference to 'inflateSync'libavcodec/flashsv.c:160: error: undefined reference to 'deflateInit_'libavcodec/flashsv.c:166: error: undefined reference to 'deflate'libavcodec/flashsv.c:167: error: undefined reference to 'deflateEnd'libavcodec/flashsv.c:169: error: undefined reference to 'inflateReset'libavcodec/lcldec.c:134: error: undefined reference to 'inflateReset'libavcodec/mscc.c:141: error: undefined reference to 'inflateReset'clang++: error: linker command failed with exit code 1 (use -v to see invocation)ninja: build stopped: subcommand failed.

2 . 问题原因 : 这是由于没有找到 z 库 ( libz.so ) 导致的 ;

3 . 修改方法 : 在 CMakeList.txt 构建脚本中 , 链接库时链接 z 库 ; 在 target_link_libraries 中 , 添加 z 库的链接 , 如下 :

4 . FFMPEG 静态库 : FFMPEG 使用静态库编译需要增加额外配置 , 如上述的 libz.so 库 ; 因为静态库在打包时就需要将所依赖的库都打包到静态库中 ;

5 . FFMPEG 动态库 : 如果使用的是 FFMPEG 动态库 , 则不需要引入 z 库 , 动态库在运行时才链接其用到的函数库 ;

II . FFMPEG 库引入顺序

1 . 问题产生 : Android Studio 中导入 FFMPEG 库后 , 编译时报如下错误 ;

  libavformat/utils.c:5548: error: undefined reference to 'av_bitstream_filter_filter'libavformat/codec2.c:74: error: undefined reference to 'avpriv_codec2_mode_bit_rate'libavformat/codec2.c:75: error: undefined reference to 'avpriv_codec2_mode_frame_size'libavformat/codec2.c:76: error: undefined reference to 'avpriv_codec2_mode_block_align'libavformat/spdifdec.c:63: error: undefined reference to 'av_adts_header_parse'clang++: error: linker command failed with exit code 1 (use -v to see invocation)ninja: build stopped: subcommand failed.

2 . FFMPEG 导入顺序 : FFMPEG 中的 6 个模块之间有相互依赖关系 , 必须按照指定的顺序进行加载 ;

3 . 问题案例分析 : avcodec 模块 ( 音视频编解码 ) 需要依赖 avformat 模块 ( 音频封装格式 ) ; 因此 , 导入 FFMPEG 函数库时 , avcodec 模块必须在 avformat 模块之后 ;

4 . 推荐顺序 : ① avfilter , ② avformat , ③ avcodec , ④ avutil , ⑤ swresample , ⑥ swscale ;

        # FFMPEG 静态库# 注意这些库的顺序必须按照如下进行 , 否则会报错#   这些库之间有依赖的关系 , 必须按照顺序加载库 , 如 avcodec 内部依赖 avformat 库avfilteravformatavcodecavutilswresampleswscale

III . Android Studio 中 FFMPEG 静态库引入完整 CMakeList.txt 构建脚本

# I . 指定 CMake 最低版本
cmake_minimum_required(VERSION 3.4.1)# II . 设置函数库编译
add_library( # 参数 1 : 设置生成的动态库名称native-lib# 参数 2 : 设置生成的函数库类型 : ① 静态库 STATIC ② 动态库 SHAREDSHARED# 参数 3 : 配置要编译的源文件native-lib.cppFFMPEG.cppJavaCallHelper.cppAudioChannel.cppVideoChannel.cpp)# III . 到预设的目录查找 log 库 , 将找到的路径赋值给 log-lib
#       这个路径是 NDK 的 ndk-bundle\platforms\android-29\arch-arm\usr\lib\liblog.so
#       不同的 Android 版本号 和 CPU 架构 需要到对应的目录中查找 , 此处是 29 版本 32 位 ARM 架构的日志库
#
# 可以不配置 :
#       可以不进行该配置, 直接在后面的 target_link_libraries 中链接 log 也不会出错
find_library(log-liblog)# IV . 指定 FFMPEG 头文件查找目录
#           CMAKE_SOURCE_DIR 指的是当前的文件地址
include_directories(${CMAKE_SOURCE_DIR}/include)# V . 指定 FFMPEG 静态库
# CMAKE_CXX_FLAGS 表示会将 C++ 的参数传给编译器
# CMAKE_C_FLAGS 表示会将 C 参数传给编译器# 参数设置 : 传递 CMAKE_CXX_FLAGS C+= 参数给编译器时 , 在 该参数后面指定库的路径
#   CMAKE_SOURCE_DIR 指的是当前的文件地址
#   -L 参数指定动态库的查找路径
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -L${CMAKE_SOURCE_DIR}/lib")# V . 链接函数库
#       参数 1 : 本构建脚本要生成的动态库目标
#       参数 2 ~ ... : 后面是之前预编译的动态库或静态库 , 或引入的动态库
target_link_libraries(native-lib# FFMPEG 静态库# 注意这些库的顺序必须按照如下进行 , 否则会报错#   这些库之间有依赖的关系 , 必须按照顺序加载库 , 如 avcodec 内部依赖 avformat 库avfilteravformatavcodecavutilswresampleswscale# 日志库${log-lib}#FFMPEG 使用到了 libz 库 , 没有会报错#   FFMPEG 对于 z 的依赖是以动态库的形式进行的#   如果 FFMPEG 是动态库 , 那么可以不链接这个库 , 可以运行时链接这个库#   当前 FFMPEG 是静态库 , 需要在编译时将这个库打包到静态库中#   推荐使用静态库 , 静态库打包出来的库比动态库小很多 , 一倍左右z
)