diff --git a/docs/available_versions.rst b/docs/available_versions.rst index 1adb497..f9a3a6a 100644 --- a/docs/available_versions.rst +++ b/docs/available_versions.rst @@ -2,12 +2,16 @@ .. _available_versions: -Available Qt versions(Informative) -================================== +===================== +Available Qt versions +===================== Here is an available combinations of Qt versions and platforms. It is based on contents at https://download.qt.io/ as in January, 2021. -It may be changed by The Qt Foundation. + +WARNING: Older versions may be removed and new version will be added, +because The Qt Foundation maintains the site and aqtinstall just see there. +So there is no guarantee for you to be able to install versions listed here. Linux ===== @@ -15,42 +19,43 @@ Linux desktop ------- -+---------+---------------------------------------------+ -| Variant | Qt Versions | -+=========+=============================================+ -| gcc_64 | 5.15.2 | -| wasm_32 | 5.15.1 5.15.0 | -| | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 | -+---------+---------------------------------------------+ -| | 6.0.1 6.0.0 5.13.0 | -| gcc_64 | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -+---------+---------------------------------------------+ ++-----------+---------------------------------------------+ +| Variant | Qt Versions | ++===========+=============================================+ +| gcc_64 | - 6.0.1, 6.0.0, 5.13.0 | +| | - 5.15.2, 5.15.1, 5.15.0 | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5, | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++-----------+---------------------------------------------+ +| wasm_32 | - 5.15.2, 5.15.1, 5.15.0 | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1 | ++-----------+---------------------------------------------+ android ------- -+-------------------+---------------------------------------------+ -| Variant | Qt Versions | -+===================+=============================================+ -| android_armv7 | 6.0.1 6.0 | -| android_arm64_v8a | | -| android_x86 | | -| android_x86_64 | | -+-------------------+---------------------------------------------+ -| android_armv7 | 5.15.2 5.15.1 5.15.0 | -| android_x86 | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 5.13.0 | -| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -+-------------------+---------------------------------------------+ ++---------------------+---------------------------------------------+ +| Variant | Qt Versions | ++=====================+=============================================+ +| - android_arm64_v8a | - 6.0.1, 6.0.0 | +| - android_x86_64 | | ++---------------------+---------------------------------------------+ +| | - 6.0.1, 6.0.0 | +| - android_armv7 | - 5.15.2 5.15.1 5.15.0 | +| - android_x86 | - 5.14.2 5.14.1 5.14.0 | +| | - 5.13.2 5.13.1 5.13.0 | +| | - 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| | - 5.11.3 5.11.2 5.11.1 5.11.0 | +| | - 5.10.1 5.10.0 | +| | - 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | ++---------------------+---------------------------------------------+ mac @@ -59,43 +64,44 @@ mac desktop ------- -+---------+---------------------------------------------+ -| Variant | Qt Versions | -+=========+=============================================+ -| clang_64| | -| wasm_32 | 5.15.2 5.15.1 5.15.0 | -| | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 | -+---------+---------------------------------------------+ -| | 6.0.1 6.0.0 | -| | 5.13.0 | -| clang_64| 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -+---------+---------------------------------------------+ ++-----------+---------------------------------------------+ +| Variant | Qt Versions | ++===========+=============================================+ +| clang_64 | - 6.0.1, 6.0.0, 5.13.0 | +| | - 5.15.2, 5.15.1, 5.15.0 | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5, | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++-----------+---------------------------------------------+ +| wasm_32 | - 5.15.2, 5.15.1, 5.15.0 | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1 | ++-----------+---------------------------------------------+ + android ------- -+-------------------+---------------------------------------------+ -| Variant | Qt Versions | -+===================+=============================================+ -| android_armv7 | 6.0.1 6.0 | -| android_arm64_v8a | | -| android_x86 | | -| android_x86_64 | | -+-------------------+---------------------------------------------+ -| android_armv7 | 5.15.2 5.15.1 5.15.0 | -| android_x86 | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 5.13.0 | -| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -+-------------------+---------------------------------------------+ ++---------------------+---------------------------------------------+ +| Variant | Qt Versions | ++=====================+=============================================+ +| - android_arm64_v8a | - 6.0.1, 6.0.0 | +| - android_x86_64 | | ++---------------------+---------------------------------------------+ +| | - 6.0.1, 6.0.0 | +| - android_armv7 | - 5.15.2, 5.15.1, 5.15.0 | +| - android_x86 | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1, 5.13.0 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5 | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++---------------------+---------------------------------------------+ ios --- @@ -103,15 +109,15 @@ ios +-------------------+---------------------------------------------+ | Variant | Qt Versions | +===================+=============================================+ -| ios | 6.0.1 6.0 | -| | 5.15.2 5.15.1 5.15.0 | -| | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 5.13.0 | -| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | +| ios | - 6.0.1, 6.0.0 | +| | - 5.15.2, 5.15.1, 5.15.0 | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1, 5.13.0 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5 | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | +-------------------+---------------------------------------------+ windows @@ -123,66 +129,116 @@ desktop +--------------------+---------------------------------------------+ | Variant | Qt Versions | +====================+=============================================+ -| win32_mingw81 | 6.0.1 6.0.0 | -| win64_msvc2019_64 | | +| win64_msvc2019_64 | - 6.0.1, 6.0.0 | +| | - 5.15.2, 5.15.1, 5.15.0 | ++--------------------+---------------------------------------------+ +| win32_msvc2019 | - 5.15.2 5.15.1 5.15.0 | ++--------------------+---------------------------------------------+ +| win64_msvc2017_64 | | +| | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2, 5.13.1, 5.13.0 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5, | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++--------------------+---------------------------------------------+ +| | - 5.14.2, 5.14.1, 5.14.0 | +| win32_msvc2017 | - 5.13.2, 5.13.1, 5.13.0 | +--------------------+---------------------------------------------+ -| win32_mingw81 | 5.15.2 5.15.1 5.15.0 | -| win32_msvc2019 | | | win64_msvc2015_64 | | -| win64_msvc2019_64 | | +| | - 5.15.2 5.15.1 5.15.0 | +| | - 5.14.2 5.14.1 5.14.0 | +| | - 5.13.2 5.13.1, 5.13.0 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5, | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++--------------------+---------------------------------------------+ +| | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| win32_msvc2015 | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++--------------------+---------------------------------------------+ +| win32_mingw81 | - 6.0.1, 6.0.0 | +| | - 5.15.2, 5.15.1, 5.15.0 | ++--------------------+---------------------------------------------+ +| win32_mingw73 | - 5.14.2, 5.14.1, 5.14.0 | +| | - 5.13.2 5.13.1, 5.13.0 | +| | - 5.12.9, 5.12.8, 5.12.7, 5.12.6, 5.12.5, | +| | 5.12.4, 5.12.3, 5.12.2, 5.12.1, 5.12.0 | ++--------------------+---------------------------------------------+ +| win32_mingw53 | - 5.11.3, 5.11.2, 5.11.1, 5.11.0 | +| | - 5.10.1, 5.10.0 | +| | - 5.9.9, 5.9.8, 5.9.7, 5.9.6, 5.9.5 | ++--------------------+---------------------------------------------+ | wasm_32 | | +| | - 5.15.2 5.15.1 5.15.0 | +| | - 5.14.2 5.14.1 5.14.0 | +| | - 5.13.2 5.13.1 | +--------------------+---------------------------------------------+ -| win32_mingw73 | 5.14.2 5.14.1 5.14.0 | -| win32_msvc2017 | 5.13.2 5.13.1 | -| win64_msvc2015_64 | | -| win64_msvc2017_64 | | -| wasm_32 | | -+--------------------+---------------------------------------------+ -| win32_mingw73 | 5.13.0 | -| win32_msvc2017 | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| win64_msvc2015_64 | 5.12.3 5.12.2 5.12.1 5.12.0 | -| win64_msvc2017_64 | | -+--------------------+---------------------------------------------+ -| win32_mingw53 | 5.11.3 5.11.2 5.11.1 5.11.0 | -| win32_msvc2015 | | -| win64_msvc2015_64 | | -| win64_msvc2017_64 | | -+--------------------+---------------------------------------------+ -| win32_mingw53 | 5.10.1 5.10.0 | -| win32_msvc2015 | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -| win64_msvc2013_64 | | -| win64_msvc2015_64 | | -| win64_msvc2017_64 | | -+--------------------+---------------------------------------------+ + winrt ----- - +----------------------------+-------------------------------------+ | Variant | Qt Versions | +============================+=====================================+ +| win64_msvc2019_winrt_x64 | 5.15.2 5.15.1 5.15.0 | +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | ++----------------------------+-------------------------------------+ +| win64_msvc2019_winrt_armv7 | 5.15.2 5.15.1 5.15.0 | +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | ++----------------------------+-------------------------------------+ +| win64_msvc2019_winrt_x86 | 5.15.2 5.15.1 5.15.0 | +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | ++----------------------------+-------------------------------------+ +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| win64_msvc2017_winrt_armv7 | | ++----------------------------+-------------------------------------+ +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| win64_msvc2017_winrt_x64 | | ++----------------------------+-------------------------------------+ +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| win64_msvc2017_winrt_x86 | | ++----------------------------+-------------------------------------+ | win64_msvc2015_winrt_armv7 | 5.15.2 5.15.1 5.15.0 | -| win64_msvc2015_winrt_x64 | | -| win64_msvc2019_winrt_armv7 | | -| win64_msvc2019_winrt_x64 | | -| win64_msvc2019_winrt_x86 | | -+--------------------+---------------------------------------------+ -| win64_msvc2015_winrt_armv7 | 5.14.2 5.14.1 5.14.0 | +| | 5.14.2 5.14.1 5.14.0 | +| | 5.13.2 5.13.1 5.13.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| | 5.11.2 5.11.1 5.11.0 | +| | 5.10.1 5.10.0 | +| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | ++----------------------------+-------------------------------------+ +| | 5.14.2 5.14.1 5.14.0 | | win64_msvc2015_winrt_x64 | 5.13.2 5.13.1 5.13.0 | -| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| win64_msvc2017_winrt_armv7 | | -| win64_msvc2017_winrt_x64 | | -| win64_msvc2017_winrt_x86 | | -+--------------------+---------------------------------------------+ -| win64_msvc2015_winrt_armv7 | 5.11.2 5.11.1 5.11.0 | -| win64_msvc2015_winrt_x64 | 5.10.1 5.10.0 | +| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | ++----------------------------+-------------------------------------+ +| | 5.11.2 5.11.1 5.11.0 | +| | 5.10.1 5.10.0 | | win64_msvc2015_winrt_x86 | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | -| win64_msvc2017_winrt_armv7 | | -| win64_msvc2017_winrt_x64 | | -| win64_msvc2017_winrt_x86 | | -+--------------------+---------------------------------------------+ ++----------------------------+-------------------------------------+ android ------- @@ -190,18 +246,17 @@ android +-------------------+---------------------------------------------+ | Variant | Qt Versions | +===================+=============================================+ -| android_armv7 | 6.0.1 6.0 | -| android_arm64_v8a | | -| android_x86 | | +| android_arm64_v8a | - 6.0.1, 6.0.0 | | android_x86_64 | | +-------------------+---------------------------------------------+ -| android_armv7 | 5.15.2 5.15.1 5.15.0 | -| android_x86 | 5.14.2 5.14.1 5.14.0 | -| | 5.13.2 5.13.1 5.13.0 | -| | 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 5.12.4 | -| | 5.12.3 5.12.2 5.12.1 5.12.0 | -| | 5.11.3 5.11.2 5.11.1 5.11.0 | -| | 5.10.1 5.10.0 | -| | 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | +| | - 6.0.1, 6.0.0 | +| android_armv7 | - 5.15.2, 5.15.1, 5.15.0 | +| android_x86 | - 5.14.2 5.14.1 5.14.0 | +| | - 5.13.2 5.13.1 5.13.0 | +| | - 5.12.9 5.12.8 5.12.7 5.12.6 5.12.5 | +| | 5.12.4 5.12.3 5.12.2 5.12.1 5.12.0 | +| | - 5.11.3 5.11.2 5.11.1 5.11.0 | +| | - 5.10.1 5.10.0 | +| | - 5.9.9 5.9.8 5.9.7 5.9.6 5.9.5 | +-------------------+---------------------------------------------+ diff --git a/docs/cli.rst b/docs/cli.rst index 0ad0ae0..7194691 100644 --- a/docs/cli.rst +++ b/docs/cli.rst @@ -9,14 +9,18 @@ long options may be truncated to the shortest unambiguous abbreviation. .. program:: aqt -.. option:: list - - list available versions (not implemented yet) - .. option:: help show generic help +.. option:: list + + list available variations. + positional arguments: + qt_version Qt version in the format of "5.X.Y" + {linux,mac,windows} host os name + {desktop,winrt,android,ios} target sdk + .. option:: install install Qt library specified version and target. diff --git a/docs/index.rst b/docs/index.rst index d1638bd..c6ceecd 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -6,6 +6,7 @@ Contents: .. toctree:: :maxdepth: 2 + installation cli available_versions internals diff --git a/docs/installation.rst b/docs/installation.rst new file mode 100644 index 0000000..2493441 --- /dev/null +++ b/docs/installation.rst @@ -0,0 +1,89 @@ +: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 ][-b | --base ][-E | --external <7zip command>] \ + install [] [-m all | -m [extra module] [extra module]...] [--internal] + [--archives [ ...]] [--timeout ] + +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 ][-b | --base ][-E | --external <7zip command>] \ + tool [--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//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