Tâche de génération de manifeste d'application

Génère un manifeste d’application ClickOnce ou un manifeste natif. Un manifeste natif décrit un composant en définissant une identité unique pour le composant et en identifiant tous les assemblys et fichiers qui composent le composant. Un manifeste d’application ClickOnce étend un manifeste natif en indiquant le point d’entrée de l’application et en spécifiant le niveau de sécurité de l’application.

Parameters

Le tableau suivant décrit les paramètres de la GenerateApplicationManifest tâche.

Paramètre	Description
`AssemblyName`	Paramètre facultatif `String` . Spécifie le `Name` champ de l’identité d’assembly pour le manifeste généré. Si ce paramètre n’est pas spécifié, le nom est déduit du ou `InputManifest` des `EntryPoint` paramètres. Si aucun nom ne peut être créé, la tâche génère une erreur.
`AssemblyVersion`	Paramètre facultatif `String` . Spécifie le `Version` champ de l’identité d’assembly pour le manifeste généré. Si ce paramètre n’est pas spécifié, une valeur par défaut de « 1.0.0.0 » est utilisée.
`ClrVersion`	Paramètre facultatif `String` . Spécifie la version minimale du Common Language Runtime (CLR) requis par l’application. La valeur par défaut est la version CLR utilisée par le système de build. Si la tâche génère un manifeste natif, ce paramètre est ignoré.
`ConfigFile`	Paramètre facultatif ITaskItem`[]` . Spécifie l’élément qui contient le fichier de configuration de l’application. Si la tâche génère un manifeste natif, ce paramètre est ignoré.
`Dependencies`	Paramètre facultatif ITaskItem`[]` . Spécifie une liste d’éléments qui définit l’ensemble d’assemblys dépendants pour le manifeste généré. Chaque élément peut être décrit plus en détail par les métadonnées d’élément pour indiquer un état de déploiement supplémentaire et le type de dépendance. Pour plus d’informations, consultez métadonnées d’élément.
`Description`	Paramètre facultatif `String` . Spécifie la description de l’application ou du composant.
`EntryPoint`	Paramètre facultatif ITaskItem`[]` . Spécifie un élément unique qui indique le point d’entrée de l’assembly de manifeste généré. Pour un manifeste d’application ClickOnce, ce paramètre spécifie l’assembly qui démarre lors de l’exécution de l’application.
`ErrorReportUrl`	Paramètre facultatif System.String . Spécifie l’URL de la page web affichée dans les boîtes de dialogue pendant les rapports d’erreurs dans les installations ClickOnce.
`FileAssociations`	Paramètre facultatif ITaskItem`[]` . Spécifie une liste d’un ou plusieurs types de fichiers associés au manifeste de déploiement ClickOnce. Les associations de fichiers ne sont valides que lorsque .NET Framework 3.5 ou version ultérieure est ciblée.
`Files`	Paramètre facultatif ITaskItem`[]` . Fichiers à inclure dans le manifeste. Spécifiez le chemin complet de chaque fichier.
`HostInBrowser`	Paramètre facultatif Boolean . Si`true`, l’application est hébergée dans un navigateur (comme WPF applications de navigateur web).
`IconFile`	Paramètre facultatif ITaskItem`[]` . Indique le fichier d’icône d’application. L’icône d’application est exprimée dans le manifeste d’application généré et est utilisée pour le menu Démarrer et la boîte de dialogue Ajouter/supprimer des programmes . Si cette entrée n’est pas spécifiée, une icône par défaut est utilisée. Si la tâche génère un manifeste natif, ce paramètre est ignoré.
`InputManifest`	Paramètre facultatif ITaskItem . Indique un document XML d’entrée à servir de base pour le générateur de manifeste. Cela permet aux données structurées telles que la sécurité des applications ou les définitions de manifeste personnalisées d’être reflétées dans le manifeste de sortie. L’élément racine du document XML doit être un nœud d’assembly dans l’espace de noms asmv1.
`IsolatedComReferences`	Paramètre facultatif ITaskItem`[]` . Spécifie les composants COM à isoler dans le manifeste généré. Ce paramètre prend en charge la possibilité d’isoler les composants COM pour le déploiement « COM gratuit d’inscription ». Il fonctionne en générant automatiquement un manifeste avec des définitions d’inscription COM standard. Toutefois, les composants COM doivent être inscrits sur l’ordinateur de build pour que cela fonctionne correctement.
`LauncherBasedDeployment`	Paramètre booléen facultatif. Définissez cette valeur `True` lors de la génération de .NET Core 3.1, .NET 5 et versions ultérieures pour vous assurer que l’exécutable de l’application est renommé en nom exécutable attendu après avoir généré l’exécutable hôte de l’application apphost.exe.
`ManifestType`	Paramètre facultatif `String` . Spécifie le type de manifeste à générer. Ce paramètre peut prendre les valeurs suivantes : - `Native` - `ClickOnce` Si ce paramètre n’est pas spécifié, la tâche est définie par défaut `ClickOnce`sur .
`MaxTargetPath`	Paramètre facultatif `String` . Spécifie la longueur maximale autorisée d’un chemin d’accès de fichier dans un déploiement d’application ClickOnce. Si cette valeur est spécifiée, la longueur de chaque chemin d’accès de fichier dans l’application est vérifiée par rapport à cette limite. Tous les éléments qui dépassent la limite augmenteront dans un avertissement de build. Si cette entrée n’est pas spécifiée ou est égale à zéro, aucune vérification n’est effectuée. Si la tâche génère un manifeste natif, ce paramètre est ignoré.
`OSVersion`	Paramètre facultatif `String` . Spécifie la version minimale requise du système d’exploitation requis par l’application. Si ce paramètre n’est pas spécifié, la valeur « 4.10.0.0 » est utilisée, le système d’exploitation minimum pris en charge du .NET Framework. Si la tâche génère un manifeste natif, cette entrée est ignorée.
`OutputManifest`	Paramètre de sortie facultatif ITaskItem . Spécifie le nom du fichier manifeste de sortie généré. Si ce paramètre n’est pas spécifié, le nom du fichier de sortie est déduit de l’identité du manifeste généré.
`Platform`	Paramètre facultatif `String` . Spécifie la plateforme cible de l’application. Ce paramètre peut prendre les valeurs suivantes : - `AnyCPU` - `x86` - `x64` - `Itanium` Si ce paramètre n’est pas spécifié, la tâche est définie par défaut `AnyCPU`sur .
`Product`	Paramètre facultatif `String` . Spécifie le nom de l'application. Si ce paramètre n’est pas spécifié, le nom est déduit de l’identité du manifeste généré. Ce nom est utilisé pour le nom de raccourci dans le menu Démarrer et fait partie du nom qui apparaît dans la boîte de dialogue Ajouter ou supprimer des programmes .
`Publisher`	Paramètre facultatif `String` . Spécifie l’éditeur de l’application. Si ce paramètre n’est pas spécifié, le nom est déduit de l’utilisateur inscrit ou de l’identité du manifeste généré. Ce nom est utilisé pour le nom du dossier dans le menu Démarrer et fait partie du nom qui apparaît dans la boîte de dialogue Ajouter ou supprimer des programmes .
`RequiresMinimumFramework35SP1`	Paramètre facultatif `Boolean` . Si la valeur est true, l’application nécessite l'.NET Framework 3.5 SP1 ou une version plus récente.
`TargetCulture`	Paramètre facultatif `String` . Identifie la culture de l’application et spécifie le `Language` champ de l’identité d’assembly pour le manifeste généré. Si ce paramètre n’est pas spécifié, il est supposé que l’application est invariante de culture.
`TargetFrameworkMoniker`	Paramètre facultatif `String` . Spécifie le moniker de framework cible.
`TargetFrameworkProfile`	Paramètre facultatif `String` . Spécifie le profil de framework cible.
`TargetFrameworkSubset`	Paramètre facultatif `String` . Spécifie le nom du sous-ensemble .NET Framework à cibler.
`TargetFrameworkVersion`	Paramètre facultatif `String` . Spécifie le .NET Framework cible du projet.
`TrustInfoFile`	Paramètre facultatif ITaskItem . Indique un document XML qui spécifie la sécurité de l’application. L’élément racine du document XML doit être un nœud trustInfo dans l’espace de noms asmv2. Si la tâche génère un manifeste natif, ce paramètre est ignoré.
`UseApplicationTrust`	Paramètre facultatif `Boolean` . Si la valeur est true, les propriétés et `SupportUrl` les `ProductPublisher`propriétés sont écrites dans le manifeste de l’application.

