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_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 ‘http://mirrors.ocf.berkeley.edu/qt/’ where ‘online’ folder exist.

--modules, -m <list of modules>

specify extra modules to install as a list.

aqtinstall changeLog

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

Current changes

Unreleased

Added
Changed
Fixed
Deprecated
Removed
Security

v0.6 (29, Nov., 2019)

  • same as v0.6b2

v0.6b2 (24, Nov., 2019)

Changed
  • Now don’t install extra modules when installing ‘wasm_32’ arch. You should explicitly specify it with ‘-m’ option.
Fixed
  • Fix error when mirror option specified other than http such as https, ftp.

v0.6b1 (23, Nov., 2019)

Changed
  • Just warn when argument combination check is failed.
  • CI: Compress sample project for build test with 7zip.
  • CI: Place sample script in ci directory.

v0.6a2 (19, Nov., 2019)

Added
  • Test: Unit test against command line.
  • Android target variants.
Changed
  • Use logging configuration with logging.ini
Fixed
  • qconfig.pri: fix QT_LICHECK line.
Removed
  • Logging configuration file logging.yml
  • Drop dependency for pyyaml.

v0.6a1 (17, Nov., 2019)

Added
  • More build test with sample project which uses an extra module.(#56)
  • Add support for installation of WebAssembly component by specifying ‘wasm_32’ as an arch argument.(#53, #55)
Changed
  • Optional modules are installed explicitly. Users need to specify extra modules with -m option.(#52, #56)
Fixed
  • Dependency for py7zr only for python > 3.5. Now it works with python2.7.

v0.5 (10, Nov., 2019)

Changed
  • Introduce combination DB in json form. User and developer now easily add new component for installation checking.
Fixed
  • requires py7zr >= 0.4.1 because v0.4 can fails to extract file.

v0.5b2 (8, Oct., 2019)

Changed
  • Change install path from <target>/Qt/Qt<version>/<version> to <target>/<version> (#48). - Also update CI test to specify –outputdir <target> that is $(BinariesDirectory)/Qt

v0.5b1 (8, Oct., 2019)

Added
  • Add feature to support installation of Qt Tools
  • Add CI test for tool installation
Changed
  • CI test target - add 5.14.0 - remove 5.11.3 - change patch_levels to up-to-date

v0.4.3 (25, Sep, 2019)

Fixed
  • Allow multiple redirection to mirror site.(#41)

v0.4.2 (28, Jul, 2019)

Changed
  • README: update badge layout.
  • CI: Improve azure-pipelines configurations by Nelson (#20)
  • Check parameter combination allowance and add winrt variant.
  • Support installation of mingw runtime package.
  • Add ‘–internal’ option to use py7zr instead of external 7zip command for extracting package archives.(WIP)

v0.4.1 (01, Jun, 2019)

Added
  • Option -b | –base to specify mirror site.(#24)
Changed
  • CI: add script to generate auzre-pipelines.yml (#27, #28, #29)
  • CI: use powershell script for linux, mac and windows. (#26)
Fixed
  • Avoid blacklisted mirror site that cause CI fails.(#25)

v0.4.0 (29, May, 2019)

Added
  • cli: output directory option.
  • sphinx document.
  • test packaging on CI.
  • Handler for metalink information and intelligent mirror selection.
Changed
  • Change project directory structure.
  • cli command name changed from ‘aqtinst’ to ‘aqt’ and now you can run ‘aqt install’
  • Introduce Cli class
  • Massive regression test on azure pipelines(#20)
  • blacklist against http://mirrors.tuna.tsinghua.edu.cn and http://mirrors.geekpie.club/ from mirror site.
  • Run 7zip command with ‘-o{directory}’ option.
Fixed
  • Fix File Not Found Error when making qt.conf against win64_mingw73 and win32_mingw73

v0.3.1 (15, March, 2019)

Added
  • Qmake build test code in CI environment.(#14)
Fixed
  • Connect to Qt download server through proxy with authentication.(#17)
Changed
  • Change QtInstaller.install() function signature not to take any parameter.
  • Replace standard urllib to requests library.(#18)
  • Use 7zr external command instead of 7z in Linux and mac OSX envitonment.
Removed
  • requirements.txt file.

v0.3.0 (8, March, 2019)

Added
  • Allow execute both ‘aqtinst’ and ‘python -m aqt’ form.
Changed
  • Project URL is changed.
  • Generate universal wheel support both python2.7 and python 3.x.
Fixed
  • Update README wordings.
  • Remove dependency for python3 with ‘aqtinst’ command utility.
  • Fix command name in help message.

v0.2.0 (7, March, 2019)

Added
  • Released on pypi.org
Changed
  • Install not only basic packages also optional packages.
  • Rename project/command to aqt - Another QT installer
Fixed
  • Update mkspecs/qconfig.pri to indicate QT_EDITION is OpenSource
  • Support Python2

v0.1.0 (5, March, 2019)

Changed
  • Support multiprocess concurrent download and installation.

v0.0.2 (4, March, 2019)

Added

  • CI test on Azure-pipelines

Changed

  • Refactoring code
  • Install QtSDK into (cwd)/Qt<version>/<version>/gcc_64/
  • Drop dependency for requests library
  • Use standard argparse for command line argument.

Fixed

  • Support windows.
  • looking for 7zip in standard directory.

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: alpha
  • Activity: high

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.

aqtinstall authors

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

Original qli-installer is written by Linus Jahn

Contributors, listed alphabetically, are:

  • Nelson Chen (CI tests)
  • Skycoder42 (Explicit extra module installation)

Indices and tables