Sdílet prostřednictvím

GenerateApplicationManifest úloh

  • Článek

Generuje ClickOnce manifest aplikace nebo nativní manifestu.Nativní manifest popisuje součást definováním jedinečnou identitu pro součást a všechny soubory, které tvoří součást a sestavení identifikace.A ClickOnce manifest aplikace rozšiřuje nativní manifest označující vstupní bod aplikace a určením úroveň zabezpečení aplikace.

Parametry

Následující tabulka popisuje parametry GenerateApplicationManifest úkolu.

Parametr

Description

AssemblyName

Volitelný String parametr.

Určuje, Name pole identity sestavení pro generovaný manifest.Pokud tento parametr není zadán, je název odvodit ze EntryPoint nebo InputManifest parametry.Pokud vytvoření žádný název úkolu vyvolá chybu.

AssemblyVersion

Volitelný String parametr.

Určuje, Version pole identity sestavení pro generovaný manifest.Pokud tento parametr není zadán, je použita výchozí hodnota "1.0.0.0".

ClrVersion

Volitelný String parametr.

Určuje minimální verzi z Runtime CLR (Common Language) aplikace vyžaduje.Výchozí hodnota je verze CLR používá sestavení systému.Úkol je generování nativního manifest, je tento parametr ignorován.

ConfigFile

Volitelný ITaskItem[] parametr.

Určuje, která položka obsahuje konfigurační soubor aplikace.Úkol je generování nativního manifest, je tento parametr ignorován.

Dependencies

Volitelný ITaskItem[] parametr.

Určuje položku seznamu, který definuje sadu závislá sestavení pro generovaný manifest.Jednotlivé položky mohou být dále označena metadata položky označující další nasazení stav a typ závislosti.Další informace naleznete v části "Metadata položky".

Description

Volitelný String parametr.

Určuje popis aplikace nebo komponenty.

EntryPoint

Volitelný ITaskItem[] parametr.

Určuje jednu položku, která označuje vstupní bod pro vygenerované manifestu sestavení.

Pro ClickOnce manifest aplikace tento parametr určuje sestavení, která se spustí při spuštění aplikace.

ErrorReportUrl

Volitelný [String] parametr.

Určuje adresu URL webové stránky zobrazené v dialogových oknech během instalace technologie ClickOnce zpráv o chybách.

FileAssociations

Volitelný ITaskItem[] parametr.

Určuje seznam typu jeden nebo více souboru manifestu nasazení technologie ClickOnce přidružené.

Přidružení souboru pouze platná pouze v případě.NET Framework verze 3.5 nebo vyšší je cílová.

Files

Volitelný ITaskItem[] parametr.

Soubory manifest zahrnout.Zadejte úplnou cestu pro každý soubor.

HostInBrowser

Volitelný [Boolean] parametr.

Pokud true, hostována aplikace (jako jsou aplikací WPF webových prohlížečů) v prohlížeči.

IconFile

Volitelný ITaskItem[] parametr.

Určuje soubor ikony aplikace.Ikona aplikace je vyjádřena v manifestu generované aplikací a slouží k nabídce Start a přidat nebo odebrat programy v dialogovém okně.Tento vstup není-li zadán, je použita výchozí ikona.Úkol je generování nativního manifest, je tento parametr ignorován.

InputManifest

Volitelný ITaskItem parametr.

Označuje vstupní dokument XML sloužit jako základ pro generátor manifestu.To umožňuje strukturovaných dat, například zabezpečení aplikací nebo vlastní definice manifestu v manifestu výstup.Kořenový prvek dokumentu XML musí být uzlu sestavení v oboru názvů asmv1.

IsolatedComReferences

Volitelný ITaskItem[] parametr.

Určuje součásti COM v generovaný manifest izolovat.Tento parametr podporuje schopnost izolovat komponenty modelu COM pro nasazení "Registrace zdarma COM".Pracuje pomocí generování manifestu s standardní definice registrace COM.Komponenty modelu COM však musí být registrován v počítači sestavení toto fungovat správně.

ManifestType

Volitelný String parametr.

Určuje, který typ generování manifestu.Tento parametr může mít následující hodnoty:

  • Native

  • ClickOnce

Pokud není tento parametr zadán, výchozí úkol ClickOnce.

