/sourceDependencies:directives (모듈 및 헤더 단위 종속성 나열)

  • 아티클

이 명령줄 옵션은 원본 파일 및 해당 #include 문을 검색하여 모듈 내보내기 및 가져오기를 나열하는 JSON 파일을 생성합니다. 이 정보는 빌드 시스템에서 모듈 및 헤더 단위의 빌드 순서를 결정하는 데 사용할 수 있습니다.

이 옵션은 다음과 같은 방법으로 다릅니다 /sourceDependencies .

  • 컴파일러는 컴파일된 출력을 생성하지 않습니다. 컴파일된 코드, 모듈 또는 헤더 단위가 생성되지 않습니다. 대신 파일에서 모듈 지시문을 검색합니다.
  • JSON 형식은 생성되는 형식 /sourceDependencies 과 다릅니다. 이 /sourceDependencies 옵션은 CMake와 같은 다른 빌드 도구와 함께 사용됩니다.
  • 출력 JSON 파일은 가져온 모듈 및 가져온 헤더 단위(.ifc 파일)를 나열하지 않습니다. 이 옵션은 컴파일이 아닌 프로젝트 파일을 검사하기 때문입니다. 따라서 나열할 기본 모듈 또는 헤더 단위가 없습니다.
  • 직접 가져온 모듈 또는 헤더 단위만 나열됩니다. 가져온 모듈 또는 헤더 단위 자체의 종속성은 나열되지 않습니다.
  • 헤더 파일 종속성이 나열되지 않습니다. 즉, #include <file>#include "file" 종속성이 나열되지 않습니다.
  • /sourceDependencies:directives 는 파일을 빌드하기 전에 .ifc 사용해야 합니다.
  • /sourceDependencies는 컴파일러가 특정 번역 단위에 사용된 파일, .ifc 파일 등과 같은 .pch#includes모든 파일을 보고하도록 하는 반면/sourceDependencies:directives [file1], 지정된 소스 파일을 검사하고 모든 import 문과 export 문을 보고합니다. /sourceDependencies 와 함께 /sourceDependencies:directives사용할 수 있습니다.

구문

/sourceDependencies:directives-
/sourceDependencies:directivesfilename
/sourceDependencies:directivesdirectory

인수

-
단일 대시가 제공되면 컴파일러는 원본 종속성 JSON을 stdout내보내거나 컴파일러 출력이 리디렉션되는 위치로 내보냅니다.

filename
컴파일러는 원본 종속성 출력을 지정된 파일 이름에 씁니다. 여기에는 상대 경로 또는 절대 경로가 포함될 수 있습니다. 파일이 없는 경우 새로 만들어집니다.

directory
인수가 디렉터리인 경우 컴파일러는 지정된 디렉터리에 원본 종속성 파일을 생성합니다. 디렉터리가 있어야 하거나 인수가 .로 filename처리됩니다. 출력 파일 이름은 추가된 .json 확장명을 사용하여 입력 파일의 전체 이름을 기반으로 합니다. 예를 들어 컴파일러 main.cpp에 제공된 파일이 있으면 생성된 출력 파일 이름은 .입니다 main.cpp.json.

설명

/sourceDependencies:directives 는 Visual Studio 2019 버전 16.10부터 사용할 수 있습니다.

(여러 프로세스를 사용하여 /MP 빌드) 컴파일러 옵션을 지정하는 경우 디렉터리 인수와 함께 사용하는 /sourceDependencies:directives 것이 좋습니다. 이 옵션을 사용하면 컴파일러가 각 소스 파일에 대해 별도의 *.module.json 파일을 출력합니다. 단일 파일 이름 인수를 제공하는 경우 컴파일러의 두 인스턴스가 출력 파일을 동시에 열어 오류를 일으킬 수 있습니다. /MP/sourceDependencies:directives- 출력을 보내기 위해 stdout 함께 사용하면 인터리브 결과가 발생할 수 있습니다.

치명적이 아닌 컴파일러 오류가 발생하면 종속성 정보가 출력 파일에 계속 기록됩니다.

모든 파일 경로는 출력에서 절대 경로로 표시됩니다.

이 스위치는 .와 함께 /translateInclude사용할 수 있습니다.

예제

다음 샘플 코드가 제공됩니다.

//main.cpp:
#include <vector>

import m;
import std.core;

import <utility>;

import "t.h";

int main() {}

다음 명령줄은 다음과 같습니다.

cl /std:c++latest /translateInclude /sourceDependencies:directives output.json main.cpp

는 다음과 유사한 JSON 파일을 output.json 생성합니다.

{
   "Version":"1.1",
   "Data":{
      "Source":"C:\\a\\b\\main.cpp",
      "ProvidedModule":"",
      "ImportedModules":[
         "m",
         "std.core"
      ],
      "ImportedHeaderUnits":[
         "C:\\...\\utility",
         "C:\\a\\b\\t.h"
      ]
   }
}

간단히 하기 위해 이전 예제에서는 보고된 경로를 약어로 사용합니다 ... . 보고서에는 절대 경로가 포함됩니다. 보고된 경로는 컴파일러가 종속성을 찾는 위치에 따라 달라집니다. 결과가 예기치 않은 경우 프로젝트의 포함 경로 설정을 검사 수 있습니다.

ProvidedModule 는 내보낸 모듈 또는 모듈 파티션 이름을 나열합니다.

.ifc 파일이 빌드되지 않았기 때문에 출력에 나열되지 않습니다. 달리 /sourceDependencies컴파일러는 지정된 경우 /sourceDependencies:directives 컴파일된 출력을 생성하지 않으므로 컴파일된 모듈 또는 헤더 단위가 생성되지 않습니다.

Visual Studio에서 이 컴파일러 옵션을 설정하려면

일반적으로 Visual Studio 개발 환경에서 이 옵션을 직접 설정해서는 안 됩니다. 빌드 시스템에 의해 설정됩니다.

참고 항목

/translateInclude
C++ header-units.json 참조
MSVC 컴파일러 옵션
MSVC 컴파일러 명령줄 구문
/scanDependencies (모듈 종속성을 표준 형식으로 나열)
/sourceDependencies (모든 원본 수준 종속성 나열)