0e4a2f760f
The required and recommended compiler versions are sort of scattered across several documents. Let's list them in a single document, and have other documents refer to that location. The language here intentionally recommends the same compiler versions used in CI. The find_compiler.sh script can be updated with the minimum known good version.
1.9 KiB
Troubleshooting
In case of an error, you might find an answer of how to deal it here.
Building Ladybird
CMake fails to configure the build because it's outdated
Ensure your CMake version is >= 3.25 with cmake --version. If your system doesn't provide a suitable
version of CMake, you can download a binary release from the CMake website.
GCC is missing or is outdated
Ensure your gcc version is supported by the build system with
gcc --version. Otherwise, install it. If your gcc binary is not called gcc you have to specify the names of your
C and C++ compiler when you run cmake, e.g. cmake ../.. -GNinja -DCMAKE_C_COMPILER=gcc-13 -DCMAKE_CXX_COMPILER=g++-13.
Legacy renegotiation is disabled
Ensure your /etc/ssl/openssl.cnf file has the following options:
[openssl_init]
ssl_conf = ssl_sect
[ssl_sect]
system_default = system_default_sect
[system_default_sect]
MinProtocol = TLSv1.2
CipherString = DEFAULT@SECLEVEL=1
Options = UnsafeLegacyRenegotiation
“Targets may link only to libraries. CMake is dropping the item” message (when building with the Qt UI on macOS)
When building with the Qt UI on macOS, you may encounter the following message:
CMake Warning at /opt/homebrew/Cellar/qt/6.7.0_1/lib/cmake/Qt6/FindWrapOpenGL.cmake:48 (target_link_libraries):
Target "ladybird" requests linking to directory "/usr/X11R6/lib". Targets
may link only to libraries. CMake is dropping the item.
…followed by 14-line stack trace, the top of which is this:
Build/vcpkg/scripts/buildsystems/vcpkg.cmake:859 (_find_package)
…and all of it shown in bright yellow, making you think it must be important and something must need to be fixed. But that’s not the case. Instead, despite that, you’ll be able to build successfully with the Qt UI.