krita/3rdparty/README-MSYS-USERS.md

0001 # Building Krita with MSYS2
0002
0003 **Please note that this is an unsupported, best-effort configuration.
0004 Use it at your own risk.**
0005
0006 ## Requirements
0007
0008 Use the MINGW64, CLANG64 or UCRT64 flavors. Install the following components
0009 (change the `x86_64` architecture to your own):
0010
0011 - Your flavor's compiler:
0012   - `pacman -S mingw-w64-x86_64-toolchain`
0013   - `pacman -S mingw-w64-clang-x86_64-toolchain`
0014   - `pacman -S mingw-w64-ucrt-x86_64-toolchain`
0015
0016 - CMake:
0017   - `pacman -S mingw-w64-x86_64-cmake`
0018   - `pacman -S mingw-w64-clang-x86_64-cmake`
0019   - `pacman -S mingw-w64-ucrt-x86_64-cmake`
0020
0021 If using the CLANG64 flavor, set the `CC` and `CXX` environment variables:
0022
0023 ```
0024 set CC=x86_64-w64-mingw32-cc
0025 set CXX=x86_64-w64-mingw32-c++
0026 ```
0027
0028 If you want AVIF/HEIF support, before continuing, install:
0029   - Rust:
0030     - **Stock Rust is not recommended with UCRT64 and CLANG64. Use the MSYS2-provided binaries.**
0031     - `pacman -S mingw-w64-x86_64-rust`
0032     - `pacman -S mingw-w64-clang-x86_64-cmake`
0033     - `pacman -S mingw-w64-ucrt-x86_64-cmake`
0034   - Meson and Ninja:
0035     - Issue `pip install -U meson setuptools ninja` on your Python installation, **not** on your MSYS2 shell.
0036     - For more information, see the README.md in this directory, section "Prerequisites", item 4.
0037
0038 Now follow the README.md document, Prerequisites section, item 4 onwards.
0039 Alternatively, run the `build-tools\windows\build.cmd` script from a command
0040 line that can use the MSYS2 tools.