다음을 통해 공유


증분 빌드

증분 빌드는 해당 입력 파일과 관련하여 최신 상태인 출력 파일이 있는 대상이 실행되지 않도록 최적화된 빌드입니다. 대상 요소는 대상이 입력으로 예상하는 항목을 나타내는 Inputs 특성 및 출력으로 생성하는 항목을 나타내는 Outputs 특성을 모두 가질 수 있습니다. MSBuild는 이러한 특성의 값 사이에서 1-1 매핑을 찾으려고 시도합니다. 1-1 매핑이 존재하는 경우 MSBuild는 해당 출력 항목의 타임스탬프와 모든 입력 항목의 타임스탬프를 비교합니다. 1-1 매핑이 없는 출력 파일은 모든 입력 파일과 비교됩니다. 출력 파일이 해당 입력 파일보다 최신이거나 두 파일의 타임스탬프가 같은 경우 항목이 최신 상태인 것으로 간주됩니다.

참고 항목

MSBuild가 입력 파일을 평가할 때 현재 실행 목록의 콘텐츠만 고려됩니다. 마지막 빌드에서 목록을 변경하더라도 대상이 자동으로 만료되지는 않습니다.

모든 출력 항목이 최신 상태인 경우 MSBuild는 대상을 건너뜁니다. 이 대상의 증분 빌드는 빌드 속도를 크게 향상 시킬 수 있습니다. 일부 파일만 최신 상태인 경우 MSBuild는 대상을 실행하지만 최신 항목을 건너뛰므로 모든 항목을 최신 상태로 합니다. 이 프로세스는 부분 증분 빌드로 알려져 있습니다.

1 대 1 매핑은 특성을 특성의 Inputs 변환으로 만들어 Outputs 서만 생성할 수 있습니다. 자세한 내용은 변환을 참조하세요.

다음 대상을 살펴보세요.

<Target Name="Backup" Inputs="@(Compile)"
    Outputs="@(Compile->'$(BackupFolder)%(Identity).bak')">
    <Copy SourceFiles="@(Compile)" DestinationFiles=
        "@(Compile->'$(BackupFolder)%(Identity).bak')" />
</Target>

Compile 항목 종류로 표시되는 파일 집합은 백업 디렉터리에 복사됩니다. 백업 파일에는 .bak 파일 이름 확장명이 있습니다. Compile 항목 형식으로 표시되는 파일 또는 해당 백업 파일은 백업 대상이 실행된 후 삭제 또는 수정되지 않으며 후속 빌드에서 백업 대상을 건너뜁니다.

출력 유추

MSBuild는 대상의 InputsOutputs 특성을 비교하여 대상을 실행해야 하는지 여부를 결정합니다. 이상적으로 증분 빌드가 완료된 후 존재하는 파일 집합은 연결된 대상의 실행 여부와 관계 없이 동일하게 유지되어야 합니다. 작업에 의해 만들어지거나 변경되는 속성 및 항목은 빌드에 영향을 줄 수 있기 때문에 MSBuild는 영향을 주는 대상을 건너뛰더라도 해당 값을 유추해야 합니다. 이 프로세스는 출력 유추로 알려져 있습니다.

여기에는 세 가지 경우가 있습니다.

  • 대상에 false로 평가되는 Condition 특성이 있습니다. 이 경우 대상이 실행되지 않으며 빌드에는 아무 영향이 없습니다.

  • 대상에 오래된 출력이 있으며 최신 상태가 되도록 실행됩니다.

  • 대상에 오래된 출력이 없으며 건너뜁니다. MSBuild는 대상을 평가하고 대상이 실행된 것처럼 항목 및 속성에 변경 내용을 만듭니다.

증분 컴파일을 지원하기 위해 작업은 모든 Output 요소의 TaskParameter 특성 값이 작업 입력 매개 변수와 동일한지 확인해야 합니다. 다음 몇 가지 예를 참조하세요.

<CreateProperty Value="123">
    <Output PropertyName="Easy" TaskParameter="Value" />
</CreateProperty>

대상이 실행되거나 건너뛰어지는지 여부에 관계 없이 이 코드는 값 "123"을 포함한 속성 Easy를 만듭니다.

MSBuild 3.5부터 출력 유추는 대상의 항목 및 속성 그룹에 대해 자동으로 수행됩니다. CreateItem 작업은 대상에 필요하지 않으며 피해야 합니다. 또한 CreateProperty 작업은 대상이 실행되었는지 여부를 결정하도록 대상에만 사용되어야 합니다.

MSBuild 3.5 전에는 CreateItem 작업을 사용할 수 있습니다.

대상이 실행되었는지 여부 결정

출력 유추로 인해 대상에 CreateProperty 작업을 추가하여 대상이 실행되었는지 여부를 결정할 수 있도록 속성 및 항목을 검사해야 합니다. 대상에 CreateProperty 작업을 추가하고 TaskParameter가 "ValueSetByTask"인 Output 요소를 제공합니다.

<CreateProperty Value="true">
    <Output TaskParameter="ValueSetByTask" PropertyName="CompileRan" />
</CreateProperty>

대상이 실행되는 경우에만 이 코드는 속성 CompileRan을 만들고 true 값을 제공합니다. 대상을 건너뛰는 경우 CompileRan은 생성되지 않습니다.