명령줄에서 .NET ClickOnce 애플리케이션 빌드

아티클
10/31/2023

Visual Studio에서는 IDE(통합 개발 환경)에서 프로젝트를 만들었더라도 명령줄에서 프로젝트를 빌드할 수 있습니다. 실제로 .NET 5 이상만 설치되어 있는 다른 컴퓨터에서 Visual Studio로 만든 프로젝트를 다시 빌드할 수 있습니다. 이 기능을 사용하면 자동화된 프로세스를 사용하여 빌드를 재현할 수 있습니다(예: 중앙 빌드 랩에서 또는 프로젝트 자체를 빌드하는 범위를 벗어나는 고급 스크립팅 기술 사용).

참고 항목

명령줄에서 .NET Framework ClickOnce 애플리케이션을 빌드하려면 명령줄에서 ClickOnce 애플리케이션 빌드를 참조하세요.

MSBuild를 사용하여 .NET ClickOnce 애플리케이션 배포 재현

명령줄에서 msbuild /target:publish를 호출하면, 이 명령은 MSBuild 시스템에 프로젝트를 빌드하고 publish 폴더에 ClickOnce 애플리케이션을 만들도록 지시합니다. 이 명령은 IDE에서 게시 명령을 선택하는 것과 같습니다.

이 명령은 Visual Studio 명령 프롬프트 환경의 경로에 있는 msbuild.exe를 실행합니다.

"대상"은 명령을 처리하는 방법을 MSBuild에 알려 주는 표시기입니다. 주요 대상은 "빌드" 대상과 "게시" 대상입니다. 빌드 대상은 IDE에서 빌드 명령을 선택하거나 F5 키를 누르는 것과 같습니다. 프로젝트만 빌드하려는 경우 msbuild를 입력할 수 있습니다. 빌드 대상이 Visual Studio에서 생성된 모든 프로젝트의 기본 대상이기 때문에 이 명령은 작동합니다. 따라서 빌드 대상을 명시적으로 지정할 필요가 없습니다. 따라서 msbuild 입력은 msbuild /target:build 입력과 동일한 작업입니다.

/target:publish 명령은 게시 대상을 호출하도록 MSBuild에 지시합니다. 게시 대상은 빌드 대상에 따라 달라집니다. 즉, 게시 작업은 빌드 작업의 상위 집합입니다. 예를 들어 Visual Basic 또는 C# 원본 파일을 변경한 경우, 게시 작업은 해당 어셈블리를 자동으로 다시 빌드합니다.

Mage.exe 명령줄 도구로 전체 ClickOnce 배포를 생성하여 ClickOnce 매니페스트를 만드는 방법에 대한 자세한 내용은 연습: 수동으로 ClickOnce 애플리케이션 배포를 참조하세요.

MSBuild로 기본 ClickOnce 애플리케이션 만들기 및 빌드

게시 프로필을 만드는 가장 쉬운 방법은 Visual Studio를 사용하는 것입니다. MSBuild를 사용하여 게시하려면 게시 프로필이 필요합니다.

ClickOnce 프로젝트를 만들고 게시

Visual Studio를 연 다음 새 프로젝트를 만듭니다.

Windows Forms 앱 또는 WPF 애플리케이션 프로젝트 템플릿을 선택하고 프로젝트 이름을 CmdLineDemo로 지정한 다음 프로젝트를 만듭니다.
솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하고 게시를 선택합니다.

이 단계에서는 ClickOnce 애플리케이션 배포를 생성하도록 프로젝트가 제대로 구성되었는지 확인합니다.

게시 페이지가 표시됩니다.
게시 페이지에서 게시 프로필 추가를 선택하고 ClickOnce를 선택한 다음 마침을 선택합니다.

이 연습에서는 게시 페이지의 다른 구성 설정을 무시할 수 있습니다.
프로세스가 완료되면 닫기를 선택하여 페이지 게시 대화 상자를 종료합니다.
게시를 선택합니다.

Visual Studio는 ClickOnce 배포 출력을 생성합니다.
프로젝트를 저장하고 프로젝트가 저장되는 폴더 위치를 기록해 둡니다.

이전 단계는 처음으로 게시된 ClickOnce 프로젝트를 만듭니다. 이제 IDE 외부에서 빌드를 재현할 수 있습니다.

