Qt Quick 코드 스타일 지정

내장된 코드 포맷터(사용 중단됨)나 qmlformat과 같은 외부 도구를 사용하여 QML 코딩 규칙에 따라 QML 파일을 자동으로 포맷팅할 수 있습니다.

QML 코드 스타일을 전역적으로 지정하려면:

1. Preferences > Qt Quick > Code Style 로 이동합니다.
2. Custom settings 에서 수정할 설정을 선택한 다음, ‘ Copy ’를 선택합니다.

   

3. 설정 이름을 지정하고, ‘ OK ’를 선택합니다.
4. ' Formatter Selection'에서 사용할 서식 지정기를 선택합니다.

특정 프로젝트에 대해 전역 기본 설정을 재정의하려면 Projects > Code Style 를 선택하십시오.

내장 포맷터 사용

내장 포맷터는 qmlformat 도구 또는 사용자 정의 포맷터를 사용하도록 권장됨에 따라 더 이상 사용되지 않습니다.

내장 포맷터에 대한 전역 기본 설정을 설정하려면:

1. Formatter Selection 에서 Built-in formatter 를 선택합니다.
2. 탭 키 누름을 해석하는 방법과 이어지는 줄을 정렬하는 방법을 지정하고, 코드 줄의 최대 길이를 설정합니다.

qmlformat 사용

qmlformat 도구에 대한 전역 기본 설정을 설정하려면:

1. Formatter Selection 에서 ‘ QMLFormat ’를 선택합니다.

   

2. Global qmlformat Configuration 에서 코드 스타일을 설정합니다. 이 변경 사항은 일반 구성 위치(QStandardPaths::GenericConfigLocation)에 있는 .qmlformat.ini 파일을 덮어씁니다.
3. 프로젝트에 전역 qmlformat 구성 파일의 복사본을 추가하려면 Deploy INI File to Current Project 을 선택하십시오.

qmlformat 도구는 서식 지정 대상 파일과 동일한 디렉터리에서 .qmlformat.ini 파일을 검색합니다. 해당 파일이 발견되지 않으면 루트 디렉터리까지 상위 디렉터리를 차례로 검색합니다. .qmlformat.ini 파일이 발견되지 않으면 전역 기본값이 사용됩니다. 자세한 내용은 qmlformat 구성 설정을 참조하십시오.

사용자 정의 도구 사용

qmlformat과 호환되는 사용자 정의 도구를 사용하려면:

1. Formatter Selection 에서 Custom formatter 를 선택합니다.

   

2. Command 에서 도구의 경로를 입력합니다.
3. Arguments 에서 도구 실행 옵션을 입력합니다.
4. 오른쪽의 .qmlformat.ini 파일에서 설정된 코드 스타일을 확인합니다.