GenerateApplicationManifest – úloha

Článek
08/25/2023

Generuje manifest aplikace ClickOnce nebo nativní manifest. Nativní manifest popisuje komponentu definováním jedinečné identity pro komponentu a identifikací všech sestavení a souborů, které tvoří komponentu. Manifest aplikace ClickOnce rozšiřuje nativní manifest tím, že označuje vstupní bod aplikace a určuje úroveň zabezpečení aplikace.

Parametry

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

Parametr	Popis
`AssemblyName`	Volitelný `String` parametr. Určuje `Name` pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadaný, název se odvodí z `EntryPoint` parametrů nebo `InputManifest` parametrů. Pokud nelze vytvořit žádný název, úloha vyvolá chybu.
`AssemblyVersion`	Volitelný `String` parametr. Určuje `Version` pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadaný, použije se výchozí hodnota 1.0.0.0.
`ClrVersion`	Volitelný `String` parametr. Určuje minimální verzi modulu CLR (Common Language Runtime), kterou aplikace vyžaduje. Výchozí hodnota je verze CLR, kterou používá systém sestavení. Pokud úloha generuje nativní manifest, bude tento parametr ignorován.
`ConfigFile`	Volitelný ITaskItem`[]` parametr. Určuje, která položka obsahuje konfigurační soubor aplikace. Pokud úloha generuje nativní manifest, bude tento parametr ignorován.
`Dependencies`	Volitelný ITaskItem`[]` parametr. Určuje seznam položek, který definuje sadu závislých sestavení pro vygenerovaný manifest. Jednotlivé položky mohou být dále popsány metadaty položek, které označují další stav nasazení a typ závislosti. Další informace najdete v tématu 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é sestavení manifestu. Pro manifest aplikace ClickOnce určuje tento parametr sestavení, které se spustí při spuštění aplikace.
`ErrorReportUrl`	Volitelný System.String parametr. Určuje adresu URL webové stránky, která se zobrazí v dialogových oknech během hlášení chyb v instalacích ClickOnce.
`FileAssociations`	Volitelný ITaskItem`[]` parametr. Určuje seznam jednoho nebo více typů souborů přidružených k manifestu nasazení ClickOnce. Přidružení souborů platí pouze v případech, kdy je cílem rozhraní .NET Framework 3.5 nebo novější.
`Files`	Volitelný ITaskItem`[]` parametr. Soubory, které se mají zahrnout do manifestu. Zadejte úplnou cestu pro každý soubor.
`HostInBrowser`	Volitelný Boolean parametr. Pokud `true`je aplikace hostovaná v prohlížeči (stejně jako aplikace webového prohlížeče WPF).
`IconFile`	Volitelný ITaskItem`[]` parametr. Označuje soubor ikony aplikace. Ikona aplikace se vyjadřuje v manifestu vygenerované aplikace a používá se pro nabídku Start a dialogové okno Přidat nebo odebrat programy . Pokud tento vstup není zadaný, použije se výchozí ikona. Pokud úloha generuje nativní manifest, bude tento parametr ignorován.
`InputManifest`	Volitelný ITaskItem parametr. Označuje vstupní dokument XML, který bude sloužit jako základ pro generátor manifestu. To umožňuje, aby se strukturovaná data, jako je zabezpečení aplikace nebo vlastní definice manifestu, projevily ve výstupním manifestu. Kořenový prvek v dokumentu XML musí být uzel sestavení v oboru názvů asmv1.
`IsolatedComReferences`	Volitelný ITaskItem`[]` parametr. Určuje komponenty modelu COM, které se mají izolovat v generovaném manifestu. Tento parametr podporuje možnost izolovat komponenty modelu COM pro nasazení modelu COM bez registrace. Funguje tak, že automaticky vygeneruje manifest se standardními definicemi registrace modelu COM. Aby to však fungovalo správně, musí být komponenty modelu COM zaregistrované na počítači sestavení.
`LauncherBasedDeployment`	Volitelný logický parametr. Nastavte tuto možnost na `True` při sestavování pro .NET Core 3.1, .NET 5 a novější verze, aby se zajistilo, že spustitelný soubor aplikace bude přejmenován na očekávaný název spustitelného souboru po sestavení spustitelného souboru apphost.exe hostitele aplikace.
`ManifestType`	Volitelný `String` parametr. Určuje, jaký typ manifestu se má vygenerovat. Tento parametr může mít následující hodnoty: - `Native` - `ClickOnce` Pokud tento parametr není zadán, je výchozí hodnota `ClickOnce`úkolu .
`MaxTargetPath`	Volitelný `String` parametr. Určuje maximální povolenou délku cesty k souboru v nasazení aplikace ClickOnce. Pokud je tato hodnota zadaná, délka každé cesty k souboru v aplikaci se kontroluje proti tomuto limitu. Všechny položky, které překročí limit, se zobrazí v upozornění sestavení. Pokud tento vstup není zadán nebo je nulový, neprovádí se žádná kontrola. Pokud úloha generuje nativní manifest, bude tento parametr ignorován.
`OSVersion`	Volitelný `String` parametr. Určuje minimální požadovanou verzi operačního systému (OS), kterou aplikace vyžaduje. Pokud tento parametr není zadaný, použije se hodnota 4.10.0.0, minimální podporovaný operační systém rozhraní .NET Framework. Pokud úloha generuje nativní manifest, tento vstup se ignoruje.
`OutputManifest`	Volitelný ITaskItem výstupní parametr. Určuje název vygenerovaného výstupního souboru manifestu. Pokud tento parametr není zadaný, název výstupního souboru se odvodí z identity vygenerovaného manifestu.
`Platform`	Volitelný `String` parametr. Určuje cílovou platformu aplikace. Tento parametr může mít následující hodnoty: - `AnyCPU` - `x86` - `x64` - `Itanium` Pokud tento parametr není zadán, je výchozí hodnota `AnyCPU`úkolu .
`Product`	Volitelný `String` parametr. Určuje název aplikace. Pokud tento parametr není zadaný, název se odvodí z identity vygenerovaného manifestu. 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 vydavatele aplikace. Pokud tento parametr není zadaný, název se odvodí od registrovaného uživatele nebo identity vygenerovaného manifestu. 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 ano, aplikace vyžaduje rozhraní .NET Framework 3.5 SP1 nebo novější verzi.
`TargetCulture`	Volitelný `String` parametr. Identifikuje jazykovou verzi aplikace a určuje `Language` pole identity sestavení pro vygenerovaný manifest. Pokud tento parametr není zadaný, předpokládá se, že aplikace je invariantní.
`TargetFrameworkMoniker`	Volitelný `String` parametr. Určuje moniker cílové architektury.
`TargetFrameworkProfile`	Volitelný `String` parametr. Určuje profil cílové architektury.
`TargetFrameworkSubset`	Volitelný `String` parametr. Určuje název podmnožině rozhraní .NET Framework, která se má cílit.
`TargetFrameworkVersion`	Volitelný `String` parametr. Určuje cílovou rozhraní .NET Framework projektu.
`TrustInfoFile`	Volitelný ITaskItem parametr. Označuje dokument XML, který určuje zabezpečení aplikace. Kořenový element v dokumentu XML musí být uzel trustInfo v oboru názvů asmv2. Pokud úloha generuje nativní manifest, bude tento parametr ignorován.
`UseApplicationTrust`	Volitelný `Boolean` parametr. Pokud je true , `ProductPublisher`a `SupportUrl` vlastnosti jsou zapsány do manifestu aplikace.

