Compartilhar via

Tarefa GenerateDeploymentManifest

  • Artigo

Gera um manifesto de implantação do ClickOnce. Um manifesto de implantação do ClickOnce descreve a implantação de um aplicativo definindo uma identidade exclusiva para a implantação, identificando as características de implantação tais como o modo online ou da instalação, especificando as configurações de atualização do aplicativo e locais de atualização e indicando o manifesto do aplicativo do ClickOnce correspondente.

Parâmetros

A tabela a seguir descreve os parâmetros da tarefa GenerateDeploymentManifest.

Parâmetro Descrição
AssemblyName Parâmetro String opcional.

Especifica o campo Name da identidade do assembly para o manifesto gerado. Se esse parâmetro não for especificado, o nome será inferido com base nos parâmetros EntryPoint ou InputManifest. Se não for possível inferir o nome, a tarefa gerará um erro.
AssemblyVersion Parâmetro String opcional.

Especifica o campo Version da identidade do assembly para o manifesto gerado. Se esse parâmetro não for especificado, a tarefa usará o valor "1.0.0.0".
CreateDesktopShortcut Parâmetro Boolean opcional.

Se for verdadeiro, será criado um ícone na área de trabalho durante a instalação do aplicativo ClickOnce.
DeploymentUrl Parâmetro String opcional.

Especifica o local de atualização para o aplicativo. Se esse parâmetro não for especificado, nenhum local de atualização será definido para o aplicativo. No entanto, se o parâmetro UpdateEnabled for true, o local da atualização deverá ser especificado. O valor especificado deve ser um caminho de URL ou UNC totalmente qualificado.
Description Parâmetro String opcional.

Especifica uma descrição opcional para o aplicativo.
DisallowUrlActivation Parâmetro Boolean opcional.

Especifica se o aplicativo deve ser executado automaticamente quando ele é aberto por meio de uma URL. Se esse parâmetro for true, o aplicativo só poderá ser iniciado pelo menu Iniciar. O valor padrão desse parâmetro é false. Esta entrada só se aplica quando o valor do parâmetro Install é true.
EntryPoint Parâmetro opcional ITaskItem[].

Indica o ponto de entrada para o assembly do manifesto gerado. Para um manifesto de implantação do ClickOnce, essa entrada especifica o manifesto do aplicativo ClickOnce.

Se o parâmetro da tarefa EntryPoint não estiver especificado, a marca <customHostSpecified> será inserida como um filho da marca <entryPoint>, por exemplo:

<entryPoint xmlns="urn:schemas-microsoft-com:asm.v2">

<co.v1:customHostSpecified />

</entryPoint>

Você pode adicionar dependências de DLL ao manifesto do aplicativo usando as seguintes etapas:

1. Resolver as referências de assembly com uma chamada para ResolveAssemblyReference.
2. Passar a saída da tarefa anterior e o próprio assembly para ResolveManifestFiles.
3. Passar as dependências usando o parâmetro Dependencies para GenerateApplicationManifest.
ErrorReportUrl Parâmetro System.String opcional.

Especifica a URL da página da Web exibida nas caixas de diálogo durante instalações ClickOnce.
InputManifest Parâmetro ITaskItem opcional.

Indica um documento XML de entrada para servir como base para o gerador de manifesto. Isso permite que dados estruturados, tais como definições personalizadas de manifesto, sejam refletidos no manifesto de saída. O elemento raiz do documento XML deve ser um nó de assembly no namespace asmv1.
Install Parâmetro Boolean opcional.

Especifica se o aplicativo é um aplicativo instalado ou um aplicativo somente online. Se esse parâmetro for true, o aplicativo será instalado no menu Iniciar do usuário e poderá ser removido usando a caixa de diálogo Adicionar ou Remover Programas. Se esse parâmetro for false, o aplicativo será destinado ao uso online em uma página da Web. O valor padrão desse parâmetro é true.
MapFileExtensions Parâmetro Boolean opcional.

Especifica se o mapeamento da extensão de nome de arquivo .deploy é usado. Se esse parâmetro for true, cada arquivo de programa será publicado com uma extensão de nome de arquivo .deploy. Essa opção é útil para a segurança do servidor Web, para limitar o número de extensões de nome de arquivo que precisam estar desbloqueadas para habilitar a implantação do aplicativo ClickOnce. O valor padrão desse parâmetro é false.
MaxTargetPath Parâmetro String opcional.

