Partager via

Dépanner des erreurs spécifiques dans les déploiements ClickOnce

  • Article

S’applique à : Visual Studio

Cet article présente les erreurs courantes qui peuvent se produire lorsque vous déployez une application ClickOnce et fournit des étapes pour résoudre chaque problème.

Erreurs générales.

Lorsque vous essayez de localiser un fichier d’application, rien ne se produit, ou xml s’affiche dans Internet Explorer, ou vous recevez une boîte de dialogue Exécuter ou Enregistrer sous

La raison possible de cette erreur est que les types de contenu (également appelés types MIME) ne sont pas enregistrés correctement sur le serveur ou le client.

Tout d’abord, vérifiez que le serveur est configuré pour associer l’extension .application au type de contenu « application/x-ms-application ».

Si le serveur est correctement configuré, vérifiez que .NET Framework 2.0 est installé sur votre ordinateur. Si .NET Framework 2.0 est installé et que vous rencontrez toujours ce problème, essayez de désinstaller et réinstaller .NET Framework 2.0 pour réinscrire le type de contenu sur le client.

Erreur : « Impossible de récupérer l’application. Fichiers manquants dans le déploiement » ou « Le téléchargement de l’application a été interrompu, recherchez les erreurs réseau et réessayez plus tard »

Ce message indique qu’un ou plusieurs fichiers que la référence de manifeste ClickOnce ne peut pas être téléchargée. Le moyen le plus simple de déboguer cette erreur consiste à essayer de télécharger l’URL que ClickOnce indique qu’elle ne peut pas télécharger. Voici quelques causes possibles :

  • Si le fichier journal indique « (403) Interdit » ou « (404) Introuvable », vérifiez que le serveur Web est configuré afin qu’il ne bloque pas le téléchargement de ce fichier. Pour plus d’informations, consultez Problèmes de configuration de serveur et de client lors de déploiements ClickOnce.
  • Si le fichier .config est bloqué par le serveur, consultez l’erreur de téléchargement lorsque vous essayez d’installer une application ClickOnce avec un fichier .config.
  • Déterminez si cette erreur s’est produite parce que l’URL deploymentProvider du manifeste de déploiement pointe vers un autre emplacement que l’URL utilisée pour l’activation.
  • Vérifiez que tous les fichiers sont présents sur le serveur ; le journal ClickOnce doit vous indiquer quel fichier n’a pas été trouvé.
  • Vérifiez s’il existe des problèmes de connectivité réseau ; vous pouvez recevoir ce message si votre ordinateur client est passé hors connexion pendant le téléchargement.

Erreur de téléchargement lorsque vous essayez d’installer une application ClickOnce qui a un fichier .config

Par défaut, une application Windows Visual Basic inclut un fichier App.config . Vous pouvez rencontrer un problème si vous essayez d’installer à partir d’un serveur web qui utilise Windows Server 2003, car ce système d’exploitation bloque l’installation des fichiers .config pour des raisons de sécurité. Pour permettre l’installation du fichier .config , sélectionnez Utiliser l’extension de fichier . deploy » dans la boîte de dialogue Options de publication.

Vous devez également définir les types de contenu (également appelés types MIME) de manière appropriée pour les fichiers .application, .manifest et .deploy . Pour plus d’informations, consultez la documentation Web Server.

Pour plus d’informations, consultez Windows Server : types de contenu verrouillés.

Erreur : l’application est mal mise en forme ; Le fichier journal contient « La signature XML n’est pas valide »

Veillez à mettre à jour le fichier manifeste et à le signer à nouveau. Republiez votre application à l’aide de Visual Studio ou utilisez Mage pour signer à nouveau l’application.

Vous avez mis à jour votre application sur le serveur, mais le client ne télécharge pas la mise à jour

Ce problème peut être résolu en effectuant l’une des tâches suivantes :

  • Examinez l’URL deploymentProvider dans le manifeste de déploiement. Vérifiez que vous mettez à jour les bits dans le même emplacement que celui deploymentProvider vers lequel pointe.
  • Vérifiez l’intervalle de mise à jour dans le manifeste de déploiement. Si cet intervalle est défini sur un intervalle périodique, tel qu’une fois toutes les six heures, ClickOnce n’analyse pas une mise à jour tant que cet intervalle n’est pas passé. Vous pouvez modifier le manifeste pour rechercher une mise à jour chaque fois que l’application démarre. La modification de l’intervalle de mise à jour est une option pratique pendant le développement pour vérifier que les mises à jour sont en cours d’installation, mais elle ralentit l’activation de l’application.
  • Essayez de redémarrer l’application dans le menu Démarrer. ClickOnce a peut-être détecté la mise à jour en arrière-plan, mais vous invite à installer les bits lors de la prochaine activation.

