MageUI.exe (매니페스트 생성 및 편집 도구, 그래픽 클라이언트)

MageUI.exe는 명령줄 도구인 Mage.exe와 동일한 기능을 지원하지만 Windows 기반 UI(사용자 인터페이스)를 사용합니다. 이 도구를 사용하면 배포 및 애플리케이션 매니페스트를 만들고, 편집하고, 서명할 수 있습니다. Mageui.exe로 만든 새 매니페스트는 .NET Framework 4 클라이언트 프로필을 대상으로 합니다. 이전 버전의 MageUI.exe는 이전 .NET Framework 버전을 대상으로 사용해야 합니다. 매니페스트에서 어셈블리를 추가 또는 제거하거나 기존 매니페스트를 다시 서명할 때 MageUI.exe는 매니페스트를 대상 .NET Framework 4 클라이언트 프로필로 업데이트하지 않습니다. 자세한 내용은 Mage.exe(매니페스트 생성 및 편집 도구)를 참조하세요.

이 도구는 자동으로 Visual Studio와 함께 설치됩니다. 도구를 실행하려면 Visual Studio 개발자 명령 프롬프트 또는 Visual Studio 개발자 PowerShell을 사용합니다.

Mage.exe 및 MageUI.exe의 두 버전이 Visual Studio의 구성 요소로 포함되어 있습니다. 버전 정보를 보려면 MageUI.exe를 실행하고 도움말을 선택하고 정보를 선택합니다. 이 설명서는 Mage.exe 및 MageUI.exe의 버전 4.0.x.x에 대해 설명합니다.

참고

MageUI.exe를 사용하는 인증서로 이미 서명된 애플리케이션 매니페스트를 저장할 때 MageUI.exe는 compatibleFrameworks 요소를 지원하지 않습니다. 대신, Mage.exe를 사용해야 합니다.

UI 요소 목록

다음 표에서는 사용 가능한 메뉴 및 도구 모음 항목을 보여 줍니다.

명령	메뉴	바로 가기	설명
애플리케이션 매니페스트	파일, 새로 만들기		새 애플리케이션 매니페스트를 만듭니다.
배포 매니페스트	파일, 새로 만들기		새 배포 매니페스트를 만듭니다.
열기	파일	Ctrl+O	기존 배포 매니페스트, 애플리케이션 매니페스트 또는 트러스트 라이선스를 편집을 위해 엽니다.
닫기	파일	Ctrl+F4	열린 파일을 닫습니다. 파일을 닫기 전에 수정한 사항이 있는 경우 MageUI.exe에서 공개 키, 키 쌍 또는 저장된 인증서를 사용하여 파일에 다시 서명하라는 메시지가 표시됩니다.
저장	파일	Ctrl+S	현재 사용자 입력 포커스가 있는 문서를 디스크에 저장합니다.
다른 이름으로 저장	파일		다른 파일 이름 또는 저장 위치를 지정하여 파일을 디스크에 저장합니다.
모두 저장	파일		현재 MageUI.exe 내에 열려 있는 모든 파일의 변경 내용을 저장합니다.
기본 설정	파일		기본 설정 대화 상자를 엽니다. 자세한 내용은 다음 단원을 참조하세요.
끝내기	파일	Alt+F4	MageUI.exe를 종료합니다.
잘라내기	편집	Ctrl+X	현재 선택한 텍스트를 애플리케이션에서 제거하여 시스템 클립보드로 이동합니다.
복사	편집	Ctrl+C	현재 선택한 텍스트를 시스템 클립보드에 복사합니다.
붙여넣기	편집	Ctrl+V	시스템 클립보드의 텍스트를 현재 활성화된 텍스트 요소에 붙여넣습니다.
삭제	편집		목록에서 현재 선택한 요소를 삭제합니다.예를 들면 배포 매니페스트 탭에 나열된 트러스트 라이선스를 삭제합니다.
모두 닫기	창		MageUI.exe에서 현재 열려 있는 모든 파일을 닫습니다. 저장해야 하는 파일이 있는 경우 파일을 저장하라는 메시지가 표시됩니다. 서명되지 않았거나 변경된 각 파일에 대해 서명 키를 선택하라는 메시지도 표시됩니다.
정보	도움말		MageUI.exe에 대한 버전 및 저작권 정보를 표시합니다.

기본 설정 대화 상자

