Tarefa GenerateApplicationManifest
Gerencia um manifesto de aplicativo do ClickOnce ou um manifesto nativo. Um manifesto nativo descreve um componente definindo uma identidade exclusiva para o componente e identificando todos os assemblies e os arquivos que compõem o componente. Um manifesto de aplicativo de ClickOnce estende um manifesto nativo indicando o ponto de entrada do aplicativo, especificando o nível de segurança do aplicativo.
Parâmetros
A tabela a seguir descreve os parâmetros para a tarefa GenerateApplicationManifest.
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 nenhum nome puder ser criado, 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, um valor padrão de "1.0.0.0" será usado. |
ClrVersion |
Parâmetro opcional de String. Especifica a versão mínima do CLR (Common Language Runtime) exigida pelo aplicativo. O valor padrão é a versão do CLR em uso pelo sistema de compilação. Caso a tarefa esteja gerando um manifesto nativo, esse parâmetro será ignorado. |
ConfigFile |
Parâmetro opcional de ITaskItem[]. Especifica o item que contém o arquivo de configuração do aplicativo. Caso a tarefa esteja gerando um manifesto nativo, esse parâmetro será ignorado. |
Dependencies |
Parâmetro opcional de ITaskItem[]. Especifica uma lista de itens que define o conjunto de assemblies dependentes para o manifesto gerado. Cada item pode ser descrito com mais detalhes por metadados de item para indicar o estado adicional de implantação e o tipo de dependência. Para obter mais informações, consulte a seção "Metadados de Itens " a seguir. |
Description |
Parâmetro opcional de String. Especifica a descrição para o aplicativo ou componente. |
EntryPoint |
Parâmetro opcional de ITaskItem[]. Especifica um único item que indica o ponto de entrada para o assembly do manifesto gerado. Para um manifesto de aplicativo de ClickOnce, este parâmetro especifica o assembly que inicia quando o aplicativo é executado. |
ErrorReportUrl |
Parâmetro opcional de [String]. Especifica a URL da página da Web que é exibida em caixas de diálogo durante relatórios de erro em instalações do ClickOnce. |
FileAssociations |
Parâmetro opcional de ITaskItem[]. Especifica uma lista de um ou mais tipos de arquivo associados ao manifesto de implantação do ClickOnce. As associações de arquivos são válidas somente quando o .NET Framework 3.5 ou posterior é tido como alvo. |
Files |
Parâmetro opcional de ITaskItem[]. Os arquivos a serem incluídos no manifesto. Especifique o caminho completo para cada arquivo. |
HostInBrowser |
Parâmetro opcional de [Boolean]. Se true, o aplicativo é hospedado em um navegador (assim como os aplicativos de navegador da Web do WPF). |
IconFile |
Parâmetro opcional de ITaskItem[]. Indica o arquivo de ícone do aplicativo. O ícone do aplicativo é expresso no manifesto do aplicativo gerado e é usado para o menu Iniciar e a caixa de diálogo Adicionar/Remover programas. Se a entrada não for especificada, um ícone padrão será usado. Caso a tarefa esteja gerando um manifesto nativo, esse parâmetro será ignorado. |
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 segurança de aplicativo ou 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. |
IsolatedComReferences |
Parâmetro opcional de ITaskItem[]. Especifica componentes COM a serem isolados no manifesto gerado. Esse parâmetro oferece suporte à capacidade de isolar componentes COM para implantação "COM de Registro Gratuito". Funciona gerando automaticamente um manifesto com definições padrão do registro COM. No entanto, os componentes COM devem ser registrados no computador de compilação para este funcionar corretamente. |
ManifestType |
Parâmetro opcional de String. Especifica que tipo de manifesto a ser gerado. Essa propriedade pode ter os seguintes valores:
Se esse parâmetro não for especificado, a tarefa terá como padrão ClickOnce. |
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 valor 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 originarão um aviso de compilação. Se a entrada não for especificada ou for zero, nenhuma verificação será executada. Caso a tarefa esteja gerando um manifesto nativo, esse parâmetro será ignorado. |
OSVersion |
Parâmetro opcional de String. Especifica a versão mínima necessária do sistema operacional (SO) exigida pelo aplicativo. Por exemplo, o valor "5.1.2600.0" indica que o sistema operacional é o Windows XP. Se este parâmetro não for especificado, o valor “4.10.0.0” será usado, que indica o Windows 98 Second Edition, o sistema operacional mínimo compatível com o .NET Framework. Caso a tarefa esteja gerando um manifesto nativo, essa entrada será ignorada. |
OutputManifest |
Parâmetro de saída 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:
Se esse parâmetro não for especificado, a tarefa terá como 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. |
RequiresMinimumFramework35SP1 |
Parâmetro opcional de Boolean. Se verdadeiro, o aplicativo irá requerer o .NET Framework 3.5 SP1 ou uma versão mais recente. |
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. |
TargetFrameworkMoniker |
Parâmetro opcional de [String]. Especifica o moniker do framework de destino. |
TargetFrameworkProfile |
Parâmetro opcional de [String]. Especifica o perfil do framework de destino. |
TargetFrameworkSubset |
Parâmetro opcional de [String]. Especifica o nome do subconjunto do .NET Framework a ser direcionado. |
TargetFrameworkVersion |
Parâmetro opcional de [String]. Especifica o .NET Framework de destino do projeto. |
TrustInfoFile |
Parâmetro opcional de ITaskItem. Indica um documento XML que especifica a segurança do aplicativo. O elemento raiz no documento XML deve ser um nó de trustInfo no namespace asmv2. Caso a tarefa esteja gerando um manifesto nativo, esse parâmetro será ignorado. |
UseApplicationTrust |
Parâmetro opcional de [Boolean]. Se verdadeiro, as propriedades Product, Publisher, e SupportUrl serão gravadas no manifesto do aplicativo. |
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.
Para obter mais informações sobre como usar a tarefa GenerateDeploymentManifest, consulte Tarefa GenerateApplicationManifest.
As entradas para dependências e arquivos podem ser decoradas posteriormente com metadados de item, de modo a especificar o estado da implantação adicional de cada item.
Metadados de itens
Nome de metadados |
Descrição |
---|---|
DependencyType |
Indica se a dependência está publicada e instalada com o aplicativo ou um pré-requisito. Esses metadados são válidos para todas as dependências, mas não são usados para arquivos. Os valores disponíveis para esses metadados são:
Instalação é o valor padrão. |
AssemblyType |
Indica se a dependência é um assembly gerenciado ou nativo. Esses metadados são válidos para todas as dependências, mas não são usados para arquivos. Os valores disponíveis para esses metadados são:
Unspecified é o valor padrão, que indica que o gerador do manifesto determinará o tipo de assembly automaticamente. |
Group |
Indica o grupo para baixar arquivos adicionais sob demanda. O nome do grupo é definido pelo aplicativo e pode ser qualquer cadeia de caracteres. Uma cadeia de caracteres vazia indica que o arquivo não faz parte de um grupo de download, que é o padrão. Os arquivos que não estão em um grupo são parte do download inicial do aplicativo. Os arquivos em um grupo são baixados somente quando são solicitados explicitamente pelo aplicativo usando System.Deployment.Application. Esses metadados são válidos para todos os arquivos onde IsDataFile é false e todas as dependências onde DependencyType é Install. |
TargetPath |
Especifica como o caminho deve ser definido no manifesto gerado. Esse atributo é válido para todos os arquivos. Se esse atributo não for especificado, a especificação de item será usada. Esse atributo é válido para todos os arquivos e dependências com um valor DependencyType de Install. |
IsDataFile |
Um valor de metadados de Boolean que indica se o arquivo é ou não um arquivo de dados. Um arquivo de dados é especial na medida em que é migrado entre atualizações do aplicativo. Esses metadados são válidos somente para arquivos. False é o valor padrão. |
Exemplo
Esse exemplo usa a tarefa GenerateApplicationManifest para gerar um manifesto de aplicativo ClickOnce e a tarefa GenerateDeploymentManifest para gerar um manifesto de implantação para um aplicativo com um único assembly. Em seguida, usa a tarefa de SignFile para assinar os manifestos.
Isso ilustra o cenário mais simples possível de geração de manifesto onde os manifestos ClickOnce são gerados para um único programa. Um nome padrão e uma identidade são inferidos do assembly para o manifesto.
Dica
No exemplo abaixo, todos os binários do aplicativo são predefinidos para focalizar aspectos de geração do manifesto.Esse exemplo gera uma implantação do ClickOnce totalmente funcional.
Dica
Para obter mais informações sobre a propriedade de Thumbprint usada na tarefa de SignFile neste exemplo, consulte Tarefa SignFile.
<Project DefaultTargets="Build"
xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<EntryPoint Include="SimpleWinApp.exe" />
</ItemGroup>
<PropertyGroup>
<Thumbprint>
<!-- Insert generated thumbprint here -->
</Thumbprint>
</PropertyGroup>
<Target Name="Build">
<GenerateApplicationManifest
EntryPoint="@(EntryPoint)">
<Output
ItemName="ApplicationManifest"
TaskParameter="OutputManifest"/>
</GenerateApplicationManifest>
<GenerateDeploymentManifest
EntryPoint="@(ApplicationManifest)">
<Output
ItemName="DeployManifest"
TaskParameter="OutputManifest"/>
</GenerateDeploymentManifest>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(ApplicationManifest)"/>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(DeployManifest)"/>
</Target>
</Project>
Esse exemplo usa as tarefas GenerateApplicationManifest e GenerateDeploymentManifest para gerar manifestos de aplicativo e implantação ClickOnce para um aplicativo com um único assembly, especificando o nome e a identidade dos manifestos.
Esse exemplo é semelhante ao exemplo anterior, exceto pelo nome e pela identidade dos manifestos que são explicitamente especificados. Além disso, esse exemplo é configurado como um aplicativo online em vez de um aplicativo instalado.
Dica
No exemplo abaixo, todos os binários do aplicativo são predefinidos para focalizar aspectos de geração do manifesto.Esse exemplo gera uma implantação do ClickOnce totalmente funcional.
Dica
Para obter mais informações sobre a propriedade de Thumbprint usada na tarefa de SignFile neste exemplo, consulte Tarefa SignFile.
<Project DefaultTargets="Build"
xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<EntryPoint Include="SimpleWinApp.exe" />
</ItemGroup>
<PropertyGroup>
<Thumbprint>
<!-- Insert generated thumbprint here -->
</Thumbprint>
</PropertyGroup>
<Target Name="Build">
<GenerateApplicationManifest
AssemblyName="SimpleWinApp.exe"
AssemblyVersion="1.0.0.0"
EntryPoint="@(EntryPoint)"
OutputManifest="SimpleWinApp.exe.manifest">
<Output
ItemName="ApplicationManifest"
TaskParameter="OutputManifest"/>
</GenerateApplicationManifest>
<GenerateDeploymentManifest
AssemblyName="SimpleWinApp.application"
AssemblyVersion="1.0.0.0"
EntryPoint="@(ApplicationManifest)"
Install="false"
OutputManifest="SimpleWinApp.application">
<Output
ItemName="DeployManifest"
TaskParameter="OutputManifest"/>
</GenerateDeploymentManifest>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(ApplicationManifest)"/>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(DeployManifest)"/>
</Target>
</Project>
Esse exemplo usa as tarefas GenerateApplicationManifest e GenerateDeploymentManifest para gerar manifestos de aplicativo e implantação ClickOnce para um aplicativo com vários arquivos e assemblies.
Dica
No exemplo abaixo, todos os binários do aplicativo são predefinidos para focalizar aspectos de geração do manifesto.Esse exemplo gera uma implantação do ClickOnce totalmente funcional.
Dica
Para obter mais informações sobre a propriedade de Thumbprint usada na tarefa de SignFile neste exemplo, consulte Tarefa SignFile.
<Project DefaultTargets="Build"
xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<EntryPoint Include="SimpleWinApp.exe" />
</ItemGroup>
<PropertyGroup>
<Thumbprint>
<!-- Insert generated thumbprint here -->
</Thumbprint>
<DeployUrl>
<!-- Insert the deployment URL here -->
</DeployUrl>
<SupportUrl>
<!-- Insert the support URL here -->
</SupportUrl>
</PropertyGroup>
<Target Name="Build">
<ItemGroup>
<EntryPoint Include="SimpleWinApp.exe"/>
<Dependency Include="ClassLibrary1.dll">
<AssemblyType>Managed</AssemblyType>
<DependencyType>Install</DependencyType>
</Dependency>
<Dependency Include="ClassLibrary2.dll">
<AssemblyType>Managed</AssemblyType>
<DependencyType>Install</DependencyType>
<Group>Secondary</Group>
</Dependency>
<Dependency Include="MyAddIn1.dll">
<AssemblyType>Managed</AssemblyType>
<DependencyType>Install</DependencyType>
<TargetPath>Addins\MyAddIn1.dll</TargetPath>
</Dependency>
<Dependency Include="ClassLibrary3.dll">
<AssemblyType>Managed</AssemblyType>
<DependencyType>Prerequisite</DependencyType>
</Dependency>
<File Include="Text1.txt">
<TargetPath>Text\Text1.txt</TargetPath>
<Group>Text</Group>
</File>
<File Include="DataFile1.xml ">
<TargetPath>Data\DataFile1.xml</TargetPath>
<IsDataFile>true</IsDataFile>
</File>
<IconFile Include="Heart.ico"/>
<ConfigFile Include="app.config">
<TargetPath>SimpleWinApp.exe.config</TargetPath>
</ConfigFile>
<BaseManifest Include="app.manifest"/>
</ItemGroup>
<Target Name="Build">
<GenerateApplicationManifest
AssemblyName="SimpleWinApp.exe"
AssemblyVersion="1.0.0.0"
ConfigFile="@(ConfigFile)"
Dependencies="@(Dependency)"
Description="TestApp"
EntryPoint="@(EntryPoint)"
Files="@(File)"
IconFile="@(IconFile)"
InputManifest="@(BaseManifest)"
OutputManifest="SimpleWinApp.exe.manifest">
<Output
ItemName="ApplicationManifest"
TaskParameter="OutputManifest"/>
</GenerateApplicationManifest>
<GenerateDeploymentManifest
AssemblyName="SimpleWinApp.application"
AssemblyVersion="1.0.0.0"
DeploymentUrl="$(DeployToUrl)"
Description="TestDeploy"
EntryPoint="@(ApplicationManifest)"
Install="true"
OutputManifest="SimpleWinApp.application"
Product="SimpleWinApp"
Publisher="Microsoft"
SupportUrl="$(SupportUrl)"
UpdateEnabled="true"
UpdateInterval="3"
UpdateMode="Background"
UpdateUnit="weeks">
<Output
ItemName="DeployManifest"
TaskParameter="OutputManifest"/>
</GenerateDeploymentManifest>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(ApplicationManifest)"/>
<SignFile
CertificateThumbprint="$(Thumbprint)"
SigningTarget="@(DeployManifest)"/>
</Target>
</Project>
Esse exemplo usa a tarefa GenerateApplicationManifest para gerar um manifesto nativo para o aplicativo Test.exe, fazendo referência a um componente nativo Alpha.dll e a um componente COM isolado Bravo.dll.
Esse exemplo gera o Test.exe.manifest, fazendo o aplicativo XCOPY implantável aproveitar o COM de Registro Gratuito.
Dica
No exemplo abaixo, todos os binários do aplicativo são predefinidos para focalizar aspectos de geração do manifesto.Esse exemplo gera uma implantação do ClickOnce totalmente funcional.
<Project DefaultTargets="Build" xmlns="https://schemas.microsoft.com/developer/msbuild/2003">
<ItemGroup>
<File Include="Test.exe" />
<Dependency Include="Alpha.dll">
<AssemblyType>Native</AssemblyType>
<DependencyType>Install</DependencyType>
</Dependency>
<ComComponent Include="Bravo.dll" />
</ItemGroup>
<Target Name="Build">
<GenerateApplicationManifest
AssemblyName="Test.exe"
AssemblyVersion="1.0.0.0"
Dependencies="@(Dependency)"
Files="@(File)"
IsolatedComReferences="@(ComComponent)"
ManifestType="Native">
<Output
ItemName="ApplicationManifest"
TaskParameter="OutputManifest"/>
</GenerateApplicationManifest>
</Target>
</Project>
Consulte também
Referência
Tarefa GenerateDeploymentManifest