Tarefa GenerateDeploymentManifest
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.
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 . |
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.