Poznámky

Kromě výše uvedených parametrů tato úloha dědí parametry z GenerateManifestBase třídy, která sama dědí z Task třídy. Seznamparametrůch

Informace o použití GenerateDeploymentManifest úlohy naleznete v tématu GenerateApplicationManifest task.

Vstupy pro závislosti a soubory mohou být dále zdobeny metadaty položek, aby bylo možné určit další stav nasazení pro každou položku.

Metadata položek

Název metadat	Popis
`DependencyType`	Určuje, jestli je závislost publikovaná a nainstalovaná s aplikací nebo požadovaným předpokladem. Tato metadata jsou platná pro všechny závislosti, ale nepoužívá se pro soubory. Dostupné hodnoty pro tato metadata jsou: - `Install` - `Prerequisite` Instalace je výchozí hodnota.
`AssemblyType`	Určuje, zda je závislost spravovaná nebo nativní sestavení. Tato metadata jsou platná pro všechny závislosti, ale nepoužívá se pro soubory. Dostupné hodnoty pro tato metadata jsou: - `Managed` - `Native` - `Unspecified` `Unspecified` je výchozí hodnota, která indikuje, že generátor manifestu určí typ sestavení automaticky.
`Group`	Označuje skupinu pro stahování dalších souborů na vyžádání. Název skupiny je definován aplikací a může to být libovolný řetězec. Prázdný řetězec označuje, že soubor není součástí skupiny stahování, což je výchozí hodnota. Soubory, které nejsou ve skupině, jsou součástí počátečního stažení aplikace. Soubory ve skupině se stáhnou pouze v případech, kdy aplikace explicitně požaduje .System.Deployment.Application Tato metadata jsou platná pro všechny soubory, kde `IsDataFile` jsou `false` a všechny závislosti, kde `DependencyType` je `Install`.
`TargetPath`	Určuje, jak má být cesta definována v vygenerovaném manifestu. Tento atribut je platný pro všechny soubory. Pokud tento atribut není zadán, použije se specifikace položky. Tento atribut je platný pro všechny soubory a závislosti s `DependencyType` hodnotou `Install`.
`IsDataFile`	`Boolean` Hodnota metadat, která označuje, jestli je soubor datovým souborem nebo ne. Datový soubor je speciální v tom, že se migruje mezi aktualizacemi aplikací. Tato metadata jsou platná pouze pro soubory. `False` je výchozí hodnota.

