docs/devel/build-environment.rst

2 .. _setup-build-env:
4 Setup build environment
7 QEMU uses a lot of dependencies on the host system. glib2 is used everywhere in
15 - `Linux <https://wiki.qemu.org/Hosts/Linux>`_
16 - `MacOS <https://wiki.qemu.org/Hosts/Mac>`_
17 - `Windows <https://wiki.qemu.org/Hosts/W32>`_
18 - `BSD <https://wiki.qemu.org/Hosts/BSD>`_
20 Note: Installing dependencies using your package manager build dependencies may
25 -----
34 Debian/Ubuntu
37 You first need to enable `Sources List <https://wiki.debian.org/SourcesList>`_.
42     sudo apt update && sudo apt build-dep qemu
45 -----
52     brew update && brew install $(brew deps --include-build qemu)
55 -------
61 We recommend to use MINGW64 for windows-x86_64 and CLANGARM64 for windows-aarch64
62 (only available on windows-aarch64 hosts).
68     c:/msys64/msys2_shell.cmd -defterm -here -no-start -mingw64
69     # Replace -ucrt64 by -clangarm64 or -ucrt64 for other environments.
71 MSYS2 package manager does not offer a built-in way to install build
80     pacman -Syu
81     pacman -S \
82         base-devel binutils bison diffutils flex git grep make sed \
83         ${MINGW_PACKAGE_PREFIX}-toolchain \
84         ${MINGW_PACKAGE_PREFIX}-glib2 \
85         ${MINGW_PACKAGE_PREFIX}-gtk3 \
86         ${MINGW_PACKAGE_PREFIX}-libnfs \
87         ${MINGW_PACKAGE_PREFIX}-libssh \
88         ${MINGW_PACKAGE_PREFIX}-ninja \
89         ${MINGW_PACKAGE_PREFIX}-pixman \
90         ${MINGW_PACKAGE_PREFIX}-pkgconf \
91         ${MINGW_PACKAGE_PREFIX}-python \
92         ${MINGW_PACKAGE_PREFIX}-SDL2 \
93         ${MINGW_PACKAGE_PREFIX}-zstd
96 build QEMU in MSYS2 itself.
100     pacman -S wget base-devel git
101 …wget https://raw.githubusercontent.com/msys2/MINGW-packages/refs/heads/master/mingw-w64-qemu/PKGBU…
104     makepkg --syncdeps --nobuild PKGBUILD || true
106 Build on windows-aarch64
117     ./configure --cpu=x86_64 --cross-prefix=