Elemento <implantação> (implantação do ClickOnce)

  • Artigo

Identifica os atributos usados para a implantação de atualizações e exposição ao sistema.

Syntax


      <deployment
   install
   minimumRequiredVersion
   mapFileExtensions
   disallowUrlActivation
   trustUrlParameters
>
   <subscription>
         <update>
            <beforeApplicationStartup/>
            <expiration
               maximumAge
               unit
            />
         </update>
   </subscription>
   <deploymentProvider
      codebase
   />
</deployment>

Elementos e atributos

O elemento deployment é necessário e está no namespace urn:schemas-microsoft-com:asm.v2. O elemento possui os atributos a seguir:

Atributo Descrição
install Obrigatórios. Especifica se este aplicativo define uma presença no menu Iniciar do Windows e no aplicativo Adicionar ou Remover Programas do Painel de Controle. Os valores válidos são true e false. Se false, o ClickOnce sempre executará a versão mais recente desse aplicativo da rede e não reconhecerá o elemento subscription.
minimumRequiredVersion Opcional. Especifica a versão mínima desse aplicativo que pode ser executada no cliente. Se o número de versão do aplicativo for menor que o número de versão fornecido no manifesto de implantação, o aplicativo não será executado. Os números de versão devem ser especificados no formato N.N.N.N, em que N é um inteiro sem sinal. Se o atributo install for false, minimumRequiredVersion não deverá ser definido.
mapFileExtensions Opcional. Assume o padrão de false. Se true, todos os arquivos na implantação deverão ter uma extensão .deploy. O ClickOnce removerá essa extensão desses arquivos assim que os baixar do servidor Web. Se publicar seu aplicativo usando o Visual Studio, ele adicionará automaticamente essa extensão a todos os arquivos. Esse parâmetro permite que todos os arquivos em uma implantação do ClickOnce sejam baixados de um servidor Web que bloqueia a transmissão de arquivos que terminam em extensões "não seguras", como .exe.
disallowUrlActivation Opcional. Assume o padrão de false. Se true, impede que um aplicativo instalado seja iniciado clicando na URL ou inserindo a URL em um navegador. Se o atributo install não estiver presente, esse atributo será ignorado.
trustURLParameters Opcional. Assume o padrão de false. Se true, permitirá que a URL contenha parâmetros de cadeia de caracteres de consulta que são passados para o aplicativo, assim como argumentos de linha de comando são passados para um aplicativo de linha de comando. Para obter mais informações, confira Como recuperar informações de cadeia de caracteres de consulta em um aplicativo ClickOnce online.

Se o atributo disallowUrlActivation for true, trustUrlParameters deve ser excluído do manifesto ou definido explicitamente como false.

Este elemento deployment contém os elementos filho a seguir.

subscription

Opcional. Contém o elemento update. O elemento subscription não tem atributos. Se o elemento subscription não existir, o aplicativo ClickOnce nunca verificará se há atualizações. Se o atributo install do elemento deployment for false, o elemento subscription será ignorado, pois um aplicativo ClickOnce iniciado da rede sempre usará a versão mais recente.

atualizar

Obrigatórios. Esse elemento é um filho do elemento subscription e contém o elemento beforeApplicationStartup ou expiration. beforeApplicationStartup e expiration não podem ser especificados no mesmo manifesto de implantação.

O elemento update não tem atributos.

beforeApplicationStartup

Opcional. Esse elemento é um filho do elemento update e não tem atributos. Quando o elemento beforeApplicationStartup existir, o aplicativo será bloqueado quando o ClickOnce verificar se há atualizações, se o cliente estiver online. Se esse elemento não existir, o ClickOnce primeiro verificará se há atualizações com base nos valores especificados para o elemento expiration. beforeApplicationStartup e expiration não podem ser especificados no mesmo manifesto de implantação.

expiração

Opcional. Esse elemento é um filho do elemento update e não tem filhos. beforeApplicationStartup e expiration não podem ser especificados no mesmo manifesto de implantação. Quando ocorrer a verificação de atualização e uma versão atualizada for detectada, a nova versão é armazenada em cache enquanto a versão existente é executada. Em seguida, a nova versão é instalada na próxima inicialização do aplicativo ClickOnce.

O elemento expiration possui os atributos a seguir:

Atributo Descrição
maximumAge Obrigatórios. Identifica o tempo da atualização atual antes que o aplicativo execute uma verificação de atualização. A unidade de tempo é determinada pelo atributo unit.
unit Obrigatórios. Identifica a unidade de tempo para maximumAge. As unidades válidas são hours, days e weeks.

deploymentProvider

Para o .NET Framework 2.0, esse elemento será necessário se o manifesto de implantação contiver uma seção subscription. Para o .NET Framework 3.5 e posterior, esse elemento é opcional e usará como padrão o servidor e o caminho do arquivo no qual o manifesto de implantação foi descoberto.

Esse elemento é um filho do elemento deployment e não tem os seguintes atributos:

Atributo Descrição
codebase Obrigatórios. Identifica o local, como um URI (Uniform Resource Identifier), do manifesto de implantação usado para atualizar o aplicativo ClickOnce. Esse elemento também permite encaminhar locais de atualização para instalações baseadas em CD. Deve ser um URI válido.

Comentários

É possível configurar seu aplicativo ClickOnce para verificar se há atualizações na inicialização, verificar se há atualizações após a inicialização ou nunca verificar se há atualizações. Para verificar se há atualizações na inicialização, verifique se o elementobeforeApplicationStartup existe sob o elemento update. Para verificar se há atualizações após a inicialização, verifique se o elemento expiration existe sob o elemento update e se os intervalos de atualização são fornecidos.

Para desabilitar a verificação de atualizações, remova o elemento subscription. Ao especificar no manifesto de implantação para nunca verificar se há atualizações, ainda é possível verificar manualmente se há atualizações usando o método CheckForUpdate.

Observação

A classe ApplicationDeployment e as APIs no namespace System.Deployment.Application não têm suporte no .NET Core e no .NET 5 e versões posteriores. No .NET 7, há suporte para um novo método de acesso às propriedades de implantação do aplicativo. Para obter mais informações, consulte Acessar propriedades de implantação do ClickOnce no .NET. O .NET 7 não oferece suporte ao equivalente aos métodos ApplicationDeployment.

Para obter mais informações sobre como deploymentProvider se relaciona com atualizações, consulte Escolher uma estratégia de atualização do ClickOnce.

Exemplos

O exemplo de código a seguir ilustra um elemento deployment em um manifesto de implantação do ClickOnce. O exemplo usa um elemento deploymentProvider para indicar o local de atualização preferido.

<deployment install="true" minimumRequiredVersion="2.0.0.0" mapFileExtension="true" trustUrlParameters="true">
    <subscription>
      <update>
        <expiration maximumAge="6" unit="hours" />
      </update>
    </subscription>
    <deploymentProvider codebase="http://www.adatum.com/MyApplication.application" />
  </deployment>

Confira também