Compartilhar via


Tarefa de GenerateApplicationManifest

Gera um ClickOnce o manifesto de aplicativo ou um manifesto nativo. Um manifesto nativo descreve um componente definindo a uma identidade exclusiva para o componente e identificar todos os assemblies e arquivos que compõem o componente. A ClickOnce o manifesto de aplicativo 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 para o GenerateApplicationManifest de tarefas.

Parâmetro

Descrição

AssemblyName

Opcional String parâmetro.

Especifica o Name o campo da identidade do assembly do manifesto gerado. Se este parâmetro não for especificado, o nome é deduzido a partir de EntryPoint ou InputManifest parâmetros. Se nenhum nome pode ser criado, a tarefa lança um erro.

AssemblyVersion

Opcional String parâmetro.

Especifica o Version o campo da identidade do assembly do manifesto gerado. Se este parâmetro não for especificado, um valor padrão de "1.0.0.0" é usado.

ClrVersion

Opcional String parâmetro.

Especifica a versão mínima do CLR Common Language Runtime () exigidos pelo aplicativo. O valor padrão é a versão do CLR em uso pelo sistema de compilação. Se a tarefa está gerando um manifesto nativo, este parâmetro é ignorado.

ConfigFile

Opcional ITaskItem[] parâmetro.

Especifica qual item contém o arquivo de configuração do aplicativo. Se a tarefa está gerando um manifesto nativo, este parâmetro é ignorado.

Dependencies

Opcional ITaskItem[] parâmetro.

Especifica uma lista de itens, define o conjunto de módulos (assemblies) dependentes para o manifesto gerado. Cada item pode ser descrito com mais detalhes por metadados de item para indicar o estado de implantação adicionais e o tipo de dependência. Para obter mais informações, consulte "Metadados de Item" seção abaixo.

Description

Opcional String parâmetro.

Especifica a descrição para o aplicativo ou componente.

EntryPoint

Opcional ITaskItem[] parâmetro.

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

Para um ClickOnce o manifesto de aplicativo, este parâmetro especifica o conjunto que começa quando o aplicativo executar.

ErrorReportUrl

Opcional [String] parâmetro.

Especifica a URL da página da Web que é exibida nas caixas de diálogo durante a relatórios de erros em instalações de ClickOnce.

FileAssociations

Opcional ITaskItem[] parâmetro.

Especifica uma lista de tipo de arquivo de um ou mais estão associados com o manifesto de implantação ClickOnce.

Associações de arquivo só é válido somente quando.NET Framework 3.5 ou posterior é direcionado.

Files

Opcional ITaskItem[] parâmetro.

Os arquivos a serem incluídos no manifesto. Especifique o caminho completo para cada arquivo.

HostInBrowser

Opcional [Boolean] parâmetro.

Se true, o aplicativo é hospedado em um navegador (como aplicativos de navegador da Web WPF).

IconFile

Opcional ITaskItem[] parâmetro.

Indica o arquivo de ícone do aplicativo. O ícone do aplicativo é expresso no manifesto do aplicativo gerados e é usado para a caixa de diálogo do Menu Iniciar e adicionar ou remover programas. Se essa entrada não for especificada, um ícone padrão é usado. Se a tarefa está gerando um manifesto nativo, este parâmetro é ignorado.

InputManifest

Opcional ITaskItem parâmetro.

Indica um documento XML de entrada para servir como base para o gerador de manifesto. Isso permite que os dados estruturados como, por exemplo, as definições personalizadas de manifesto sejam refletidas no manifesto de saída ou de segurança do aplicativo. O elemento raiz no documento XML deve ser um nó de assembly no namespace asmv1.

IsolatedComReferences

Opcional ITaskItem[] parâmetro.

Especifica os componentes COM para isolar no manifesto gerado. Esse parâmetro aceita a capacidade de isolar os componentes COM para "Registro gratuito COM" implantação. Ele funciona por meio da geração automática de um manifesto com definições padrão de registro COM. No entanto, os componentes COM devem ser registrados no computador para que isso funcione corretamente.

ManifestType

Opcional String parâmetro.

Especifica o tipo de manifesto para gerar. Este parâmetro pode ter os seguintes valores:

  • Native

  • ClickOnce

Se este parâmetro não for especificado, a tarefa padrão ClickOnce.

MaxTargetPath

Opcional String parâmetro.

Especifica o comprimento máximo permitido de um caminho de arquivo em um ClickOnce implantação de aplicativo. Se esse valor for especificado, o tamanho de cada caminho do arquivo no aplicativo é verificado contra esse limite. Todos os itens que excedem o limite irá gerar um aviso de compilação. Se essa entrada não for especificada ou for zero, então nenhuma verificação será executada. Se a tarefa está gerando um manifesto nativo, este parâmetro é ignorado.

OSVersion

Opcional String parâmetro.

Especifica a versão mínima necessárias de sistema operacional (SO) exigida pelo aplicativo. Por exemplo, o valor "5.1.2600.0" indica o sistema operacional Windows XP. Se este parâmetro não for especificado, o valor "4.10.0.0" é usado, que indica que o Windows 98 Second Edition, o mínimo suportado SO do.NET Framework. Se a tarefa está gerando um manifesto nativo, essa entrada é ignorada.

OutputManifest

Opcional ITaskItem parâmetro de saída.

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

Platform

Opcional String parâmetro.

Especifica a plataforma de destino do aplicativo. Este parâmetro pode ter os seguintes valores:

  • AnyCPU

  • x86

  • x64

  • Itanium

