ClickOnce를 통해 게시할 파일 지정

ClickOnce 애플리케이션을 게시할 때 프로젝트의 모든 비 코드 파일이 애플리케이션과 함께 배포됩니다. 일부 경우에는 특정 파일을 게시하지 않으려는 경우 또는 조건에 따라 특정 파일을 설치해야 할 수 있습니다. Visual Studio는 조건부 설치를 위해 파일을 제외하고, 파일을 데이터 파일 또는 필수 구성 요소로 표시하고, 파일 그룹을 만드는 기능을 제공합니다.

ClickOnce 애플리케이션용 파일은 프로젝트 디자이너게시 페이지에서 액세스할 수 있는 애플리케이션 파일 대화 상자에서 관리됩니다.

처음에는 (필수) 라는 단일 파일 그룹이 있습니다. 추가 파일 그룹을 만들어 파일을 할당할 수 있습니다. 애플리케이션을 실행하는 데 필요한 파일에 대한 다운로드 그룹은 변경할 수 없습니다. 예를 들어 애플리케이션의 .exe 또는 데이터 파일로 표시된 파일은 (필수) 그룹에 속해야 합니다.

파일의 기본 게시 상태 값에는 (자동) 태그가 지정됩니다. 예를 들어 애플리케이션의 .exe에는 기본적으로 포함(자동) 이라는 게시 상태가 있습니다.

빌드 작업 속성이 콘텐츠로 설정된 파일은 애플리케이션 파일로 지정되며 기본적으로 포함된 것으로 표시됩니다. 이를 포함하거나, 제외하거나, 데이터 파일로 표시할 수 있습니다. 이에 대한 예외는 다음과 같습니다.

  • SQL Database( .mdf.mdb) 파일 및 XML 파일과 같은 데이터 파일은 기본적으로 데이터 파일로 표시됩니다.

  • 참조를 추가할 때 어셈블리( .dll 파일)에 대한 참조는 다음과 같이 지정됩니다. 로컬 복사False인 경우 기본적으로 애플리케이션이 설치되기 전에 GAC에 표시되어야 하는 필수 구성 요소 어셈블리(필수 구성 요소(자동) )로 표시됩니다. 로컬 복사True인 경우 어셈블리는 기본적으로 애플리케이션 어셈블리(포함(자동) )로 표시되고 설치 시 애플리케이션 폴더로 복사됩니다. COM 참조는 격리됨 속성이 True로 설정된 경우에만 애플리케이션 파일 대화 상자에 .ocx 파일로 표시됩니다. 기본적으로 포함됩니다.

애플리케이션 파일 대화 상자에 파일을 추가하려면

  1. 솔루션 탐색기에서 데이터 파일을 선택합니다.

  2. 속성 창에서 빌드 작업 속성을 콘텐츠 값으로 변경합니다.

ClickOnce 게시에서 파일을 제외하려면

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

  2. 게시 탭을 클릭합니다.

    참고

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

  3. 애플리케이션 파일 단추를 클릭하여 애플리케이션 파일 대화 상자를 엽니다.

  4. 애플리케이션 파일 대화 상자에서 제외할 파일을 선택합니다.

  5. 게시 상태 필드의 드롭다운 목록에서 제외를 선택합니다.

파일을 데이터 파일로 표시하려면

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

  2. 게시 탭을 클릭합니다.

  3. 애플리케이션 파일 단추를 클릭하여 애플리케이션 파일 대화 상자를 엽니다.

  4. 애플리케이션 파일 대화 상자에서 데이터로 표시할 파일을 선택합니다.

  5. 게시 상태 필드의 드롭다운 목록에서 데이터 파일을 선택합니다.

파일을 필수 구성 요소로 표시하려면

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

  2. 게시 탭을 클릭합니다.

  3. 애플리케이션 파일 단추를 클릭하여 애플리케이션 파일 대화 상자를 엽니다.

  4. 애플리케이션 파일 대화 상자에서 필수 구성 요소로 표시할 애플리케이션 어셈블리( .dll 파일)를 선택합니다. 애플리케이션은 목록에 표시되려면 애플리케이션 어셈블리에 대한 참조가 있어야 합니다.

  5. 게시 상태 필드의 드롭다운 목록에서 필수 구성 요소를 선택합니다.

새 파일 그룹을 추가하려면

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

  2. 게시 탭을 클릭합니다.

  3. 애플리케이션 파일 단추를 클릭하여 애플리케이션 파일 대화 상자를 엽니다.

  4. 애플리케이션 파일 대화 상자에서 새 그룹에 포함할 파일의 그룹 필드를 선택합니다.

    참고

    파일 이름이 애플리케이션 파일 대화 상자에 표시되려면 파일의 빌드 작업 속성이 콘텐츠로 설정되어 있어야 합니다.

  5. 그룹 다운로드 필드의 드롭다운 목록에서 <새로 만들기...>를 선택합니다.

  6. 새 그룹 대화 상자에서 그룹의 이름을 입력하고 확인을 클릭합니다.

그룹에 파일을 추가하려면

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

  2. 게시 탭을 클릭합니다.

  3. 애플리케이션 파일 단추를 클릭하여 애플리케이션 파일 대화 상자를 엽니다.

  4. 애플리케이션 파일 대화 상자에서 새 그룹에 포함할 파일의 그룹 필드를 선택합니다.

  5. 다운로드 그룹 필드의 드롭다운 목록에서 그룹을 선택합니다.

    참고

    애플리케이션을 실행하는 데 필요한 파일에 대한 다운로드 그룹은 변경할 수 없습니다.