ClickOnce 게시 속성 지정

아티클
07/02/2024

프로젝트 디자이너의 게시 페이지에서 ClickOnce Publish 속성을 구성할 수 있습니다. 이 문서에서는 게시 위치, 설치 URL, 온라인 또는 오프라인 설치 모드 및 게시 버전과 같은 속성을 지정하는 방법을 알아봅니다.

참고 항목

.NET Core 3.1 및 .NET 5 이상용 ClickOnce에서는 프로젝트 디자이너의 게시 마법사 및 게시 페이지 대신 게시 도구를 사용하여 배포 속성을 설정합니다. 자세한 내용은 ClickOnce를 사용하여 .NET Windows 애플리케이션 배포 및 .NET용 ClickOnce를 참조하세요.

게시 위치 지정

ClickOnce를 사용하여 애플리케이션을 게시하는 경우 Publish Location 속성에서 애플리케이션 파일 및 매니페스트가 배치되는 위치를 지정합니다. 이 위치는 파일 경로나 FTP 서버에 대한 경로가 될 수 있습니다.

Publish Location 속성은 프로젝트 디자이너의 게시 페이지나 게시 마법사를 사용하여 지정할 수 있습니다. 자세한 내용은 방법: 게시 마법사를 사용하여 ClickOnce 애플리케이션 게시를 참조하세요.

참고

ClickOnce를 사용하여 애플리케이션 버전을 둘 이상 설치하면 이전 애플리케이션 버전이 지정한 게시 위치의 Archive 폴더로 이동합니다. 이러한 방식으로 이전 버전이 보관되므로 설치 디렉터리에 이전 버전의 폴더가 남지 않습니다.

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
게시 위치 필드에 다음 형식 중 하나를 사용하여 게시 위치를 입력합니다.
- 파일 공유나 디스크 경로에 게시하려면 UNC 경로(\\Server\ApplicationName) 또는 파일 경로(C:\Deploy\ApplicationName)를 사용하여 경로를 입력합니다.
- FTP 서버에 게시하려면 ftp://ftp.microsoft.com/<ApplicationName> 형식을 사용하여 경로를 입력합니다.
  
  찾아보기( ... ) 단추가 작동하려면 게시 위치 상자에 텍스트가 있어야 합니다.

최종 사용자의 설치 원본 위치 지정

ClickOnce 애플리케이션을 게시할 때 사용자가 애플리케이션을 다운로드하여 설치하는 위치가 애플리케이션을 처음 게시하는 위치일 필요는 없습니다. 예를 들어 일부 조직에서는 개발자가 준비 서버에 애플리케이션을 게시한 다음 관리자가 애플리케이션을 웹 서버로 이동할 수 있습니다.

이 경우 Installation URL 속성을 사용하여 사용자가 애플리케이션을 다운로드할 웹 서버를 지정할 수 있습니다. 애플리케이션 매니페스트가 업데이트를 찾을 위치를 알 수 있도록 이 작업을 수행해야 합니다.

Installation URL 속성은 프로젝트 디자이너의 게시 페이지에서 설정할 수 있습니다.

참고

게시 마법사를 사용하여 Installation URL 속성을 설정할 수도 있습니다. 자세한 내용은 방법: 게시 마법사를 사용하여 ClickOnce 애플리케이션 게시를 참조하세요.

설치 URL 지정

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
설치 URL 필드에서 https://www.contoso.com/ApplicationName 형식을 사용하는 정규화된 URL을 사용하여 설치 위치를 입력하거나 \Server\ApplicationName 형식을 사용하는 UNC 경로를 입력합니다.

ClickOnce 오프라인 또는 온라인 설치 모드 지정

ClickOnce 애플리케이션 Install Mode에 따라 오프라인 또는 온라인에서 애플리케이션을 사용 가능한지 여부가 결정됩니다. 온라인으로만 애플리케이션 사용 가능을 선택하는 경우 애플리케이션을 실행하려면 사용자에게 ClickOnce 게시 위치(웹 페이지 또는 파일 공유)에 대한 액세스 권한이 있어야 합니다. 오프라인으로도 애플리케이션 사용 가능을 선택하는 경우 애플리케이션에서 시작 메뉴 및 프로그램 추가/제거 대화 상자에 항목을 추가합니다. 사용자는 연결되어 있지 않은 경우에도 애플리케이션을 실행할 수 있습니다.

Install Mode는 프로젝트 디자이너의 게시 페이지에서 설정할 수 있습니다.