Remarques

Outre les paramètres répertoriés ci-dessus, cette tâche hérite des paramètres de la GenerateManifestBase classe, qui lui-même hérite de la Task classe. Pour obtenir la liste des paramètres de la classe Task, consultez la classe de base de tâches.

Pour plus d’informations sur l’utilisation de la GenerateDeploymentManifest tâche, consultez la tâche GenerateApplicationManifest.

Les entrées des dépendances et des fichiers peuvent être décorées avec des métadonnées d’élément pour spécifier un état de déploiement supplémentaire pour chaque élément.

Métadonnées de l’élément

Nom des métadonnées	Description
`DependencyType`	Indique si la dépendance est publiée et installée avec l’application ou une condition préalable. Ces métadonnées sont valides pour toutes les dépendances, mais elles ne sont pas utilisées pour les fichiers. Les valeurs disponibles pour ces métadonnées sont les suivantes : - `Install` - `Prerequisite` L’installation est la valeur par défaut.
`AssemblyType`	Indique si la dépendance est un assembly managé ou natif. Ces métadonnées sont valides pour toutes les dépendances, mais elles ne sont pas utilisées pour les fichiers. Les valeurs disponibles pour ces métadonnées sont les suivantes : - `Managed` - `Native` - `Unspecified` `Unspecified` est la valeur par défaut, qui indique que le générateur de manifeste détermine automatiquement le type d’assembly.
`Group`	Indique le groupe pour télécharger des fichiers supplémentaires à la demande. Le nom du groupe est défini par l’application et peut être n’importe quelle chaîne. Une chaîne vide indique que le fichier ne fait pas partie d’un groupe de téléchargement, qui est la valeur par défaut. Les fichiers qui ne se trouvent pas dans un groupe font partie du téléchargement initial de l’application. Les fichiers d’un groupe sont téléchargés uniquement lorsqu’ils sont explicitement demandés par l’application à l’aide <xref:System.Deployment.Application>de . Ces métadonnées sont valides pour tous les fichiers où `IsDataFile` se `false` trouve et toutes les dépendances où `DependencyType` se trouve `Install`.
`TargetPath`	Spécifie la façon dont le chemin d’accès doit être défini dans le manifeste généré. Cet attribut est valide pour tous les fichiers. Si cet attribut n’est pas spécifié, la spécification de l’élément est utilisée. Cet attribut est valide pour tous les fichiers et dépendances avec une `DependencyType` valeur de `Install`.
`IsDataFile`	Valeur `Boolean` de métadonnées qui indique si le fichier est ou non un fichier de données. Un fichier de données est spécial dans le fait qu’il est migré entre les mises à jour d’application. Ces métadonnées sont valides uniquement pour les fichiers. `False` est la valeur par défaut.

