Compartilhar via

Especificar propriedades de Publicação do ClickOnce

Você pode configurar as propriedades ClickOnce Publish 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 do .NET Core 3.1 e .NET 5 ou posterior, você define as propriedades de implantação usando a ferramenta de Publicação em vez do Assistente de Publicação e da página de Publicação do Designer de Projeto. Para obter mais informações, consulte Implantar um aplicativo do Windows .NET usando ClickOnce e ClickOnce para .NET.

Especificar um local de publicação

Quando você publica um aplicativo usando o ClickOnce, a Publish Location propriedade especifica o local em que os arquivos e o manifesto do aplicativo são colocados. Pode ser um caminho de unidade (C:\deploy\myapplication), um compartilhamento de arquivos (\\server\myapplication) ou um servidor FTP (ftp://ftp.microsoft.com/myapplication). Observe que o texto deve estar presente na caixa Local de Publicação para que o botão procurar (...) funcione.

Você pode especificar a Publish Location propriedade 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

Quando você instala mais de uma versão de um aplicativo usando o ClickOnce, a instalação move versões anteriores do aplicativo para uma pasta chamada Arquivo Morto, no local de publicação especificado. O arquivamento de versões anteriores dessa maneira mantém o diretório de instalação longe das 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 deve estar presente na caixa Local de Publicação para que o botão Procurar (...) funcione.

Especifique o local de onde os usuários finais irão instalar

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

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

A Installation URL propriedade pode ser configurada na página Publicar do Projetista.

Observação

A Installation URL propriedade 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/ApplicationNameou um caminho UNC usando o formato \Server\ApplicationName.

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

O Install Mode 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 deve ter acesso ao local de publicação do ClickOnce (uma página da Web ou um compartilhamento de arquivos) 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 é capaz de executar o aplicativo quando ele não está conectado.

Install Mode pode ser definido 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 apenas um aplicativo ClickOnce 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 na opção A aplicação está disponível apenas online.

Disponibilizar um aplicativo ClickOnce online ou 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 O aplicativo está disponível offline também .

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

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

A propriedade ClickOnce Publish Version determina se o aplicativo que você está publicando será tratado como uma atualização. Sempre que a versão for incrementada, o aplicativo será publicado como uma atualização.

A Publish Version propriedade pode ser configurada na página Publicar do Projetista.

Quando o número da versão é alterado, o aplicativo é publicado como uma atualização. Cada parte da versão de publicação (Major, Minor, Build, Revision) pode ter um valor máximo de 65535 (MaxValue), o máximo permitido por Version.

Quando você instala mais de uma versão de um aplicativo usando o ClickOnce, a instalação move versões anteriores do aplicativo para uma pasta chamada Arquivo Morto, no local de publicação especificado. O arquivamento de versões anteriores dessa maneira mantém o diretório de instalação longe das pastas da versão anterior.

Observação

Há uma opção de projeto que incrementará automaticamente a Publish Version propriedade sempre que o aplicativo for publicado; essa opção é habilitada por padrão. Para obter mais informações, consulte Incrementar automaticamente a versão de publicação do ClickOnce.

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, incremente os números de versão Maior, Menor, Build ou Revisão.

    Observação

    Você nunca deve decrementar um número de versão; Fazer 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 Publish Version propriedade faz com que o aplicativo seja publicado como uma atualização. Por padrão, o Visual Studio incrementa automaticamente o Revision número do Publish Version cada vez 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 que você vê podem ser diferentes daqueles descritos na Ajuda, dependendo de suas configurações ativas ou edição. Para alterar suas configurações, escolha Configurações de Importação e Exportação no menu Ferramentas. Para obter mais informações, confira 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 revisão automaticamente com 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. Esta página contém o nome do aplicativo, um link para instalar o aplicativo e/ou quaisquer pré-requisitos e um link para um tópico da Ajuda que descreve ClickOnce. A propriedade Publicar Página do 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 tiver sido especificada, na próxima vez que você publicar, ela será copiada para o local de publicação; não será sobrescrita se você publicar novamente. Se você quiser personalizar a aparência da página, poderá fazê-lo sem se preocupar em perder suas alterações. Para obter mais informações, consulte Personalizar a página da Web padrão do ClickOnce.

A propriedade Publicar Página pode ser definida na caixa de diálogo Opções de Publicação , acessível 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 página da Web de implantação após a publicação está selecionada (ela deve estar selecionada por padrão).

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

Para impedir que a página de publicação seja aberta toda vez 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 página da Web Abrir implantação após a caixa de seleção de 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 junto 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 ajuda no MSDN.

Observação

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

O nome padrão da página da Web é Publish.htm; você pode alterar o nome 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 WebPublish.htm será publicada somente se uma versão mais recente for detectada.

Observação

As 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 os pré-requisitos após a publicação inicialmente, a lista de pré-requisitos não será mais precisa. Você precisará editar o texto do link de pré-requisito para refletir as alterações.

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

  1. Publique seu 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 sua página da Web de publicação personalizada, desmarque 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 em que os usuários podem ir para obter informações sobre o aplicativo. Essa propriedade é opcional; se fornecido, 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). O ClickOnce, no entanto, não pode instalar nenhum desses pré-requisitos em si; 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 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 como um todo, se ele for definido.