MaxTargetPath

Volitelný String parametr.

Určuje maximální povolenou délku cesty k souboru v ClickOnce nasazení aplikací.Pokud je tato hodnota zadána, délka cesty každého souboru v aplikaci se kontroluje vůči tento limit.Všechny položky, které překračují limit bude zvyšovat v sestavení upozornění.Pokud tento vstup není zadáno nebo je nula, je žádná kontrola provedena.Úkol je generování nativního manifest, je tento parametr ignorován.

OSVersion

Volitelný String parametr.

Určuje minimální požadovaný operační systém (OS) verzi aplikace vyžaduje.Například hodnota "5.1.2600.0" označuje, že je operační systém Windows XP.Pokud není tento parametr zadán, bude použita hodnota "4.10.0.0", který označuje systém Windows 98 Druhé vydání, minimální podporované OS z.NET Framework.Pokud úkol je generování nativního manifest, tento vstup je ignorována.

OutputManifest

Volitelný ITaskItem výstupní parametr.

Určuje název souboru manifestu generovaný výstup.Pokud tento parametr není zadán, je název výstupního souboru odvodit z identity generovaný manifest.

Platform

Volitelný String parametr.

Určuje platformu cílové aplikace.Tento parametr může mít následující hodnoty:

  • AnyCPU

  • x86

  • x64

  • Itanium

Pokud není tento parametr zadán, výchozí úkol AnyCPU.

Product

Volitelný String parametr.

Určuje název aplikace.Pokud tento parametr není zadán, je název odvodit z identity generovaný manifest.Tento název se používá pro název zástupce v nabídce Start a je součástí názvu, který se zobrazí v dialogovém okně Přidat nebo odebrat programy.

Publisher

Volitelný String parametr.

Určuje vydavatel aplikace.Pokud tento parametr není zadán, je název odvodit z registrovaný uživatel nebo identita generovaný manifest.Tento název se používá pro název složky v nabídce Start a je součástí názvu, který se zobrazí v dialogovém okně Přidat nebo odebrat programy.

RequiresMinimumFramework35SP1

Volitelný Boolean parametr.

Pokud hodnota true, je nutné.NET Framework 3.5 SP1 nebo novější verze.

TargetCulture

Volitelný String parametr.

Identifikuje kultury aplikace a určuje Language pole identity sestavení pro generovaný manifest.Pokud tento parametr není zadán, předpokládá se výchozí kultury je aplikace.

TargetFrameworkMoniker

Volitelný [String] parametr.

Určuje zástupný název cílového rámce.

TargetFrameworkProfile

Volitelný [String] parametr.

Určuje cílový rámec profil.

TargetFrameworkSubset

Volitelný [String] parametr.

Určuje název.NET Framework dílčí cíle.

TargetFrameworkVersion

Volitelný [String] parametr.

Určuje cíl.NET Framework projektu.

TrustInfoFile

Volitelný ITaskItem parametr.

Označuje dokument XML, který určuje zabezpečení aplikací.Kořenový prvek dokumentu XML musí být trustInfo uzlu v oboru názvů asmv2.Úkol je generování nativního manifest, je tento parametr ignorován.

UseApplicationTrust

Volitelný [Boolean] parametr.

Pokud je hodnota true, Product, Publisher, a SupportUrl vlastnosti jsou zapisovány do manifest aplikace.

Poznámky

Vedle výše uvedených parametrů, zdědí tento úkol parametry z GenerateManifest dědí třídu, která sama Task třídy.Seznam parametrů třídy úloh naleznete v tématu Základní třídy úloh.

Informace o použití GenerateDeploymentManifest úkol, viz GenerateApplicationManifest úloh.

Vstupy pro soubory a závislostí může dále upraven pomocí metadata položky určete další nasazení stát pro každou položku.

Metadata položky

Název metadat

Description

DependencyType

Označuje publikování a nainstalována aplikace nebo předpokladem závislost.Tato metadata je platný pro všechny závislosti, ale není použit pro soubory.Jsou k dispozici hodnoty pro tato metadata:

  • Install

  • Prerequisite

Výchozí hodnota je instalovat.

AssemblyType

Označuje, zda je závislost spravovaných nebo nativní sestavení.Tato metadata je platný pro všechny závislosti, ale není použit pro soubory.Jsou k dispozici hodnoty pro tato metadata:

  • Managed

  • Native

  • Unspecified

