Tarefa GenerateDeploymentManifest

 

Para obter a documentação mais recente do Visual Studio 2017 RC, consulte a documentação do Visual Studio 2017 RC.

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

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

ParâmetroDescrição
AssemblyNameParâmetro opcional de String.

Especifica o campo Name da identidade do assembly para o manifesto gerado. Se este parâmetro não for especificado, o nome é inferido pelos parâmetros de EntryPoint ou de InputManifest. Se o nome não puder ser inferido, a tarefa gerará um erro.
AssemblyVersionParâmetro opcional de String.

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".
CreateDesktopShortcutParâmetro opcional de Boolean.

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

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

Especifica uma descrição opcional para o aplicativo.
DisallowUrlActivationParâmetro opcional de Boolean.

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

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

No Visual Studio 2005, o Tarefa GenerateApplicationManifest precisava de um EntryPoint para gerar um manifesto de aplicativo. (Os manifestos de assembly ou nativos não requerem um EntryPoint.) Esse requisito foi aplicado com o erro de compilação: "MSB3185: EntryPoint não especificado para manifesto."

 MSBuild não emite este erro quando o parâmetro de tarefa EntryPoint não é especificado. Em vez disso, a maca <customHostSpecified> é 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. Resolva as referências de assembly com uma chamada para ResolveAssemblyReference.
2. Passe a saída da tarefa anterior e o próprio assembly para ResolveManifestFiles.
3. Passe as dependências usando o parâmetro Dependencies para GenerateApplicationManifest.
ErrorReportUrlParâmetro opcional de String.

Especifica a URL da página da Web que é exibida em caixas de diálogo durante instalações do ClickOnce.
InputManifestParâmetro opcional de ITaskItem.

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

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 se destinará ao uso on-line em uma página da Web. O valor padrão desse parâmetro é true.
MapFileExtensionsParâmetro opcional de Boolean.

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

Especifica o tamanho máximo permitido de um caminho de arquivo em uma implantação de aplicativos do ClickOnce. Se este parâmetro for especificado, o comprimento de cada caminho de arquivo no aplicativo será verificado com relação a esse limite. Todos os itens que excederem o limite causarão um aviso de compilação. Se a entrada não for especificada ou for zero, nenhuma verificação será executada.
MinimumRequiredVersionParâmetro opcional de String.

Especifica se o usuário pode ignorar a atualização. Se o usuário tiver uma versão que é menor que o mínimo necessário, não terá a opção de ignorar a atualização. Essa entrada se aplica somente quando o valor do parâmetro Install é true.
OutputManifestParâmetro opcional de ITaskItem.

Especifica o nome do arquivo de manifesto de saída gerado. Se este parâmetro não for especificado, o do arquivo de saída é inferido pela identidade do manifesto gerado.
PlatformParâmetro opcional de String.

Especifica a plataforma de destino do aplicativo. Essa propriedade pode ter os seguintes valores:

- AnyCPU
- x86
- x64
- Itanium

O valor padrão é AnyCPU.
ProductParâmetro opcional de String.

Especifica o nome do aplicativo. Se este parâmetro não for especificado, o nome é inferido pela identidade do manifesto gerado. Esse nome é usado para o nome de atalho no menu Iniciar e faz parte do nome que aparece na caixa de diálogo Adicionar ou Remover Programas.
PublisherParâmetro opcional de String.

Especifica o editor do aplicativo. Se este parâmetro não for especificado, o nome é inferido pelo usuário registrado, ou pela identidade do manifesto gerado. Esse nome é usado para o nome de pasta no menu Iniciar e faz parte do nome que aparece na caixa de diálogo Adicionar ou Remover Programas.
SuiteNamelParâmetro opcional de String.

Especifica o nome da pasta no menu Iniciar na qual o aplicativo estará localizado após a implantação do ClickOnce.
SupportUrlParâmetro opcional de String.

Especifica o link que aparece na caixa de diálogo Adicionar ou Remover Programas do aplicativo. O valor especificado deve ser um caminho UNC ou uma URL totalmente qualificada.
TargetCultureParâmetro opcional de String.

Identifica a cultura do aplicativo e especifica o campo de Language de identidade de assembly para o manifesto gerado. Se este parâmetro não for especificado, assume-se que a cultura do aplicativo é invariável.
TrustUrlParametersParâmetro opcional de Boolean.

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

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

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

Especifica se as atualizações devem ser verificadas em primeiro plano antes de o aplicativo ser iniciado ou em segundo plano quando o aplicativo estiver sendo executado. Essa propriedade pode ter os seguintes valores:

- Foreground
- Background

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

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

- Hours
- Days
- Weeks

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

Além dos parâmetros listados acima, essa tarefa herda parâmetros da classe GenerateManifestBase, que é herdada da própria classe Task. Para uma lista de parâmetros da classe de tarefas, consulte Classe base Task.

(tarefas)
Tarefa GenerateApplicationManifest
Tarefa SignFile
Referência de tarefas

Mostrar: