Compartilhar via


Especificar propriedades de publicação do ClickOnce

Você pode configurar as propriedades de publicação do ClickOnce na página Publicar do Designer de Projeto ou usando o Assistente de Publicação. Neste artigo, você aprenderá a especificar propriedades, como o local de publicação, a URL de instalação, o modo de instalação online ou offline e a versão de publicação.

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, consulte Implantar um aplicativo .NET do Windows usando ClickOnce e ClickOnce para .NET.

Especificar um local de publicação

Quando você publica um aplicativo usando o ClickOnce, a propriedade Publish Location especifica o local em que os arquivos e o manifesto do aplicativo são colocados. Pode ser um caminho de arquivo ou o caminho para um servidor FTP.

Você pode especificar a propriedade Publish Location na página Publicar do Designer de Projeto ou usando o Assistente de Publicação. Para obter mais informações, consulte Como publicar um aplicativo ClickOnce usando o Assistente de Publicação.

Observação

Ao instalar mais de uma versão de um aplicativo usando o ClickOnce, a instalação moverá as versões anteriores do aplicativo para uma pasta chamada Arquivo, no local de publicação especificado. O arquivamento de versões anteriores dessa maneira mantém o diretório de instalação livre de pastas da versão anterior.

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

  2. Clique na guia Publicar.

  3. No campo Local de Publicação, insira o local de publicação usando um dos seguintes formatos:

    • Para publicar em um caminho de disco ou compartilhamento de arquivos, insira o caminho usando um caminho UNC (\\Server\ApplicationName) ou um caminho de arquivo (C:\Deploy\ApplicationName).

    • Para publicar em um servidor FTP, insira o caminho usando o formato ftp://ftp.microsoft.com/<ApplicationName>.

      Observe que o texto precisa estar presente na caixa Local de Publicação para que o botão Procurar (...) funcione.

Especificar a localização da qual os usuários finais instalarão

Ao publicar um aplicativo ClickOnce, o local no qual os usuários vão para baixar e instalar o aplicativo não é necessariamente o local em que você publica o aplicativo inicialmente. Por exemplo, em algumas organizações, um desenvolvedor pode publicar um aplicativo em um servidor de preparo e, em seguida, um administrador moveria o aplicativo para um servidor Web.

Nesse caso, você pode usar a propriedade Installation URL para especificar o servidor Web onde os usuários irão para baixar o aplicativo. Isso é necessário para que o manifesto do aplicativo saiba onde procurar atualizações.

A propriedade Installation URL pode ser habilitada na página Publicar do Designer de Projeto.

Observação

A propriedade Installation URL também pode ser definida usando o PublishWizard. Para obter mais informações, consulte Como publicar um aplicativo ClickOnce usando o Assistente de Publicação.

Especificar uma URL de instalação

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

  2. Clique na guia Publicar.

  3. No campo URL de Instalação, insira o local de instalação usando uma URL totalmente qualificada usando o formato https://www.contoso.com/ApplicationName ou um caminho UNC usando o formato \Server\ApplicationName.

Especificar o modo de instalação offline ou online do ClickOnce

O Install Mode de um aplicativo ClickOnce determina se o aplicativo estará disponível offline ou online. Quando você escolhe O aplicativo está disponível somente online, o usuário precisa ter acesso ao local de publicação do ClickOnce (uma página da Web ou um compartilhamento de arquivo) para executar o aplicativo. Quando você escolhe O aplicativo também está disponível offline, o aplicativo adiciona entradas ao menu Iniciar e à caixa de diálogo Adicionar ou Remover Programas; o usuário pode executar o aplicativo quando não estiver conectado.

O Install Mode pode ser habilitado na página Publicar do Designer de Projeto.

Observação

O Install Mode também pode ser definido usando o assistente de Publicação. Para obter mais informações, consulte Como publicar um aplicativo ClickOnce usando o Assistente de Publicação.

Disponibilizar um aplicativo ClickOnce somente online

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

  2. Clique na guia Publicar.

  3. Na área Modo de Instalação e Configurações, clique no botão de opção O aplicativo está disponível somente online.

Disponibilizar um aplicativo ClickOnce somente offline

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

  2. Clique na guia Publicar.

  3. Na área Modo de Instalação e Configurações, clique no botão de opção O aplicativo também está disponível offline.

    Quando instalado, o aplicativo adiciona entradas ao menu Iniciar e a Adicionar ou Remover Programas no Painel de Controle.