명령줄에서 빌드 재현

Visual Studio를 끝냅니다.
Windows 시작 메뉴에서 도구>명령줄>개발자 명령 프롬프트를 선택합니다.

Visual Studio 개발자 명령 프롬프트가 열립니다.
Visual Studio 명령 프롬프트에서 현재 디렉터리에 앞에서 빌드한 프로젝트의 위치가 표시되는지 확인합니다.

프로젝트 디렉터리에서 작업하지 않는 경우 명령을 입력하여 원하는 위치(예: chdir C:\Users\username\source\repos\CmdLineDemo)로 변경합니다.
이전 섹션에서 생성된 기존 파일을 제거하려면, rmdir /s publish를 입력합니다.

이 단계는 선택 사항이지만 명령줄 빌드가 새 파일을 모두 생성했는지 확인합니다.

.NET 5 이상의 경우 명령줄에서 .NET ClickOnce 애플리케이션을 빌드하는 것은 비슷하게 진행됩니다. 한 가지 차이점은 MSBuild 명령줄에서 게시 프로필에 대한 추가 속성을 제공해야 한다는 것입니다.
msbuild /target:publish /p:PublishProfile=<pubxml file> /p:PublishDir="<specific location>"를 입력합니다.

이전 단계에서는 publish라는 프로젝트의 하위 폴더에 전체 ClickOnce 애플리케이션 배포를 생성합니다. CmdLineDemo.application은 ClickOnce 배포 매니페스트입니다. CmdLineDemo_1.0.0.0 폴더에는 CmdLineDemo.exe 파일과 ClickOnce 애플리케이션 매니페스트인 CmdLineDemo.exe.manifest가 포함되어 있습니다. Setup.exe는 기본적으로 .NET를 설치하도록 구성된 부트스트래퍼입니다. 이 폴더의 파일은 웹 또는 UNC 또는 CD/DVD를 통해 애플리케이션을 배포하는 데 필요한 파일의 전체 집합을 구성합니다.

참고 항목

MSBuild 시스템은 PublishDir 옵션을 사용하여 출력 위치를 지정합니다(예: msbuild /t:publish /p:PublishProfile=<pubxml file> /p:PublishDir="<specific location>").

게시 프로세스 출력

MSBuild는 PublishDir 속성을 사용하여 빌드 아티팩트 등 빌드 출력 위치를 설정합니다. MSBuild가 게시 대상으로 사용하는 PublishDir 값은 기본적으로 .pubxml 파일(.NET)의 PublishDir 속성에서 가져옵니다. 또한 /p 스위치를 사용하여 MSBuild 명령줄에서 이 동작을 재정의할 수 있습니다. 설정을 재정의하면 게시 출력이 지정된 위치로 이동합니다. 출력은 MSBuild 게시 단계 중에 생성됩니다. 이 복사본이 만들어진 후 AfterTargets="ClickOncePublish"가 실행되는 모든 MSBuild 대상입니다.

PublishUrl 속성은 PublishDir과 달리 MSBuild 단계에서는 사용되지 않습니다. PublishUrl은 명령줄에서 게시하기 위해 MSBuild를 직접 호출할 때 무시됩니다.

Visual Studio IDE에서 게시가 시작되면 Visual Studio는 MSBuild를 호출하여 PublishDir 위치에 아티팩트를 게시합니다. 이 MSBuild 단계가 완료되면 Visual Studio는 ClickOnce 관련 파일을 PublishUrl이 가리키는 위치에 게시합니다. 이 두 번째 단계는 Visual Studio 프로세스 내에서 실행됩니다. Visual Studio 프로세스이므로 이 단계에서 실행할 대상/작업을 삽입할 수 없습니다.

Visual Studio를 사용하지 않는 MSBuild 배포의 경우 배포 디렉터리의 모든 파일을 배포 대상 또는 미디어에 복사합니다. 배포 디렉터리는 웹 사이트 또는 FTP 사이트의 폴더, 파일 공유 또는 CD-ROM일 수 있습니다. 예를 들어 타사 도구 또는 사용자 지정 MSBuild 작업을 사용하여 ClickOnce 파일을 복사할 수 있습니다.

