Partilhar via


Tarefa GenerateApplicationManifest

Gera um manifesto nativo ou um manifesto do aplicativo ClickOnce. Um manifesto nativo descreve um componente definindo uma identidade exclusiva para ele e identificando todos os assemblies e arquivos que compõem o componente. Um manifesto do aplicativo ClickOnce estende um manifesto nativo indicando o ponto de entrada do aplicativo e especificando o nível de segurança do aplicativo.

Parâmetros

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

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 nenhum nome puder ser criado, a tarefa gerará um erro.
AssemblyVersion Parâmetro String opcional.

Especifica o campo Version da identidade do assembly para o manifesto gerado. Se o parâmetro não for especificado, será usado o valor padrão de “1.0.0.0”.
ClrVersion Parâmetro String opcional.

Especifica a versão mínima do CLR (Common Language Runtime) exigida pelo aplicativo. O valor padrão é a versão CLR em uso no sistema do build. Caso a tarefa esteja gerando um manifesto nativo, este parâmetro será ignorado.
ConfigFile Parâmetro opcional ITaskItem[].

Especifica qual item contém o arquivo de configuração de aplicativo. Caso a tarefa esteja gerando um manifesto nativo, este parâmetro será ignorado.
Dependencies Parâmetro opcional 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 do item para indicar o estados de implantação adicionais e o tipo de dependência. Para obter mais informações, confira Metadados de item.
Description Parâmetro String opcional.

Especifica a descrição do aplicativo ou componente.
EntryPoint Parâmetro opcional ITaskItem[].

Especifica um único item que indica o ponto de entrada para o assembly do manifesto gerado.

Para um manifesto do aplicativo ClickOnce, esse parâmetro especifica o assembly que é iniciado quando o aplicativo é executado.
ErrorReportUrl Parâmetro System.String opcional.

Especifica a URL da página da Web exibida nas caixas de diálogo durante os relatórios de erro em instalações ClickOnce.
FileAssociations Parâmetro opcional 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 voltado para o .NET Framework 3.5 ou posterior.
Files Parâmetro opcional ITaskItem[].

Os arquivos a serem incluídos no manifesto. Especifique o caminho completo para cada arquivo.
HostInBrowser Parâmetro Boolean opcional.

Se true, o aplicativo é hospedado em um navegador (assim como Aplicativos de navegador da Web WPF).
IconFile Parâmetro opcional ITaskItem[].

Indica o arquivo de ícone do aplicativo. O ícone do aplicativo é expresso no manifesto do aplicativo gerado e usado para as caixas de diálogo Menu Iniciar e Adicionar/Remover Programas. Se essa entrada não for especificada, um ícone padrão será usado. Caso a tarefa esteja gerando um manifesto nativo, este parâmetro será ignorado.
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 segurança de aplicativos ou 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.
IsolatedComReferences Parâmetro opcional ITaskItem[].

Especifica os componentes COM a serem isolados no manifesto gerado. Esse parâmetro dá suporte à capacidade de isolar os componentes COM para implantação de “COM sem Registro”. Ele funciona por meio da geração automática de um manifesto com definições padrão de registro de COM. No entanto, os componentes COM devem ser registrados no computador de build para que isso funcione corretamente.
LauncherBasedDeployment Parâmetro Boolean opcional.

Defina isso como True ao compilar para .NET Core 3.1, .NET 5 e versões posteriores para garantir que o executável do aplicativo seja renomeado como o nome do executável esperado depois de compilar o executável do host do aplicativo apphost.exe.
ManifestType Parâmetro String opcional.

Especifica o tipo de manifesto a ser gerado. Esse parâmetro pode ter os seguintes valores:

- Native
- ClickOnce

Se esse parâmetro não for especificado, a tarefa será ClickOnce por padrão.
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 valor 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. Caso a tarefa esteja gerando um manifesto nativo, este parâmetro será ignorado.
OSVersion Parâmetro String opcional.

Especifica a versão mínima necessária do SO (sistema operacional) exigida pelo aplicativo. Se esse parâmetro não for especificado, será usado o valor “4.10.0.0”, o sistema operacional mínimo com suporte no .NET Framework. Caso a tarefa esteja gerando um manifesto nativo, esta entrada será ignorada.
OutputManifest Parâmetro de saída 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

Se esse parâmetro não for especificado, a tarefa será AnyCPU por padrão.
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.
RequiresMinimumFramework35SP1 Parâmetro Boolean opcional.

Se for verdadeiro, o aplicativo exigirá o .NET Framework 3.5 SP1 ou uma versão mais recente.
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.
TargetFrameworkMoniker Parâmetro String opcional.

Especifica o moniker da estrutura de destino.
TargetFrameworkProfile Parâmetro String opcional.

Especifica o perfil da estrutura de destino.
TargetFrameworkSubset Parâmetro String opcional.

