コマンドラインインターフェースを使用した Qt の入手とインストール
Qt Online Installer およびQt Maintenance Tool を使用して、コマンドラインインターフェースからコンポーネントのインストール、アンインストール、更新、検索を行います。
コマンドラインインターフェースは、対話型および非対話型（無人実行）の両方の使用法をサポートしています。以下のトピックでは、コマンドラインインターフェースの使用方法に関する例や情報を提供しています：
- コマンドラインインターフェースを使用したQt Online Installer のダウンロード
- インストール対象のコンポーネント名
- ユーザーの操作を必要としないインストール
- ユーザー操作を伴うインストール
- パッケージのアンインストール
- インストール済みパッケージの一覧表示
- 更新の確認
- パッケージの更新
- よく使われるコマンド
- オープンソースのミラーの選択
- コマンドラインインターフェースの使用法のまとめ
コマンドラインインターフェースを使用したQt Online Installer のダウンロード
コマンドラインインターフェースで `curl ` コマンドを使用すると、Qt Online Installer をダウンロードできます。さまざまなプラットフォームで利用可能なすべてのQt Online Installer パッケージを確認するには、Qt Online Installer の公式リリースページをご覧ください。
リモートファイルと同じ名前の特定のQt Online Installer パッケージをダウンロードするには、-O （大文字の「O」）オプションを使用します。
以下のコマンド例は、qt-online-installer-linux-x64-online.run パッケージをダウンロードするものです：
curl -OL https://download.qt.io/official_releases/online_installers/qt-online-installer-linux-x64-online.runインストール用のコンポーネント名
エイリアスパッケージを使用したクイックインストール
インストールする特定のパッケージ名を検索する代わりに、エイリアスパッケージを使用して最も一般的な構成をインストールすることができます。エイリアスパッケージは、実際のパッケージをまとめて含めるためのショートカットであり、インストールを容易にするものです。
既存のエイリアスパッケージの一覧表示
既存のエイリアスパッケージを一覧表示するには、コマンドラインインターフェースで次のコマンドを実行します。
Qt Online Installer の使用：
<installer executable> search各プラットフォーム向けの Qt Online Installer 各プラットフォーム向けの実行ファイルの詳細については、「ユーザー操作によるインストール」を参照してください。
Qt Maintenance Tool の使用方法：
<maintenancetool executable> search各プラットフォーム向けの Qt Maintenance Tool 各プラットフォーム向けの実行ファイルの詳細については、「ユーザー操作によるインストール」を参照してください。
エイリアスパッケージの内容
エイリアスパッケージの内容は、以下の表にまとめられています。
注： 以下に挙げるエイリアスパッケージの例では、Qt 6.12.0 リリースを使用しています。必ず、現在作業している Qt リリースに一致するパッケージを使用するようにしてください。
| エイリアスパッケージ名 | Qt Online Installer (パッケージの内容) |
|---|---|
| qt6.12.0-essentials |
|
| qt6.12.0-essentials-dev |
|
| qt6.12.0-full |
|
| qt6.12.0-full-dev |
|
| qt6.12.0-full-dbg |
|
| qt6.12.0-sdk |
|
Qt Online Installer コマンド例
# Windows: new installation with Qt Online Installer
qt-unified-windows-x64-[Qt Online Installer version]-online.exe install qt6.12.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.12.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.12.0-sdkWindows 用のエイリアスパッケージオプション
注： このセクションの情報は 、Qt 6.8、Qt 6.9、および Qt 6.10 のリリースに適用されます。
ARM64 上の Windows
Windows on ARM (WoA) では、他の Qt バイナリパッケージは利用できないため、MSVC バイナリ (msvc2022-arm64) のみがインストールされます。
x86_64 版 Windows
デフォルトでは、MinGW バイナリのみがインストールされます。
ただし、x86_64 版 Windowsでは、以下のツールチェーン用のバイナリもインストールできます。
- llvm-mingw
- msvc2022
- msvc2022-arm64 (クロスコンパイル用)
たとえば、qt6.12.0-essentialsエイリアスパッケージを使用すると、デフォルトの MinGW バイナリを含むパッケージがインストールされます。
たとえば、MSVC 2022 バイナリを含む `Qt essentials ` パッケージの内容を取得するには、対応する `qt6.12.0-msvc2022-essentials` エイリアスパッケージを使用します。
エイリアスではないパッケージの一覧表示
エイリアスではないパッケージを一覧表示するには、コマンドラインインターフェースで次のコマンドを使用します。
Qt Online Installer の使用方法：
<installer executable> search --type package異なるプラットフォーム向けの Qt Online Installer 各プラットフォーム向けの実行ファイルの詳細については、「ユーザー操作によるインストール」を参照してください。
Qt Maintenance Tool の使用方法：
<maintenancetool executable> search --type package各プラットフォーム用の Qt Maintenance Tool 各プラットフォーム用の実行ファイルの詳細については、「ユーザー操作によるインストール」を参照してください。
特定のインストールパッケージを詳細検索する
search コマンドと正規表現を使用して、利用可能なパッケージを検索します: search <regexp>。結果を --filter-packages <regexp>。たとえば、表示名情報を使ってフィルタリングすると、検索が容易になります。
たとえば、次のコマンドは Qt 6.12.0 用のすべての MSVC 2022 パッケージを検索します:
search .*6120.*msvc2022検索結果を次のようにフィルタリングしても、同じ結果が得られます:
search --filter-packages DisplayName=MSVC 2022,Version=6.12.0その結果、以下のパッケージが取得されます:
<availablepackages>
<package name="qt.qt6.6120.win64_msvc2022_64" displayname="MSVC 2022 64-bit" version="6.12.0.-0-<timestamp>"/>
<package name="qt.qt6.6120.win64_msvc2022_arm64" displayname="MSVC 2022 ARM64" version="6.12.0.-0-<timestamp>"/>
</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-<timestamp>"/>
<package name="qt.qt6.641.addons.qtcharts" displayname="Qt Charts" version="6.4.1-0-<timestamp>"/>
<package name="qt.qt5.5123.qtcharts" displayname="Qt Charts" version="5.12.3-0-<timestamp>"/>ユーザーの操作を必要としないインストール
デフォルトでは、Qt Online Installer やQt Maintenance Tool はインストール中に追加情報の入力を求めてくることがあり、ユーザーの操作が必要となります。適切なオプションを使用して、要求されるすべての情報を事前に指定することで、コマンドラインインターフェースを介した無人でのインストールが可能です。
以下のコマンドによる新規インストールQt Online Installer
コマンドラインインターフェースから、ユーザーの操作を必要とせずに新規インストールを行うには、次のようにします：
- 実行ファイルを定義します Qt Online Installer 実行ファイルを指定します。
- インストール先ディレクトリを
--rootで指定します。 -
install <list of packages>コマンドを無人インストール用のオプション付きで使用します。オプションの完全な一覧については、「無人インストール用のオプション」を参照してください。
以下の例は、Windows、macOS、およびLinux向けに、Qt Online Installer を使用してQt 6.12.0のバイナリをインストールする方法を示しています。無人インストール用コマンドは、ライセンスに自動的に同意し（--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.6120.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.6120.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.6120.linux_gcc_64「無人実行用のオプション」には、無人実行で使用可能なすべてのオプションが記載されています。
以下のコマンドによるインストールの更新Qt Maintenance Tool
以下の手順に従うことで、ユーザーの操作を必要とせずにコマンドラインインターフェースから既存のインストールを更新できます：
- 実行ファイルを定義します Qt Maintenance Tool 実行ファイルを定義します。
- 「
install <list of packages>を、無人実行用のオプションとともに使用します。オプションの完全な一覧については、「無人実行用のオプション」を参照してください。
以下の例は、Windows、macOS、および Linux 上の既存のインストールに、Qt Maintenance Tool を含む Qt 6.12.0 バイナリを追加する方法を示しています。無人インストール用のコマンドは、ライセンスに自動的に同意し（--accept-licenses）、すべてのメッセージの問い合わせに対してデフォルトの回答で応答し（--default-answer）、および処理の継続に関する許可の要求をスキップします（--confirm-command）：
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe --accept-licenses --default-answer --confirm-command install qt.qt6.6120.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.app/Contents/MacOS/MaintenanceTool --accept-licenses --default-answer --confirm-command install qt.qt6.6120.clang_64
# linux: update installation with Qt Maintenance Tool
MaintenanceTool.run --accept-licenses --default-answer --confirm-command install qt.qt6.6120.linux_gcc_64無人実行用のオプション
次の表に、無人コマンドライン使用時のすべてのオプションを一覧表示します：
| 無人実行用のオプション | 説明 |
|---|---|
--accept-licenses | すべてのライセンス契約に自動的に同意します。 |
--accept-obligations | オープンソース版でのインストール時、ユーザー入力なしに Qt オープンソースの利用義務に同意します。 |
--default-answer | すべてのメッセージの問い合わせに対して、デフォルトの回答を返します。 |
--auto-answer <identifier=value> | 特定の問い合わせに対して異なる回答を指定したい場合は、このオプションを使用できます。例:--auto-answer telemetry-question=Yes,AssociateCommonFiletypes=Yes 。--auto-answer に関するすべてのメッセージ識別子については、「メッセージ識別子」を参照してください。 |
--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 オプションを使用すると、特定のクエリに対する回答を指定できます。以下の表に、--auto-answer で使用される既知の識別子と値を示します：
| ID | 値 | デフォルト |
|---|---|---|
| OperationDoesNotExistError | 中止、無視 | 無視 |
| OverwriteTargetDirectory | はい、いいえ | いいえ |
| stopProcessesForUpdates | 再試行、無視、キャンセル | キャンセル |
| インストールエラー（キャンセル） | 再試行、無視、キャンセルキャンセル | キャンセル |
| installationErrorWithIgnore | 再試行、無視 | 無視 |
| 一般的なファイル形式の関連付け | はい、いいえ | はい |
| テレメトリに関する質問 | はい、いいえ | はい |
ログイン情報の提供
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 Online Installer を使用してQt 6.12.0バイナリを新規インストールする方法を示しています。
# 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.6120.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.6120.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.6120.linux_gcc_64以下の例は、Qt Maintenance Tool を使用してQt 6.12.0のバイナリをインストールし、既存のインストールを更新する方法を示しています：
# Windows: update installation with Qt Maintenance Tool
MaintenanceTool.exe install qt.qt6.6120.win64_msvc2022_64
# macOS: update installation with Qt Maintenance Tool
MaintenanceTool.dmg install qt.qt6.6120.clang_64
# Linux: update installation with Qt Maintenance Tool
MaintenanceTool.run install qt.qt6.6120.linux_gcc_64パッケージのアンインストール
コマンドラインインターフェースには、パッケージをアンインストールするための 2 つのコマンドが用意されています:
-
remove <list of packages>コマンドは、リストされたパッケージをアンインストールします。 - `
purgeコマンドは、インストールされているすべてのパッケージをアンインストールします。
これらのコマンドは、Qt Maintenance Tool を指定して使用する必要があります。
デフォルトでは、Qt Maintenance Tool は、コマンドの影響を受けるコンポーネントの概要を表示します。その後、誤った変更を防ぐため、ツールは処理を続行する許可を求めます。 --confirm-command を使用すると、続行の許可を求めるプロンプトをスキップできます。
次の例は、ユーザーの操作を必要とせずに Qt 6.12.0 のバイナリをアンインストールします:
# windows
MaintenanceTool.exe --confirm-command remove qt.qt6.6120.win64_msvc2022_64
# macOS
MaintenanceTool.dmg --confirm-command remove install qt.qt6.6120.clang_64
# linux
MaintenanceTool.run --confirm-command remove qt.qt6.6120.linux_gcc_64以下の例では、すべてのパッケージをアンインストールし、操作の続行許可を求めます：
# Windows
MaintenanceTool.exe purge
# macOS
MaintenanceTool.dmg purge
# Linux
MaintenanceTool.run purgeインストール済みパッケージの一覧表示
`xml-ph-0000@deepl.internal` 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 マニュアルには、コマンドやオプションに関する詳細情報が記載されています。
Opensourceのミラーの選択
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 マニュアルには、コマンドラインインターフェースに関するより詳細な情報が記載されています:
- 「コマンドラインからの使用」では、コマンドラインインターフェースのさまざまな使用例について説明しています。
- 「オプションの概要」では、利用可能なすべてのオプションを一覧表示しています。
- 「コマンドの概要」では、利用可能なすべてのコマンドを一覧表示しています。
© 2026 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.