Lors de la mise à jour, vous recevez une erreur contenant l’entrée de journal suivante : « La référence dans le déploiement ne correspond pas à l’identité définie dans le manifeste de l’application »

Cette erreur peut se produire, car vous avez modifié manuellement les manifestes de déploiement et d’application, et que vous avez provoqué la description de l’identité d’un assembly dans un manifeste de sorte qu’elle ne soit plus synchronisée avec l’autre. L’identité d’un assembly se compose de son nom, de sa version, de sa culture et de son jeton de clé publique. Examinez les descriptions d’identité dans vos manifestes et corrigez les différences.

La première fois que l’activation à partir d’un disque local ou d’un CD-ROM réussit, mais l’activation ultérieure à partir du menu Démarrer ne réussit pas

ClickOnce utilise l’URL du fournisseur de déploiement pour recevoir les mises à jour de l’application. Vérifiez que l’emplacement vers lequel l’URL pointe est correct.

Erreur : Impossible de démarrer l’application

Ce message d’erreur indique généralement qu’il existe un problème lors de l’installation de cette application dans le magasin ClickOnce. L’application présente une erreur ou le magasin est endommagé. Le fichier journal peut vous indiquer où l’erreur s’est produite.

Pour résoudre ce problème, effectuez les étapes suivantes :

  1. Assurez-vous que l’identité du manifeste de déploiement, l’identité du manifeste d’application et l’identité de l’application principale EXE sont toutes uniques.
  2. Assurez-vous que vos chemins d’accès aux fichiers ne dépassent pas 100 caractères. Si votre application contient des chemins d’accès de fichiers trop longs, vous pouvez dépasser les limitations sur le chemin d’accès maximal que vous pouvez stocker. Essayez de raccourcir les chemins d’accès, puis réinstallez-les.

Les paramètres PrivatePath dans le fichier de configuration de l’application ne sont pas respectés

Pour utiliser PrivatePath (chemins d’accès de détection fusion), l’application doit demander l’autorisation de confiance totale. Essayez de modifier le manifeste de l’application pour demander une confiance totale, puis réessayez.

Pendant la désinstallation, un message s’affiche indiquant « Échec de la désinstallation de l’application »

Ce message indique généralement que l’application a déjà été supprimée ou que le magasin est endommagé. Une fois que vous avez sélectionné OK, l’entrée Ajouter/Supprimer le programme sera supprimée.

Pendant l’installation, un message s’affiche indiquant que les dépendances de la plateforme ne sont pas installées

Vous ne disposez pas d’un prérequis dans le GAC (Global Assembly Cache) dont l’application a besoin pour s’exécuter.

Publier avec Visual Studio

Échec de la publication dans Visual Studio

Vérifiez que vous avez le droit de publier sur le serveur que vous ciblez. Par exemple, si vous êtes connecté à un ordinateur serveur terminal en tant qu’utilisateur ordinaire, et non en tant qu’administrateur, vous n’avez probablement pas les droits requis pour publier sur le serveur web local.

Si vous publiez avec une URL, vérifiez que l’ordinateur de destination a activé les extensions serveur FrontPage.

Erreur : Impossible de créer le site web «< site> ». Les composants permettant de communiquer avec les extensions serveur FrontPage ne sont pas installés

Vérifiez que le composant Microsoft Visual Studio Web Authoring est installé sur l’ordinateur à partir duquel vous publiez. Pour les utilisateurs Express, ce composant n’est pas installé par défaut.

Erreur : Impossible de trouver le fichier « Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32 »

Ce message d’erreur s’affiche lorsque vous tentez de publier une application WPF avec des styles visuels activés. Pour résoudre ce problème, consultez Guide pratique pour publier une application WPF avec des styles visuels activés.

Utilisation de Mage

Vous avez essayé de vous connecter avec un certificat dans votre magasin de certificats et une boîte de message vide reçue

Dans la boîte de dialogue Signature, vous devez :

  1. Sélectionnez Signer avec un certificat stocké.
  2. Sélectionnez un certificat dans la liste ; le premier certificat n’est pas la sélection par défaut.

Cliquer sur le bouton « Ne pas signer » provoque une exception

Ce problème est un bogue connu. Tous les manifestes ClickOnce doivent être signés. Sélectionnez simplement l’une des options de signature, puis sélectionnez OK.

Autres erreurs

Le tableau suivant présente certains messages d’erreur courants qu’un utilisateur client-ordinateur peut recevoir quand l’utilisateur installe une application ClickOnce. Chaque message d’erreur est répertorié en regard d’une description de la cause la plus probable de l’erreur.

Message d’erreur Description
Impossible de démarrer l’application. Contactez l’éditeur de l’application.