Definir a versão da publicação do ClickOnce

A propriedade Publish Version do ClickOnce determina se o aplicativo que você está publicando será ou não tratado como uma atualização. Cada vez que a versão for melhorada, o aplicativo será publicado como uma atualização.

A propriedade Publish Version pode ser habilitada na página Publicar do Designer de Projeto.

Observação

Há uma opção de projeto que melhora automaticamente a propriedade Publish Versionsempre que o aplicativo for publicado. Essa opção é habilitada por padrão. Para obter mais informações, consulte Incrementar a versão da publicação do ClickOnce automaticamente.

Alterar a versão de publicação

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

  2. Clique na guia Publicar.

  3. No campo Publicar Versão, melhore os números de versão Principal, Secundária, Compilação ou Revisão.

    Observação

    Nunca diminua um número de versão. Isso pode causar um comportamento de atualização imprevisível.

Incrementar automaticamente a versão de publicação do ClickOnce

Ao publicar um aplicativo ClickOnce, alterar a propriedade Publish Version faz com que o aplicativo seja publicado como uma atualização. Por padrão, o Visual Studio incrementa automaticamente o número Revision do Publish Version sempre que você publica o aplicativo.

Você pode desabilitar esse comportamento na página Publicar do Designer de Projeto.

Observação

As caixas de diálogo e os comandos de menu encontrados podem diferir daqueles descritos na Ajuda, dependendo das configurações ativas ou edição. Para alterar suas configurações, selecione Importar e Exportar Configurações no menu Ferramentas . Para obter mais informações, consulte Redefinir as configurações.

Desabilitar o incremento automático da versão de publicação

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

  2. Clique na guia Publicar.

  3. Na seção Publicar Versão, desmarque a caixa de seleção Incrementar automaticamente a revisão a cada versão.

Especificar uma página de publicação para um aplicativo ClickOnce

Ao publicar um aplicativo ClickOnce, uma página da Web padrão (publish.htm) é gerada e publicada junto com o aplicativo. Essa página contém o nome do aplicativo, um link para instalar o aplicativo e/ou quaisquer pré-requisitos, além de um link para um tópico da Ajuda que descreve o ClickOnce. A propriedade Publish Page para seu projeto permite que você especifique um nome para a página da Web para seu aplicativo ClickOnce.

Depois que a página de publicação for especificada, ela será copiada para o local de publicação na próxima vez que você publicar; ela não será substituída se você publicar novamente. Se você quiser personalizar a aparência da página, isso pode ser feito sem se preocupar em perder as alterações. Para obter mais informações, confira Personalizar a página da Web padrão do ClickOnce.

A propriedade Publish Page pode ser definida na caixa de diálogo Opções de Publicação, que pode ser acessada no painel Publicar do Designer de Projeto.

Para especificar uma página da Web personalizada para um aplicativo ClickOnce:

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

  2. Selecione o painel Publicar.

  3. Clique no botão Opções para abrir a caixa de diálogo Opções de Publicação.

  4. Clique em Implantação.

  5. Na caixa de diálogo Opções de Publicação, verifique se a caixa de seleção Abrir a página da Web de implantação depois da publicação está selecionada (por padrão, ela deve estar selecionada).

  6. Na caixa Página da Web de implantação, insira o nome da página da Web e clique em OK.

Para impedir que a página de publicação seja inicializada sempre que você publicar:

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

  2. Selecione o painel Publicar.

  3. Clique no botão Opções para abrir a caixa de diálogo Opções de Publicação.

  4. Clique em Implantação.

  5. Na caixa de diálogo Opções de Publicação, desmarque a caixa de seleção Abrir a página da Web de implantação depois da publicação.

Personalizar a página da Web padrão para um aplicativo ClickOnce

Ao publicar um aplicativo ClickOnce na Web, uma página da Web é gerada e publicada automaticamente com o aplicativo. A página padrão contém o nome do aplicativo e links para instalar o aplicativo, instalar pré-requisitos ou acessar a ajuda no MSDN.

Observação

Os links reais que você vê na página dependem do computador no qual a página está sendo exibida e de quais pré-requisitos você está incluindo.

O nome padrão da página da Web é Publish.htm; você pode alterá-lo no Designer de Projeto. Para obter mais informações, consulte Especificar uma página de publicação para um aplicativo ClickOnce.