참고

게시 마법사를 사용하여 Install Mode를 설정할 수도 있습니다. 자세한 내용은 방법: 게시 마법사를 사용하여 ClickOnce 애플리케이션 게시를 참조하세요.

ClickOnce 애플리케이션을 온라인으로만 사용 가능하도록 설정

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
설치 모드 및 설정 영역에서 온라인으로만 애플리케이션 사용 가능 옵션 단추를 클릭합니다.

ClickOnce 애플리케이션을 온라인 또는 오프라인으로 사용 가능하도록 설정

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
설치 모드 및 설정 영역에서 오프라인으로도 애플리케이션 사용 가능 옵션 단추를 클릭합니다.

설치되면 애플리케이션에서 시작 메뉴 및 제어판의 프로그램 추가/제거에 항목을 추가합니다.

ClickOnce 게시 버전 설정

ClickOnce Publish Version 속성은 게시 중인 애플리케이션을 업데이트로 처리할지 여부를 결정합니다. 버전이 증분될 때마다 애플리케이션은 업데이트로 게시됩니다.

Publish Version 속성은 프로젝트 디자이너의 게시 페이지에서 설정할 수 있습니다.

참고

애플리케이션이 게시될 때마다 Publish Version 속성을 자동으로 증분할 프로젝트 옵션이 있습니다. 이 옵션은 기본적으로 사용하도록 설정됩니다. 자세한 내용은 ClickOnce 게시 버전 자동 증가를 참조하세요.

게시 버전 변경

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
게시 버전 필드에서 주, 부, 빌드 또는 수정 버전 번호를 증분합니다.

참고

버전 번호는 감소하면 안 됩니다. 감소하면 예기치 않은 업데이트 동작이 발생할 수 있습니다.

ClickOnce 게시 버전 자동 증가

ClickOnce 애플리케이션을 게시하는 경우 Publish Version 속성을 변경하면 애플리케이션이 업데이트로 게시됩니다. 기본적으로 Visual Studio에서는 애플리케이션을 게시할 때마다 Publish Version의 Revision 번호가 자동으로 증가됩니다.

이 동작은 프로젝트 디자이너의 게시 페이지에서 사용하지 않도록 설정할 수 있습니다.

참고

표시되는 대화 상자와 메뉴 명령은 활성 설정이나 버전에 따라 도움말에서 설명하는 것과 다를 수 있습니다. 설정을 변경하려면 도구 메뉴에서 설정 가져오기 및 내보내기 를 선택합니다. 자세한 내용은 재설정 설정을 참조하세요.

게시 버전 자동 증가를 사용하지 않도록 설정

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
게시 버전 섹션에서 릴리스할 때마다 자동으로 수정 번호 증가 확인란 선택을 취소합니다.

ClickOnce 애플리케이션의 게시 페이지 지정

ClickOnce 애플리케이션을 게시하면 기본 웹 페이지(publish.htm)가 생성되고 애플리케이션과 함께 게시됩니다. 이 페이지에는 애플리케이션 이름, 애플리케이션 및/또는 필수 구성 요소 설치 링크, ClickOnce에 대해 설명하는 도움말 항목 링크가 있습니다. 프로젝트의 게시 페이지 속성을 사용하면 ClickOnce 애플리케이션 웹 페이지의 이름을 지정할 수 있습니다.

게시 페이지가 지정되면 다음에 게시할 때 게시 위치로 복사됩니다. 다시 게시해도 덮어쓰지 않습니다. 페이지 모양을 사용자 지정하려는 경우 변경 내용 손실에 대한 걱정 없이 모양을 사용자 지정할 수 있습니다. 자세한 내용은 ClickOnce 기본 웹 페이지 사용자 지정을 참조하세요.

게시 페이지 속성은 게시 옵션 대화 상자에서 설정할 수 있습니다. 이 대화 상자는 프로젝트 디자이너의 게시 창에서 액세스할 수 있습니다.

ClickOnce 애플리케이션의 사용자 지정 웹 페이지 지정:

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 창을 선택합니다.
옵션 단추를 클릭하여 게시 옵션 대화 상자를 엽니다.
배포를 클릭합니다.
게시 옵션 대화 상자에서 게시 후 배포 웹 페이지 열기 확인란이 선택되어 있는지 확인합니다(기본적으로 선택되어 있어야 함).
배포 웹 페이지 상자에 웹 페이지 이름을 입력하고 확인을 클릭합니다.

