docs/devel/build-environment.rst

2 .. _setup-build-env:
7 QEMU uses a lot of dependencies on the host system. glib2 is used everywhere in
13 You can find additional instructions on `QEMU wiki <https://wiki.qemu.org/>`_:
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>`_
21 miss out on deps that have been newly introduced in qemu.git. In more, it misses
25 -----
32     sudo dnf update && sudo dnf builddep qemu
42     sudo apt update && sudo apt build-dep qemu
45 -----
52     brew update && brew install $(brew deps --include-build qemu)
55 -------
59 x86_64 environments are based on GCC, while aarch64 is based on Clang.
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
109 When trying to cross compile meson for x86_64 using UCRT64 or MINGW64 env,
112 Meson detects x86_64 processes emulated, so you need to manually set the cpu,
117     ./configure --cpu=x86_64 --cross-prefix=