ClickOnce 애플리케이션을 만든 다음 고객에게 게시 및 배포를 제공할 때 고객은 일반적으로 배포 매니페스트를 업데이트하고 다시 서명해야 했습니다. 대부분의 경우 여전히 기본 방법이지만 .NET Framework 3.5를 사용하면 새 배포 매니페스트를 다시 생성하지 않고도 고객이 배포할 수 있는 ClickOnce 배포를 만들 수 있습니다. 자세한 내용은 중단 없이 테스트 및 프로덕션 서버에 ClickOnce 애플리케이션을 배포하는 방법을 참조하세요.
ClickOnce 애플리케이션을 만든 다음 고객에게 게시 및 배포를 제공하는 경우 애플리케이션은 고객의 브랜딩을 사용하거나 브랜딩을 유지할 수 있습니다. 예를 들어 애플리케이션이 단일 전용 애플리케이션인 경우 브랜딩을 유지할 수 있습니다. 애플리케이션이 각 고객에 대해 고도로 사용자 지정된 경우 고객의 브랜딩을 사용할 수 있습니다. .NET Framework 3.5를 사용하면 배포할 조직에 애플리케이션을 제공할 때 브랜딩, 게시자 정보 및 보안 서명을 유지할 수 있습니다. 자세한 내용은 다른 사용자가 배포할 ClickOnce 애플리케이션 만들기를 참조하세요.
비고
이 연습에서는 명령줄 도구 Mage.exe 또는 그래픽 도구 MageUI.exe를 사용하여 배포를 수동으로 만듭니다. 수동 배포에 대한 자세한 내용은 연습: ClickOnce 애플리케이션 수동 배포를 참조하세요.
비고
.NET Core 3.1 및 .NET 5 이상용 ClickOnce에서 Mage.exe 대신 dotnet-mage.exe사용합니다. 자세한 내용은 .NET용 ClickOnce를 참조하세요.
필수 조건
이 연습의 단계를 수행하려면 다음이 필요합니다.
배포할 준비가 된 Windows Forms 애플리케이션입니다. 이 애플리케이션을 WindowsFormsApp1이라고 합니다.
Visual Studio 또는 Windows SDK.
Mage.exe 사용하여 여러 배포 및 브랜딩 지원을 사용하여 ClickOnce 애플리케이션을 배포하려면
Visual Studio 명령 프롬프트 또는 Windows SDK 명령 프롬프트를 열고 ClickOnce 파일을 저장할 디렉터리로 변경합니다.
현재 배포 버전의 이름을 따서 명명된 디렉터리를 만듭니다. 애플리케이션을 처음 배포하는 경우 1.0.0.0을 선택할 수 있습니다.
비고
배포 버전은 애플리케이션 파일 버전과 다를 수 있습니다.
bin이라는 하위 디렉터리를 만들고 실행 파일, 어셈블리, 리소스 및 데이터 파일을 포함하여 모든 애플리케이션 파일을 여기에 복사합니다.
Mage.exe호출하여 애플리케이션 매니페스트를 생성합니다.
mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"디지털 인증서를 사용하여 애플리케이션 매니페스트에 서명합니다.
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfxMage.exe호출하여 배포 매니페스트를 생성합니다. 기본적으로 Mage.exe ClickOnce 배포를 설치된 애플리케이션으로 표시하므로 온라인 및 오프라인에서 실행할 수 있습니다. 사용자가 온라인일 때만 애플리케이션을 사용할 수 있도록 하려면 값
-i이f있는 인수를 사용합니다. 이 애플리케이션은 여러 배포 기능을 활용하므로-providerUrl인수를 제외합니다. (버전 3.5 이전의 .NET Framework 버전에서는 오프라인 애플리케이션을 제외-providerUrl하면 오류가 발생합니다.)mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest배포 매니페스트에 서명하지 마세요.
자신의 네트워크에 애플리케이션을 배포할 고객에게 모든 파일을 제공합니다.
이 시점에서 고객은 자체 생성된 인증서를 사용하여 배포 매니페스트에 서명해야 합니다. 예를 들어 고객이 Adventure Works라는 회사에서 작업하는 경우 MakeCert.exe 도구를 사용하여 자체 서명된 인증서를 생성할 수 있습니다. 다음으로Pvk2pfx.exe도구를 사용하여 MakeCert.exe 만든 파일을 Mage.exe 전달할 수 있는 PFX 파일로 결합 합니다.
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx고객은 다음으로 이 인증서를 사용하여 배포 매니페스트에 서명합니다.
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx고객은 애플리케이션을 사용자에게 배포합니다.
MageUI.exe 사용하여 여러 배포 및 브랜딩 지원을 사용하여 ClickOnce 애플리케이션을 배포하려면
Visual Studio 명령 프롬프트 또는 Windows SDK 명령 프롬프트를 열고 ClickOnce 파일을 저장할 디렉터리로 이동합니다.
bin이라는 하위 디렉터리를 만들고 실행 파일, 어셈블리, 리소스 및 데이터 파일을 포함하여 모든 애플리케이션 파일을 여기에 복사합니다.
배포의 현재 버전 이름을 따서 명명된 하위 디렉터리를 만듭니다. 애플리케이션을 처음 배포하는 경우 1.0.0.0을 선택할 수 있습니다.
비고
배포 버전은 애플리케이션 파일 버전과 다를 수 있습니다.
\bin 디렉터리를 2단계에서 만든 디렉터리로 이동합니다.
그래픽 도구 MageUI.exe시작합니다.
MageUI.exe메뉴에서 파일, 새로 만들기, 애플리케이션 매니페스트를 선택하여 새 애플리케이션 매니페스트 를 만듭니다.
기본 이름 탭에서 이 배포의 이름 및 버전 번호를 입력합니다. 또한 게시자에 대한 값을 제공합니다. 이 값은 배포될 때 시작 메뉴에서 애플리케이션의 바로 가기 링크에 대한 폴더 이름으로 사용됩니다.
애플리케이션 옵션 탭을 선택하고 신뢰 정보에 애플리케이션 매니페스트 사용을 클릭합니다. 이렇게 하면 이 ClickOnce 애플리케이션에 대한 타사 브랜딩이 활성화됩니다.
파일 탭을 선택하고 애플리케이션 디렉터리 텍스트 상자 옆에 있는 찾아보기 단추를 클릭합니다.
2단계에서 만든 애플리케이션 파일이 포함된 디렉터리를 선택하고 폴더 선택 대화 상자에서 확인을 클릭합니다.
채우기 단추를 클릭하여 모든 애플리케이션 파일을 파일 목록에 추가합니다. 애플리케이션에 둘 이상의 실행 파일이 포함된 경우 파일 형식 드롭다운 목록에서 진입점을 선택하여 이 배포의 기본 실행 파일을 시작 애플리케이션으로 표시합니다. (애플리케이션에 하나의 실행 파일만 포함된 경우, MageUI.exe가 자동으로 그것을 지정해 줍니다.)
필요한 사용 권한 탭을 선택하고 애플리케이션을 어설션하는 데 필요한 신뢰 수준을 선택합니다. 기본값은 대부분의 애플리케이션에 적합한 완전 신뢰입니다.
파일을 선택하고 메뉴에서 저장한 다음 애플리케이션 매니페스트를 저장합니다. 애플리케이션 매니페스트를 저장할 때 서명하라는 메시지가 표시됩니다.
파일 시스템에 파일로 저장된 인증서가 있는 경우 인증서 파일로 서명 옵션을 사용하고 줄임표(...) 단추를 사용하여 파일 시스템에서 인증서를 선택합니다.
-또는-
인증서가 컴퓨터에서 액세스할 수 있는 인증서 저장소에 보관된 경우 저장된 인증서로 서명 옵션을 선택하고 제공된 목록에서 인증서를 선택합니다.
메뉴에서 파일, 새로 만들기, 배포 매니페스트 를 선택하여 배포 매니페스트를 만든 다음 이름 탭에서 이름 및 버전 번호(이 예제에서는 1.0.0.0 )를 제공합니다.
업데이트 탭으로 전환하고 이 애플리케이션을 업데이트할 빈도를 지정합니다. 애플리케이션이 ClickOnce 배포 API를 사용하여 자체적으로 업데이트를 확인하는 경우, 이 애플리케이션은 업데이트를 확인해야 합니다라는 확인란의 선택을 해제합니다.
애플리케이션 참조 탭으로 전환합니다. 매니페스트 선택 단추를 클릭하고 이전 단계에서 만든 애플리케이션 매니페스트를 선택하여 이 탭의 모든 값을 미리 채울 수 있습니다.
저장을 선택하고 배포 매니페스트를 디스크에 저장합니다. 애플리케이션 매니페스트를 저장할 때 서명하라는 메시지가 표시됩니다. 매니페스트에 서명하지 않고 저장하려면 [취소 ]를 클릭하십시오.
고객에게 모든 애플리케이션 파일을 제공합니다.
이 시점에서 고객은 자체 생성된 인증서를 사용하여 배포 매니페스트에 서명해야 합니다. 예를 들어 고객이 Adventure Works라는 회사에서 작업하는 경우 MakeCert.exe 도구를 사용하여 자체 서명된 인증서를 생성할 수 있습니다. 다음으로Pvk2pfx.exe도구를 사용하여 MakeCert.exe 만든 파일을 MageUI.exe 전달할 수 있는 PFX 파일로 결합 합니다.
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx인증서가 생성되면 고객은 이제 MageUI.exe배포 매니페스트를 열고 저장하여 배포 매니페스트에 서명합니다. 서명 대화 상자가 나타나면 고객은 인증서 파일로 서명 옵션을 선택하고 디스크에 저장한 PFX 파일을 선택합니다.
고객은 애플리케이션을 사용자에게 배포합니다.