Tarefa GenerateDeploymentManifest
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.
Parâmetros
A tabela a seguir descreve os parâmetros para a tarefa GenerateDeploymentManifest.
Parâmetro |
Descrição |
|---|---|
AssemblyName |
Parâ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. |
AssemblyVersion |
Parâ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". |
CreateDesktopShortcut |
Parâmetro opcional de Boolean. Se verdadeiro, um ícone será criado na área de trabalho durante a instalação do aplicativo ClickOnce. |
DeploymentUrl |
Parâ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. |
Description |
Parâmetro opcional de String. Especifica uma descrição opcional para o aplicativo. |
DisallowUrlActivation |
Parâ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. |
EntryPoint |
Parâ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:
|
ErrorReportUrl |
Parâmetro opcional de [String]. Especifica a URL da página da Web que é exibida em caixas de diálogo durante instalações do ClickOnce. |
InputManifest |
Parâ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. |
Install |
Parâ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. |
MapFileExtensions |
Parâ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. |
MaxTargetPath |
Parâ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. |
MinimumRequiredVersion |
Parâ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. |
OutputManifest |
Parâ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. |
Platform |
Parâmetro opcional de String. Especifica a plataforma de destino do aplicativo. Essa propriedade pode ter os seguintes valores:
O valor padrão é AnyCPU. |
Product |
Parâ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. |
Publisher |
Parâ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. |
SuiteNamel |
Parâ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. |
SupportUrl |
Parâ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. |
TargetCulture |
Parâ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. |
TrustUrlParameters |
Parâ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. |
UpdateEnabled |
Parâ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. |
UpdateInterval |
Parâ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. |
UpdateMode |
Parâ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:
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. |
UpdateUnit |
Parâmetro opcional de String. Especifica as unidades para o parâmetro UpdateInterval. Essa propriedade pode ter os seguintes valores:
Esse parâmetro se aplica somente 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 é herdada da própria classe Task. Para uma lista de parâmetros da classe de tarefas, consulte Classe base Task.
Consulte também
Referência
Tarefa GenerateApplicationManifest