게시 시 게시 페이지의 시작 방지:

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 창을 선택합니다.
옵션 단추를 클릭하여 게시 옵션 대화 상자를 엽니다.
배포를 클릭합니다.
게시 옵션 대화 상자에서 게시 후 배포 웹 페이지 열기 확인란 선택을 취소합니다.

ClickOnce 애플리케이션의 기본 웹 페이지 사용자 지정

ClickOnce 애플리케이션을 웹에 게시하면 애플리케이션과 함께 자동으로 웹 페이지가 생성되고 게시됩니다. 기본 페이지에는 애플리케이션 이름과 애플리케이션을 설치하거나 필수 구성 요소를 설치하거나 MSDN의 도움말에 액세스하는 링크가 포함됩니다.

참고 항목

페이지에 표시되는 실제 링크는 페이지가 표시되는 컴퓨터와 포함할 필수 구성 요소에 따라 달라집니다.

웹 페이지의 기본 이름은 Publish.htm입니다. 이 이름은 프로젝트 디자이너에서 변경할 수 있습니다. 자세한 내용은 ClickOnce 애플리케이션의 게시 페이지 지정을 참조하세요.

Publish.htm 웹 페이지는 최신 버전이 검색된 경우에만 게시됩니다.

참고 항목

게시 설정을 변경해도 Publish.htm 페이지에 영향을 주지 않습니다. 단, 처음 게시한 후 필수 구성 요소를 추가하거나 제거하면 필수 구성 요소 목록이 더 이상 정확하지 않게 됩니다. 변경 내용을 반영하려면 필수 구성 요소 링크의 텍스트를 편집해야 합니다.

게시 웹 페이지 사용자 지정:

ClickOnce 애플리케이션을 웹 위치에 게시합니다. 자세한 내용은 방법: 게시 마법사를 사용하여 ClickOnce 애플리케이션 게시를 참조하세요.
웹 서버의 시각적 웹 디자이너 또는 다른 HTML 편집기에서 Publish.htm 파일을 엽니다.
원하는 대로 페이지를 사용자 지정하고 저장합니다.
선택 사항. Visual Studio에서 사용자 지정된 게시 웹 페이지를 덮어쓰지 않도록 하려면 게시 옵션 대화 상자에서 게시할 때마다 자동으로 배포 웹 페이지 생성 선택을 취소합니다.

기술 지원을 위한 링크 지정

ClickOnce 애플리케이션을 게시하는 경우 Support URL 속성은 사용자가 애플리케이션에 대한 정보를 얻을 수 있는 웹 페이지나 파일 공유를 나타냅니다. 이 속성은 선택 사항입니다. URL이 제공되면 애플리케이션 항목 프로그램 추가/제거 대화 상자에 표시됩니다.

지원 URL 속성은 프로젝트 디자이너의 게시 페이지에서 설정할 수 있습니다.

지원 URL 지정:

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
옵션 단추를 클릭하여 게시 옵션 대화 상자를 엽니다.
설명을 클릭합니다.
지원 URL 필드에 웹 사이트, 웹 페이지 또는 UNC 공유에 대한 정규화된 경로를 입력합니다.

ClickOnce 배포 시 개별 필수 구성 요소에 대한 지원 URL 지정

ClickOnce 배포는 ClickOnce 애플리케이션을 실행하기 위해 클라이언트 컴퓨터에서 사용 가능해야 하는 여러 필수 조건을 테스트할 수 있습니다. 이 종속성에는 필요한 최소 버전의 .NET Framework, 해당 버전의 운영 체제, GAC(전역 어셈블리 캐시)에 미리 설치되어야 하는 어셈블리가 포함됩니다. 하지만 ClickOnce에서 이 필수 조건 자체를 설치할 수는 없습니다. 필수 조건이 없으면 설치가 중지되고 설치 실패 이유가 설명된 대화 상자가 표시됩니다.

필수 구성 요소를 설치하는 방법은 두 가지가 있습니다. 필수 구성 요소는 부트스트래퍼 애플리케이션을 사용하여 설치할 수 있습니다. 또는 필수 구성 요소가 없는 경우 대화 상자에서 사용자에게 표시되는 개별 필수 구성 요소 지원 URL을 지정할 수 있습니다. 해당 URL에서 참조되는 페이지에 필요한 필수 구성 요소 설치 지침 링크가 포함될 수 있습니다. 애플리케이션에서 개별 필수 조건 지원 URL을 지정하지 않으면 ClickOnce에서 애플리케이션 배포 매니페스트에 지정된 지원 URL을 전체적으로 표시합니다(정의된 경우).