Unspecifiedvýchozí hodnotu, která označuje, že manifestu generátor automaticky určí typ sestavení.

Group

Označuje skupinu pro stahování dalších souborů na vyžádání.Název skupiny je definována aplikací a může být libovolný řetězec.Prázdný řetězec označuje, že soubor není součástí skupiny stahování, což je výchozí.Soubory není ve skupině jsou součástí původní žádost stáhnout.Soubory ve skupině jsou stahovány pouze při výslovně požadovány, pomocí aplikace System.Deployment.Application.

Tato metadata jsou platné pro všechny soubory kde IsDataFile je false a všechny závislosti kde DependencyType je Install.

TargetPath

Určuje, jak by měly být definovány cesty v generovaný manifest.Tento atribut je platné pro všechny soubory.Pokud tento atribut není určen, se používá specifikace položky.Tento atribut je platné pro všechny soubory a se závislostí DependencyType hodnotu Install.

IsDataFile

A Boolean hodnoty metadat, která označuje, zda je soubor datového souboru.Datový soubor je speciální při přenesení mezi aktualizace aplikací.Tato metadata platí pouze pro soubory.Falsevýchozí hodnotu.

Příklad

V tomto příkladu GenerateApplicationManifest úkolu generovat ClickOnce manifest aplikace a GenerateDeploymentManifest úloh ke generování manifestu nasazení aplikace s jediným sběrným.Poté použije SignFile úloh podepsat manifestů.

To dokládá nejjednodušším scénáři možné generování manifestu kde ClickOnce manifestů jsou generovány pro jeden program.Výchozí název a identity jsou odvodit od sestavení pro manifest.

[!POZNÁMKA]

V následujícím příkladu jsou předem připravené, aby se zaměřuje na aspekty generování manifestu všechny binární soubory aplikace.Tento příklad vytvoří plně funkční ClickOnce nasazení.

[!POZNÁMKA]

Další informace o Thumbprint vlastnost v SignFile úkol v tomto příkladu, viz SignFile úloh.

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

V tomto příkladu GenerateApplicationManifest a GenerateDeploymentManifest úlohy generovat ClickOnce aplikace a nasazení manifesty pro aplikace s jediným sběrným, zadáním jména a identity manifestů.

Tento příklad je podobný předchozímu příkladu kromě explicitně zadán název a identity manifestů.V tomto příkladu je také nakonfigurován jako online aplikace namísto nainstalovanou aplikaci.

[!POZNÁMKA]

V následujícím příkladu jsou předem připravené, aby se zaměřuje na aspekty generování manifestu všechny binární soubory aplikace.Tento příklad vytvoří plně funkční ClickOnce nasazení.

[!POZNÁMKA]

Další informace o Thumbprint vlastnost v SignFile úkol v tomto příkladu, viz SignFile úloh.

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

V tomto příkladu GenerateApplicationManifest a GenerateDeploymentManifest úlohy generovat ClickOnce aplikace a nasazení manifesty pro aplikace s více soubory a sestavení.

[!POZNÁMKA]

V následujícím příkladu jsou předem připravené, aby se zaměřuje na aspekty generování manifestu všechny binární soubory aplikace.Tento příklad vytvoří plně funkční ClickOnce nasazení.

[!POZNÁMKA]

Další informace o Thumbprint vlastnost v SignFile úkol v tomto příkladu, viz SignFile úloh.

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

V tomto příkladu GenerateApplicationManifest úkolu generovat nativní manifest aplikace Test.exe, odkazující na nativní součást Alpha.dll a izolované komponenty COM Bravo.dll.

Tento příklad vytvoří Test.exe.manifest, vytváření aplikaci XCOPY zaveditelné díky registraci zdarma COM.

[!POZNÁMKA]

V následujícím příkladu jsou předem připravené, aby se zaměřuje na aspekty generování manifestu všechny binární soubory aplikace.Tento příklad vytvoří plně funkční ClickOnce nasazení.

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

Viz také

Referenční dokumentace

GenerateDeploymentManifest úloh

SignFile úloh

Koncepty

Nástroj MSBuild úkoly

Další zdroje

Úloha MSBuild odkaz