Задача GenerateApplicationManifest

Создание манифеста приложения ClickOnce или собственного манифеста. Собственный манифест описывает компонент посредством определения уникального идентификатора для этого компонента и определения всех сборок и файлов, образующих этот компонент. Манифест приложения ClickOnce расширяет собственный манифест посредством указания точки входа и уровня безопасности этого приложения.

Параметры

В следующей таблице описаны параметры задачи GenerateApplicationManifest.

Заметки

Помимо параметров, которые перечислены выше, эта задача наследует параметры от класса GenerateManifest, который наследует от класса Task. Список параметров класса Task см. в описании класса Базовый класс Task.

Сведения об использовании задачи GenerateDeploymentManifest см. в Задача GenerateApplicationManifest.

Для каждого из входных параметров зависимостей и файлов можно дополнительно указать состояние развертывания в метаданных элементов.

Метаданные элементов

Пример

В этом примере задача GenerateApplicationManifest используется для создания манифеста приложения ClickOnce, а задача GenerateDeploymentManifest — для создания манифеста развертывания приложения с одной сборкой. Затем используется задача SignFile для подписи манифестов.

Этот пример является иллюстрацией простейшего возможного сценария создания манифестов, где манифесты ClickOnce создаются для одной программы. Имя и идентификатор по умолчанию выводятся из сборки для данного манифеста.

Примечание
В приведенном ниже примере все двоичные файлы приложений собраны заранее, чтобы сосредоточить внимание на создании манифестов.В этом примере представлено полностью работоспособное развертывание ClickOnce.

Примечание
Дополнительные сведения о свойстве Thumbprint, которое используется в задаче SignFile данного примера, см. в разделе Задача 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>

В этом примере используются задачи GenerateApplicationManifest и GenerateDeploymentManifest для создания манифестов приложения ClickOnce и развертывания для приложения с одной сборкой, и указываются имя и удостоверение манифестов.

Этот пример аналогичен предыдущему за исключением того, что имя и удостоверение заданы явно. Кроме того, этот пример настроен как интернет-приложение, а не как установленное приложение.

Примечание
В приведенном ниже примере все двоичные файлы приложений собраны заранее, чтобы сосредоточить внимание на создании манифестов.В этом примере представлено полностью работоспособное развертывание ClickOnce.

Примечание
Дополнительные сведения о свойстве Thumbprint, которое используется в задаче SignFile данного примера, см. в разделе Задача 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>

В этом примере используются задачи GenerateApplicationManifest и GenerateDeploymentManifest для создания манифестов приложения ClickOnce и развертывания для приложения с несколькими файлами и сборками.

Примечание
В приведенном ниже примере все двоичные файлы приложений собраны заранее, чтобы сосредоточить внимание на создании манифестов.В этом примере представлено полностью работоспособное развертывание ClickOnce.

Примечание
Дополнительные сведения о свойстве Thumbprint, которое используется в задаче SignFile данного примера, см. в разделе Задача 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>

В этом примере используется задача GenerateApplicationManifest для создания собственного манифеста приложения Test.exe, ссылающегося на собственный компонент Alpha.dll и изолированный COM-компонент Bravo.dll.

В этом примере на выходе получается манифест Test.exe.manifest, позволяющий развертывать приложение, скопированное командой XCOPY, то есть использовать COM-компоненты без регистрации.

Примечание
В приведенном ниже примере все двоичные файлы приложений собраны заранее, чтобы сосредоточить внимание на создании манифестов.В этом примере представлено полностью работоспособное развертывание ClickOnce.

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

См. также

Ссылки

Задача GenerateDeploymentManifest

Задача SignFile

Основные понятия

Задачи MSBuild

Другие ресурсы

Справочные сведения о задачах MSBuild