Embora o Visual Studio, Mage.exee MageUI.exe possam ser usados para gerar implantações do ClickOnce, nenhuma dessas ferramentas dá suporte diretamente à 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 do .NET Core 3.1 e .NET 5 ou posterior, você define as propriedades de implantação usando a ferramenta de Publicação em vez do Assistente de Publicação e da página de Publicação do Designer de Projeto. Para obter mais informações, consulte Implantar um aplicativo do Windows .NET 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 supportUrl atributo 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 supportUrl atributo à dependentAssembly entrada 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 supportUrldependentAssembly elemento 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 ) para o aplicativo ClickOnce em um editor de texto.

  6. Para um pré-requisito do .NET Framework 4, adicione o supportUrl atributo ao compatibleFrameworks elemento:

    <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 também. Use as ferramentas do SDKMage.exe ou MageUI.exe 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 novamente manifestos, 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.

Observação

No ClickOnce para .NET Core e .NET 5 ou posterior, a confiança parcial, que requer a Segurança de Acesso ao Código, não tem suporte. No .NET Framework, o uso da Segurança de Acesso ao Código não é uma prática recomendada e não é recomendado.

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 a linguagem e a cultura do computador de desenvolvimento. Se você estiver publicando um aplicativo localizado, precisará especificar um idioma e cultura para corresponder à versão localizada. Isso é determinado pela propriedade do Publish language seu projeto.

A Publish language propriedade 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 que você vê podem ser diferentes daqueles descritos na Ajuda, dependendo de suas configurações ativas ou edição. Para alterar suas configurações, escolha Configurações de Importação e Exportação no menu Ferramentas. Para obter mais informações, confira 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 do .NET Core 3.1 e .NET 5 ou posterior, você define as propriedades de implantação usando a ferramenta de Publicação em vez do Assistente de Publicação e da página de Publicação do Designer de Projeto. Para obter mais informações, consulte Implantar um aplicativo do Windows .NET 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 de 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 o 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 publicador será exibido 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 do Menu Iniciar ou a referência de aplicativo é criado em %appdata%\Microsoft\Windows\Menu Iniciar\Programas\<nome do editor>. A referência de atalho ou aplicativo tem o mesmo nome do produto.

Você pode definir o nome do produto e as propriedades de nome do Publicador 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 no nome do produto.

  6. Opcionalmente, você pode inserir um nome de editor no nome do Publicador.

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

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

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

Para habilitar o Início Automático:

  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. Selecione a caixa de seleção Para instalações de CD, inicie automaticamente a Instalação quando o CD for inserido .

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

Conteúdo relacionado