Exemple 1 :

Cet exemple utilise la GenerateApplicationManifest tâche pour générer un manifeste d’application ClickOnce et la GenerateDeploymentManifest tâche pour générer un manifeste de déploiement pour une application avec un seul assembly. Il utilise ensuite la SignFile tâche pour signer les manifestes.

Cela illustre le scénario de génération de manifeste le plus simple où les manifestes ClickOnce sont générés pour un seul programme. Un nom et une identité par défaut sont déduits de l’assembly pour le manifeste.

Note

Dans l’exemple ci-dessous, tous les fichiers binaires d’application sont prédéfinis pour se concentrer sur les aspects de génération de manifeste. Cet exemple produit un déploiement ClickOnce entièrement opérationnel.

Note

Pour plus d’informations sur la Thumbprint propriété utilisée dans la SignFile tâche dans cet exemple, consultez la tâche SignFile.

<Project DefaultTargets="Build">

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

Exemple 2

Cet exemple utilise les tâches et GenerateDeploymentManifest les tâches pour générer des GenerateApplicationManifest manifestes d’application et de déploiement ClickOnce pour une application avec un seul assembly, en spécifiant le nom et l’identité des manifestes.

Cet exemple est similaire à l’exemple précédent, à l’exception du nom et de l’identité des manifestes spécifiés explicitement. En outre, cet exemple est configuré en tant qu’application en ligne au lieu d’une application installée.

Note

Pour plus d’informations sur la Thumbprint propriété utilisée dans la SignFile tâche dans cet exemple, consultez la tâche SignFile.

<Project DefaultTargets="Build">

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

Exemple 3

Note

Pour plus d’informations sur la Thumbprint propriété utilisée dans la SignFile tâche dans cet exemple, consultez la tâche SignFile.

<Project DefaultTargets="Build">

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

Exemple 4

Cet exemple utilise la GenerateApplicationManifest tâche pour générer un manifeste natif pour l’applicationTest.exe, référencer desAlpha.dll de composants natifs et un composant COM isolé Bravo.dll.

Cet exemple produit le Test.exe.manifest, ce qui rend l’application XCOPY déployable et tire parti de l’inscription com gratuite.

Note

<Project DefaultTargets="Build">

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

Voir aussi

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2026-08-28

Tâche de génération de manifeste d'application

Parameters

Remarques

Métadonnées de l’élément

Exemple 1 :

Exemple 2

Exemple 3

Exemple 4

Voir aussi

Commentaires

Ressources supplémentaires