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} 문서의 상위 디렉터리 이름으로 확장됩니다.

키트 및 빌드 구성 변수

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

환경설정 > Build & Run > Default Build Properties 에서 Default build directory 을 조합하여 설정할 수 있습니다:

../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 사용자 이름이 필요한 모든 필드에서 이 변수를 사용할 수 있습니다.