Especifica o nome do subconjunto do .NET Framework de destino.
TargetFrameworkVersion Parâmetro String opcional.

Especifica o .NET Framework de destino do projeto.
TrustInfoFile Parâmetro ITaskItem opcional.

Indica um documento XML que especifica a segurança do aplicativo. O elemento raiz do documento XML deve ser um nó trustInfo no namespace asmv2. Caso a tarefa esteja gerando um manifesto nativo, este parâmetro será ignorado.
UseApplicationTrust Parâmetro Boolean opcional.

Se for verdadeiro, as propriedades Product, Publisher e SupportUrl são gravadas no manifesto do aplicativo.

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.

Para obter informações sobre como usar a tarefa GenerateDeploymentManifest, confira Tarefa GenerateApplicationManifest.

As entradas para as dependências e os arquivos podem ser mais decorados ainda com metadados de item para especificar o estado de implantação adicional para cada item.

Metadados do item

Nome dos metadados Descrição
DependencyType Indica se a dependência é 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:

- Install
- Prerequisite

Instala 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:

- Managed
- Native
- Unspecified

Unspecified é o valor padrão, que indica que o gerador de 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. Arquivos que não estão em um grupo fazem parte do download inicial do aplicativo. Os arquivos em um grupo são baixados apenas quando explicitamente solicitado pelo aplicativo usando System.Deployment.Application.

Esses metadados são válido para todos os arquivos em que IsDataFile é false e todas as dependências em que 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 do item será usada. Esse atributo é válido para todos os arquivos e as dependências com um valor DependencyType de Install.
IsDataFile Um valor de metadados Boolean que indica se o arquivo é um arquivo de dados ou não. Um arquivo de dados é especial, pois ele é migrado entre as atualizações de aplicativos. Esses metadados só são válido para os arquivos. False é o valor padrão.

Exemplo 1

Este exemplo usa a tarefa GenerateApplicationManifest para gerar um manifesto do aplicativo ClickOnce e a tarefa GenerateDeploymentManifest para gerar um manifesto de implantação para um aplicativo com um único assembly. Em seguida, ele usa a tarefa SignFile para assinar os manifestos.

Isso ilustra o cenário mais simples possível da geração de manifesto, no qual manifestos ClickOnce são gerados para um único programa. Um nome padrão e uma identidade são inferidos do assembly para o manifesto.

Observação

No exemplo abaixo, todos os binários do aplicativo são predefinidos para se concentrar em aspectos de geração de manifesto. Este exemplo produz uma implantação do ClickOnce totalmente funcional.

Observação

Para obter mais informações sobre a propriedade Thumbprint usada na tarefa SignFile neste exemplo, confira Tarefa SignFile.

<Project DefaultTargets="Build"
    xmlns="http://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>

Exemplo 2

Este exemplo usa as tarefas GenerateApplicationManifest e GenerateDeploymentManifest para gerar o aplicativo ClickOnce e manifestos de implantação para um aplicativo com um único assembly, especificando o nome e a identidade dos manifestos.

Este exemplo é semelhante ao exemplo anterior, exceto que o nome e a identidade dos manifestos são especificados explicitamente. Além disso, este exemplo é configurado como um aplicativo online em vez de um aplicativo instalado.

Observação

No exemplo abaixo, todos os binários do aplicativo são predefinidos para se concentrar em aspectos de geração de manifesto. Este exemplo produz uma implantação do ClickOnce totalmente funcional.

Observação

Para obter mais informações sobre a propriedade Thumbprint usada na tarefa SignFile neste exemplo, confira Tarefa SignFile.

<Project DefaultTargets="Build"
    xmlns="http://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>

Exemplo 3

Este exemplo usa as tarefas GenerateApplicationManifest e GenerateDeploymentManifest para gerar o aplicativo ClickOnce e manifestos de implantação para um aplicativo com vários arquivos e assemblies.

Observação

No exemplo abaixo, todos os binários do aplicativo são predefinidos para se concentrar em aspectos de geração de manifesto. Este exemplo produz uma implantação do ClickOnce totalmente funcional.

Observação

Para obter mais informações sobre a propriedade Thumbprint usada na tarefa SignFile neste exemplo, confira Tarefa SignFile.

<Project DefaultTargets="Build"
    xmlns="http://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>

Exemplo 4

Este exemplo usa a tarefa GenerateApplicationManifest para gerar um manifesto nativo para o aplicativo Test.exe, referenciando o componente nativo Alpha.dll e um componente COM isolado Bravo.dll.

Este exemplo produz Test.exe.manifest, tornando o aplicativo XCOPY implantável e aproveitando o COM Sem Registro.

Observação

No exemplo abaixo, todos os binários do aplicativo são predefinidos para se concentrar em aspectos de geração de manifesto. Este exemplo produz uma implantação do ClickOnce totalmente funcional.

<Project DefaultTargets="Build" xmlns="http://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>

Confira também