// Copyright (C) 2024 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only

/*!
\page build-sources.html
\title Building Qt Sources
\brief Building Qt from the source packages

There are two ways to install Qt:
\list 1
\li through the \l{Get and Install Qt}{Qt Installers} - downloads and installs Qt
\li through the \e{Qt sources}
\endlist

\note Add the Qt build directory to the list of excluded directories
      of any anti-virus application that runs on your system.

You can download the Qt installers and sources from the \l Downloads page.
For more information, visit the \l{Getting Started with Qt} page.

This page lists the relevant information for installing Qt by building the Qt
sources. The installation procedure is different on each Qt platform. This page
collects the relevant information for the \l{Supported Platforms}
{supported platforms}. In addition, this page provides links to any
module-specific system requirements.

\section1 General Installation Information

To build Qt from source, use \c configure to configure Qt for a particular
platform with a particular set of Qt features or modules. For more information,
visit the following page:

\list
\li \l{Qt Configure Options}
\endlist

It's also possible for you to build an optimized version of Qt according to your specific needs.
For more information, visit the following page:

\list
\li \l {Building Optimized Qt}
\endlist

\section1 Windows

\list
\li \l{Qt for Windows - Building from Source}
\endlist

\section1 \macos

\list
\li \l{Qt for macOS - Building from Source}
\endlist

\section1 Linux/X11

\list
\li \l{Qt for X11 Requirements}
\li \l{Qt for Linux/X11 - Building from Source}
\endlist

\section1 Embedded Linux

\list
    \li \l{Configure an Embedded Linux Device}
    \li \l{Qt for Embedded Linux}
\endlist

\section1 Android

\list
\li \l {Qt for Android - Building from Source}
\endlist

\section1 iOS

\list
\li \l {Qt for iOS - Building from Source}
\endlist

\section1 Module-specific System Requirements

\list
    \li \l {Qt WebEngine Platform Notes} {Building Qt WebEngine from Source}
    \li \l [QtQuick3D] {Building From Source}
           {Building Qt Quick 3D from Source}
    \li \l {Building Qt Multimedia from sources}{Building Qt Multimedia from Source}
    \li \l [QtGRPC] {Module prerequisites}{Qt GRPC and Qt Protobuf Module Requirements}
\endlist

\section1 Additional Information

The top-level qt5 Git repository contains a set of build instructions in the
form of \e {provisioning scripts}, used by Qt's continuous integration (CI)
system to build and test the \l {Supported Platforms}. These
scripts are useful for anyone building Qt from source, as they provide
information on the tools and components that are required for each
configuration.

\list
    \li \l {https://code.qt.io/cgit/qt/qt5.git/tree/coin?h=\qtver}
           {qt/qt5.git CI provisioning for Qt \qtver}
    \li \l {https://wiki.qt.io/CI_Overview}{CI Overview in Qt Wiki}
    \li \l {https://wiki.qt.io/Building_Qt_Documentation}
           {Building Qt Documentation}
\endlist
*/
