Qt wiki will be updated on October 12th 2023 starting at 11:30 AM (EEST) and the maintenance will last around 2-3 hours. During the maintenance the site will be unavailable.
Getting Commercial Qt Sources: Difference between revisions
(Updated general information about Gerrit.) |
(Updated the VxWorks-specific instructions for Qt 5.15.14 for VxWorks.) |
||
(3 intermediate revisions by the same user not shown) | |||
Line 6: | Line 6: | ||
Only commercial customers and those who work closely with The Qt Company have access to these repositories. | Only commercial customers and those who work closely with The Qt Company have access to these repositories. | ||
The LTS branches have a common prefix, <kbd>tqtc/lts-</kbd> – for example, <kbd>tqtc/lts-5.15</kbd>. | The LTS commercial branches have a common prefix, <kbd>tqtc/lts-</kbd> – for example, <kbd>tqtc/lts-5.15</kbd>. | ||
You can add a shadow repository as a remote of an existing checkout of the corresponding public repository, | You can add a shadow repository as a remote of an existing checkout of the corresponding public repository, | ||
with which it shares history. | with which it shares history. | ||
This is usually the most convenient way to work with commercial-only repositories. | This is usually the most convenient way to work with commercial-only repositories. | ||
== Precondition: Gerrit account == | ==Precondition: Gerrit account== | ||
You must have a Gerrit account to clone the | You must have a Gerrit account to clone the LTS commercial Qt sources: | ||
# Register to Gerrit as instructed in [https://wiki.qt.io/Setting_up_Gerrit#How_to_get_started_-_Gerrit_registration <nowiki>[1]</nowiki>]. Some notes: | #Register to Gerrit as instructed in [https://wiki.qt.io/Setting_up_Gerrit#How_to_get_started_-_Gerrit_registration <nowiki>[1]</nowiki>]. Some notes: | ||
## If you just want to clone the sources, you need to follow the instructions in steps 1-3 and either set an SSH key (step 5) or an HTTP password (step 7). | ##If you just want to clone the sources, you need to follow the instructions in steps 1-3 and either set an SSH key (step 5) or an HTTP password (step 7). | ||
## If you are going to contribute to the Qt Project, step 4 is mandatory. | ##If you are going to contribute to the Qt Project, step 4 is mandatory. | ||
# Login to Gerrit and follow the cloning instructions on this page. | #Login to Gerrit and follow the cloning instructions on this page. | ||
'''Note! To be able to clone the LTS sources, you must have a commercial license. An evaluation license does not provide access to the LTS sources. | '''Note!''' To be able to clone the LTS commercial sources, you must have a commercial license. An evaluation license does not provide access to the LTS commercial sources. | ||
==Cloning commands in Gerrit== | ==Cloning commands in Gerrit== | ||
Line 46: | Line 46: | ||
==Cloning Qt for VxWorks Sources== | ==Cloning Qt for VxWorks Sources== | ||
Qt for VxWorks source code is available for Qt 5.15. | The latest Qt for VxWorks source code is available for Qt 5.15.14 via Qt account and Git. The source code release has been done on top of the Qt 5.15.14 release and it only supports building in Linux and Windows. | ||
The release provides Qt for VxWorks-specific changes in the <kbd>tqtc/ | The release provides Qt for VxWorks-specific changes in the <kbd>tqtc/lts-5.15-vxworks</kbd> branch on the following repositories: | ||
*qt/tqtc-qtbase | *qt/tqtc-qtbase | ||
Line 55: | Line 55: | ||
*qt/tqtc-qtdoc | *qt/tqtc-qtdoc | ||
The release is tagged as follows: <kbd>v5.15. | The release is tagged as follows: <kbd>v5.15.14-vxworks-lts.</kbd> | ||
For example, you can clone the Qt for VxWorks source code with the release tag as follows: | For example, you can clone the Qt for VxWorks source code with the release tag as follows: | ||
git clone -b tqtc/lts-5.15 | $ git clone -b tqtc/lts-5.15-vxworks "<nowiki>https://codereview.qt-project.org/qt/tqtc-qt5</nowiki>" | ||
cd tqtc-qt5 | $ cd tqtc-qt5 | ||
git checkout <kbd>v5.15. | $ git checkout <kbd>v5.15.14-vxworks-lts</kbd> | ||
perl-init repository | $ perl-init repository | ||
'''Note!''' Relevant option for <code>init-repository</code>: | '''Note!''' Relevant option for <code>init-repository</code>: | ||
*<code>--module-subset=default,-qtwebengine</code> : '''Consider skipping the web module''' (Qt WebEngine) by passing this option. It is quite big and takes a long time to compile (and is often a source of compile errors), so it is recommended to only download it if you intend to use it. You can always re-run init-repository later on to add it. | *<code>--module-subset=default,-qtwebengine</code> : '''Consider skipping the web module''' (Qt WebEngine) by passing this option. It is quite big and takes a long time to compile (and is often a source of compile errors), so it is recommended to only download it if you intend to use it. You can always re-run init-repository later on to add it. | ||
*See tips for other options in [https://wiki.qt.io/Building_Qt_5_from_Git#Getting_the_submodule_source_code] | *See tips for other options in [https://wiki.qt.io/Building_Qt_5_from_Git#Getting_the_submodule_source_code] |
Latest revision as of 08:46, 11 July 2023
Some Qt components are commercial-only and some branches, after the next minor version's branch has produced a release, continue as commercial-only LTS branches. Such commercial-only content is supplied in shadow repositories whose names have a tqtc- prefix, for example tqtc-qtbase corresponds to the public qt/qtbase. Only commercial customers and those who work closely with The Qt Company have access to these repositories.
The LTS commercial branches have a common prefix, tqtc/lts- – for example, tqtc/lts-5.15. You can add a shadow repository as a remote of an existing checkout of the corresponding public repository, with which it shares history. This is usually the most convenient way to work with commercial-only repositories.
Precondition: Gerrit account
You must have a Gerrit account to clone the LTS commercial Qt sources:
- Register to Gerrit as instructed in [1]. Some notes:
- If you just want to clone the sources, you need to follow the instructions in steps 1-3 and either set an SSH key (step 5) or an HTTP password (step 7).
- If you are going to contribute to the Qt Project, step 4 is mandatory.
- Login to Gerrit and follow the cloning instructions on this page.
Note! To be able to clone the LTS commercial sources, you must have a commercial license. An evaluation license does not provide access to the LTS commercial sources.
Cloning commands in Gerrit
You can clone the shadow repositories in all the usual ways. You can get sources for all Qt submodules or just one specific Qt submodule. The clone commands are visible in the Gerrit as follows:
- sign in to Gerrit with your Qt account (that has a valid commercial license): https://codereview.qt-project.org
- In Browse > Repositories, type "tqtc-qt5" to Filter field to open the top-level Qt 5 shadow repository. If you like to open some submodule shadow repository, type "tqtc-qt<submodule>". For example, "tqtc-qtbase".
- Under the Download topic, you can see the clone commands for different protocols (anonymous HTTP, HTTP, SSH).
- remember to check that you have either uploaded your SSH key or set the HTTP password. See steps 5 and 6 in [1].
Cloning all the Qt submodules
First clone the top-level Qt 5 git repository (the anonymous HTTP clone command is used in the following example):
$ git clone "https://codereview.qt-project.org/qt/tqtc-qt5"
Then check out the target branch. For example, check out the tqtc/lts-5.15 branch:
$ cd tqtc-qt5 $ git checkout tqtc/lts-5.15
Get the submodule source code (options are described in the [2]):
$ perl init-repository
Cloning specific Qt submodule
You can clone some specific Qt submodule, for example, Qt Base (the anonymous HTTP clone command is used in the following example). The lts branch is the default branch that is cloned:
$ git clone "https://codereview.qt-project.org/qt/tqtc-qtbase"
Cloning Qt for VxWorks Sources
The latest Qt for VxWorks source code is available for Qt 5.15.14 via Qt account and Git. The source code release has been done on top of the Qt 5.15.14 release and it only supports building in Linux and Windows.
The release provides Qt for VxWorks-specific changes in the tqtc/lts-5.15-vxworks branch on the following repositories:
- qt/tqtc-qtbase
- qt/tqtc-qtmultimedia
- qt/tqtc-qtdeclarative
- qt/tqtc-qtdoc
The release is tagged as follows: v5.15.14-vxworks-lts.
For example, you can clone the Qt for VxWorks source code with the release tag as follows:
$ git clone -b tqtc/lts-5.15-vxworks "https://codereview.qt-project.org/qt/tqtc-qt5"
$ cd tqtc-qt5
$ git checkout v5.15.14-vxworks-lts
$ perl-init repository
Note! Relevant option for
init-repository
:
- : Consider skipping the web module (Qt WebEngine) by passing this option. It is quite big and takes a long time to compile (and is often a source of compile errors), so it is recommended to only download it if you intend to use it. You can always re-run init-repository later on to add it.
--module-subset=default,-qtwebengine
- See tips for other options in [3]