PublishUrl 폴더의 후처리의 경우 별도의 스크립트가 있어야 합니다.

Important

PublishDir이 PublishUrl과 동일한 위치로 설정된 경우 중복 컴파일 출력이 PublishUrl 위치에 복사됩니다. Visual Studio 2022 버전 17.4 이상에서는 새 프로필을 만들어 이 문제를 방지할 수 있습니다. 새 프로필은 PublishDir을 PublishUrl과 다른 위치로 설정합니다. 게시 작업이 끝나면 관련 ClickOnce 파일이 PublishDir에서 PublishUrl 위치로 복사됩니다.

속성 게시

이전 절차를 사용하여 애플리케이션을 게시하면 .NET 프로젝트(.NET 5 이상)에 대한 게시 프로필 파일에 다음 속성이 삽입됩니다. 이러한 속성은 ClickOnce 애플리케이션이 생성되는 방식에 직접적인 영향을 미칩니다.

.pubxml에서:

<AssemblyOriginatorKeyFile>WindowsApplication3.snk</AssemblyOriginatorKeyFile>
<GenerateManifests>true</GenerateManifests>
<TargetZone>LocalIntranet</TargetZone>
<PublisherName>Microsoft</PublisherName>
<ProductName>CmdLineDemo</ProductName>
<PublishUrl>http://localhost/CmdLineDemo</PublishUrl>
<Install>true</Install>
<ApplicationVersion>1.0.0.*</ApplicationVersion>
<ApplicationRevision>1</ApplicationRevision>
<UpdateEnabled>true</UpdateEnabled>
<UpdateRequired>false</UpdateRequired>
<UpdateMode>Foreground</UpdateMode>
<UpdateUrlEnabled>false</UpdateUrlEnabled>
<IsWebBootstrapper>true</IsWebBootstrapper>
<BootstrapperEnabled>true</BootstrapperEnabled>

프로젝트 파일 자체를 변경하지 않고 명령줄에서 이러한 속성을 재정의할 수 있습니다. 예를 들어 다음은 부트스트래퍼 없이 ClickOnce 애플리케이션 배포를 빌드할 수 있습니다.

msbuild /target:publish /p:PublishProfile=<pubxml file> /property:BootstrapperEnabled=false

게시 속성은 Visual Studio에서 프로젝트 디자이너의 게시, 보안 및 서명 속성 페이지에서 제어됩니다. .NET 프로젝트(.NET 5 이상)의 경우 게시 도구를 사용하여 Visual Studio에서 액세스할 수 있는 pubxml 파일에 이러한 설정이 제공됩니다.

다음 게시 속성은 애플리케이션 디자이너의 다양한 속성 페이지에 설정됩니다.

AssemblyOriginatorKeyFile은 ClickOnce 애플리케이션 매니페스트에 서명하는 데 사용되는 키 파일을 결정합니다. 동일한 키를 사용하여 어셈블리에 강력한 이름을 할당할 수도 있습니다. 이 속성은 프로젝트 디자이너의 서명 페이지에서 설정됩니다. .NET Windows 애플리케이션의 경우 이 설정은 프로젝트 파일에 남아 있습니다.

다음 속성은 게시 페이지에서 설정됩니다.

PublishUrl은 IDE에서 애플리케이션이 게시되는 위치입니다. InstallUrl 및 UpdateUrl 속성이 모두 지정되지 않는 경우 ClickOnce 애플리케이션 매니페스트에 삽입됩니다.
ApplicationVersion은 ClickOnce 애플리케이션의 버전을 지정합니다. 버전은 4자리 숫자입니다. 마지막 자리가 "*"(별표)인 경우 ApplicationRevision은 빌드 시 매니페스트에 삽입된 값으로 대체됩니다.
ApplicationRevision은 수정 버전을 지정합니다. 이 값은 IDE에 게시할 때마다 증가하는 정수입니다. 명령줄에서 수행되는 빌드의 경우에는 자동으로 증가하지 않습니다.
Install은 애플리케이션이 설치되는 애플리케이션인지 웹에서 실행되는 애플리케이션인지 여부를 지정합니다.
InstallUrl(표시되지 않음)은 사용자들이 애플리케이션을 설치하는 위치입니다. 지정되는 경우 IsWebBootstrapper가 사용하도록 설정되면 이 값이 setup.exe 부트스트래퍼에 기록됩니다. UpdateUrl이 지정되지 않은 경우에도 애플리케이션 매니페스트에 삽입됩니다.
SupportUrl(표시되지 않음)은 설치된 애플리케이션의 프로그램 추가/제거 대화 상자에 연결된 위치입니다.

