{"id":13418091,"url":"https://github.com/qt-creator/qt-creator","last_synced_at":"2026-01-29T12:14:06.157Z","repository":{"id":8328711,"uuid":"9881671","full_name":"qt-creator/qt-creator","owner":"qt-creator","description":"A cross-platform Qt IDE","archived":false,"fork":false,"pushed_at":"2025-04-25T16:43:54.000Z","size":614240,"stargazers_count":2761,"open_issues_count":0,"forks_count":840,"subscribers_count":154,"default_branch":"master","last_synced_at":"2025-04-27T05:47:59.547Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/qt-creator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSES/LICENSE.GPL3-EXCEPT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2013-05-06T07:34:55.000Z","updated_at":"2025-04-26T05:05:31.000Z","dependencies_parsed_at":"2025-04-16T15:56:28.514Z","dependency_job_id":"bd0a9f4a-5aaf-4295-8c3a-e695060aad88","html_url":"https://github.com/qt-creator/qt-creator","commit_stats":{"total_commits":81568,"total_committers":834,"mean_commits":97.80335731414868,"dds":0.9245537465672813,"last_synced_commit":"52f45056f0109abe3c488b6e82b2f12ae9861818"},"previous_names":["qtproject/qt-creator"],"tags_count":362,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qt-creator%2Fqt-creator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qt-creator%2Fqt-creator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qt-creator%2Fqt-creator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/qt-creator%2Fqt-creator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/qt-creator","download_url":"https://codeload.github.com/qt-creator/qt-creator/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251094603,"owners_count":21535325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-30T22:00:58.418Z","updated_at":"2025-12-16T20:44:42.240Z","avatar_url":"https://github.com/qt-creator.png","language":"C++","funding_links":[],"categories":["TODO scan for Android support in followings","Integrated Development Environment","Applications","Table of Contents","C++","Integrated Development Environments","HarmonyOS","应用"],"sub_categories":["Development","IDE","Windows Manager","开发"],"readme":"# Qt Creator\n\nQt Creator is a cross-platform, integrated development environment (IDE) for\napplication developers to create applications for multiple desktop, embedded,\nand mobile device platforms.\n\nThe Qt Creator Manual is available at:\n\nhttps://doc.qt.io/qtcreator/index.html\n\nFor an overview of the Qt Creator IDE, see:\n\nhttps://doc.qt.io/qtcreator/creator-overview.html\n\n## Supported Platforms\n\nThe standalone binary packages support the following platforms:\n\n* Windows 10 (x86_64) or later\n* Windows 11 (ARM64) or later\n* (K)Ubuntu Linux 22.04 (x86_64) or later\n* (K)Ubuntu Linux 24.04 (arm64) or later\n* macOS 12 or later\n\nWhen you compile Qt Creator yourself, the Qt version that you build with\ndetermines the supported platforms.\n\n## Contributing\n\nFor instructions on how to set up the Qt Creator repository to contribute\npatches back to Qt Creator, please check:\n\nhttps://wiki.qt.io/Setting_up_Gerrit\n\nSee the following page for information about our coding standard:\n\nhttps://doc.qt.io/qtcreator-extending/coding-style.html\n\n## Compiling Qt Creator\n\nPrerequisites:\n\n* Qt 6.5.3 or later. The Qt version that you use to build Qt Creator defines the\n  minimum platform versions that the result supports\n  (Windows 10, RHEL/CentOS 8.8, Ubuntu 22.04, macOS 11 for Qt 6.5.3).\n* Qt WebEngine module for QtWebEngine based help viewer\n* On Windows:\n    * MinGW with GCC 11.2 or Visual Studio 2019 or later\n    * Python 3.8 or later (optional, needed for the python enabled debug helper)\n    * Debugging Tools for Windows (optional, for MSVC debugging support with CDB)\n* On macOS: latest Xcode\n* On Linux: GCC 10 or later\n* LLVM/Clang 14 or later (optional, LLVM/Clang 17 is recommended.\n  See [instructions](#getting-llvmclang-for-the-clang-code-model) on how to\n  get LLVM.\n  The ClangFormat plugin uses the LLVM C++ API.\n  Since the LLVM C++ API provides no compatibility guarantee,\n  if later versions don't compile we don't support that version.)\n* CMake\n* Ninja (recommended)\n\nThe used toolchain has to be compatible with the one Qt was compiled with.\n\n### Getting Qt Creator from Git\n\nThe official mirror of the Qt Creator repository is located at\nhttps://code.qt.io/cgit/qt-creator/qt-creator.git/. Run\n\n    git clone https://code.qt.io/qt-creator/qt-creator.git\n\nto clone the Qt Creator sources from there. This creates a checkout of the\nQt Creator sources in the `qt-creator/` directory of your current working\ndirectory.\n\nQt Creator relies on some submodules, like\n[litehtml](https://github.com/litehtml) for displaying documentation. Get these\nsubmodules with\n\n    cd qt-creator  # switch to the sources, if you just ran git clone\n    git submodule update --init --recursive\n\nNote the `--recursive` in this command, which fetches also submodules within\nsubmodules, and is necessary to get all the sources.\n\nThe git history contains some coding style cleanup commits, which you might\nwant to exclude for example when running `git blame`. Do this by running\n\n    git config blame.ignoreRevsFile .gitignore-blame\n\n### Linux and macOS\n\nThese instructions assume that Ninja is installed and in the `PATH`, Qt Creator\nsources are located at `/path/to/qtcreator_sources`, Qt is installed in\n`/path/to/Qt`, and LLVM is installed in `/path/to/llvm`.\n\nNote that if you install Qt via the online installer, the path to Qt must\ninclude the version number and compiler ABI. The path to the online installer\ncontent is not enough.\n\nNote that `/path/to/Qt` doesn't imply the full path depth like:\n`$USER/Qt/6.4.3/gcc_64/lib/cmake/Qt6`, but only `$USER/Qt/6.4.3/gcc_64`.\n\nSee [instructions](#getting-llvmclang-for-the-clang-code-model) on how to\nget LLVM.\n\n    mkdir qtcreator_build\n    cd qtcreator_build\n\n    cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja \"-DCMAKE_PREFIX_PATH=/path/to/Qt;/path/to/llvm\" /path/to/qtcreator_sources\n    cmake --build .\n\n#### Troubleshooting: libxcb plugin not found while using Qt libraries built locally from source\n\nEnsure all prerequisites for building Qt are installed:\nhttps://doc.qt.io/qt-6/linux.html\nhttps://doc.qt.io/qt-6/linux-requirements.html\n\nIf they were installed before building Qt and xcb plugin is missing try reinstall them with\n\n```sh\n    sudo apt-get --reinstall \u003cpackage_name\u003e\n```\n\nReset building configuration for Qt libraries at '/path/to/qt_sources'\n\n```sh\n    cmake --build . --target=clean\n```\n\nand remove CMakeCache.txt\n\n```sh\n    rm CMakeCache.txt\n```\n\nTry building Qt source again.\n\n\n### Windows\n\nThese instructions assume that Ninja is installed and in the `PATH`, Qt Creator\nsources are located at `\\path\\to\\qtcreator_sources`, Qt is installed in\n`\\path\\to\\Qt`, and LLVM is installed in `\\path\\to\\llvm`.\n\nNote that if you install Qt via the online installer, the path to Qt must\ninclude the version number and compiler ABI. The path to the online installer\ncontent is not enough.\n\nNote that `\\path\\to\\Qt` doesn't imply the full path depth like:\n`c:\\Qt\\6.4.3\\msvc2019_64\\lib\\cmake\\Qt6`, but only `c:/Qt/6.4.3/msvc2019_64`.\nThe usage of slashes `/` is intentional, since CMake has issues with backslashes `\\`\nin `CMAKE_PREFX_PATH`, they are interpreted as escape codes.\n\nSee [instructions](#getting-llvmclang-for-the-clang-code-model) on how to\nget LLVM.\n\nDecide which compiler to use: MinGW or Microsoft Visual Studio.\n\nMinGW is available via the Qt online installer, for other options see\n\u003chttps://wiki.qt.io/MinGW\u003e. Run the commands below in a shell prompt that has\n`\u003cpath_to_mingw\u003e\\bin` in the `PATH`.\n\nFor Microsoft Visual C++ you can use the \"Build Tools for Visual Studio\". Also\ninstall the \"Debugging Tools for Windows\" from the Windows SDK installer. We\nstrongly recommend using the 64-bit version and 64-bit compilers on 64-bit\nsystems. Open the `x64 Native Tools Command Prompt for VS \u003cversion\u003e` from the\nstart menu items that were created for Visual Studio, and run the commands\nbelow in it.\n\n    md qtcreator_build\n    cd qtcreator_build\n\n    cmake -DCMAKE_BUILD_TYPE=Debug -G Ninja \"-DCMAKE_PREFIX_PATH=/path/to/Qt;/path/to/llvm\" \\path\\to\\qtcreator_sources\n    cmake --build .\n\nQt Creator can be registered as a post-mortem debugger. This can be done in the\noptions page or by running the tool qtcdebugger with administrative privileges\npassing the command line options -register/unregister, respectively.\nAlternatively, the required registry entries\n\n    HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\AeDebug\n    HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node\\Microsoft\\Windows NT\\CurrentVersion\\AeDebug\n\ncan be modified using the registry editor regedt32 to contain\n\n    qtcreator_build\\bin\\qtcdebugger %ld %ld\n\nWhen using a self-built version of Qt Creator as post-mortem debugger, it needs\nto be able to find all dependent Qt-libraries and plugins when being launched\nby the system. The easiest way to do this is to create a self-contained Qt\nCreator by installing it and installing its dependencies. See \"Options\" below\nfor details.\n\nNote that unlike on Unix, you cannot overwrite executables that are running.\nThus, if you want to work on Qt Creator using Qt Creator, you need a separate\ninstallation of it. We recommend using a separate, release-built version of Qt\nCreator to work on a debug-built version of Qt Creator.\n\nAlternatively, take the following template of `CMakeUserPresets.json` for\nreference. Write your own configurePreset inheriting `cmake-plugin-minimal` in\n`CMakeUserPresets.json` to build with IDEs (such as QtCreator, VSCode,\nCLion...etc) locally:\n\n```json\n{\n  \"version\": 4,\n  \"cmakeMinimumRequired\": {\n    \"major\": 3,\n    \"minor\": 23,\n    \"patch\": 0\n  },\n  \"configurePresets\": [\n    {\n      \"name\": \"custom\",\n      \"displayName\": \"custom\",\n      \"description\": \"custom\",\n      \"inherits\": \"cmake-plugin-minimal\",\n      \"binaryDir\": \"${sourceDir}/build/${presetName}\",\n      \"toolset\": {\n        \"value\": \"v142,host=x64\",\n        \"strategy\": \"external\"\n      },\n      \"architecture\": {\n        \"value\": \"x64\",\n        \"strategy\": \"external\"\n      },\n      \"cacheVariables\": {\n        \"CMAKE_CXX_COMPILER\": \"cl.exe\",\n        \"CMAKE_C_COMPILER\": \"cl.exe\",\n        \"CMAKE_PREFIX_PATH\": \"c:/Qt/6.4.3/msvc2019_64\"\n      }\n    }\n  ]\n}\n```\n\n### Options\n\nIf you do not have Ninja installed and in the `PATH`, remove `-G Ninja` from\nthe first `cmake` call. If you want to build in release mode, change the build\ntype to `-DCMAKE_BUILD_TYPE=Release`. You can also build with release\noptimizations but debug information with `-DCMAKE_BUILD_TYPE=RelWithDebInfo`.\n\nYou can find more options in the generated CMakeCache.txt file. For instance,\nbuilding of Qbs together with Qt Creator can be enabled with `-DBUILD_QBS=ON`.\n\nInstallation is not needed. You can run Qt Creator directly from the build\ndirectory. On Windows, make sure that your `PATH` environment variable points to\nall required DLLs, like Qt and LLVM. On Linux and macOS, the build already\ncontains the necessary `RPATH`s for the dependencies.\n\nIf you want to install Qt Creator anyway, that is however possible using\n\n    cmake --install . --prefix /path/to/qtcreator_install\n\nTo create a self-contained Qt Creator installation, including all dependencies\nlike Qt and LLVM, additionally run\n\n    cmake --install . --prefix /path/to/qtcreator_install --component Dependencies\n\nTo install development files like headers, CMake files, and `.lib` files on\nWindows, run\n\n    cmake --install . --prefix /path/to/qtcreator_install --component Devel\n\nIf you used the `RelWithDebInfo` configuration and want debug information to be\navailable to the installed Qt Creator, run\n\n    cmake --install . --prefix /path/to/qtcreator_install --component DebugInfo\n\n### QML Designer\n\nTo disable the build of the experimental QML Designer plugins and their dependencies,\nuse the CMake option `-DWITH_QMLDESIGNER=OFF`. The QML Designer plugin requires additional\ntesting for specific Qt versions. If that can not be provided we suggest to disable it.\n\n### Perf Profiler Support\n\nSupport for the [perf](https://perf.wiki.kernel.org/index.php/Main_Page) profiler\nrequires the `perfparser` tool that is part of the Qt Creator source package, and also\npart of the Qt Creator Git repository in form of a submodule in `src/tools/perfparser`.\n\nCompilation of `perfparser` requires ELF and DWARF development packages.\nYou can either download and extract a prebuilt package from\nhttps://download.qt.io/development_releases/prebuilt/elfutils/ and add the\ndirectory to the `CMAKE_PREFIX_PATH` when configuring Qt Creator,\nor install the `libdw-dev` package on Debian-style Linux systems.\n\nYou can also point Qt Creator to a separate installation of `perfparser` by\nsetting the `PERFPROFILER_PARSER_FILEPATH` environment variable to the full\npath to the executable.\n\n### Partial building of executables and plugins\n\nSet the following CMake definitions in order to configure and build only\nparts of Qt Creator. Note that dependencies are not automatically handled.\n```\n-DBUILD_EXECUTABLES:STRING=QtCreator;ClangBackend;qtcreator_processlauncher\n```\n```\n-DBUILD_PLUGINS:STRING=Core;TextEditor;ProjectExplorer;CppTools;CppEditor;QmakeProjectManager;CMakeProjectManager;Debugger;ResourceEditor;QtSupport;LanguageClient\n```\n## Getting LLVM/Clang for the Clang Code Model\n\nThe Clang code model uses `Clangd` and the ClangFormat plugin depends on the\nLLVM/Clang libraries. The currently recommended LLVM/Clang version is 14.0.\n\n### Prebuilt LLVM/Clang packages\n\nPrebuilt packages of LLVM/Clang can be downloaded from\nhttps://download.qt.io/development_releases/prebuilt/libclang/\n\nThis should be your preferred option because you will use the version that is\nshipped together with Qt Creator (with backported/additional patches). In\naddition, MinGW packages for Windows are faster due to profile-guided\noptimization. If the prebuilt packages do not match your configuration, you\nneed to build LLVM/Clang manually.\n\nIf you use the MSVC compiler to build Qt Creator the suggested way is:\n    1. Download both MSVC and MinGW packages of libclang.\n    2. Use the MSVC version of libclang during the Qt Creator build.\n    3. Prepend PATH variable used for the run time with the location of MinGW version of libclang.dll.\n    4. Launch Qt Creator.\n\n### Building LLVM/Clang manually\n\nYou need to install CMake in order to build LLVM/Clang.\n\nBuild LLVM/Clang by roughly following the instructions at\nhttp://llvm.org/docs/GettingStarted.html#git-mirror:\n\n   1. Clone LLVM/Clang and checkout a suitable branch\n\n          git clone -b release_17.0.6-based --recursive https://code.qt.io/clang/llvm-project.git\n\n   2. Build and install LLVM/Clang\n\n          mkdir build\n          cd build\n\n      For Linux/macOS:\n\n          cmake \\\n            -D CMAKE_BUILD_TYPE=Release \\\n            -D LLVM_ENABLE_RTTI=ON \\\n            -D LLVM_ENABLE_PROJECTS=\"clang;clang-tools-extra\" \\\n            -D CMAKE_INSTALL_PREFIX=\u003cinstallation location\u003e \\\n            ../llvm-project/llvm\n          cmake --build . --target install\n\n      For Windows:\n\n          cmake ^\n            -G Ninja ^\n            -D CMAKE_BUILD_TYPE=Release ^\n            -D LLVM_ENABLE_RTTI=ON ^\n            -D LLVM_ENABLE_PROJECTS=\"clang;clang-tools-extra\" ^\n            -D CMAKE_INSTALL_PREFIX=\u003cinstallation location\u003e ^\n            ..\\llvm-project\\llvm\n          cmake --build . --target install\n\n# Licenses and Attributions\n\nQt Creator is available under commercial licenses from The Qt Company,\nand under the GNU General Public License version 3,\nannotated with The Qt Company GPL Exception 1.0.\nSee [LICENSE.GPL3-EXCEPT](LICENSE.GPL3-EXCEPT) for the details.\n\nFor more information about the third-party components that Qt Creator\nincludes, see the\n[Acknowledgements section in the documentation](https://doc.qt.io/qtcreator/creator-acknowledgements.html).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqt-creator%2Fqt-creator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fqt-creator%2Fqt-creator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fqt-creator%2Fqt-creator/lists"}