Qt Creator 변수 사용

Preferences, Build Settings 및 Run Settings 에서, 예를 들어 인수, 실행 파일 경로 및 작업 디렉터리를 설정하는 필드에서 Qt Creator 변수를 사용할 수 있습니다. 변수는 확장 시 따옴표 처리를 자동으로 처리하므로, 변수를 따옴표로 묶을 필요가 없습니다.

특정 필드에서 ‘ (Variables)’ 버튼을 선택하면 해당 컨텍스트에서 사용할 수 있는 변수 목록을 선택할 수 있습니다. 각 변수에 대한 자세한 정보를 보려면 목록에서 해당 변수 위로 커서를 이동하십시오.

Qt Creator 변수 대화 상자" src="images/qtcreator-variables.png" title="툴팁이 표시되는 Qt Creator 변수 대화 상자"/>

다음 구문을 사용하면 환경 변수를 Qt Creator 변수로 활용할 수 있습니다: %{Env:VARNAME}.

패턴 치환

Qt Creator 는 변수 이름을 확장할 때 패턴 치환을 사용합니다. 변수 내에서 패턴의 첫 번째 일치 항목을 대체 문구로 바꾸려면 다음을 사용하십시오:

%{variable/pattern/replacement}

변수 내에서 패턴이 일치하는 모든 부분을 대체 텍스트로 바꾸려면 다음을 사용하십시오:

%{variable//pattern/replacement}

패턴은 정규 표현식일 수 있으며, 대체 문자열에는 역참조가 포함될 수 있습니다. 예를 들어, %{variable} 가 my123var 인 경우, %{variable/(..)(\d+)/\2\1} 는 123myvar 로 확장됩니다.

슬래시(/) 대신 해시 기호(#)를 대체 문자로 사용할 수도 있습니다. 이는 값이 파일 경로인 경우에 유용할 수 있는데, 이 경우 Windows 호스트에서는 슬래시가 백슬래시로 변환될 수 있기 때문입니다.

기본값 사용하기

변수가 설정되지 않은 경우 기본값을 사용하려면 다음을 사용하십시오:

%{variable:-default}

예제

다음 섹션에서는 Qt Creator 변수 사용 예제를 다룹니다.

현재 문서 변수

%{CurrentDocument} 변수는 편집기에서 현재 열려 있는 파일에 대한 정보로 확장됩니다.

예를 들어:

• %{CurrentDocument:Project:Name} 는 문서가 포함된 프로젝트의 이름으로 확장됩니다.
• %{CurrentDocument:FileName} 는 문서의 이름으로 확장됩니다.
• %{CurrentDocument:FilePath} 파일 이름을 포함한 문서의 전체 경로로 확장됩니다.
• %{CurrentDocument:DirName} 는 문서의 상위 디렉터리 이름으로 확장됩니다.

Kit 및 빌드 구성 변수

%{Project:DirName} 변수는 프로젝트 폴더 이름으로 확장되고, %{Kit:FileSystemName} 는 빌드 및 실행 키트에 대한 정보로 확장되며, %{BuildConfig:Name} 는 빌드 구성 이름으로 확장됩니다.

이 변수들을 조합하여 Default build directory 을 Preferences > Build & Run > Default Build Properties 로 설정할 수 있습니다:

../build-%{Project:DirName}-%{Kit:FileSystemName}-%{BuildConfig:Name}

Qt 변수

%{Qt} 변수는 Qt 설치에 대한 정보로 확장됩니다.

%{Qt:Version} 는 Qt 설치의 버전 번호로 확장됩니다. 키트 이름에서 이 변수를 사용할 수 있습니다.

기기 변수

%{Device} 변수는 프로젝트를 실행하는 장치(실행 장치)에 대한 정보로 확장됩니다.

예를 들어:

• %{Device:HostAddress} 는 장치 구성에서 가져온 장치의 호스트 이름 또는 IP 주소로 확장됩니다. SSH 인증에 사용할 수 있습니다.
• %{Device:PrivateKeyFile} 는 개인 키 파일의 파일명과 경로로 확장됩니다. SSH 인증에 사용할 수 있습니다.
• %{Device:SshPort} SSH 연결에 사용되는 포트 번호로 확장됩니다.
• %{Device:UserName} 는 기기에 로그인할 때 사용할 사용자 이름으로 확장됩니다. 기기가 자동으로 연결되지 않을 때 사용자 지정 연결에 사용할 수 있습니다.

Git 변수

%{Git:Config:user.name} Git 구성에서 지정된 사용자 이름으로 확장됩니다. 라이선스 헤더 템플릿이나 Git 사용자 이름이 필요한 모든 필드에서 사용할 수 있습니다.