Welcome to aqtinstall’s documentation!

Contents:

Command Line Options

The CLI uses argparse to parse the command line options so the short or long versions may be used and the long options may be truncated to the shortest unambiguous abbreviation.

list

list available versions (not implemented yet)

help

show generic help

install <Qt version> <target OS> <target variant> <target environment>

install Qt library specified version and target.

Qt version

This is a Qt version such as 5.9,7, 5.12.1 etc

target OS

linux, windows or mac

target variant

desktop or android

target environment
  • gcc_64 for linux desktop
  • clang_64 for mac desktip
  • win64_msvc2019_64, win64_msvc2017_64, win64_msvc2015_64, in32_msvc2015, win32_mingw53 for windows desktop
  • android_x86, android_armv7 for android
--version, -v

Display version

--help, -h

Display help text

--outputdir, -O <Output Directory>

specify output directory.

--base, -b <base url>

specify mirror site base url such as -b ‘https://mirrors.ocf.berkeley.edu/qt/’ where ‘online’ folder exist.

--modules, -m <list of modules>

specify extra modules to install as a list.

--archives <list of archives>

[Advanced] specify subset of archives to limit installed archvies.

src <Qt version> <target OS> <target variant>

install Qt sources specified version and target.

doc <Qt version> <target OS> <target variant>

install Qt documents specified version and target.

examples <Qt version> <target OS> <target variant>

install Qt examples specified version and target.

tools <target OS> <target tool name> <target tool version> <tool variant name>

install tools specified. tool name may be ‘tools_openssl_x64’, ‘tools_ninja’, ‘tools_ifw’, ‘tools_cmake’ and tool variants name may be ‘qt.tools.openssl.gcc_64’, ‘qt.tools.ninja’, ‘qt.tools.ifw.32’, ‘qt.tools.cmake’. You may need to looking for version number at https://download.qt.io/online/qtsdkrepository/

Internals

Archives module

Installer module

Cli module

Helper module

QtPatch module

aqtinstall changeLog

All notable changes to this project will be documented in this file.

Current changes

Unreleased

Added
Changed
Fixed
Deprecated
Removed
Security

v0.10.0 (25, Nov. 2020)

Added
  • Add v5.12.2, v6.0.0 as known versions.(#176, #177)
  • Support –archives option on src installation.
Changed
  • Use multiprocessing.Pool instead of concurrent.futures(#178)
  • Refactoring whole modules. (#179)
  • Split old changelogs to CHNAGELOG_prerelease.rst
  • Drop an upper limitaion (<0.11) for py7zr.(#183)
Fixed
  • When we used “-m all” to download doc or examples, Qt sources are also downloaded(@Gamso)(#182)

v0.9.8 (4, Nov. 2020)

Added
  • Added new combinations for tools_ifw
Fixed
  • When we start an installation, all packages are downloaded whatever the specified platform.(#159)

Contribution guide

This is contribution guide for aqtinstall project. You are welcome to send a Pull-Request, reporting bugs and ask questions.

Resources

  • Project owner: Hiroshi Miura
  • Bug Tracker: Github issue Tracker
  • Status: Beta
  • Activity: moderate

Bug triage

Every report to github issue tracker should be in triage. whether it is bug, question or invalid.

Send patch

Here is small amount rule when you want to send patch the project;

  1. every proposal for modification should send as ‘Pull Request’
  1. each pull request can consist of multiple commits.
  1. you are encourage to split modifications to individual commits that are logical subpart.

CI tests

The project configured to use Azure Pipelines, Travis-CI and CoverAlls for regression test. You can see test results on badge and see details in a web page linked from badge.

Authors

Aqtinstall is written and maintained by Hiroshi Miura <miurahr@linux.com>

Original qli-installer is written by Linus Jahn

Contributors, listed alphabetically, are:

  • Gamso (improve parsing of update.xml)
  • Kyle Altendorf (7z binary path search)
  • Martin Delille
  • Nelson Chen (CI tests)
  • Skycoder42 (Explicit extra module installation)
  • Thomas Grainger

Indices and tables