Skip to content

Build QtAV

Jump to bottom
WangBin edited this page Oct 11, 2015 · 68 revisions

Uninstall QtAV SDK before building to avoid header files confliction. Run sdk_uninstall.bat/sh under your build dir

0. Prerequisites

Get QtAV source code

git clone https://github.com/wang-bin/QtAV.git
git submodule update --init

FFmpeg>=1.0/Libav>=9.0 is always required. The latest FFmpeg release is recommended (that's what i use).

You can download latest prebuilt FFmpeg, or build yourself

Libass headers is required if you need ass subtitle rendering support.

Other requirements are:

Windows

OpenAL(Optional). OpenAL is not required since QtAV1.8.0. XAudio2 is always used instead. XAudio2 supports most windows, from XP to windows 10, WinRT and windows phone. Windows 8 and later natively supports XAudio2. For Windows 7 and older, you have to install the driver from DirectX to run.

OS X, iOS

None. System OpenAL is used

Android

None

Ubuntu

OpenAL(recommended) or PulseAudio. To enable all supported features, you must install libass, XVideo and VA-API dev packages.

sudo apt-get install libopenal-dev libpulse-dev libva-dev libxv-dev libass-dev libegl1-mesa-dev

You may have to install VA-API drivers to make VA-API available at runtime

1. Setup the environment

You MUST let your compiler know where FFmpeg headers and libraries are. Otherwise you will get an error when running qmake. If they are already be where they should be, just skip this step.

Choose one of the following methods.

(Recommended) Put FFmpeg headers and libs into Qt directories

This is the simplest and best way to let compilers find ffmpeg and other depend libraries(e.g. OpenAL). Qt header dir and library dir is always be searched. This should work for all platforms, including android, iOS and meego.

(NOT Recommended)Use Environment Vars

VC

set INCLUDE=ffmpeg_path\include;openal_path\include;%INCLUDE%
set LIB=ffmpeg_path\lib;openal_path\lib;%LIB%

GCC in unix shell environment(including mingw with sh.exe):

export CPATH=ffmpeg_path/include:openal_path/include:$CPATH
export LIBRARY_PATH=ffmpeg_path/lib:openal_path/lib:$LIBRARY_PATH

GCC on windows cmd.exe environment without UNIX Shell:

set CPATH=ffmpeg_path\include;openal_path\include;%CPATH%
set LIBRARY_PATH=ffmpeg_path\lib;openal_path\lib;%LIBRARY_PATH%

If you are building in QtCreator, goto QtCreator's 'Projects' page and add/append the environment/values.

QtCreator Settings

2. Build in QtCreator or command line

  • Command line build

    For most platforms, just

    qmake
make -j4 #nmake or jom for msvc

    It's strongly recommend not to build in source dir(especially OSX).

    mkdir your_build_dir cd your_build_dir qmake QtAV_source_dir/QtAV.pro make -j4

    qmake will run check the required libraries at the first time, so you must make sure those libraries can be found by compiler.

    Then qmake will create a cache file .qmake.cache in your build dir. Cache file stores the check results, for example, whether portaudio is available. If you want to recheck, you can either delete .qmake.cache and run qmake again, or run

    qmake QtAV_source_dir/QtAV.pro -r "CONFIG+=recheck"

WARNING: If you are in windows mingw with sh.exe environment, you may need run qmake twice. I have not found out the reason behind this phenomenon.

Visual Studio/MSBuild

I don't put any vs project file in QtAV, because it's easy to create by qmake.

Open cmd

qmake -r -tp vc QtAV.pro

Then sln and vcxproj(vcproj) files will be created. Run msbuild /m to build the projects. You can also open QtAV.sln in your Visual Studio to Compile it.

Another solution is using Qt vs plugin. It will help you to load qmake projects(not tested).

NOTE: you may have to put ffmpeg/openal development files in Qt include and lib dir!

QtCreator With MSVC

QtCreator will detect VC compiler if it is installed. So it's easy to build in QtCreator

Build for Android on Windows

You may get qmake error libavutil is required, but compiler can not find it. That's because mingw32-make.exe can not be found in the config test step. An workaround is put your mingw32-make.exe to one of %PATH% dirs

Build Debian Packages

run

debuild -us -uc

in QtAV source tree

Link to Static FFmpeg and OpenAL

QtAV >=1.4.2 supports linking to static ffmpeg and openal libs. It's disabled by default. To enable it, add

CONFIG += static_ffmpeg static_openal

in $QtAV/.qmake.conf for Qt5 or $QtAV_BUILD_DIR/.qmake.cache

Ubuntu 12.04 Support

If QtAV, FFmpeg and OpenAL are built on newer OS, some symbols will not be found on 12.04. For example, clock_gettime is in both librt and glibc2.17, we must force the linker link against librt because 12.04 glibc does not have that symbol. add

CONFIG += glibc_compat

to .qmake.conf or .qmake.cache

CI

You can read the build log to see how they works.

Clone this wiki locally