This repository contains XD (eXtra Dimension),
the cross-platform framework used by both GUI
and CLI
applications.
Based on qtbase
5.6.x,
which's a bundle of Qt libraries that are enough to replace both boost
and wxWidgets
,
in other words, the other Qt libraries are nice to have,
but they are really just fancy additions, unused by most projects.
However, if needed XD
provides an all in one bundle which includes this bundle as a git-sub-module, at:
https://github.com/top-master/qt5
WARNING: use the word Qt
instead of XD
in your search for solutions, like in StackOverflow.com,
and our header files are intentionally compatible with Qt headers to make that possible.
Naming: Considering we see only a three-dimensional reality, and most people only see original
Qt5
, then our additions are the extra dimension.
For more information read other README.md
or README
files related to each directory.
We make use of git-sub-module
feature,
and you will need to clone
with below command to include all sub-modules:
git clone --recurse-submodules https://github.org/top-master/qtbase.git --depth=1 --branch main
But if you already cloned without --recurse-submodules
,
then you will need to run below command to fetch any sub-module:
git submodule update --init --recursive --depth=1
-
Qt Creator 5.x or later (github).
- Note that CDB-debugging plugin of Qt-Creator version 4 works for version 5 as well.
- Also, version 5.x is last that supports Windows 7.
-
MSVC 2015 (Microsoft Visual Studio 2015)
- Just used as compiler, not as IDE, hence installing should be enough (no need to purchase).
- Microsoft's C++ Build tools 2015 may work as well (we only tested with MSVC).
-
Install both '
Qt-Creator
' and 'MSVC 2015
' (thenQt-Creator
should automatically detectMSVC 2015
as compiler when both are installed). -
Download
XD
-framework, and place it at 'C:/XD
', like:- First open the
terminal
andcd
into your 'C:/
' drive (or for advanced users, wherever you want). - Then
clone
this repository with above mentioned command. - Wait until download is finished successfully.
- At last ensure the '
C:/XD/bin
' directory is created and contains a prebuiltqmake
named executable in it (but ifqmake
does not exist there, download one fromQt-5
)
- First open the
-
Open
Qt-Creator
, then Add Qt-version and configure it like:- Put in "
qmake location
" field theXD
framework's qmake-executable address (e.g. "C:/XD/bin/qmake.exe
" without quotes). - Also set the "
Version name
" field to "MyXD
" (without quotes).
- Put in "
-
Still in
Qt-Creator
Create a build tool-kit and configure it like:- In "
Name
" Text-box type "MyToolKit
" without quotes. - In "
Qt Version
" Drop-down menu select "MyXD
" (which you added in previous step) - In
"Compiler"
Drop-down menu select the auto-detected one withx86
architecture (or even configure compiler manually)
- In "
-
In
Qt-Creator
open as project our main build-script file which is "XD-mini.pro
" file, or for advanced users "XD.pro
", then configure it to use the build tool-kit (which you added in previous step), like:- The "
Configure Project
" wizard should appear right after open. - WARNING: if said wizard does not appear, then do either of these:
- Close Qt-Creator, and remove the "
C:/XD/XD-mini.pro.user
" file or if advancedXD.pro.user
file, finally re-open said main build-script file in Qt-Creator. - Or configure project manually.
- Close Qt-Creator, and remove the "
- In said wizard, tick the "
MyToolKit
" checkbox, and un-tick any other kit. - Expand the "
Details
" of said checkbox. - In both "
Debug
" and "Release
" text-boxes type "C:/build/XD-tmp" without quotes (any path is allowed except "C:/XD
" folder or its sub-folders).
- The "
-
In
Qt-Creator
click "Build All" from "Build" menu (note that bothdebug
andrelease
libraies get built, unlike normal projects, hence no need for switching torelease
mode, usingCtrl+T
menu). -
Optionally, create the
XD_ROOT
named environment-variable, and point it toC:/XD
(directory which second step creates).
All done, XD
framework is ready to use!