コマンドラインインターフェイスを使った Qt の入手とインストール
Qt Online Installer とQt Maintenance Tool のコマンドラインインターフェイスを使用して、コンポーネントのインストール、アンインストール、更新、検索を行います。
コマンドラインインターフェイスは、対話的な使用法と非対話的な使用法（無人での使用法）の両方をサポートしています。以下のトピックでは、コマンドラインインターフェースの使用方法に関する例と情報を提供します：
- インストールのためのコンポーネント名
- ユーザー操作なしのインストール
- ユーザ操作によるインストール
- パッケージのアンインストール
- インストール済みパッケージの一覧表示
- アップデートの確認
- パッケージの更新
- よく使われるコマンド
- オープンソース用ミラーの選択
- コマンドラインインターフェイスの使い方
インストールのためのコンポーネント名
エイリアスパッケージを使ったクイックインストール
注意: エイリアスパッケージを使ったクイックインストールは、Qt Online Installer リリース 4.8 で利用できるようになります。
インストールのために特定のパッケージ名を検索する代わりに、エイリアスパッケージを使用して最も一般的な設定をインストールすることができます。エイリアスパッケージは、実際のパッケージを含めるためのショートカットで あり、より簡単にインストールできます。
既存のエイリアスパッケージを一覧表示するには、コマンドラインインターフェ ースで以下のコマンドを使用します：
installer.exe / maintenancetool.exe search
エイリアスパッケージの内容は以下の表の通りです。
注意: 以下のエイリアスパッケージの例では、Qt 6.8.0 リリースを使用しています。常に、作業中の Qt リリースに一致するパッケージを使用することを忘れないでください。
| エイリアスパッケージ名 | Qt Online Installer (パッケージの内容) |
|---|---|
| qt6.8.0-essentials |
|
| qt6.8.0-essentials-dev |
|
| qt6.8.0-full |
|
| qt6.8.0-full-dev |
|
| qt6.8.0-full-dbg |
|
| qt6.8.0-sdk |
|
Qt Online Installer コマンドの例
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe install qt6.8.0-sdk
# macOS: new installation with Qt Online Installer
hdiutil attach qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg
/Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online/qt-unified-macOS-x64-[Qt Online Installer version]-online.app/Contents/MacOS/qt-unified-macOS-x64-[Qt Online Installer version]-online install qt6.8.0-sdk
hdiutil detach /Volumes/qt-unified-macOS-x64-[Qt Online Installer version]-online
# Linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run install qt6.8.0-sdkエイリアスでないパッケージのリストアップ
エイリアス以外のパッケージを一覧表示するには、コマンドラインインターフェイスで以下のコマンドを使います：
installer.exe / maintenancetool.exe search --type package
特定のインストールパッケージの高度な検索
search コマンドと正規表現を使って利用可能なパッケージを検索します： search <regexp>.で結果をフィルタリングできます。 --filter-packages <regexp>.例えば、表示名情報でフィルタリングすると、検索に役立ちます。
例えば、次のコマンドは Qt 6.8.0 用の MSVC 2022 パッケージをすべて検索します：
search .*680.*msvc2022
検索結果を以下のようにフィルタリングしても、同じ結果が得られます：
search --filter-packages DisplayName=MSVC 2022,Version=6.8.0
その結果、以下のパッケージが見つかります：
<availablepackages>
<package name="qt.qt6.680.win64_msvc2022_64" displayname="MSVC 2022 64-bit" version="6.8.0-0-202303290841"/>
<package name="qt.qt6.680.win64_msvc2022_arm64" displayname="MSVC 2022 ARM64 (TP)" version="6.8.0-0-202303290841"/>
</availablepackages>あるパッケージが提供されているすべての Qt バージョンを検索する場合にも、フィルタリングを使用できます。例えば、Qt バージョンで提供されているすべてのQt Charts パッケージを検索します：
search --filter-packages DisplayName=charts
検索結果は以下のようになります：
<availablepackages>
<package name="qt.qt5.5125.qtcharts" displayname="Qt Charts" version="5.12.5-0-201909090651"/>
<package name="qt.qt6.641.addons.qtcharts" displayname="Qt Charts" version="6.4.1-0-202211101525"/>
<package name="qt.qt5.5123.qtcharts" displayname="Qt Charts" version="5.12.3-0-201904161619"/>ユーザーを介さないインストール
デフォルトでは、Qt Online Installer やQt Maintenance Tool は、インストール中に追加情報の入力を求めることがあります。適切なオプションを指定して、要求されたすべての情報を事前に提供することで、コマンドラインインターフェイスを使った無人での利用が可能になります。
での新規インストールQt Online Installer
以下のように、コマンドラインインターフェイスから、ユーザーの操作なしで新規インストールを行うことができます：
- 実行ファイルを定義します。 Qt Online Installer実行ファイルを定義します。
- 実行ファイルを定義します。
--root. - コマンドを使用します。
install <list of packages>コマンドを使用します。オプションの完全なリストは、「Options for Unattended Usage」を参照してください。
以下の例では、Windows、macOS、Linux 用の Qt 6.8.0 バイナリをQt Online Installer でインストールする方法を示します。無人コマンドは自動的にライセンス (--accept-licenses)、すべてのメッセージクエリにデフォルトの回答(--default-answer)、実行を続行する許可を求めるのをスキップします(--confirm-command):
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.680.win64_msvc2022_64
# macOS: new installation with Qt Online Installer
qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.680.clang_644
# linux: new installation with Qt Online Installer
qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir --accept-licenses --default-answer --confirm-command install qt.qt6.680.gcc_64無人使用のオプションには、無人使用で利用可能なすべてのオプションが記載されています。
コマンドによるインストールの更新Qt Maintenance Tool
以下のように、コマンドラインインタフェースから、ユーザの操作なしで既存のインストールを更新できます：
- 実行ファイルを定義します。 Qt Maintenance Tool実行可能ファイルを定義します。
- 実行ファイルを定義します。
install <list of packages>を使用します。オプションの完全なリストは、「無人使用のオプション」を参照してください。
以下の例では、Qt 6.8.0 のバイナリを Windows、macOS、Linux の exsting インストールにQt Maintenance Tool とともに追加する方法を示します。無人コマンドは自動的にライセンス (--accept-licenses)、すべてのメッセージクエリにデフォルトの回答(--default-answer)、実行を続行する許可を求めるのをスキップします(--confirm-command):
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe --accept-licenses --default-answer --confirm-command install qt.qt6.680.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.app/Contents/MacOS/MaintenanceTool --accept-licenses --default-answer --confirm-command install qt.qt6.680.clang_64
# linux: update installation with Qt Maintenance Tool
MaintenanceTool.run --accept-licenses --default-answer --confirm-command install qt.qt6.680.gcc_64無人使用のオプション
以下の表に、無人コマンドライン使用時のすべてのオプションを示します：
| 無人使用時のオプション | 説明 |
|---|---|
--accept-licenses | すべてのライセンス契約を自動的に受け入れます。 |
--accept-obligations | オープンソースのインストールでは、ユーザー入力なしで Qt オープンソースの使用義務を受け入れます。 |
--default-answer | すべてのメッセージクエリにデフォルトの答えを返します。 |
--auto-answer <identifier=value> | 特定のクエリに対して異なる回答が必要な場合は、このオプションを使用できます。例えば、--auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes 。auto-answer」については、「Message Identifiers」の「Message Identifiers」を参照してください。 |
--accept-messages | すべてのメッセージ・クエリを受け付けます。 |
--reject-messages | すべてのメッセージ・クエリを拒否します。 |
--confirm-command | デフォルトでは、Qt Online Installer とQt Maintenance Tool は、オプションの影響を受けるコンポーネントの概要を表示します。その後、偶発的な変更を防ぐために、動作を継続する許可を求める。このオプションは継続の許可を求めるのをスキップする。 |
--email <your_email> | コマンドラインからログインしたときの電子メールを提供する。詳細については、ログイン情報の提供を参照してください。 |
--pw <your_pw> | コマンドラインからログインする際にパスワードを提供する。詳細については、ログイン情報の提供を参照してください。 |
--file-query <identifier=value> | Qt Online Installer がファイルやフォルダの場所を尋ねることがあります。その場所を指定するには、--file-query <identifier=value>.例えば、--file-query PathForSDP7=<path_to_sdp> 。識別子は、実際の質問とメッセージ・タイプの前にコマンド・ラインに出力されます。そこから識別子を拾うことができます。 |
自動応答のメッセージ識別子
--auto-answer オプションを使用すると、特定のクエリに対する答えを提供することができる。以下の表は、--auto-answer で使用される既知の識別子とその値の一覧である：
| ID | 値 | デフォルト |
|---|---|---|
| 操作エラー（OperationDoesNotExistError | 中止、無視 | 無視 |
| OverwriteTargetDirectory（上書き対象ディレクトリ | はい、いいえ | いいえ |
| 更新プロセスの停止 | 再試行、無視、キャンセル | キャンセル |
| キャンセルを伴うインストールエラー | リトライ、無視、キャンセル | キャンセル |
| 無視付きインストールエラー | 再試行、無視 | 無視 |
| AssociateCommonFiletypes | はい、いいえ | はい |
| テレメトリー・クエスチョン | はい、いいえ | はい |
ログイン情報の提供
Qt Online Installer と には強制ログインがある。強制ログインでは、Qt Maintenance Tool qtaccount.iniファイルがキャッシュされている場合、その情報を使用します。qtaccount.iniは以下のようにあります：
| ホスト | qtaccount.iniの場所 |
|---|---|
| Windows | C:\Users\<username>\AppData\Roaming\Qt |
| macOS | /Users/<username>/Library/Application Support/Qt/qtaccount.ini |
| Linux | /home/<username>/.local/share/Qt/qtaccount.ini |
オプションとして、電子メールとパスワードのスイッチ--email <your_email> と--pw <your_pw> を使って、コマンドラインからログインすることもできます。
あるいは、jwt トークンを環境変数QT_INSTALLER_JWT_TOKEN に保存することもできます。トークンはqtaccount.iniファイルにあります。
ユーザー操作によるインストール
以下のように、コマンドラインインターフェースを使用してユーザーと対話することができます：
- 実行ファイルを定義します：
- Qt Online Installer新規にインストールする場合
- Qt Maintenance Tool既存のインストールを更新する場合。
- 新規にインストールする場合は、インストール・ディレクトリを
--root - を使用します。
install <list of packages>を使用してインストールディレクトリを定義します。
以下の例では、Windows、macOS、Linux 用の Qt 6.8.0 バイナリをQt Online Installer で新規インストー ルする方法を示します：
# Windows: new installation with user interaction qt-unified-windows-x64-[Qt Online Installer version]-online.exe --root C:\Users\[username]\installation_dir install qt.qt6.680.win64_msvc2022_64 # macOS: new installation with user interaction qt-unified-macOS-x64-[Qt Online Installer version]-online.dmg --root /home/<username>/installation_dir install qt.qt6.680.clang_64 # linux: new installation with user interaction qt-unified-linux-x64-[Qt Online Installer version]-online.run --root /home/<username>/installation_dir install qt.qt6.680.gcc_64
次の例は、Qt Maintenance Tool を使用して Qt 6.8.0 バイナリをインストールし、既存のインストー ルを更新する方法を示しています：
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe install qt.qt6.680.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.dmg install qt.qt6.680.clang_64
# Linux: update installation with Qt Maintenance Tool
MaintenanceTool.run install qt.qt6.680.gcc_64パッケージのアンインストール
コマンドラインインターフェイスには、パッケージをアンインストールするためのコマンドが 2 つあります：
- コマンド
remove <list of packages>コマンドは、リストされたパッケージをアンインストールします。 - コマンドは、リストされたパッケージをアンインストールします。
purgeコマンドは、インストールされているすべてのパッケージをアンインストールします。
どちらのコマンドもQt Maintenance Tool と一緒に使用する必要があります。
デフォルトでは、Qt Maintenance Tool はコマンドの影響を受けるコンポーネントの概要を表示します。その後、偶発的な変更を防ぐため、ツールは動作の継続許可を求めます。続行許可を求めないようにするには --confirm-commandを使用すると、続行許可を求めるのをスキップできます。
以下の例では、Qt 6.8.0 のバイナリをユーザー操作なしでアンインストールしています：
# windows MaintenanceTool.exe --confirm-command remove qt.qt6.680.win64_msvc2022_64 # macOS MaintenanceTool.dmg --confirm-command remove install qt.qt6.680.clang_64 # linux MaintenanceTool.run --confirm-command remove qt.qt6.680.gcc_64
以下の例では、すべてのパッケージをアンインストールし、動作を続行する許可を求めています：
# Windows MaintenanceTool.exe purge # macOS MaintenanceTool.dmg purge # Linux MaintenanceTool.run purge
インストール済みパッケージの一覧表示
インストールされているパッケージの一覧 listコマンドは、インストールされているすべてのパッケージを一覧表示します。このコマンドは、Qt Maintenance Tool で以下のように使用します：
# Windows MaintenanceTool.exe list # macOS MaintenanceTool.dmg list # Linux MaintenanceTool.run list
アップデートの確認
この check-updatesコマンドは、インストールされているパッケージで利用可能なアップデートをチェックします。このコマンドはQt Maintenance Tool とともに次のように使用します：
# Windows MaintenanceTool.exe check-updates # macOS MaintenanceTool.dmg check-updates # Linux MaintenanceTool.run check-updates
パッケージの更新
パッケージの更新 updateコマンドはインストールされているパッケージを更新します。このコマンドはQt Maintenance Tool ：
# windows MaintenanceTool.exe update # macOS MaintenanceTool.dmg update # linux MaintenanceTool.run update
よく使うコマンド
コマンド <installer_executable> --helpコマンドを使って、利用可能なコマンドとオプションを調べます。よく使われるコマンドは以下の通りです：
| コマンド | 使用方法 |
|---|---|
in,install <pkg ...> | 引数として与えられたパッケージをインストールする。何も指定しない場合は、デフォルトのパッケージ・セットをインストールします。 |
rm,remove <pkg ...> | 選択したパッケージとその子コンポーネントをアンインストールします。 |
ch,check-updates | Qt Maintenance Tool で利用可能なアップデートに関する情報を表示します。 |
up,update <pkg ...> | 引数で指定されたパッケージを更新します。パッケージが指定されていない場合は、利用可能なすべてのアップデートをインストールします。 |
se,search <regexp> | 利用可能なパッケージを検索します。検索パターンを指定しない場合は、利用可能なパッケージをすべて表示します。--filter-packages オプションを使用すると、検索操作に追加のフィルタを指定できます。Qt Installer Framework マニュアルの「オプションの概要」を参照してください。 |
Qt Installer Framework マニュアルには、コマンドとオプションの詳細が記載されています。
オープンソース用ミラーの選択
Qt Online Installer には、オープンソースのメタデータとダウンロード用のミラーを選択するオプションがあります。コマンドラインから --mirrorオプションを使ってコマンドラインから設定します。
例えば、--mirror を次のように使用します：
installer(.exe) --mirror http://www.nic.funet.fi/pub/mirrors/download.qt-project.org installer(.exe) --mirror http://ftp2.nluug.nl/languages/qt maintenancetool(.exe) --mirror http://qt.mirror.constant.com
例にあるように、フルパスではなく、'/online'の前のパスを使用します（最後にフォワードスラッシュは付けません）。
利用可能なミラーはhttps://download.qt.io/online/qtsdkrepository/windows_x86/root/qt/Updates.xml.mirrorlist。
コマンドラインインターフェイスの使い方のまとめ
Qt Installer Framework マニュアルでは、コマンドラインインターフェイスに関するより詳細な情報を提供しています：
- コマンドラインからの使用」では、コマンドラインインターフェースのさまざまな使用例について説明しています。
- オプションの概要には、使用可能なすべてのオプションがリストされています。
- コマンドの概要には、使用可能なコマンドがすべてリストされています。
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