Especifica o comprimento máximo permitido de um caminho de arquivo na implantação de um aplicativo ClickOnce. Se esse parâmetro for especificado, o comprimento de cada caminho de arquivo no aplicativo é verificado em relação a esse limite. Todos os itens que excedem o limite gerarão um aviso de build. Se essa entrada não for especificada ou for zero, nenhuma verificação será executada.
MinimumRequiredVersion Parâmetro String opcional.

Especifica se o usuário pode ignorar a atualização. Se o usuário tiver uma versão inferior à mínima necessária, ele não terá a opção de ignorar a atualização. Esta entrada se aplica somente se o valor do parâmetro Install for true.
OutputManifest Parâmetro ITaskItem opcional.

Especifica o nome do arquivo de manifesto de saída gerado. Se esse parâmetro não for especificado, o nome do arquivo de saída será inferido com base na identidade do manifesto gerado.
Platform Parâmetro String opcional.

Especifica a plataforma de destino do aplicativo. Esse parâmetro pode ter os seguintes valores:

- AnyCPU
- x86
- x64
- Itanium

O valor padrão é AnyCPU.
Product Parâmetro String opcional.

Especifica o nome do aplicativo. Se esse parâmetro não for especificado, o nome será inferido com base na identidade do manifesto gerado. Esse nome é usado para o nome do atalho no menu Iniciar e faz parte do nome exibido na caixa de diálogo Adicionar ou Remover Programas.
Publisher Parâmetro String opcional.

Especifica o editor do aplicativo. Se esse parâmetro não for especificado, o nome será inferido com base no usuário registrado ou na identidade do manifesto gerado. Esse nome é usado para o nome da pasta no menu Iniciar e faz parte do nome exibido na caixa de diálogo Adicionar ou Remover Programas.
SuiteNamel Parâmetro String opcional.

Especifica o nome da pasta no menu Iniciar, na qual o aplicativo está localizado após a implantação ClickOnce.
SupportUrl Parâmetro String opcional.

Especifica o link exibido na caixa de diálogo Adicionar ou Remover Programas do aplicativo. O valor especificado deve ser um caminho de URL ou UNC totalmente qualificado.
TargetCulture Parâmetro String opcional.

Identifica a cultura do aplicativo e especifica o campo Language da identidade do assembly para o manifesto gerado. Se esse parâmetro não for especificado, presume-se que o aplicativo não varia conforme a cultura.
TrustUrlParameters Parâmetro Boolean opcional.

Especifica se os parâmetros de cadeia de caracteres de consulta da URL devem ser disponibilizados para o aplicativo. O valor padrão desse parâmetro é false, que indica que parâmetros não estarão disponíveis para o aplicativo.
UpdateEnabled Parâmetro Boolean opcional.

Indica se o aplicativo está habilitado para atualizações. O valor padrão desse parâmetro é false. Esse parâmetro se aplica somente se o valor do parâmetro Install for true.
UpdateInterval Parâmetro Int32 opcional.

Especifica o intervalo de atualização para o aplicativo. O valor padrão desse parâmetro é zero. Este parâmetro se aplica somente a quando os valores dos parâmetros Install e UpdateEnabled são ambos true.
UpdateMode Parâmetro String opcional.

Especifica se as atualizações devem ser verificadas em primeiro plano, antes do aplicativo ser iniciado ou em segundo plano, enquanto o aplicativo está em execução. Esse parâmetro pode ter os seguintes valores:

- Foreground
- Background

O valor padrão desse parâmetro é Background. Este parâmetro se aplica somente a quando os valores dos parâmetros Install e UpdateEnabled são ambos true.
UpdateUnit Parâmetro String opcional.

Especifica as unidades para o parâmetro UpdateInterval. Esse parâmetro pode ter os seguintes valores:

- Hours
- Days
- Weeks

Este parâmetro se aplica somente a quando os valores dos parâmetros Install e UpdateEnabled são ambos true.

Comentários

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe GenerateManifestBase, que herda da classe Task. Para obter uma lista dos parâmetros da classe Task, confira Classe base Task.

Confira também