Visual Studio, Mage.exe, MageUI.exe는 모두 ClickOnce 배포를 생성하는 데 사용할 수 있지만 이러한 도구는 개별 필수 조건 지원 URL 지정을 직접 지원하지 않습니다. 이 문서에서는 지원 URL을 포함하도록 배포의 애플리케이션 매니페스트 및 배포 매니페스트를 수정하는 방법을 설명합니다.

참고 항목

개별 필수 구성 요소 지원 URL 지정

텍스트 편집기에서 ClickOnce 애플리케이션의 애플리케이션 매니페스트(.manifest 파일)를 엽니다.

운영 체제 필수 구성 요소의 경우 supportUrl 특성을 dependentOS 요소에 추가합니다.

 <dependency>
    <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm">
      <osVersionInfo>
        <os majorVersion="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

특정 버전의 공용 언어 런타임 필수 구성 요소의 경우 supportUrl 특성을 공용 언어 런타임 종속성을 지정하는 dependentAssembly 항목에 추가합니다.

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

전역 어셈블리 캐시에 미리 설치되어야 하는 어셈블리 필수 구성 요소의 경우 필수 어셈블리를 지정하는 dependentAssembly 요소의 supportUrl을 설정합니다.

  <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm">
      <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" />
    </dependentAssembly>
  </dependency>

선택 사항. .NET Framework 4를 대상으로 하는 애플리케이션의 경우 텍스트 편집기에서 ClickOnce 애플리케이션의 배포 매니페스트(.application 파일)를 엽니다.

.NET Framework 4 필수 구성 요소의 경우 supportUrl 특성을 compatibleFrameworks 요소에 추가합니다.

<compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

애플리케이션 매니페스트를 수동으로 변경한 후에는 디지털 인증서를 사용하여 애플리케이션 매니페스트에 다시 서명한 후 배포 매니페스트도 업데이트하고 다시 서명해야 합니다. Visual Studio를 사용하여 이러한 파일을 다시 생성하면 수동으로 변경한 내용이 지워지므로 이 작업을 수행하려면 Mage.exe 또는 MageUI.exe SDK 도구를 사용합니다. Mage.exe를 사용하여 매니페스트에 다시 서명하는 방법에 대한 자세한 내용은 방법: 애플리케이션 및 배포 매니페스트에 다시 서명을 참조하세요.

.NET Framework 보안

애플리케이션이 부분 신뢰 상태에서 실행되도록 표시된 경우 지원 URL이 대화 상자에 표시되지 않습니다.

ClickOnce 애플리케이션의 게시 언어 변경

ClickOnce 애플리케이션을 게시하는 경우 설치 중 표시되는 사용자 인터페이스는 개발 컴퓨터의 언어 및 문화권이 기본값으로 지정됩니다. 지역화된 애플리케이션을 게시하는 경우 지역화된 버전과 일치하도록 언어 및 문화권을 지정해야 합니다. 프로젝트의 Publish language 속성에 따라 결정됩니다.

Publish language 속성은 프로젝트 디자이너의 게시 페이지에서 액세스할 수 있는 게시 옵션 대화 상자에서 설정할 수 있습니다.

참고

게시 언어 변경:

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

참고

.NET Core 3.1 및 .NET 5 이상용 ClickOnce에서는 프로젝트 디자이너의 게시 마법사 및 게시 페이지 대신 게시 도구를 사용하여 배포 속성을 설정합니다. 자세한 내용은 ClickOnce를 사용하여 .NET Windows 애플리케이션 배포 및 .NET용 ClickOnce를 참조하세요.
옵션 단추를 클릭하여 게시 옵션 대화 상자를 엽니다.
설명을 클릭합니다.
게시 옵션 대화 상자에서 게시 언어 드롭다운 목록의 언어 및 문화권을 선택하고 확인을 클릭합니다.

ClickOnce 애플리케이션이 온라인 및 오프라인용으로 설치되면 시작 메뉴 및 프로그램 추가/제거 목록에 항목이 추가됩니다. 기본적으로 표시 이름은 애플리케이션 어셈블리의 이름과 동일하지만 게시 옵션 대화 상자에서 제품 이름을 설정하여 표시 이름을 변경할 수 있습니다.

제품 이름은 publish.htm 페이지에 표시됩니다. 설치된 오프라인 애플리케이션의 경우 시작 메뉴에 있는 항목의 이름이며 프로그램 추가/제거에 표시되는 이름이기도 합니다.