Příklad 1

Tento příklad používá GenerateApplicationManifest úlohu k vygenerování manifestu aplikace ClickOnce a GenerateDeploymentManifest úlohy k vygenerování manifestu nasazení pro aplikaci s jedním sestavením. Pak pomocí SignFile úlohy podepíše manifesty.

To ilustruje nejjednodušší možný scénář generování manifestu, ve kterém jsou manifesty ClickOnce generovány pro jeden program. Výchozí název a identita se odvozují ze sestavení manifestu.

Poznámka:

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

Poznámka:

Další informace o Thumbprint vlastnosti použité v SignFile úloze v tomto příkladu naleznete v tématu SignFile úloha.

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

Příklad 2

Tento příklad používá úlohy GenerateApplicationManifest k GenerateDeploymentManifest vygenerování manifestů aplikace a nasazení ClickOnce pro aplikaci s jedním sestavením a zadáním názvu a identity manifestů.

Tento příklad je podobný předchozímu příkladu s výjimkou názvu a identity manifestů, které jsou explicitně zadány. Tento příklad je také nakonfigurovaný jako online aplikace místo nainstalované aplikace.

Poznámka:

Další informace o Thumbprint vlastnosti použité v SignFile úloze v tomto příkladu naleznete v tématu SignFile úloha.

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

Příklad 3

V tomto příkladu se používají úlohy GenerateApplicationManifest a GenerateDeploymentManifest aplikace ClickOnce k vygenerování manifestů nasazení pro aplikaci s více soubory a sestaveními.

Poznámka:

Další informace o Thumbprint vlastnosti použité v SignFile úloze v tomto příkladu naleznete v tématu SignFile úloha.

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

Příklad 4

Tento příklad používá GenerateApplicationManifest úlohu k vygenerování nativní manifest pro aplikaci Test.exe odkazující na nativní komponentu Alpha.dll a izolovanou komponentu COM Bravo.dll.

Tento příklad vytvoří Test.exe.manifest, aby aplikace XCOPY nasaditelná a využila výhod Modelu COM pro registraci zdarma.

Poznámka:

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

Sdílet prostřednictvím

GenerateApplicationManifest – úloha

Parametry

Poznámky

Metadata položek

Příklad 1

Příklad 2

Příklad 3

Příklad 4

Viz také

Váš názor

Další materiály