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 요소 | 설명 |
|---|---|
| 매니페스트 선택 | 애플리케이션 매니페스트를 선택할 수 있습니다. 애플리케이션 매니페스트를 선택하면 이 페이지의 모든 기타 필드가 채워집니다. |
참조
.NET