Composants requis pour le déploiement d'applications

Mise à jour : novembre 2007

Pour garantir l'installation et l'exécution de votre application, vous devez d'abord vous assurez que tous les composants dont dépend votre application sont déjà installés sur l'ordinateur de destination. 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.

Détection de la plateforme pour 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. Ces composants sont les suivants :

  • 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 les composants requis manquants, mais ne peut pas les installer. Si l'une de ces dépendances de plateforme s'avère manquante, ClickOnce arrête l'installation et présente une boîte de dialogue d'erreur à l'utilisateur.

Remarque :

Il n'existe aucune prise en charge d'outil pour la définition de versions spécifiques du .NET Framework et du système d'exploitation dans le manifeste. 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 de nouveau signer les manifestes d'application et de déploiement.

Amorçage des applications ClickOnce

Les composants requis manquants doivent être installés à l'aide de packages redistribuables distincts. Les outils de déploiement dans Visual Studio vous permettent d'installer le .NET Framework et d'autres redistribuables dans le cadre de votre installation ; cette procédure est appelée bootstrapping.

Visual Studio inclut les packages déployables suivants :

  • .NET Framework version 2.0 

  • Microsoft Data Access Components (MDAC) 2.8

  • Microsoft Visual J# .NET Framework Redistributable Package 3.1

  • SQL Server 2005 Express Edition

  • Windows Installer 2.0

Par défaut, l'amorçage est activé pour un déploiement Windows Installer ou un déploiement ClickOnce. 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.

Lorsque vous déployez une application ClickOnce à l'aide de Visual Studio, l'environnement de développement vous demandera si vous souhaitez inclure certains redistribuables, tels que le .NET Framework, comme dépendances. Si vous sélectionnez une ou plusieurs de ces options, Visual Studio génère un programme exécutable Windows appelé Setup.exe (le « programme d'amorçage »), chargé d'installer ces dépendances avant l'exécution de votre application. Ce programme d'amorçage s'exécute en tant que processus distinct indépendant du moteur runtime ClickOnce.

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 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). Il s'agit des mêmes tâches de génération que celles qui sont utilisées par Visual Studio pour générer l'application d'amorçage. Pour plus d'informations, consultez GenerateBootstrapper, tâche. Pour plus d'informations sur l'utilisation de MSBuild pour compiler des projets, consultez Vue d'ensemble de MSBuild.

Lors de l'installation, les utilisateurs de certains systèmes d'exploitation Windows peuvent être invités pour des autorisations administratives à exécuter les redistribuables, même si ils sont déjà installés.

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 la ligne de commande de l'application 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.

  • -?, -h, -help
    Affiche une boîte de dialogue d'aide.

  • -url, -componentsurl
    Montre l'URL stockée et -componentsurl 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.

Voir aussi

Concepts

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

Vue d'ensemble du déploiement ClickOnce

Vue d'ensemble de MSBuild