엔터프라이즈 Qt 데비안 패키지
Qt와 함께 엔터프라이즈 데비안 패키지를 사용하려면, 엔터프라이즈 저장소를 APT(고급 패키징 도구)에 추가하세요. 자세한 내용은 Debian 리포지토리 구성 형식을 참조하십시오.
엔터프라이즈 리포지토리를 사용하려면 다음을 수행해야 합니다:
- 엔터프라이즈 리포지토리를 위한 공개 GPG 키를 설치합니다.
- 엔터프라이즈 리포지토리 액세스를 위한Qt 계정 기반 인증 구성하기
- 리포지토리 구성
참고: 자세한 내용 및 지원은문의하세요. 무료 평가판에 대한 자세한 내용은 Qt 소프트웨어 무료 평가판을 참조하세요.
Debian 리포지토리 구성 형식
APT용 리포지토리를 추가하려면 /etc/apt/sources.list.d 디렉터리 아래에 확장자가 .list인 파일에 리포지토리를 삽입합니다. 각 리포지토리에 대해 파일에 새 항목을 추가합니다. 일반적인 형식은 다음과 같습니다:
deb [arch=<arch> signed-by=<path>] <REPO_URL> <DIST> <COMPONENT(s)>
엔터프라이즈 리포지토리 항목의 예입니다:
$ sudo nano /etc/apt/sources.list.d/tqtc.list deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt-\1-arm64 tqtc-jammy main
Qt 릴리스 및 아키텍처별로 리포지토리를 구성하는 방법에 대한 자세한 내용은 Qt 릴리스를 위한 리포지토리 정보를 참조하십시오.
공개 GPG 키 설치하기
다음과 같이 엔터프라이즈 Qt Debian 리포지토리에 대한 공개 GPG(GNU Privacy Guard) 키를 설치합니다:
$ sudo mkdir -p /etc/apt/keyrings/tqtc # Create the directory with appropriate permissions $ cd /etc/apt/keyrings/tqtc $ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg
인증 구성하기
나열된 리포지토리에 액세스하려면 엔터프라이즈 Qt 계정 또는 평가판 Qt 계정이 필요합니다.
참고: 비밀번호에 특수 문자가 포함된 경우 '\' 또는 '%40'을 사용하여 이스케이프 처리해야 할 수 있습니다.
APT 패키지 관리자에 대한 Qt 계정 자격 증명을 다음과 같이 구성합니다:
$ sudo nano /etc/apt/auth.conf
machine https://debian-packages.qt.io
login <Qt Account login name (email)>
password <Qt Account password>로컬 패키지 캐시 업데이트
다음과 같이 로컬 패키지 캐시를 업데이트합니다:
$ sudo apt-get update
출력에 추가된 리포지토리에서 오류가 발생하지 않아야 합니다.
Debian 별칭 패키지
실제 Debian 패키지를 가리키는 메타 패키지인 에일리어스 패키지를 사용하면 콘텐츠를 더 쉽게 설치할 수 있습니다.
Debian 에일리어스 패키지의 내용은 아래 표에 나와 있습니다.
참고: 아래 나열된 에일리어스 패키지 예제에서는 Qt 6.8.0 릴리스가 사용됩니다. 항상 작업 중인 Qt 릴리스와 일치하는 패키지를 사용해야 합니다. 자세한 내용은 Qt 릴리스에 대한 리포지토리 정보를 참조하십시오.
| 별칭 패키지 이름 | 패키지 내용 |
|---|---|
| QT6.8.0-ESSENTIALS |
|
| qt6.8.0-essentials-dev |
|
| qt6.8.0-full |
|
| qt6.8.0-full-dev |
|
| qt6.8.0-full-dbg |
|
데비안 설치 명령 예제
$ sudo apt install qt6.8.0-full-dev
전체 구성 예제
다음 코드 스니펫은 엔터프라이즈 Qt Debian 패키지를 사용한 전체 작업 흐름을 보여줍니다:
# install repository key $ sudo mkdir -p /etc/apt/keyrings/tqtc $ cd /etc/apt/keyrings/tqtc $ sudo wget https://cdn.qt.io/debian/keys/qt-company-debian-repo.gpg # configure Qt Account based authentication to Qt Debian repositories $ sudo nano /etc/apt/auth.conf machine https://debian-packages.qt.io login <your Qt Account email> password <your Qt Account password> # add repositories $ sudo nano /etc/apt/sources.list.d/tqtc.list deb [arch=arm64 signed-by=/etc/apt/keyrings/tqtc/qt-company-debian-repo.gpg] https://debian-packages.qt.io/debian/enterprise/qt\1-arm64 tqtc-jammy main # update local package cache $ sudo apt-get update # search and install packages $ apt-cache search qt6.8.0-full-dev .... .... # files are installed under /opt/qt-6.8.0 $ sudo apt install qt6.8.0-full-dev
Qt 릴리스에 대한 저장소 정보를 참조하여 /etc/apt/sources.list.d/tqtc.list 파일에 필요한 저장소를 선택하십시오.
문제 해결
인증에 어려움
서버에서 다음과 같은 HTTP 오류 코드가 응답할 수 있습니다:
401 권한 없음
자격 증명이 잘못되었습니다. 사용자 이메일과 비밀번호를 올바른 형식으로 제공해야 합니다.
또한 리포지토리 구성에 자격 증명을 직접 저장해 보세요:
deb [...] https://<Qt Account email>:<Qt Account passwd>@https://debian-packages.qt.io/.....
비밀번호에 특수 문자가 포함된 경우 APT를 위해 이스케이프 처리해야 할 수 있습니다. '' 또는 '%40'을 사용하여 해당 문자를 이스케이프 처리하거나 Qt 계정 비밀번호를 변경해 보세요.
403 금지됨
자격 증명이 누락되었습니다.
429 너무 많은 요청
사용자가 실패한 요청을 너무 많이 보냈습니다(분당 3건).
500 내부 서버 오류
Qt 지원팀에 문의하세요.
리포지토리 GPG 키 사용에 대한 어려움
리포지토리 구성에서 '서명된' 사용 속성의 대안으로 다음과 같은 방법으로 키를 설치하는 방법이 있지만, 더 이상 권장되지 않는 설치 방법이므로 권장하지 않습니다:
$ sudo apt-key add qt-company-debian-repo.gpg
Qt 릴리스에 대한 리포지토리 정보
아래에서 엔터프라이즈 Qt Debian 패키지가 지원하는 Qt 릴리스를 확인할 수 있습니다. 필요한 리포지토리를 선택하여 위의 지침에 따라 /etc/apt/sources.list.d/tqtc.list에 추가합니다.
또한 다음 표에는 시스템의 설치 디렉터리와 패키지와 호환되는 Linux 배포판이 나열되어 있습니다.
참고: 나열된 저장소에 액세스하려면 평가판 Qt 계정 또는 Qt for Device Creation 라이선스가 있는 상용 Qt 계정이 필요합니다.
참고: 패키지는 다른 배포판에서도 작동할 수 있지만 이에 대한 보장은 없습니다.
Qt Creator
| 아키텍처 | 배포판 | 설치 디렉토리 | APT용 패키지 리소스 목록 항목 |
|---|---|---|---|
| amd64 | jammy-jellyfish (우분투 22.04) | /opt/qt-creator/ | deb [arch=amd64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qtcreator-amd64 tqtc-jammy main |
| arm64 | jammy-해파리 (우분투 22.04) | /opt/qt-creator/ | deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qtcreator-arm64 tqtc-jammy main |
Qt 6.8.0
| 아키텍처 | 배포 | 설치 디렉토리 | APT용 패키지 리소스 목록 항목 |
|---|---|---|---|
| amd64 | jammy-jellyfish (우분투 22.04) | /opt/qt-6.8.0/x86_64-linux-gnu/ | deb [arch=amd64-signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.8.0-amd64 tqtc-jammy main |
| arm64 | jammy-jellyfish (우분투 22.04) | /opt/qt-6.8.0/aarch64-linux-gnu/ | deb [arch=arm64 signed-by=<path>] https://debian-packages.qt.io/debian/enterprise/qt-6.8.0-arm64 tqtc-jammy main |
© 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.