기본 설정 대화 상자에는 다음과 같은 요소가 있습니다.

UI 요소	설명
저장할 때 서명	변경 내용을 저장할 때마다 파일에 서명하라는 메시지를 표시합니다.
기본 서명 인증서 사용	인증서 파일 텍스트 상자에 입력한 키를 모든 파일에 서명하는 데 사용합니다. 이 옵션을 선택하면 저장할 때 서명이 선택되어 있는 상태에서 파일을 저장할 때 일반적으로 표시되는 서명 요구 메시지가 나타나지 않습니다. 키 파일을 선택하려면 인증서 파일 텍스트 상자 옆에 있는 줄임표( … ) 단추를 사용합니다.
다이제스트 알고리즘	종속성 다이제스트를 생성하는 알고리즘을 지정합니다. 값은 "Sha256RSA" 또는 "sha1RSA"이어야 합니다. 기본적으로 SHA1을 사용합니다. 애플리케이션 및 배포 매니페스트에 사용합니다. 매니페스트를 저장할 때 인증서를 제공 하는 경우, 종속성 다이제스트를 생성하는 인증서에 알고리즘을 사용합니다.

서명 옵션 대화 상자

서명 옵션 대화 상자는 매니페스트 또는 트러스트 라이선스를 처음으로 저장하는 경우나 변경하는 경우에 표시됩니다. 이 대화 상자는 기본 설정 대화 상자에서 저장할 때 서명 옵션을 선택한 경우에만 표시됩니다. TimeStamping URI 텍스트 상자에 값을 지정하는 매니페스트를 서명할 때 인터넷에 연결해야 합니다.

이 대화 상자에는 다음 요소가 있습니다.

UI 요소	설명
인증서 파일로 서명	파일 시스템에 저장된 디지털 인증서를 사용하여 매니페스트에 서명합니다.
파일	인증서를 나타내는 .pfx 파일에 대한 경로를 입력할 수 있는 영역을 제공합니다.
...	기존 .pfx 파일을 선택하기 위해 파일 선택 대화 상자를 엽니다.
새로 만들기	CA(인증 기관)를 통해 확인할 수 없는 새 .pfx를 생성합니다. ClickOnce 배포에 서명하는 데 사용되는 인증서의 형식에 대한 자세한 설명은 신뢰할 수 있는 애플리케이션 배포 개요를 참조하세요.
암호	이 인증서로 서명하는 데 사용되는 암호를 입력할 수 있는 영역을 제공합니다. 암호를 사용하지 않는 경우에는 이 영역을 비워 둡니다.
저장된 인증서로 서명	컴퓨터의 인증서 저장소에 저장된 디지털 인증서의 목록을 표시하여 디지털 인증서를 선택할 수 있게 합니다.
타임스탬프 URI	디지털 타임스탬프 서비스의 URI(Uniform Resource Locator)를 표시합니다. 매니페스트에 타임스탬프를 적용하면 애플리케이션의 다음 버전을 배포하기 전에 디지털 인증서가 만료되어도 매니페스트에 다시 서명할 필요가 없습니다. 자세한 내용은 Windows 루트 인증서 프로그램 구성원 및 ClickOnce 및 Authenticode를 참조하세요.
서명 안 함	디지털 인증서의 서명을 추가하지 않고 매니페스트를 저장할 수 있습니다.

탭 및 패널 설명

MageUI.exe를 사용하여 문서를 열 때 문서는 고유의 탭 페이지에 표시됩니다. 각 탭에는 일련의 속성 패널이 포함되어 있고, 패널에는 문서 데이터의 그룹화된 하위 집합이 포함되어 있습니다.

애플리케이션 매니페스트 탭

애플리케이션 매니페스트 탭에는 애플리케이션 매니페스트의 내용이 표시됩니다. 애플리케이션 매니페스트는 배포에 포함된 모든 파일 및 클라이언트에서 애플리케이션을 실행하는 데 필요한 권한을 설명합니다.

애플리케이션 매니페스트 탭은 다음 탭으로 구성됩니다.

UI 요소	설명
이름	이 배포에 대한 식별 정보를 지정합니다.
설명	게시자, 제품 및 지원 정보를 지정합니다.
애플리케이션 옵션	브라우저 애플리케이션인지 여부 및 이 매니페스트가 신뢰 정보의 소스인지 여부를 지정합니다.
파일	이 배포를 구성하는 모든 파일을 지정합니다.
필요한 권한	클라이언트에서 실행할 애플리케이션에 필요한 최소 권한 집합을 지정합니다.