A página da Web Publish.htm será publicada somente se uma versão mais recente for detectada.

Observação

Alterações feitas nas configurações de Publicação não afetarão a página Publish.htm, com uma exceção: se você adicionar ou remover pré-requisitos após a publicação inicial, a lista de pré-requisitos deixará de ser precisa. Você precisará editar o texto do link de pré-requisitos para refletir as alterações.

Para personalizar a página da Web de publicação:

  1. Publique o aplicativo ClickOnce em um local da Web. Para obter mais informações, consulte Como publicar um aplicativo ClickOnce usando o Assistente de Publicação.

  2. No servidor Web, abra o arquivo Publish.htm no Visual Web Designer ou em outro editor HTML.

  3. Personalize a página conforme desejado e salve-a.

  4. Opcional. Para impedir que o Visual Studio substitua a página da Web de publicação personalizada, desmarque Gerar automaticamente a página da Web de implantação após cada publicação na caixa de diálogo Opções de Publicação.

Ao publicar um aplicativo ClickOnce, a propriedade URL de Suporte identifica uma página da Web ou um compartilhamento de arquivos que os usuários podem acessar para obter informações sobre o aplicativo. Essa propriedade é opcional; se fornecida, a URL será exibida na caixa de diálogo Adicionar ou Remover Programas da entrada do aplicativo.

A propriedade URL de Suporte pode ser definida na página Publicar do Designer de Projeto.

Para especificar uma URL de suporte:

  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 Opções para abrir a caixa de diálogo Opções de Publicação.

  4. Clique em Descrição.

  5. No campo URL de Suporte, insira um caminho totalmente qualificado para um site, página da Web ou compartilhamento UNC.

Especificar uma URL de suporte para pré-requisitos individuais em uma implantação do ClickOnce

Uma implantação do ClickOnce pode testar vários pré-requisitos que devem estar disponíveis no computador cliente para que o aplicativo ClickOnce seja executado. Essas dependências incluem a versão mínima necessária do .NET Framework, a versão do sistema operacional e todos os assemblies que devem ser pré-instalados no GAC (cache de assembly global). No entanto, o ClickOnce não pode instalar nenhum desses pré-requisitos; se um pré-requisito não for encontrado, ele simplesmente interromperá a instalação e exibirá uma caixa de diálogo explicando por que a instalação falhou.

Há dois métodos para instalar os pré-requisitos. Você pode instalá-los usando um aplicativo bootstrapper. Como alternativa, você pode especificar uma URL de suporte para pré-requisitos individuais, que será exibida aos usuários na caixa de diálogo se o pré-requisito não for encontrado. A página referenciada por essa URL pode conter links para instruções para instalar o pré-requisito necessário. Se um aplicativo não especificar uma URL de suporte para um pré-requisito individual, o ClickOnce exibirá a URL de suporte especificada no manifesto de implantação do aplicativo de modo geral, se ela estiver definida.

Embora o Visual Studio, Mage.exee MageUI.exe possam ser usados para gerar implantações do ClickOnce, nenhuma dessas ferramentas é diretamente compatível com a especificação de uma URL de suporte para pré-requisitos individuais. Este documento descreve como modificar o manifesto do aplicativo e o manifesto de implantação da implantação para incluir essas URLs de suporte.

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, consulte Implantar um aplicativo .NET do Windows usando ClickOnce e ClickOnce para .NET.

Especificar uma URL de suporte para um pré-requisito individual

  1. Abra o manifesto do aplicativo (o arquivo .manifest) para o aplicativo ClickOnce em um editor de texto.

  2. Para um pré-requisito do sistema operacional, adicione o atributo supportUrl ao dependentOS elemento:

     <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>
    
  3. Para obter um pré-requisito para uma determinada versão do Common Language Runtime, adicione o atributo supportUrl à entrada dependentAssembly que especifica a dependência do Common Language Runtime:

      <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>
    
  4. Para um pré-requisito para um assembly que deve ser pré-instalado no cache de assembly global, defina o supportUrl para o elemento dependentAssembly que especifica o assembly necessário:

      <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>
    
  5. Opcional. Para aplicativos direcionados ao .NET Framework 4, abra o manifesto de implantação (o arquivo .application) do aplicativo ClickOnce em um editor de texto.

  6. Para um pré-requisito .NET Framework 4, adicione o atributo supportUrl ao elemento 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>
    
  7. Depois de alterar manualmente o manifesto do aplicativo, você deve assinar novamente o manifesto do aplicativo usando seu certificado digital e, em seguida, atualizar e assinar novamente o manifesto de implantação. Use o Mage.exe ou MageUI.exe ferramentas do SDK para realizar essa tarefa, pois a regeneração desses arquivos usando o Visual Studio apaga as alterações manuais. Para obter mais informações sobre como usar Mage.exe para assinar manifestos novamente, consulte Como assinar novamente manifestos de aplicativo e implantação.

