명령줄 인터페이스로 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>명령과 함께 무인 사용 옵션을 사용합니다. 전체 옵션 목록은 무인 사용을 위한 옵션에서 확인할 수 있습니다.
다음 예제는 Windows, macOS 및 Linux용 Qt Online Installer 을 사용하여 Qt 6.8.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.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>를 무인 사용 옵션과 함께 사용합니다. 전체 옵션 목록은 무인 사용을 위한 옵션에서 확인하세요.
다음 예제는 Windows, macOS 및 Linux의 exsting 설치에 Qt Maintenance Tool 를 사용하여 Qt 6.8.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.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. 자동 응답에 대한 모든 메시지 식별자는 메시지 식별자의 --자동 응답을 참조하세요. |
--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 | 중단, 무시 | Ignore |
| 오버라이트 타겟 디렉터리 | 예, 아니요 | 아니요 |
| stopProcessesForUpdates | 재시도, 무시, 취소 | 취소 |
| 설치 오류 취소 | 재시도, 무시, 취소 | 취소 |
| installationErrorWithIgnore | 재시도, 무시 | Ignore |
| 연관 공통 파일 유형 | 예, 아니요 | Yes |
| 원격 측정 질문 | 예, 아니요 | 예, 아니요 |
로그인 정보 제공
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>.
또는 환경 변수 QT_INSTALLER_JWT_TOKEN 에 jwt 토큰을 저장할 수 있습니다. 토큰은 qtaccount.ini 파일에서 찾을 수 있습니다.
사용자 인터랙션으로 설치하기
다음과 같이 명령줄 인터페이스를 사용하여 사용자 상호작용을 할 수 있습니다:
- 실행 파일을 정의합니다:
- Qt Online Installer 새 설치를 해야 하는 경우
- Qt Maintenance Tool 기존 설치를 업데이트해야 하는 경우
- 새로 설치하는 경우 설치 디렉터리를 정의할 때
--root - 를 사용하여
install <list of packages>를 사용하여 설치 디렉터리를 정의하여 나열된 패키지를 설치합니다.
다음 예제는 Windows, macOS 및 Linux용 Qt Online Installer 을 사용하여 Qt 6.8.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.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패키지 제거하기
명령줄 인터페이스는 패키지를 제거하기 위한 두 가지 명령을 제공합니다:
- 명령은
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
예제에서 볼 수 있듯이 전체 경로를 사용하지 말고 '/온라인' 앞의 경로를 사용하세요(끝에 슬래시 없이).
사용 가능한 미러는 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.