이름 탭

이름 탭은 애플리케이션 매니페스트를 처음 만들거나 열 때 표시됩니다. 이 탭은 배포를 고유하게 식별하고 선택적으로 유효한 대상 플랫폼을 지정합니다.

UI 요소	설명
이름	필수 요소. 애플리케이션 매니페스트의 이름입니다. 대개 파일 이름과 같습니다.
Version	필수 요소. N.N.N.N 형식의 배포 버전 번호입니다. 첫 번째 주요 빌드 번호만 필요합니다. 예를 들어 애플리케이션 버전 1.0에 대한 유효한 값에는 1, 1.0, 1.0.0 및 1.0.0.0이 포함됩니다.
프로세서	선택 사항입니다. 이 배포가 실행될 수 있는 컴퓨터 아키텍처입니다. 기본값은 모든 관리되는 어셈블리의 기본 형식인 msil(Microsoft Intermediate Language)입니다. 특정 아키텍처에 대한 애플리케이션에서 어셈블리를 미리 컴파일한 경우 이 필드를 변경하세요. 미리 컴파일에 대한 자세한 내용은 Ngen.exe(네이티브 이미지 생성기)를 참조하세요.
문화권.	선택 사항입니다. 이 애플리케이션이 실행하는 두 부분으로 구성된 ISO 국가 및 지역 코드입니다. 기본값은 neutral입니다.
공개 키 토큰	선택적 요소. 이 애플리케이션 매니페스트에 서명하는 데 사용된 공개 키입니다. 새 매니페스트이거나 서명되지 않은 매니페스트이면 이 필드가 Unsigned로 표시됩니다.

설명 탭

이 정보는 대기 배포 매니페스트 내에서 제공됩니다. 이러한 필드는 애플리케이션 옵션 탭에서 애플리케이션 매니페스트 신뢰 정보 사용 확인란이 선택된 경우에만 수정할 수 있습니다.

UI 요소	설명
게시자	애플리케이션에 대한 책임이 있는 개인 또는 조직의 이름입니다. 이 값은 시작 메뉴 폴더 이름으로 사용됩니다.
제품	전체 제품 이름입니다. 배포 매니페스트의 배포 옵션 탭에서 애플리케이션 형식 요소에 대해 로컬에서 설치를 선택하면 이 이름이 시작 메뉴 링크 및 이 애플리케이션의 프로그램 추가/제거에 표시됩니다.
지원 위치	고객이 애플리케이션에 대한 도움과 지원을 얻을 수 있는 URL입니다.

애플리케이션 옵션 탭

UI 요소	설명
Windows Presentation Foundation 브라우저 애플리케이션	브라우저에서 XBAP(XAML 브라우저 애플리케이션)로 실행되는 WPF 애플리케이션인지를 지정합니다.
애플리케이션 매니페스트 신뢰 정보 사용	이 매니페스트에 신뢰 정보를 포함할지를 지정합니다.

파일 탭

UI 요소	설명
애플리케이션 디렉터리	애플리케이션 파일이 있는 디렉터리입니다. 줄임표( … ) 단추를 사용하여 디렉터리를 선택합니다.
채우기	애플리케이션 디렉터리 및 하위 디렉터리의 모든 파일을 애플리케이션 매니페스트에 추가합니다. MageUI.exe가 디렉터리에서 하나의 실행 파일을 찾으면 자동으로 이 파일을 진입점으로 표시합니다. 진입점은 ClickOnce 애플리케이션이 클라이언트에서 시작될 때 처음 실행되는 파일입니다.
애플리케이션 파일	애플리케이션의 모든 파일을 나열합니다. 각 파일에는 아래 설명된 편집 가능한 특성 세 개가 있습니다.
파일 형식	파일 형식은 다음 네 가지 값의 하나일 수 있습니다. - 없음 - 진입점 애플리케이션의 주 실행 파일입니다. 실행 파일 하나만 진입점으로 표시할 수 있습니다. - 데이터 파일 애플리케이션에 데이터를 제공하는 XML 파일과 같은 파일입니다. - 아이콘 파일 애플리케이션 창의 모퉁이나 바탕 화면에 표시되는 것과 같은 애플리케이션 아이콘입니다.
선택 사항	선택적으로 표시된 파일은 초기 설치 또는 업데이트 시 다운로드되지 않지만 런타임에 System.Deployment 주문형 API를 사용하여 다운로드할 수 있습니다. 자세한 내용은 연습: 디자이너를 사용하여 ClickOnce 배포 API에서 요청 시 어셈블리 다운로드를 참조하세요.
그룹	선택적 파일 집합에 대한 레이블입니다. 그룹 레이블을 파일 집합에 적용하고 주문형 API를 사용하여 API 호출 한 번으로 파일을 일괄 다운로드할 수 있습니다.

