Resource Compiler (rcc)

rcc 도구는 빌드 과정에서 Qt 애플리케이션에 리소스를 포함시키는 데 사용됩니다. 이 도구는 Qt 리소스(.qrc) 파일에 지정된 데이터를 포함하는 C++ 소스 파일을 생성하는 방식으로 작동합니다.

사용법:

rcc [options] <inputs>

RCC는 다음 명령줄 옵션을 지원합니다:

옵션인수설명
-ofile출력을 stdout 대신 file 에 기록합니다.
-g, --generator<cpp|python|python2>생성기를 선택합니다.
-namenamename 를 사용하여 외부 초기화 함수를 생성합니다.
-thresholdlevel파일을 압축할지 여부를 결정할 때 사용할 임계값 level (백분율 단위)을 지정합니다. 파일 크기의 감소량이 임계값 level 보다 크면 파일이 압축되고, 그렇지 않으면 압축되지 않은 데이터가 대신 저장됩니다. 기본 임계값은 70%이며, 이는 원본 크기의 30% 이하인 압축 파일이 압축된 데이터로 저장됨을 의미합니다.
-compress-algoalgorithm파일을 압축하는 데 사용할 알고리즘입니다. 지원되는 알고리즘은 zstd, zlib, none 이며, 각각 Zstandard 라이브러리, zlib 라이브러리를 사용하여 내용을 압축하거나 압축을 적용하지 않음을 의미합니다. 기본값은 컴파일 시 해당 라이브러리가 발견된 경우 zstd 이며, 그렇지 않은 경우 zlib 입니다.
-compresslevel입력 파일을 지정된 압축 수준 level 으로 압축합니다. 이 수준은 알고리즘에 따라 달라집니다. 알고리즘이 zstd 인 경우 유효한 수준은 1부터 19까지이며, 특수 값인 0과 -1은 각각 libzstd 및 rcc 의 기본 압축 수준을 의미합니다. 알고리즘이 zlib 인 경우, 레벨은 1부터 9 사이의 정수입니다. 두 알고리즘 모두에서 레벨 1은 압축률이 가장 낮지만 처리 속도가 가장 빠릅니다. 레벨 9 또는 19는 압축률이 가장 높지만 처리 속도가 가장 느립니다. 압축을 해제하려면 -no-compress 를 사용하십시오. level 의 기본값은 -1입니다.
-rootpath리소스 액세스 경로 앞에 path 를 접두사로 붙입니다. 기본값은 접두사가 없는 것입니다.
-no-compress압축을 비활성화합니다.
--no-zstdzstd 압축 사용을 비활성화합니다.
--pass<number>대용량 리소스에 대한 번호 전달
-binary동적 리소스로 사용할 바이너리 파일을 출력합니다.
-version버전 정보를 표시합니다.
-help사용 정보를 표시합니다.
-t, --temp <file>대용량 리소스에 대해 임시 <파일>을 사용합니다.
--namespace네임스페이스 매크로를 비활성화합니다.
--verbose자세한 출력 모드를 활성화합니다.
--list.qrc 파일 항목만 나열하고 코드는 생성하지 않습니다.
--list-mapping.qrc 파일에 정의된 리소스 경로와 파일 시스템 경로의 매핑만 출력하고, 코드는 생성하지 않습니다.
-d, --depfile<file>.qrc 의존성이 포함된 depfile을 <file>에 작성합니다.
-project현재 디렉터리의 모든 파일이 포함된 리소스 파일을 출력합니다.
--format-version<number>쓰기할 RCC 형식 버전입니다.

Qt 애플리케이션에 리소스를 삽입하는 방법에 대한 자세한 내용은 Qt 리소스 시스템을 참조하십시오.

© 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.