Composants requis pour le déploiement d'applications

Pour garantir l'installation et l'exécution correctes de votre application, vous devez d'abord vous assurer que tous les composants dont dépend votre application sont déjà installés sur l'ordinateur cible.Par exemple, la plupart des applications créées à l'aide de Visual Studio ont un lien de dépendance avec le .NET Framework ; la version correcte du Common Language Runtime doit être présente sur l'ordinateur de destination avant que l'application soit installée.

Vous pouvez sélectionner ces composants requis dans la boîte de dialogue Composants requis et installer le .NET Framework et d'autres redistribuables dans le cadre de votre installation.Cette pratique est appelée amorçage.Ensuite, Visual Studio génère un programme exécutable Windows nommé Setup.exe, également appelé programme d'amorçage.Le programme d'amorçage est chargé de l'installation de ces composants requis avant l'exécution de votre application.Pour plus d'informations sur la sélection de ces composants requis, consultez Composants requis, boîte de dialogue.

Chaque composant requis est un package du programme d'amorçage.Un package de programme d'amorçage est un groupe de répertoires et de fichiers contenant des fichiers manifeste qui décrivent le mode d'installation du composant requis.Si vos composants requis d'application n'apparaissent pas dans la boîte de dialogue Composants requis, vous pouvez créer des packages de programme d'amorçage personnalisés et les ajouter à Visual Studio.Vous pouvez sélectionner ensuite les composants requis dans la boîte de dialogue Composants requis.Pour plus d'informations, consultez Création de packages de programme d'amorçage.

Par défaut, l'amorçage est activé pour le déploiement ClickOnce.Le programme d'amorçage généré pour le déploiement ClickOnce est signé.Vous pouvez désactiver l'amorçage d'un composant, mais uniquement si vous êtes certain que la version correcte du composant est déjà installée sur tous les ordinateurs cibles.

Amorçage et déploiement ClickOnce

Avant d'installer une application sur un ordinateur client, ClickOnce examine le client pour s'assurer qu'il dispose de certains composants requis spécifiés dans le manifeste d'application.et notamment :

  • la version minimale requise du Common Language Runtime, qui est spécifiée comme une dépendance d'assembly dans le manifeste d'application ;

  • la version minimale requise du système d'exploitation Windows requis par l'application, comme spécifié dans le manifeste d'application à l'aide de l'élément <osVersionInfo>(consultez <dependency>, élément (Application ClickOnce)) ;

  • la version minimale de tous les assemblys qui doivent être préinstallés dans le Global Assembly Cache, comme spécifié par les déclarations de dépendance d'assembly dans le manifeste d'assembly.

ClickOnce peut détecter des composants requis manquants, et vous pouvez installer les composants requis à l'aide d'un programme d'amorçage. Pour plus d'informations, consultez Comment : installer les composants requis avec une application ClickOnce.

[!REMARQUE]

Pour modifier les valeurs par défaut générées par des outils tels que Visual Studio et MageUI.exe, vous devez modifier le manifeste d'application dans un éditeur de texte, puis signer à nouveau les manifestes d'application et de déploiement.Pour plus d'informations, consultez Comment : signer de nouveau des manifestes d'application et de déploiement.

Si vous utilisez Visual Studio et ClickOnce pour déployer votre application, les packages de programme d'amorçage sélectionnés par défaut dépendent de la version du .NET Framework dans la solution.Toutefois, si vous modifiez la version du .NET Framework cible, vous devez mettre à jour manuellement les options dans la boîte de dialogue Composants requis.

.NET Framework cible

Packages de programme d'amorçage sélectionnés

.NET Framework 4 Client Profile

.NET Framework 4 Client Profile

Windows Installer 3.1

.NET Framework 4

.NET Framework 4

Windows Installer 3.1

Avec un déploiement ClickOnce, la page Publish.htm générée par l'Assistant Publication ClickOnce pointe vers un lien qui installe uniquement l'application ou vers un lien qui installe à la fois l'application et les composants amorcés.

Si vous générez le programme d'amorçage à l'aide de l'Assistant Publication de ClickOnce ou la fonction de publication de pages dans Visual Studio, le fichier Setup.exe est signé automatiquement.Toutefois, si vous souhaitez utiliser le certificat de votre client pour signer le programme d'amorçage, vous avez la possibilité de signer le fichier ultérieurement.Pour plus d'informations, consultez Comment : signer des fichiers d'installation avec SignTool.exe (Windows Installer).

Amorçage et MSBuild

Si vous n'utilisez pas Visual Studio, mais que vous compilez vos applications dans la ligne de commande, vous pouvez créer l'application d'amorçage ClickOnce à l'aide d'une tâche Microsoft Build Engine (MSBuild).Pour plus d'informations, consultez GenerateBootstrapper, tâche.

Comme alternative à l'amorçage, vous pouvez pré-déployer des composants à l'aide d'un système de distribution électronique de logiciels, tel que Microsoft Systems Management Server (SMS).

Arguments de ligne de commande de programme d'amorçage (Setup.exe)

Le fichier Setup.exe généré par Visual Studio et les tâches MSBuild prennent en charge l'ensemble suivant d'arguments de ligne de commande.Tout argument fourni à l'application d'amorçage en plus de ceux-ci est transféré au programme d'installation de l'application.

Si vous modifiez des options du programme d'amorçage, vous devez modifier le programme d'amorçage non signé, puis signer le fichier du programme d'amorçage ultérieurement.Pour plus d'informations, consultez Comment : signer des fichiers d'installation avec SignTool.exe (Windows Installer) ou Comment : signer des fichiers d'installation avec SignTool.exe (ClickOnce).

Argument de ligne de commande

Description

-?, -h, -help

Affiche une boîte de dialogue d'aide.

-url, -componentsurl

Montre l'URL stockée et l'URL des composants pour cette installation.

-url=location

Définit l'URL dans laquelle Setup.exe recherche l'application ClickOnce.

-componentsurl=location

Définit l'URL dans laquelle Setup.exe recherche les dépendances, par exemple le .NET Framework.

-homesite=true|false

Lorsque sa valeur est true, télécharge les dépendances à partir de l'emplacement par défaut sur le site du fournisseur.Il substitue le paramètre -componentsurl.Lorsque sa valeur est false, télécharge les dépendances à partir de l'URL spécifiée par -componentsurl.

Système d'exploitation pris en charge

Le programme d'amorçage Visual Studio n'est pas pris en charge sur les versions d'installation minimale de Windows Server 2008 ou Windows Server 2008 R2, qui fournissent un environnement serveur à faible maintenance avec des fonctionnalités limitées.Par exemple, l'option d'installation minimale prend uniquement en charge le profil d'installation minimale de .NET Framework 3.5 ; les fonctionnalités Visual Studio qui dépendent de la version complète du .NET Framework ne peuvent donc pas s'exécuter.

Voir aussi

Concepts

Choix d'une stratégie de déploiement ClickOnce

Sécurité et déploiement ClickOnce