필요한 권한 탭

기본적으로 부여되는 로컬 컴퓨터에 대한 추가 액세스 권한을 애플리케이션에 부여해야 할 경우 필요한 권한 탭을 사용합니다. 자세한 내용은 ClickOnce 애플리케이션 게시를 참조하세요.

UI 요소	설명
권한 집합 형식	클라이언트에서 실행할 이 애플리케이션에 필요한 최소 권한 집합입니다. 이들 권한 세트 및 권한 세트가 요청하거나 요청하지 않는 권한에 대한 자세한 내용은 명명된 권한 세트를 참조하세요.
설명	애플리케이션 매니페스트에서 권한 집합을 나타내려고 만들어진 XML입니다. 애플리케이션 매니페스트 XML 형식을 잘 알고 있지 않다면 이 XML을 수동으로 편집하면 안 됩니다. 자세한 내용은 ClickOnce 애플리케이션 매니페스트를 참조하세요.

배포 매니페스트 탭

배포 매니페스트 탭은 다음 탭으로 구성됩니다.

UI 요소	설명
이름	이 배포에 대한 식별 정보를 지정합니다.
설명	게시자, 제품 및 지원 정보를 지정합니다.
배포 옵션	애플리케이션 형식 및 시작 위치와 같은 배포에 대한 추가 정보를 지정합니다.
업데이트 옵션	ClickOnce가 애플리케이션 업데이트를 확인해야 하는 빈도를 지정합니다.
애플리케이션 참조	이 배포에 대한 애플리케이션 매니페스트를 지정합니다.

이름 탭

이름 탭은 배포 매니페스트를 처음 만들거나 열 때 표시됩니다. 이 탭은 배포를 고유하게 식별하고 선택적으로 유효한 대상 플랫폼을 지정합니다.

UI 요소	설명
이름	필수 요소. 배포 매니페스트의 이름입니다. 대개 파일 이름과 같습니다.
Version	필수 요소. N.N.N.N 형식의 배포 버전 번호입니다. 첫 번째 주요 빌드 번호만 필요합니다. 예를 들어 애플리케이션 버전 1.0에 대한 유효한 값에는 1, 1.0, 1.0.0 및 1.0.0.0이 포함됩니다.
프로세서	선택 사항입니다. 이 배포가 실행될 수 있는 컴퓨터 아키텍처입니다. 기본값은 모든 관리되는 어셈블리의 기본 형식인 msil(Microsoft Intermediate Language)입니다. 특정 아키텍처에 대한 애플리케이션에서 어셈블리를 컴파일한 경우 이 필드를 변경하세요.
문화권.	선택 사항입니다. 이 애플리케이션이 실행하는 두 부분으로 구성된 ISO 국가/지역 코드입니다. 기본값은 neutral입니다.
공개 키 토큰	선택 사항입니다. 이 배포 매니페스트에 서명하는 데 사용된 공개 키입니다. 새 매니페스트이거나 서명되지 않은 매니페스트이면 이 필드가 Unsigned로 표시됩니다.

설명 탭

UI 요소	설명
게시자	필수 요소. 애플리케이션에 대한 책임이 있는 개인 또는 조직의 이름입니다. 이 값은 시작 메뉴 폴더 이름으로 사용됩니다.
제품	필수 요소. 전체 제품 이름입니다. 배포 옵션 탭에서 애플리케이션 형식 요소에 대해 로컬에서 설치를 선택하면 이 이름이 시작 메뉴 링크 및 이 애플리케이션의 프로그램 추가/제거에 표시됩니다.
지원 위치	선택 사항입니다. 고객이 애플리케이션에 대한 도움과 지원을 얻을 수 있는 URL입니다.

배포 옵션 탭

