Spécifier une URL du support technique pour chaque prérequis lors d’un déploiement ClickOnce

  • Article

Un déploiement ClickOnce peut tester un certain nombre de prérequis qui doivent être disponibles sur l’ordinateur client pour que l’application ClickOnce s’exécute. Ces dépendances incluent la version minimale requise du .NET Framework, la version du système d’exploitation et tous les assemblys qui doivent être préinstallés dans le Global Assembly Cache (GAC). Toutefois, ClickOnce ne peut pas installer l’un de ces prérequis lui-même ; si aucun prérequis n’est trouvé, il interrompt simplement l’installation et affiche une boîte de dialogue expliquant pourquoi l’installation a échoué.

Il existe deux méthodes pour installer les prérequis. Vous pouvez les installer à l’aide d’une application de programme d’amorçage. Vous pouvez également spécifier une URL d’assistance pour chaque prérequis, qui s’affiche aux utilisateurs de la boîte de dialogue si la configuration requise est introuvable. La page référencée par cette URL peut contenir des liens vers des instructions pour installer la configuration requise. Si une application ne spécifie pas d’URL d’assistance pour un prérequis individuel, ClickOnce affiche l’URL d’assistance spécifiée dans le manifeste de déploiement de l’application dans son ensemble, si elle est définie.

Bien que Visual Studio, Mage.exeet MageUI.exe puissent 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 d’assistance pour chaque prérequis. Ce document explique comment modifier le manifeste d’application et le manifeste de déploiement de votre déploiement pour inclure ces URL d’assistance.

Spécifier une URL d’assistance pour chaque prérequis

  1. Ouvrez le manifeste de l’application (fichier .manifest) pour l’application ClickOnce dans un éditeur de texte.

  2. Pour un pré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="5" minorVersion="1" buildNumber="2600" servicePackMajor="0" servicePackMinor="0" />
      </osVersionInfo>
    </dependentOS>
  </dependency>

  3. Pour un prérequis d’une certaine version du Common Language Runtime, ajoutez l’attribut supportUrl à l’entrée dependentAssembly qui spécifie la dépendance Common Language Runtime :

      <dependency>
    <dependentAssembly dependencyType="preRequisite" allowDelayedBinding="true" supportUrl=" http://www.adatum.com/MyApplication/wrongClrVersionFound.htm">
      <assemblyIdentity name="Microsoft.Windows.CommonLanguageRuntime" version="4.0.30319.0" />
    </dependentAssembly>
  </dependency>

  4. Pour un pré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>

  5. facultatif. Pour les applications qui ciblent .NET Framework 4, ouvrez le manifeste de déploiement (fichier .application) pour l’application ClickOnce dans un éditeur de texte.

  6. Pour un prérequis .NET Framework 4, ajoutez l’attribut supportUrl à l’élément compatibleFrameworks :

    <compatibleFrameworks  xmlns="urn:schemas-microsoft-com:clickonce.v2" supportUrl="http://adatum.com/MyApplication/CompatibleFrameworks.htm">
  <framework targetVersion="4.0" profile="Client" supportedRuntime="4.0.30319" />
  <framework targetVersion="4.0" profile="Full" supportedRuntime="4.0.30319" />
</compatibleFrameworks>

  7. Une fois que vous avez modifié manuellement le manifeste de l’application, vous devez signer à nouveau le manifeste de l’application à l’aide de votre certificat numérique, puis mettre à jour et signer à nouveau le manifeste de déploiement. Utilisez les outils 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 Mage.exe pour signer à nouveau des manifestes, consultez Guide pratique pour signer à nouveau des manifestes d’application et de déploiement.

sécurité du .NET Framework

L’URL d’assistance n’est pas affichée dans la boîte de dialogue si l’application est marquée pour s’exécuter dans une approbation partielle.

Contenu connexe