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.

aqtinstall changeLog

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

Current changes

Unreleased

Added
Changed
Fixed
Deprecated
Removed
Security

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
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 argparser 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)

Indices and tables