Comment : spécifier une URL du support technique pour chaque composant requis lors d'un déploiement ClickOnce
Mise à jour : novembre 2007
Comme indiqué dans Composants requis pour le déploiement d'applications, un déploiement ClickOnce peut tester de nombreux composants requis qui doivent être disponibles sur l'ordinateur client pour l'exécution de l'application ClickOnce. Il s'agit notamment de la version minimale requise du .NET Framework, de la version du système d'exploitation, et de tous les assemblys qui doivent être préinstallés dans le Global Assembly Cache (GAC). Toutefois, ClickOnce ne peut pas installer ces composants requis lui-même ; si un composant requis est introuvable, l'installation s'arrête et une boîte de dialogue expliquant pourquoi l'installation a échoué s'affiche.
Il existe deux méthodes d'installation des composants requis. Vous pouvez, comme indiqué dans le document nommé ci-dessus, les installer à l'aide d'une application d'amorçage. Vous pouvez également spécifier une URL du support technique pour chaque composant requis, cette URL apparaissant dans la boîte de dialogue si le composant requis est introuvable. La page référencée par cette URL peut contenir des liens vers les instructions d'installation du composant requis. Si une application ne spécifie aucune URL du support technique pour un composant requis, ClickOnce affiche l'URL du support technique spécifiée dans le manifeste de déploiement pour l'application dans son ensemble, si elle est définie.
Alors que Visual Studio, Mage.exe et MageUI.exe peuvent tous être utilisés pour générer des déploiements ClickOnce, aucun de ces outils ne prend directement en charge la spécification d'une URL du support technique pour chaque composant requis. Ce document décrit comment modifier le manifeste d'application de votre déploiement pour inclure ces URL du support technique.
Spécification d'une URL du support technique pour chaque composant requis
Ouvrez le manifeste d'application de votre application ClickOnce dans un éditeur de texte.
Pour un composant requis du système d'exploitation, ajoutez l'attribut supportUrl à l'élément dependentOS :
<dependency> <dependentOS supportUrl="http://www.adatum.com/MyApplication/wrongOSFound.htm"> <osVersionInfo> <os majorVersion="4" minorVersion="0" servicePackMajor="0" servicePackMinor="0" /> </osVersionInfo> </dependentOS> </dependency>Pour le composant requis d'une certaine version du Common Language Runtime, ajoutez l'attribut supportUrl à l'entrée dependentAssembly qui spécifie la dépendance du Common Language Runtime :
<dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm"> <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="2.0.40607.0" /> </dependentAssembly> </dependency>Pour le composant requis d'un assembly qui doit être préinstallé dans le Global Assembly Cache, définissez supportUrl pour l'élément dependentAssembly qui spécifie l'assembly requis :
<dependency> <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/missingSampleGACAssembly.htm"> <assemblyIdentity name="SampleGACAssembly" version="5.0.0.0" publicKeyToken="04529dfb5da245c5" processorArchitecture="msil" language="neutral" /> </dependentAssembly> </dependency>Une fois que vous avez modifié manuellement le manifeste d'application, vous devez signer de nouveau le manifeste d'application à l'aide de votre certificat numérique, puis régénérer et signer de nouveau le manifeste de déploiement. Vous devez utiliser les outils du Kit de développement logiciel (SDK) Mage.exe ou MageUI.exe pour accomplir cette tâche, car la régénération de ces fichiers à l'aide de Visual Studio efface vos modifications manuelles. Pour plus d'informations sur l'utilisation de MageUI.exe pour signer et générer des manifestes, consultez Outil Manifest Generation and Editing (Mage.exe) et Procédure pas à pas : déploiement manuel d'une application ClickOnce.
Sécurité
L'URL du support technique n'apparaît pas dans la boîte de dialogue si l'application est marquée pour s'exécuter avec une confiance partielle.