UI 요소	설명
애플리케이션 종류	선택 사항입니다. 이 애플리케이션이 클라이언트 컴퓨터에 설치될지(로컬에서 설치), 온라인으로 실행될지(온라인일 때만) 또는 브라우저에서 실행되는 WPF 애플리케이션일지(WPF 브라우저 애플리케이션)를 지정합니다. 기본값은 로컬에서 설치입니다.
시작 위치	선택 사항입니다. 애플리케이션이 실제로 시작되어야 하는 소스 URL입니다. 웹에서 자동으로 업데이트되어야 하는 애플리케이션을 CD에서 배포할 때 유용합니다.
매니페스트에 시작 위치(ProviderURL) 포함	선택 사항입니다. ClickOnce에서 애플리케이션 업데이트를 확인할 URL을 지정합니다.
설치 후 자동으로 애플리케이션 실행	필수 요소. URL에서 처음 설치한 직후 ClickOnce 애플리케이션이 실행되도록 지정합니다. 이 항목은 기본적으로 선택되어 있습니다.
애플리케이션으로 URL 매개 변수가 전달되도록 허용	필수 요소. 배포 매니페스트의 URL에 추가된 쿼리 문자열을 통해 ClickOnce 애플리케이션에 매개 변수 데이터를 전송하도록 허용합니다. 이 항목은 기본적으로 선택 취소되어 있습니다.
.deploy 파일 확장명 사용	필수 요소. 이 항목을 선택하면 애플리케이션 매니페스트의 모든 파일에 .deploy 확장명이 포함되어야 합니다. 이 항목은 기본적으로 선택 취소되어 있습니다.

업데이트 옵션 탭

이름 탭의 애플리케이션 형식 선택 상자가 로컬에서 설치로 설정되면 업데이트 옵션 탭에는 여기 언급된 옵션만 포함됩니다.

UI 요소	설명
이 애플리케이션의 업데이트 확인	ClickOnce에서 애플리케이션 업데이트를 확인할지를 지정합니다. 이 확인란을 선택하지 않으면 System.Deployment.Application 네임스페이스에서 API를 사용하여 프로그래밍 방식으로 애플리케이션을 업데이트하지 않는 한 애플리케이션이 업데이트를 확인하지 않습니다.
애플리케이션이 언제 업데이트를 확인해야 하는지 선택하세요.	다음 두 가지 업데이트 확인 옵션을 제공합니다. - 애플리케이션 시작 전. 애플리케이션 실행 전에 업데이트 확인이 수행됩니다. - 애플리케이션 시작 후. 애플리케이션 기본 폼이 초기화되면 업데이트 확인이 시작되고 다음에 애플리케이션이 시작될 때 실행됩니다.
업데이트 확인 빈도	ClickOnce에서 업데이트를 확인하는 빈도를 결정합니다. - 애플리케이션 실행할 때마다 확인. 사용자가 애플리케이션을 열 때마다 ClickOnce에서 업데이트 확인을 수행합니다. - 확인 간격: 업데이트 확인 전에 경과되어야 하는 시간 간격 및 단위(시간, 일 또는 주)를 선택합니다.
이 애플리케이션의 최소 필요 버전을 지정합니다.	선택 사항입니다. 특정 애플리케이션 버전을 필수 설치로 지정하여 사용자가 이전 버전에서 작업하지 못하도록 방지합니다.
Version	이 애플리케이션에 필요한 최소 버전 지정 확인란을 선택할 경우 필수입니다. 제공된 버전 번호는 N.N.N.N 형식이어야 합니다. 첫 번째 주요 빌드 번호만 필요합니다. 예를 들어 애플리케이션 버전 1.0에 대한 유효한 값에는 1, 1.0, 1.0.0 및 1.0.0.0이 포함됩니다.

애플리케이션 참조 탭

애플리케이션 참조 탭에는 이 항목에서 이전에 설명한 이름 탭과 같은 필드가 포함됩니다. 다음 필드는 한 가지 예외입니다.

UI 요소	설명
매니페스트 선택	애플리케이션 매니페스트를 선택할 수 있습니다. 애플리케이션 매니페스트를 선택하면 이 페이지의 모든 기타 필드가 채워집니다.

참조

• ClickOnce 보안 및 배포
• 연습: 수동으로 ClickOnce 애플리케이션 배포
• Mage.exe(매니페스트 생성 및 편집 도구)