게시자 이름은 제품 이름 위에 있는 publish.htm 페이지에 표시되며, 설치된 오프라인 애플리케이션의 경우 시작 메뉴에 있는 애플리케이션 아이콘이 포함된 폴더의 이름이기도 합니다.

시작 메뉴 바로 가기 또는 앱 참조는 %appdata%\Microsoft\Windows\Start Menu\Programs\<publisher name>에 만들어집니다. 바로 가기 또는 앱 참조의 이름은 제품 이름과 동일합니다.

제품 이름 및 게시자 이름 속성은 게시 옵션 대화 상자에서 설정할 수 있습니다. 이 대화 상자는 프로젝트 디자이너의 게시 페이지에서 사용할 수 있습니다.

시작 메뉴 이름 지정:

솔루션 탐색기에서 프로젝트를 선택한 상태에서 프로젝트 메뉴에서 속성을 클릭합니다.
게시 탭을 클릭합니다.
옵션 단추를 클릭하여 게시 옵션 대화 상자를 엽니다.
설명을 클릭합니다.
게시 옵션 대화 상자에서 제품 이름에 표시할 이름을 입력합니다.
선택적으로 게시자 이름에 게시자 이름을 입력할 수 있습니다.

CD 설치를 위한 자동 시작 사용

CD-ROM 또는 DVD-ROM과 같은 이동식 미디어를 통해 ClickOnce 애플리케이션을 배포할 때 미디어를 삽입하면 ClickOnce 애플리케이션이 자동으로 시작될 수 있게 AutoStart를 사용하도록 설정할 수 있습니다.

AutoStart는 프로젝트 디자이너의 게시 페이지에서 사용하도록 설정할 수 있습니다.

AutoStart 사용 설정:

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

게시 옵션 대화 상자가 표시됩니다.
배포를 클릭합니다.
CD 설치 시 CD를 삽입하면 자동으로 설치 시작 확인란을 선택합니다.

애플리케이션이 게시되면 Autorun.inf 파일이 게시 위치로 복사됩니다.

다음을 통해 공유

ClickOnce 게시 속성 지정

게시 위치 지정

최종 사용자의 설치 원본 위치 지정

설치 URL 지정

ClickOnce 오프라인 또는 온라인 설치 모드 지정

ClickOnce 애플리케이션을 온라인으로만 사용 가능하도록 설정

ClickOnce 애플리케이션을 온라인 또는 오프라인으로 사용 가능하도록 설정

ClickOnce 게시 버전 설정

게시 버전 변경

ClickOnce 게시 버전 자동 증가

게시 버전 자동 증가를 사용하지 않도록 설정

ClickOnce 애플리케이션의 게시 페이지 지정

ClickOnce 애플리케이션의 기본 웹 페이지 사용자 지정

기술 지원을 위한 링크 지정

ClickOnce 배포 시 개별 필수 구성 요소에 대한 지원 URL 지정

개별 필수 구성 요소 지원 URL 지정

.NET Framework 보안

ClickOnce 애플리케이션의 게시 언어 변경

ClickOnce 애플리케이션의 시작 메뉴 이름 지정

CD 설치를 위한 자동 시작 사용

피드백

추가 리소스

다음을 통해 공유

ClickOnce 게시 속성 지정

게시 위치 지정

최종 사용자의 설치 원본 위치 지정

설치 URL 지정

ClickOnce 오프라인 또는 온라인 설치 모드 지정

ClickOnce 애플리케이션을 온라인으로만 사용 가능하도록 설정

ClickOnce 애플리케이션을 온라인 또는 오프라인으로 사용 가능하도록 설정

ClickOnce 게시 버전 설정

게시 버전 변경

ClickOnce 게시 버전 자동 증가

게시 버전 자동 증가를 사용하지 않도록 설정

ClickOnce 애플리케이션의 게시 페이지 지정

ClickOnce 애플리케이션의 기본 웹 페이지 사용자 지정

기술 지원을 위한 링크 지정

ClickOnce 배포 시 개별 필수 구성 요소에 대한 지원 URL 지정

개별 필수 구성 요소 지원 URL 지정

.NET Framework 보안

ClickOnce 애플리케이션의 게시 언어 변경

ClickOnce 애플리케이션의 시작 메뉴 이름 지정

CD 설치를 위한 자동 시작 사용

관련 콘텐츠

피드백

추가 리소스