mirror of
https://github.com/miurahr/aqtinstall.git
synced 2025-12-18 05:04:38 +03:00
90 lines
3.1 KiB
ReStructuredText
90 lines
3.1 KiB
ReStructuredText
:tocdepth: 2
|
|
|
|
.. _installation:
|
|
|
|
Installation
|
|
============
|
|
|
|
Requirements
|
|
------------
|
|
|
|
- Minimum Python version: 3.6
|
|
- Recommended Python version: 3.7.5 or later
|
|
|
|
- Dependent libraries: requests, py7zr
|
|
|
|
|
|
Install by pip command
|
|
----------------------
|
|
|
|
Same as usual, it can be installed with `pip`
|
|
|
|
.. code-block:: bash
|
|
|
|
$ pip install aqtinstall
|
|
|
|
|
|
Usage
|
|
=====
|
|
|
|
General usage looks like this:
|
|
|
|
.. code-block:: bash
|
|
|
|
aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
|
|
install <qt-version> <host> <target> [<arch>] [-m all | -m [extra module] [extra module]...] [--internal]
|
|
[--archives <archive>[ <archive>...]] [--timeout <timeout(sec)>]
|
|
|
|
You can also call with ``python -m aqt`` syntax as well as command script ``aqt``.
|
|
|
|
* The Qt version is formatted like this: `5.11.3`
|
|
* Host is one of: `linux`, `mac`, `windows`
|
|
* Target is one of: `desktop`, `android`, `ios` (iOS only works with mac host)
|
|
* For some platforms you also need to specify an arch:
|
|
* For windows, choose one of:
|
|
* `win64_msvc2019_64`, `win32_msvc2019`,
|
|
* `win64_msvc2017_64`, `win32_msvc2017`,
|
|
* `win64_msvc2015_64`, `win32_msvc2015`,
|
|
* `win64_mingw81`, `win32_mingw81`,
|
|
* `win64_mingw73`, `win32_mingw73`,
|
|
* `win64_mingw53`, `win32_mingw53`,
|
|
* `win64_msvc2019_winrt_x64`, `win64_msvc2019_winrt_x86`, `win64_msvc2019_winrt_armv7`
|
|
* `win64_msvc2017_winrt_x64`, `win64_msvc2017_winrt_x86`, `win64_msvc2017_winrt_armv7`
|
|
* For android and Qt 5.13 or below, choose one of: `android_x86_64`, `android_arm64_v8a`, `android_x86`,
|
|
`android_armv7`
|
|
* You can specify external 7zip command path instead of built-in extractor.
|
|
* When specifying `all` for extra modules option `-m` all extra modules are installed.
|
|
|
|
|
|
Installing tool and utility (Experimental)
|
|
------------------------------------------
|
|
|
|
You can install tools and utilities using following syntax;
|
|
|
|
.. code-block:: bash
|
|
|
|
python -m aqt [-h][--help][-O | --outputdir <directory>][-b | --base <mirror url>][-E | --external <7zip command>] \
|
|
tool <host> <tool_name> <tool-version> <arch> [--timeout <timeout>]
|
|
|
|
* tool_name is one of `tools_ifw`, `tools_vcredist`, and `tools_openssl`.
|
|
* arch is full qualified tool name such as `qt.tools.ifw.31` which values can be seen on Qt `archive_site`_
|
|
This is a quite experimental feature, may not work and please use it with your understanding of what you are doing.
|
|
* It does not recognize 'installscript.qs'. When using tools which depends on a qt script, you should do something by yourself.
|
|
|
|
.. _`archive_site`: https://download.qt.io/online/qtsdkrepository/linux_x64/desktop/tools_ifw/
|
|
|
|
|
|
Target directory
|
|
----------------
|
|
|
|
aqt can take option '--outputdir' or '-O' that specify a target directory.
|
|
|
|
The Qt packages are installed under current directory as such `Qt/<ver>/gcc_64/`
|
|
If you want to install it in `C:\Qt` as same as standard gui installer default,
|
|
run such as follows:
|
|
|
|
.. code-block:: bash
|
|
|
|
C:\> mkdir Qt
|
|
C:\> aqt install --outputdir c:\Qt 5.11.3 windows desktop win64_msvc2019_64
|