Résoudre les erreurs spécifiques dans les déploiements ClickOnce
S’applique à : Visual Studio
Cet article présente les erreurs courantes qui peuvent se produire lorsque vous déployez l’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 inscrits 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é, case activée que .NET Framework 2.0 est installé sur votre ordinateur. Si .NET Framework 2.0 est installé et que ce problème persiste, essayez de désinstaller et de 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, case activée pour les erreurs réseau et réessayer ultérieurement »
Ce message indique qu’un ou plusieurs fichiers que la référence de manifestes 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’il 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é de sorte qu’il ne bloque pas le téléchargement de ce fichier. Pour plus d’informations, consultez Problèmes de configuration du serveur et du client dans les déploiements ClickOnce.
- Si le fichier .config est bloqué par le serveur, consultez Erreur de téléchargement lorsque vous essayez d’installer une application ClickOnce qui a un fichier .config.
- Déterminez si cette erreur s’est produite, car l’URL
deploymentProvider
dans le manifeste de déploiement pointe vers un emplacement différent de 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 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 de votre serveur Web.
Pour plus d’informations, consultez Windows Server : types de contenu verrouillés.
Erreur : La mise en forme de l’application est incorrecte. 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 au même emplacement que celui quideploymentProvider
pointe vers. - Vérifiez l’intervalle de mise à jour dans le manifeste de déploiement. Si cet intervalle est défini sur un intervalle périodique, par exemple une fois toutes les six heures, ClickOnce ne recherche pas de 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 au moment du développement pour vérifier que les mises à jour sont installées, 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.
Pendant la mise à jour, vous recevez une erreur qui contient 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 parce que vous avez modifié manuellement les manifestes de déploiement et d’application, et que vous avez provoqué la désynchronisation de la description de l’identité d’un assembly dans un manifeste 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 activation à partir d’un disque local ou d’un CD-ROM réussit, mais l’activation ultérieure à partir du menu Démarrer échoue
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 y a 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, procédez comme suit :
- Assurez-vous que l’identité du manifeste de déploiement, l’identité du manifeste d’application et l’identité de l’exe de l’application main sont toutes uniques.
- Assurez-vous que vos chemins d’accès de fichier ne dépassent pas 100 caractères. Si votre application contient des chemins d’accès trop longs, vous pouvez dépasser les limitations du 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 un programme est 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.
Publication 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 Terminal Server en tant qu’utilisateur ordinaire, et non en tant qu’administrateur, vous n’aurez probablement pas les droits requis pour publier sur le serveur Web local.
Si vous publiez avec une URL, vérifiez que les extensions serveur FrontPage sont activées sur l’ordinateur de destination.
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 les 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 :
- Sélectionnez Signer avec un certificat stocké.
- Sélectionnez un certificat dans la liste ; le premier certificat n’est pas la sélection par défaut.
Le fait de 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 d’ordinateur client 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 aucune autre raison spécifique n’est trouvée. Cela signifie souvent que l’application est endommagée ou que le magasin ClickOnce est endommagé. |
Impossible de continuer. La mise en forme de l’application est 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 dans le déploiement. |
L’un des fichiers manifeste du déploiement n’est pas 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 les erreurs manuellement 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. Pour obtenir de l’aide, contactez l’éditeur de l’application ou votre administrateur. |
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 Interdit 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 fait que le serveur Web le traite comme un 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 requis sont manquants pour l’application. 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 du téléchargement du fichier<>. | Si un utilisateur a défini l’option Sécurité avancée Explorer Internet « Avertir en cas de changement entre le mode sécurisé et le mode non sécurisé » sur l’ordinateur cible de déploiement, et si l’URL d’installation de l’application ClickOnce en cours d’installation est redirigée d’un site non sécurisé vers un site sécurisé (ou inversement), l’installation échoue car l’avertissement internet Explorer l’interrompt. Pour résoudre cette erreur, vous pouvez effectuer l’une des tâches suivantes : - Désactivez l’option de sécurité. - Assurez-vous que l’URL d’installation n’est pas redirigée de manière à modifier les modes de sécurité. - 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 peut également indiquer une erreur d’E/S plus générale lorsque vous essayez d’enregistrer les fichiers de l’application sur le lecteur. |
Impossible de démarrer l’application. L’espace disponible sur le disque est insuffisant. | Le disque dur est plein. Effacez l’espace et essayez de réexécuter l’application. |
Trop d’activations déployées tentent de se charger simultanément. | 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 tentent de démarrer la même application à plusieurs reprises, dans une succession rapide, se retrouvent 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 grande pour s’exécuter en ligne en 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 dépasser la moitié de la taille du quota d’applications en ligne, qui est par défaut de 250 Mo. |