Partilhar via


Especificar quais arquivos são publicados pelo ClickOnce

Ao publicar um aplicativo ClickOnce, todos os arquivos exigidos no projeto são implantados junto com o aplicativo. O conjunto padrão de arquivos necessários é determinado pelo tipo de projeto (por exemplo, um aplicativo do Windows Forms). Em alguns casos, talvez você não queira ou precise publicar determinados arquivos ou talvez queira instalar determinados arquivos com base nas condições. O Visual Studio fornece os recursos para incluir arquivo, excluir arquivos, marcar arquivos como arquivos de dados ou pré-requisitos e criar grupos de arquivos para instalação condicional.

Os arquivos de um aplicativo ClickOnce são gerenciados na caixa de diálogo Arquivos do Aplicativo, acessível na página Publicar do Designer de Projeto.

Inicialmente, há um único grupo de arquivos chamado (Obrigatório). Você pode criar grupos de arquivos adicionais e atribuir arquivos a eles. Você não pode alterar o Grupo de Download de arquivos necessários para a execução do aplicativo. Por exemplo, os arquivos .exe ou do aplicativo marcados como arquivos de dados devem pertencer ao grupo (Obrigatório).

O valor de status de publicação padrão de um arquivo é marcado com (Auto). Por exemplo, o .exe do aplicativo tem um status de publicação de Incluir (Auto) por padrão.

Arquivos com a propriedade Build Action definida como Content são designados como arquivos de aplicativo e serão marcados como incluídos por padrão. Eles podem ser incluídos, excluídos ou marcados como arquivos de dados. As exceções são as seguintes:

  • Arquivos de dados como arquivos do Banco de Dados SQL (.mdf e .mdb) e arquivos XML serão marcados como arquivos de dados por padrão.

  • As referências a assemblies (arquivos .dll ) são designadas da seguinte maneira quando você adiciona a referência: se Copiar Local for False, ela será marcada por padrão como um assembly de pré-requisito (Pré-requisito (Auto)) que deve estar presente no GAC antes que o aplicativo seja instalado. Se Copiar Local for True, o assembly será marcado por padrão como um assembly de aplicativo (Incluir (Automático) e será copiado para a pasta do aplicativo na instalação. Uma referência COM aparecerá na caixa de diálogo Arquivos de Aplicativos (como um arquivo .ocx) somente se sua propriedade Isolado estiver definida como True. Por padrão, ele será incluído.

Para adicionar arquivos à caixa de diálogo Arquivos de Aplicativo

  1. Selecione um arquivo de dados no Gerenciador de Soluções.

  2. Na janela Propriedades, altere a propriedade Ação de Compilação para o valor Conteúdo.

Para excluir arquivos da publicação do ClickOnce

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Publicar.

    Observação

    No ClickOnce para .NET Core 3.1 e .NET 5 ou posterior, você define propriedades de implantação usando a ferramenta Publicar, em vez do Assistente de Publicação, e a página Publicar do Designer de Projeto. Para obter mais informações, confira Implantar um aplicativo .NET do Windows usando ClickOnce e ClickOnce para .NET.

  3. Clique no botão Arquivos de Aplicativo para abrir a caixa de diálogo Arquivos de Aplicativo.

  4. Na caixa de diálogo Arquivos de Aplicativo, selecione o arquivo que você deseja excluir.

  5. No campo Publicar Status, selecione Excluir na lista suspensa.

Para marcar arquivos como arquivos de dados

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Publicar.

  3. Clique no botão Arquivos de Aplicativo para abrir a caixa de diálogo Arquivos de Aplicativo.

  4. Na caixa de diálogo Arquivos de Aplicativo, selecione o arquivo que você deseja marcar como dados.

  5. No campo Publicar Status, selecione Arquivo de Dados na lista suspensa.

Para marcar arquivos como pré-requisitos

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Publicar.

  3. Clique no botão Arquivos de Aplicativo para abrir a caixa de diálogo Arquivos de Aplicativo.

  4. Na caixa de diálogo Arquivos do Aplicativo, selecione o assembly do aplicativo (arquivo .dll) que deseja marcar como pré-requisito. Observe que seu aplicativo deve ter uma referência ao assembly do aplicativo para que ele apareça na lista.

  5. No campo Publicar Status, selecione Pré-requisito na lista suspensa.

Para adicionar um novo grupo de arquivos

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Publicar.

  3. Clique no botão Arquivos de Aplicativo para abrir a caixa de diálogo Arquivos de Aplicativo.

  4. Na caixa de diálogo Arquivos de Aplicativo, selecione o campo Grupo para um arquivo que você deseja incluir no novo grupo.

    Observação

    Os arquivos devem ter a propriedade Ação de Compilação definida como Conteúdo antes que os nomes de arquivo apareçam na caixa de diálogo Arquivos de Aplicativo.

  5. No campo Baixar Grupo, selecione <Novo...> na lista suspensa.

  6. Na caixa de diálogo Novo Grupo, insira um nome para o grupo e clique em OK.

Para adicionar um arquivo a um grupo

  1. Com um projeto selecionado no Gerenciador de Soluções, no menu Projeto, clique em Propriedades.

  2. Clique na guia Publicar.

  3. Clique no botão Arquivos de Aplicativo para abrir a caixa de diálogo Arquivos de Aplicativo.

  4. Na caixa de diálogo Arquivos de Aplicativo, selecione o campo Grupo para um arquivo que você deseja incluir no novo grupo.

  5. No campo Baixar Grupo, selecione um grupo na lista suspensa.

    Observação

    Você não pode alterar o Grupo de Download de arquivos necessários para a execução do aplicativo.