Segurança do .NET Framework

A URL de suporte não será exibida na caixa de diálogo se o aplicativo estiver marcado para ser executado em confiança parcial.

Alterar o idioma de publicação de um aplicativo ClickOnce

Ao publicar um aplicativo ClickOnce, a interface do usuário exibida durante a instalação usa como padrão o idioma e a cultura do computador de desenvolvimento. Se você estiver publicando um aplicativo localizado, precisará especificar um idioma e uma cultura para corresponder à versão localizada. Isso é determinado pela propriedade Publish language do seu projeto.

A propriedade Publish language pode ser definida na caixa de diálogo Opções de Publicação, acessível na página Publicar do Designer de Projeto.

Observação

As caixas de diálogo e os comandos de menu encontrados podem diferir daqueles descritos na Ajuda, dependendo das configurações ativas ou edição. Para alterar suas configurações, selecione Importar e Exportar Configurações no menu Ferramentas . Para obter mais informações, consulte Redefinir as configurações.

Para alterar o idioma de publicação:

  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, consulte Implantar um aplicativo .NET do Windows usando ClickOnce e ClickOnce para .NET.

  3. Clique no botão Opções para abrir a caixa de diálogo Opções de Publicação.

  4. Clique em Descrição.

  5. Na caixa de diálogo Opções de Publicação, selecione um idioma e uma cultura na lista suspensa Publicar idioma e clique em OK.

Especificar um nome no menu Iniciar para um aplicativo ClickOnce

Quando um aplicativo ClickOnce é instalado para uso online e offline, uma entrada é adicionada ao menu Iniciar e à lista Adicionar ou Remover Programas. Por padrão, o nome de exibição é o mesmo que o nome do assembly do aplicativo, mas você pode alterar o nome de exibição definindo Nome do produto na caixa de diálogo Opções de Publicação.

O Nome do produto será exibido na página publish.htm; para um aplicativo offline instalado, ele será o nome da entrada no menu Iniciar e também será o nome exibido em Adicionar ou Remover Programas.

O Nome do editor aparecerá na página publish.htm acima do Nome do produto e, para um aplicativo offline instalado, ele também será o nome da pasta que contém o ícone do aplicativo no menu Iniciar.

O atalho de menu Iniciar ou a referência de aplicativo é criado em %appdata%\Microsoft\Windows\Menu Iniciar\Programas\<nome do editor>. O atalho ou referência de aplicativo tem o mesmo nome que o nome do produto.

Você pode definir as propriedades Nome do produto e Nome do editor na caixa de diálogo Opções de Publicação, disponível na página Publicar do Designer de Projeto.

Para especificar um nome de menu Iniciar:

  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 Opções para abrir a caixa de diálogo Opções de Publicação.

  4. Clique em Descrição.

  5. Na caixa de diálogo Opções de Publicação, insira o nome a ser exibido em Nome do produto.

  6. Opcionalmente, você pode inserir um nome de editor em Nome do editor.

Habilitar o Início Automático para instalações do CD

Ao implantar um aplicativo ClickOnce por meio de mídia removível, como CD-ROM ou DVD-ROM, você pode habilitar o AutoStart para que o aplicativo ClickOnce seja iniciado automaticamente quando a mídia for inserida.

O AutoStart pode ser habilitado na página Publicar do Designer de Projeto.

Para habilitar o AutoStart:

  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 Opções .

    A caixa de diálogo Opções de Publicação é exibida.

  4. Clique em Implantação.

  5. Marque a caixa de seleção Para instalações de CD, iniciar o Setup automaticamente quando o CD for inserido.

    Um arquivo Autorun.inf será copiado para o local de publicação quando o aplicativo for publicado.