構成

aqtinstall``は設定ファイルで設定できます。デフォルトの設定は ``aqt/settings.ini ファイルに保存されています。

環境変数 AQT_CONFIG やコマンドラインオプション``-c``や``--config`` でカスタム設定ファイルを指定することができます。

設定ファイルは次のようになります。

[DEFAULTS]

[aqt]
concurrency: 4
baseurl: https://download.qt.io
7zcmd: 7z
print_stacktrace_on_error: False
always_keep_archives: False
archive_download_location: .
min_archive_size: 41

[requests]
connection_timeout: 3.5
response_timeout: 30
max_retries_on_connection_error: 5
retry_backoff: 0.1
max_retries_on_checksum_error: 5
max_retries_to_retrieve_hash: 5
hash_algorithm: sha256
INSECURE_NOT_FOR_PRODUCTION_ignore_hash: False

[mirrors]
trusted_mirrors:
    https://download.qt.io
blacklist:
    http://mirrors.ustc.edu.cn
    http://mirrors.tuna.tsinghua.edu.cn
    http://mirrors.geekpie.club
fallbacks:
    https://mirrors.ocf.berkeley.edu/qt
    https://ftp.jaist.ac.jp/pub/qtproject
    http://ftp1.nluug.nl/languages/qt
    https://mirrors.dotsrc.org/qtproject

[kde_patches]
patches:
    0001-toolchain.prf-Use-vswhere-to-obtain-VS-installation-.patch

設定

[aqt] セクションは基本的な動作を設定します。

concurrency:

concurrency は、同時に開始するダウンロードの数を設定します。これは整数値でなくてはなりません。

baseurl:

baseurl はQtダウンロードサイトのURLです。独自のQtダウンロードサイトリポジトリがある場合は、ここで設定できます。これは``--base``オプションと同じです。

7zcmd:

圧縮解凍ツールの7-zipのコマンド名です。aqtinstall が 推奨ライブラリ``py7zr``なしで インストールされている場合、py7zr ライブラリの代わりにアーカイブを抽出するために使用されます。--external オプションが指定されている場合、オプションの指定値で上書きされます。

print_stacktrace_on_error:

print_stacktrace_on_error は、 True か``False``を値にとります。True に設定すると、プログラムを終了させるエラーが発生するたびにスタックトレースがstderrに出力されます。``False``に設定すると、未処理の例外が発生しない限り、スタックトレースは表示されません。

always_keep_archives:

これは、 True``か ``False を値にとります。True が設定さえると、 --keep オプションが、aqt実行時に毎回指定されたことになります。コマンドラインオプションで上書きできません。 False が設定されると、 aqt実行するときに``.7z``アーカイブを削除したくないときは、--keep を手動で設定する必要があります。

archive_download_location:

これは、--keep がオンになっている場合に、.7z アーカイブがダウンロードされる場所への相対パスまたは絶対パスです。この場所は、--archives-dest オプションで上書きできます。

min_module_size:

This is the minimum decompressed size, in bytes, of the modules that aqt is permitted to list. The authors of aqt have discovered that the Qt repository contains a few mysteriously "empty" modules, including the examples modules for qtlottie and qtquicktimeline. These modules consist of a single archive that contains empty directories, and they are exactly 40 bytes when uncompressed. The authors feel that it is not useful for aqt list-* to list these empty modules. If you want to print these modules with aqt list-*, please feel free to change the min_module_size value to something less than 40.

この設定はこれらのモジュールをインストールする能力に影響を与えません。aqt install-* は警告なしでそれらをインストールします。

[requests] セクションは、aqt がネットワークリクエストを行う方法を制御します。

connection_timeout:

connection_timeout は接続の秒単位のタイムアウトです。これは``requests``ライブラリに渡されます。

response_timeout:

``response_timeout``は応答待ち時間の秒単位のタイムアウトです。これは``requests``ライブラリに渡されます。

max_retries:

廃止されました。この設定は使用しないでください。

max_retries_on_connection_error:

max_retries_on_connection_error は、接続エラーが発生した場合に aqt がサーバに再接続しようとする回数を制御する整数です。

retry_backoff:

retry_backoff は浮動小数点数で、aqt が失敗した接続試行間にスリープする時間を制御します。この値をあまりに低く設定するとサーバに衝撃を与え、接続が全く成功しなくなる可能性があります。

max_retries_on_checksum_error:

この設定は、チェックサムエラーが発生した場合に aqt がファイルをダウンロードしようとする回数を制御します。

hash_algorithm:

This is either sha256, sha1 or md5. sha256 is the only safe value to use here. Default is sha256 if not set. See also trusted_mirrors setting.

INSECURE_NOT_FOR_PRODUCTION_ignore_hash:

This is either True or False. The True setting disables hash checking when downloading files. Although this is not recommended, this may help when hashes are not available. The False setting will enforce hash checking. This is highly recommended to avoid corrupted files.

[mirrors] セクションはミラー処理のための設定です。

trusted_mirrors:

trusted_mirrors は、ダウンロードされたすべてのアーカイブに対して正確なチェックサムを提供するために信頼しているURLのリストです。これはセキュリティ機能です。何をしているのかわからない限り、この値を変更しないでください!

aqtinstall は、このリスト内のミラーからすべてのチェックサムをダウンロードします。これらのチェックサムは、aqtinstall がダウンロードする他のすべてのファイルが、実際には正しいファイルであり、そのファイルの不正コピーや悪意のあるコピーではないことを確認するために使用されます。デフォルトのミラーにアクセスできない場合や、ミラーが侵害されていないと信頼できない場合は、このリストを変更する必要があります。

aqtinstall は、フォールバックミラーリストからアーカイブファイルを安全にダウンロードし、trusted_mirrors リストからダウンロードしたチェックサムに照らして、それらが悪意のあるファイルでないことを確認することができます。aqtinstall は、SHA-256アルゴリズムを使ってこのチェックを行います。

blacklist:

It is a list of URL where is a problematic mirror site. Some mirror sites ignore a connection from IP addresses out of their preffered one. It will cause connection error or connection timeout. There are some known mirror sites in default. If you are not happy with the default sites, you can override them with custom settings.

fallbacks:

アクセスに適したURLの一覧です。ミラーサイトでエラーが発生した場合は、可能な場合はフォールバックを使用してください。ミラーの一覧は次の場所で確認できます: https://download.qt.io/static/mirrorlist/