명령줄 인터페이스를 사용하여 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
다른 Qt 바이너리 패키지는 Windows on Arm(WoA)에서 사용할 수 없으므로 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 | 중단, 무시 | 무시 |
| 대상 디렉터리 덮어쓰기 | 예, 아니요 | 아니요 |
| 업데이트를 위해 프로세스 중지 | 다시 시도, 무시, 취소 | 취소 |
| 취소 시 설치 오류 | 다시 시도, 무시, 취소 | 취소 |
| 설치 오류(무시) | 다시 시도, 무시 | 무시 |
| 일반 파일 형식 연결 | 예, 아니요 | 예 |
| 텔레메트리-질문 | 예, 아니요 | 예 |
로그인 정보 제공
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패키지 제거
명령줄 인터페이스에서는 패키지 제거를 위해 다음 두 가지 명령을 제공합니다:
- `
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 매뉴얼에는 명령어 및 옵션에 대한 자세한 정보가 제공됩니다.
오픈소스용 미러 선택
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.