다음 속성은 게시 페이지에서 액세스하는 애플리케이션 업데이트 대화 상자에서 설정됩니다.

UpdateEnabled는 애플리케이션이 업데이트를 확인해야 하는지 여부를 나타냅니다.
UpdateMode는 포그라운드 업데이트를 지정합니다. .NET 프로젝트(.NET 5 이상)에서는 백그라운드가 지원되지 않습니다.
UpdateUrl(표시되지 않음)은 애플리케이션이 업데이트를 받는 위치입니다. 지정된 경우 이 값이 애플리케이션 매니페스트에 삽입됩니다.

다음 속성은 게시 페이지에서 액세스하는 게시 옵션 대화 상자에서 설정됩니다.

PublisherName은 애플리케이션을 설치하거나 실행할 때 표시되는 프롬프트에 표시되는 게시자의 이름을 지정합니다. 설치된 애플리케이션의 경우 시작 메뉴에서 폴더 이름을 지정하는 데도 사용됩니다.
ProductName은 애플리케이션을 설치하거나 실행할 때 표시되는 프롬프트에 표시되는 제품 이름을 지정합니다. 설치된 애플리케이션의 경우 시작 메뉴에서 바로 가기 이름을 지정하는 데도 사용됩니다.

다음 속성은 게시 페이지에서 액세스하는 필수 구성 요소 대화 상자에서 설정됩니다.

BootstrapperEnabled는 setup.exe 부트스트래퍼를 생성할지 여부를 결정합니다.
IsWebBootstrapper는 setup.exe 부트스트래퍼가 웹을 통해 작동하는지 디스크 기반 모드에서 작동하는지 여부를 결정합니다.

옵션 사용: InstallURL, SupportUrl, PublishURL, UpdateURL

다음 표는 ClickOnce 배포의 네 가지 URL 옵션을 보여 줍니다.

URL 옵션	설명
`PublishURL`	ClickOnce 애플리케이션을 웹 사이트에 게시하는 데 필요합니다.
`InstallURL`	선택 사항입니다. 설치 사이트가 `PublishURL`과 다른 경우 이 URL 옵션을 설정합니다. 예를 들어 `PublishURL`을 FTP 경로로 설정하고 `InstallURL`을 웹 URL로 설정할 수 있습니다.
`SupportURL`	선택 사항입니다. 지원 사이트가 `PublishURL`과 다른 경우 이 URL 옵션을 설정합니다. 예를 들어 `SupportURL`을 회사의 고객 지원 웹 사이트로 설정할 수 있습니다.
`UpdateURL`	선택 사항입니다. 업데이트 위치가 `InstallURL`과 다른 경우 이 URL 옵션을 설정합니다. 예를 들어 `PublishURL`을 FTP 경로로 설정하고 `UpdateURL`을 웹 URL로 설정할 수 있습니다.

다음을 통해 공유

명령줄에서 .NET ClickOnce 애플리케이션 빌드

MSBuild를 사용하여 .NET ClickOnce 애플리케이션 배포 재현

MSBuild로 기본 ClickOnce 애플리케이션 만들기 및 빌드

ClickOnce 프로젝트를 만들고 게시

명령줄에서 빌드 재현

게시 프로세스 출력

속성 게시

옵션 사용: InstallURL, SupportUrl, PublishURL, UpdateURL

피드백

추가 리소스

다음을 통해 공유

명령줄에서 .NET ClickOnce 애플리케이션 빌드

MSBuild를 사용하여 .NET ClickOnce 애플리케이션 배포 재현

MSBuild로 기본 ClickOnce 애플리케이션 만들기 및 빌드

ClickOnce 프로젝트를 만들고 게시

명령줄에서 빌드 재현

게시 프로세스 출력

속성 게시

옵션 사용: InstallURL, SupportUrl, PublishURL, UpdateURL

관련 콘텐츠

피드백

추가 리소스