Se este parâmetro não for especificado, a tarefa padrão AnyCPU.

Product

Opcional String parâmetro.

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

Publisher

Opcional String parâmetro.

Especifica o Editor do aplicativo. Se este parâmetro não for especificado, o nome é inferido do usuário registrado, ou a identidade do manifesto gerado. Esse nome é usado para o nome da pasta no menu Iniciar e é parte do nome que aparece na caixa de diálogo Adicionar ou remover programas.

RequiresMinimumFramework35SP1

Opcional Boolean parâmetro.

Se true, o aplicativo requer o.NET Framework 3.5 SP1 ou uma versão mais recente.

TargetCulture

Opcional String parâmetro.

Identifica a cultura do aplicativo e especifica o Language o campo da identidade do assembly do manifesto gerado. Se este parâmetro não for especificado, presume-se que o aplicativo está cultura invariável.

TargetFrameworkMoniker

Opcional [String] parâmetro.

Especifica o identificador de origem do framework de destino.

TargetFrameworkProfile

Opcional [String] parâmetro.

Especifica o perfil do framework de destino.

TargetFrameworkSubset

Opcional [String] parâmetro.

Especifica o nome da.Subconjunto do NET Framework para o destino.

TargetFrameworkVersion

Opcional [String] parâmetro.

Especifica o destino.NET Framework do projeto.

TrustInfoFile

Opcional ITaskItem parâmetro.

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. Se a tarefa está gerando um manifesto nativo, este parâmetro é ignorado.

UseApplicationTrust

Opcional [Boolean] parâmetro.

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

Comentários

Além de para os parâmetros listados acima, esta tarefa herda os parâmetros da GenerateManifest , a própria classe herda o Task classe. Para obter uma lista dos parâmetros da classe Task, consulte Classe Base da tarefa.

Para obter informações sobre como usar o GenerateDeploymentManifest de tarefas, consulte Tarefa de GenerateApplicationManifest.

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

Metadados de item

Nome de metadados

Descrição

DependencyType

Indica se a dependência é publicada e instalada com o aplicativo ou um pré-requisito. Esses metadados é válido para todas as dependências, mas não é usado para arquivos. Os valores disponíveis para esses metadados são:

  • Install

  • Prerequisite

Instalação é o valor padrão.

AssemblyType

Indica se a dependência é gerenciada ou um assembly nativo. Esses metadados é válido para todas as dependências, mas não é usado para arquivos. Os valores disponíveis para esses metadados são:

  • Managed

  • Native

  • Unspecified

Unspecifiedé o valor padrão, o que indica que o gerador de manifesto determinará o tipo de assembly automaticamente.

Group

Indica o grupo para fazer o download de arquivos adicionais sob demanda. O nome do grupo é definido pelo aplicativo e pode ser qualquer seqüência. Uma seqüência de caracteres vazia indica que o arquivo não é parte de um grupo de download, o que é o padrão. Arquivos não está no grupo são parte do download do aplicativo inicial. Arquivos em um grupo só são baixados quando solicitadas explicitamente usando o aplicativo System.Deployment.Application.

Esses metadados são válido 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 este atributo não for especificado, a especificação do item é usada. Esse atributo é válido para todos os arquivos e dependências com um DependencyType valor de Install.

IsDataFile

A Boolean o valor de metadados que indica que o arquivo está ou não um arquivo de dados. Um arquivo de dados é especial em que ele foi migrado entre atualizações de aplicativos. Esses metadados são válido somente para arquivos. Falseé o valor padrão.

Exemplo

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

Isso ilustra o cenário mais simples de geração de manifesto possíveis onde ClickOnce manifestos são gerados para um único programa. Um nome padrão e a identidade são inferidos do assembly para obter o manifesto.

Observação

No exemplo abaixo, todos os binários do aplicativo são pré-criados para enfocar os aspectos de geração de manifesto.Este exemplo produz um trabalho totalmente ClickOnce implantação.

Observação

Para obter mais informações sobre o Thumbprint propriedade usada na SignFile de tarefas neste exemplo, consulte Tarefa de 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>

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

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

Observação

No exemplo abaixo, todos os binários do aplicativo são pré-criados para enfocar os aspectos de geração de manifesto.Este exemplo produz um trabalho totalmente ClickOnce implantação.

Observação

Para obter mais informações sobre o Thumbprint propriedade usada na SignFile de tarefas neste exemplo, consulte Tarefa de 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>

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

Observação

No exemplo abaixo, todos os binários do aplicativo são pré-criados para enfocar os aspectos de geração de manifesto.Este exemplo produz um trabalho totalmente ClickOnce implantação.

Observação

Para obter mais informações sobre o Thumbprint propriedade usada na SignFile de tarefas neste exemplo, consulte Tarefa de 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>

Este exemplo usa a GenerateApplicationManifest para gerar um manifesto nativo para Test. exe do aplicativo, o componente nativo referência Alpha.dll e um componente isolado do COM Bravo.dll.

Este exemplo produz Test.exe.manifest, tornando o aplicativo XCOPY implantáveis beneficiando-se com. livre de registro

Observação

No exemplo abaixo, todos os binários do aplicativo são pré-criados para enfocar os aspectos de geração de manifesto.Este exemplo produz um trabalho totalmente ClickOnce implantação.

<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 de GenerateDeploymentManifest

Tarefa de SignFile

Conceitos

Tarefas do MSBuild

Outros recursos

Referência de tarefa do MSBuild