방법: 빌드 이벤트 지정(C#)

빌드 이벤트를 사용하여 빌드 시작 전 또는 빌드 완료 후 실행되는 명령을 지정합니다. 빌드 이벤트는 빌드가 빌드 프로세스의 해당 지점에 성공적으로 도달할 경우에만 실행됩니다.

프로젝트가 빌드될 때 빌드 전 이벤트는 PreBuildEvent.bat라는 파일에 추가되고 빌드 후 이벤트는 PostBuildEvent.bat라는 파일에 추가됩니다. 오류 확인을 보장하려면 자체적인 오류 확인 명령을 빌드 단계에 추가합니다.

> [!NOTE] > 일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 IDE 개인 설정을 참조하세요.

빌드 전 및 빌드 후 이벤트를 지정하는 방법

빌드 이벤트를 지정하려면

  1. 솔루션 탐색기에서 빌드 이벤트를 지정할 프로젝트를 선택합니다.

  2. 프로젝트 메뉴에서 속성을 클릭합니다.

  3. 빌드 이벤트 탭을 선택합니다.

  4. 빌드 전 이벤트 명령줄 상자에서 빌드 이벤트의 구문을 지정합니다.

    참고

    프로젝트가 최신 상태이고 빌드가 트리거되지 않으면 빌드 전 이벤트가 실행되지 않습니다.

  5. 빌드 후 이벤트 명령줄 상자에서 빌드 이벤트의 구문을 지정합니다.

    참고

    .bat 파일을 실행하는 모든 빌드 후 이벤트 명령 앞에 call 문을 추가합니다. 예를 들어 call C:\MyFile.bat 또는 call C:\MyFile.bat call C:\MyFile2.bat로 이름을 지정할 수 있습니다.

  6. 빌드 후 이벤트 실행 상자에서 빌드 후 이벤트를 실행할 조건을 지정합니다.

    참고

    긴 구문을 추가하거나 빌드 전 이벤트/빌드 후 이벤트 명령줄 대화 상자에서 임의의 빌드 매크로를 선택하려면, 줄임표 단추(...)를 클릭하여 편집 상자를 표시합니다.

    빌드 이벤트 구문에는 명령 프롬프트 또는 .bat 파일에서 유효한 모든 명령이 포함될 수 있습니다. 일괄 처리 파일의 이름 앞에 call을 사용하여 모든 후속 명령이 실행되도록 합니다.

    참고: 빌드 전 또는 빌드 후 이벤트가 성공적으로 완료되지 않으면 성공적인 작업을 나타내는 0(영) 이외의 코드로 이벤트 작업이 종료되도록 하여 빌드를 종료할 수 있습니다.

예: 빌드 후 이벤트를 사용하여 매니페스트 정보를 변경하는 방법

다음 절차에서는 빌드 후 이벤트에서 호출된 .exe 명령을 사용하여 응용 프로그램 매니페스트의 최소 운영 체제 버전을 설정하는 방법을 보여 줍니다(프로젝트 디렉터리의 .exe.manifest 파일). 최소 운영 체제 버전은 네 부분으로 구성된 번호입니다(예: 4.10.0.0). 이를 위해 명령은 매니페스트의 <dependentOS> 섹션을 변경합니다.

<dependentOS>  
   <osVersionInfo>  
      <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />  
   </osVersionInfo>  
</dependentOS>  

.exe 명령을 만들어 응용 프로그램 매니페스트를 변경하려면

  1. 명령에 대한 콘솔 응용 프로그램을 만듭니다. 파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.

  2. 새 프로젝트 대화 상자에서 Visual C#을 확장하고, 을 클릭하고 나서, 콘솔 응용 프로그램 템플릿을 클릭합니다. 프로젝트 이름을 ChangeOSVersionCS로 지정합니다.

  3. Program.cs에서 파일 맨 위의 다른 using 문에 다음 줄을 추가합니다.

    using System.Xml;  
    
  4. ChangeOSVersionCS 네임스페이스에서 Program 클래스 구현을 다음 코드로 바꿉니다.

    class Program  
    {  
       /// <summary>  
       /// This function will set the minimum operating system version for a ClickOnce application.  
       /// </summary>  
       /// <param name="args">  
       /// Command Line Arguments:  
       /// 0 - Path to application manifest (.exe.manifest).  
       /// 1 - Version of OS  
       ///</param>  
       static void Main(string[] args)  
       {  
          string applicationManifestPath = args[0];  
          Console.WriteLine("Application Manifest Path: " + applicationManifestPath);  
    
          // Get version name.  
          Version osVersion = null;  
          if (args.Length >=2 ){  
             osVersion = new Version(args[1]);  
          }else{  
             throw new ArgumentException("OS Version not specified.");  
          }  
          Console.WriteLine("Desired OS Version: " + osVersion.ToString());  
    
          XmlDocument document;  
          XmlNamespaceManager namespaceManager;  
          namespaceManager = new XmlNamespaceManager(new NameTable());  
          namespaceManager.AddNamespace("asmv1", "urn:schemas-microsoft-com:asm.v1");  
          namespaceManager.AddNamespace("asmv2", "urn:schemas-microsoft-com:asm.v2");  
    
          document = new XmlDocument();  
          document.Load(applicationManifestPath);  
    
          string baseXPath;  
          baseXPath = "/asmv1:assembly/asmv2:dependency/asmv2:dependentOS/asmv2:osVersionInfo/asmv2:os";  
    
          // Change minimum required operating system version.  
          XmlNode node;  
          node = document.SelectSingleNode(baseXPath, namespaceManager);  
          node.Attributes["majorVersion"].Value = osVersion.Major.ToString();  
          node.Attributes["minorVersion"].Value = osVersion.Minor.ToString();  
          node.Attributes["buildNumber"].Value = osVersion.Build.ToString();  
          node.Attributes["servicePackMajor"].Value = osVersion.Revision.ToString();  
    
          document.Save(applicationManifestPath);  
       }  
    }  
    

    이 명령은 두 개의 인수인 응용 프로그램 매니페스트의 경로(매니페스트를 만드는 빌드 프로세스의 폴더, 일반적으로 Projectname.publish) 및 새 운영 체제 버전을 사용합니다.

  5. 프로젝트를 빌드합니다. 빌드 메뉴에서 솔루션 빌드를 클릭합니다.

  6. .exe 파일을 디렉터리(예: C:\TEMP\ChangeOSVersionVB.exe)에 복사합니다.

    다음으로 빌드 후 이벤트에서 이 명령을 호출하여 응용 프로그램 매니페스트를 수정합니다.

빌드 후 이벤트를 호출하여 응용 프로그램 매니페스트를 수정하려면

  1. 프로젝트를 게시할 Windows 응용 프로그램을 만듭니다. 파일 메뉴에서 새로 만들기를 가리킨 다음 프로젝트를 클릭합니다.

  2. 새 프로젝트 대화 상자에서 Visual C#을 확장하고, 을 클릭하고 나서, Windows Forms 응용 프로그램 템플릿을 클릭합니다. 프로젝트 이름을 CSWinApp로 지정합니다.

  3. 솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.

  4. 프로젝트 디자이너에서 게시 페이지를 찾고 게시 위치C:\TEMP\로 설정합니다.

  5. 지금 게시를 클릭하여 프로젝트를 게시합니다.

    매니페스트 파일이 빌드되고 C:\TEMP\CSWinApp_1_0_0_0\CSWinApp.exe.manifest에 삽입됩니다. 매니페스트를 보려면 파일을 마우스 오른쪽 단추로 클릭하고, 연결 프로그램을 클릭하고, 목록에서 프로그램 선택을 선택하고 나서, 메모장을 클릭합니다.

    파일에서 <osVersionInfo> 요소를 검색합니다. 예를 들어 버전은 다음과 같습니다.

    <os majorVersion="4" minorVersion="10" buildNumber="0" servicePackMajor="0" />  
    
  6. 프로젝트 디자이너에서 빌드 이벤트 탭을 클릭하고 빌드 후 편집 단추를 클릭합니다.

  7. 빌드 후 이벤트 명령줄 상자에서 다음 명령을 입력합니다.

    C:\TEMP\ChangeOSVersionCS.exe "$(TargetPath).manifest" 5.1.2600.0

    프로젝트를 빌드할 때 이 명령은 응용 프로그램 매니페스트의 최소 운영 체제 버전을 5.1.2600.0으로 변경합니다.

    $(TargetPath) 매크로는 생성되는 실행 파일의 전체 경로를 표현하므로 $(TargetPath).manifest는 bin 디렉터리에서 생성되는 응용 프로그램 매니페스트를 지정합니다. 게시를 수행하면 이 매니페스트가 이전에 설정한 게시 위치에 복사됩니다.

  8. 프로젝트를 다시 게시합니다. 게시 페이지로 이동하고 지금 게시를 클릭합니다.

    매니페스트를 다시 봅니다. 매니페스트를 보려면 게시 디렉터리를 열고, 파일을 마우스 오른쪽 단추로 클릭하고, 연결 프로그램을 클릭하고, 목록에서 프로그램 선택을 선택하고 나서, 메모장을 클릭합니다.

    버전은 다음과 같이 표시됩니다.

    <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" />  
    

참고 항목

프로젝트 디자이너, 빌드 이벤트 페이지(C#)
빌드 전 이벤트/빌드 후 이벤트 명령줄 대화 상자
방법: 빌드 이벤트 지정(Visual Basic)
컴파일 및 빌드