Impossible de démarrer l’application. Contactez le fournisseur de l’application pour obtenir de l’aide.		 Il s’agit de messages d’erreur génériques qui se produisent lorsque l’application ne peut pas être démarrée et qu’aucune autre raison spécifique n’est trouvée. Cela signifie souvent que l’application est en quelque sorte endommagée ou que le magasin ClickOnce est endommagé.
Impossible de continuer. L’application est mise en forme de manière incorrecte. Contactez l’éditeur de l’application pour obtenir de l’aide.

La validation de l’application n’a pas réussi. Impossible de continuer.

Impossible de récupérer les fichiers d'application. Fichiers endommagés lors du déploiement.		 L’un des fichiers manifeste du déploiement est syntaxiquement non valide ou contient un hachage qui ne peut pas être rapproché avec le fichier correspondant. Cette erreur peut également indiquer que le manifeste incorporé dans un assembly est endommagé. Recréez votre déploiement et recompilez votre application, ou recherchez et corrigez manuellement les erreurs dans vos manifestes.
Impossible de récupérer l’application. Erreur d’authentification.

L’installation de l’application n’a pas réussi. Impossible de localiser les fichiers d’applications sur le serveur. Contactez l’éditeur de l’application ou votre administrateur pour obtenir de l’aide.		 Un ou plusieurs fichiers du déploiement ne peuvent pas être téléchargés, car vous n’êtes pas autorisé à y accéder. Cela peut être dû à une erreur 403 Forbidden retournée par un serveur Web, qui peut se produire si l’un des fichiers de votre déploiement se termine par une extension, qui entraîne son traitement par le serveur Web en tant que fichier protégé. En outre, un répertoire qui contient un ou plusieurs fichiers de l’application peut nécessiter un nom d’utilisateur et un mot de passe pour y accéder.
Impossible de télécharger l’application. Les fichiers obligatoires de l’application manquent. Pour obtenir de l’aide, contactez le fournisseur de l’application ou votre administrateur système. Un ou plusieurs des fichiers répertoriés dans le manifeste de l’application sont introuvables sur le serveur. Vérifiez que vous avez chargé tous les fichiers dépendants du déploiement, puis réessayez.
Le téléchargement de l’application n’a pas réussi. Vérifiez votre connexion réseau ou contactez votre administrateur système ou votre fournisseur de services réseau. ClickOnce ne peut pas établir une connexion réseau au serveur. Examinez la disponibilité du serveur et l’état de votre réseau.
URLDownloadToCacheFile a échoué avec HRESULT « <number> ». Une erreur s'est produite lors de la tentative de téléchargement de « <fichier> ». Si un utilisateur a défini l’option Sécurité avancée d’Internet Explorer « Avertir en cas de changement entre le mode sécurisé et non sécurisé » sur l’ordinateur cible de déploiement, et si l’URL d’installation de l’application ClickOnce installée est redirigée d’un site non sécurisé (ou vice versa), l’installation échoue car l’avertissement Internet Explorer l’interrompt.

Pour résoudre cette erreur, vous pouvez effectuer l’une des opérations suivantes :

- Effacez l’option de sécurité.
- Vérifiez que l’URL de configuration n’est pas redirigée de telle manière que les modes de sécurité changent.
- Supprimez complètement la redirection et pointez vers l’URL d’installation réelle.
Une erreur s’est produite lors de l’écriture sur le disque dur. L’espace disponible sur le disque peut être insuffisant. Pour obtenir de l’aide, contactez le fournisseur de l’application ou votre administrateur système. Cela peut indiquer un espace disque insuffisant pour le stockage de l’application, mais il peut également indiquer une erreur d’E/S plus générale lorsque vous essayez d’enregistrer les fichiers d’application sur le lecteur.
Impossible de démarrer l’application. L’espace disponible sur le disque est insuffisant. Le disque est plein. Effacez l’espace et réessayez d’exécuter l’application.
Trop d’activations déployées tentent de se charger à la fois. ClickOnce limite le nombre d’applications différentes qui peuvent démarrer en même temps. Cela permet en grande partie de se protéger contre les tentatives malveillantes d’incitation à des attaques par déni de service contre le service ClickOnce local ; les utilisateurs qui essaient de démarrer la même application à plusieurs reprises, dans une succession rapide, ne se retrouveront qu’avec une seule instance de l’application.
Les raccourcis ne peuvent pas être activés sur le réseau. Les raccourcis vers une application ClickOnce ne peuvent être démarrés que sur le disque dur local. Ils ne peuvent pas être démarrés en ouvrant une URL qui pointe vers un fichier de raccourcis sur un serveur distant.
L’application est trop volumineuse pour s’exécuter en ligne avec une confiance partielle. Pour obtenir de l’aide, contactez le fournisseur de l’application ou votre administrateur système. Une application qui s’exécute en confiance partielle ne peut pas être supérieure à la moitié de la taille du quota d’application en ligne, qui est par défaut de 250 Mo.

References