Dépannage d'erreurs spécifiques lors de déploiements de ClickOnce
Cette rubrique répertorie les erreurs courantes qui peuvent se produire lorsque vous déployez une application ClickOnce et présente les étapes permettant de résoudre chaque problème.
Erreurs d'ordre général
Lorsque vous essayez de localiser un fichier .application, rien ne se produit, ou le XML effectue un rendu dans Internet Explorer, ou une boîte de dialogue Exécuter ou Enregistrer sous s'ouvre
Cette erreur est provoquée vraisemblablement par le fait que des types de contenus (également appelés types MIME) ne sont pas enregistrés correctement sur le serveur ou le client.
En premier lieu, assurez-vous que le serveur est configuré pour associer l'extension .application au type de contenu « application/x-m-application ».
Si le serveur est correctement configuré, vérifiez que le .NET Framework 2,0 est installé sur votre ordinateur. S'il est installé et que ce problème persiste, essayez de désinstaller et de réinstaller le .NET Framework 2,0 pour réinscrire le type de contenu sur le client.
Le message d'erreur indique "Impossible d'extraire l'application.Fichiers manquants dans le déploiement." ou "Le téléchargement de l'application a été interrompu, vérifiez les erreurs réseau et réessayez ultérieurement."
Ce message indique qu'un ou plusieurs fichiers référencés par les manifestes ClickOnce ne peuvent pas être téléchargés. La façon la plus simple de déboguer cette erreur consiste à essayer de télécharger l'URL que ClickOnce affirme ne pas pouvoir télécharger. Voici quelques causes possibles :
Si le fichier journal dit "(403) Interdit" ou "(404) Introuvable", vérifie 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 la section « Erreur de téléchargement lors d'une tentative d'installation d'une application ClickOnce possédant un fichier .config », plus loin dans cette rubrique.
Déterminez si cela s'est produit parce que l'URL deploymentProvider du manifeste de déploiement pointe sur un emplacement différent de l'URL utilisée pour l'activation.
Assurez-vous que tous les fichiers sont présents sur le serveur ; le journal ClickOnce doit indiquer le fichier qui n'a pas été détecté.
Recherchez les problèmes de connectivité réseau ; ce message peut s'afficher si votre ordinateur client s'est déconnecté lors du téléchargement.
Erreur de téléchargement lors d'une tentative d'installation d'une application ClickOnce possédant un fichier .config
Par défaut, une application Windows Visual Basic inclut un fichier App.config. Un problème surviendra si un utilisateur tente d'installer un serveur Web exécutant Windows Server 2003, car ce système d'exploitation bloque l'installation de fichiers .config pour des raisons de sécurité. Pour autoriser l'installation du fichier .config, cliquez sur Utiliser l'extension de fichier ".deploy" dans la boîte de dialogue Options de publication.
Vous devez également définir convenablement les types de contenus (également appelés types MIME) pour les fichiers .application, .manifest et .deploy. Pour plus d'informations, consultez la documentation du serveur Web.
Pour plus d'informations, consultez « Windows Server 2003 : types de contenus verrouillés » dans Problèmes de configuration de serveur et de client lors de déploiements ClickOnce.
Message d'erreur : "Format de l'application incorrect" ; le fichier journal contient le message "Signature XML non valide"
Vérifiez que vous avez mis à jour le fichier manifeste et que vous l'avez à nouveau signé. 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 la télécharge pas
Ce problème peut être résolu en effectuant l'une des tâches suivantes :
Vérifiez l'URL de deploymentProvider spécifiée dans le manifeste de déploiement. Assurez-vous que vous mettez à jour les bits à l'emplacement sur lequel deploymentProvider pointe.
Vérifiez l'intervalle de mise à jour défini dans le manifeste de déploiement. S'il est défini à un intervalle périodique, par exemple une fois toutes les six heures, ClickOnce ne recherche pas les mises à jour aussi longtemps que cet intervalle ne s'est pas écoulé. Vous pouvez modifier le manifeste pour rechercher les mises à jour à chaque démarrage de l'application. La modification de l'intervalle de mise à jour est une option utile au moment du développement afin de vérifier les mises à jour en cours d'installation, mais cela ralentit l'activation de l'application.
Essayez de redémarrer l'application dans le menu Démarrer. ClickOnce a pu détecter la mise à jour en arrière-plan, mais vous invitera à installer les bits lors de la prochaine activation.
Pendant la mise à jour, affichage d'une erreur contenant l'entrée du journal suivante : "La référence dans le déploiement ne correspond pas à l'identité définie dans le manifeste d'application"
Cette erreur peut se produire parce que vous avez modifié manuellement les manifestes de déploiement et d'application, et a entraîné 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 du jeton de clé publique. Examinez les descriptions d'identité dans vos manifestes et corrigez les éventuelles différences.
La première activation à parti du disque local ou CD-ROM réussit, mais l'activation suivante à 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 sur lequel l'URL pointe est correct.
Erreur : "Impossible de démarrer l'application".
Ce message d'erreur indique généralement la présence d'un problème lors de l'installation de cette application dans le magasin ClickOnce. L'application comprend une erreur ou le magasin est endommagé. Le fichier journal peut vous dire où l'erreur a eu lieu.
Vous devez effectuer les opérations suivantes :
Vérifiez que l'identité du manifeste de déploiement, l'identité du manifeste d'application et l'identité de l'application EXE principale sont toutes uniques.
Vérifiez que vos chemins d'accès ne comptent pas plus de 100 caractères. Si votre application contient des chemins d'accès qui sont trop longs, vous pouvez dépasser les limites imposées sur le chemin d'accès maximal que vous pouvez stocker. Essayez de raccourcir les chemins d'accès et recommencez l'installation.
Les paramètres PrivatePath définis dans le fichier de configuration de l'application ne sont pas respectés
Pour utiliser PrivatePath (chemins d'accès de détection de Fusion), l'application doit demander l'autorisation de confiance totale. Essayez de modifier le manifeste d'application pour demander la confiance totale et réessayez.
Pendant la désinstallation, un message indiquant "Impossible de désinstaller l'application" s'affiche
Ce message indique généralement que l'application a déjà été supprimée ou que le magasin est endommagé. Lorsque vous cliquez sur OK, l'entrée Ajout/Suppression de programmes est supprimée.
Pendant l'installation, un message apparaît indiquant que les dépendances de plateforme ne sont pas installées
Un composant requis par le GAC (Global Assembly Cache) est absent, alors que l'application en a besoin pour s'exécuter.
Publication avec Visual Studio
La publication dans Visual Studio échoue
Vérifiez que vous disposez du droit de publier sur le serveur cible. Par exemple, si vous vous connectez à un ordinateur Terminal Server en tant qu'utilisateur ordinaire, et non comme administrateur, vous ne possédez probablement pas les droits nécessaires 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.
Message d'erreur : Impossible de créer le site Web '< site >'.Les composants pour communiquer avec les extensions serveur FrontPage ne sont pas installés.
Vérifiez que le composant Microsoft Visual Studio Web Authoring Component est installé sur l'ordinateur à partir duquel vous publiez. Pour les utilisateurs de la version Express, ce composant n'est pas installé par défaut. Pour plus d'informations, consultez https://go.microsoft.com/fwlink/?LinkId=102310.
message d'erreur : N'a pas pu 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 essayez de publier une application WPF avec les styles visuels activés. Pour résoudre ce problème, consultez le Comment : publier une application WPF avec les styles visuels activés.
Utilisation de Mage
Vous avez essayé de signer à l'aide d'un certificat dans votre magasin de certificats et un message vierge s'est affiché
Dans la boîte de dialogue Signing, vous devez :
sélectionner Sign with a stored certificate, et
sélectionner un certificat dans la liste ; le premier certificat n'est pas sélectionné par défaut.
Un clic sur le bouton "Don't Sign" entraîne une exception
Il s'agit d'un bogue connu. Tous les manifestes ClickOnce doivent être signés. Choisissez simplement l'une des options de signature et cliquez sur OK.
Autres erreurs
Le tableau suivant affiche quelques messages d'erreur courants qu'un utilisateur d'ordinateur client peut recevoir lorsque l'utilisateur installe une application ClickOnce. Chaque message d'erreur est répertorié en regard d'une description de la cause la plus probable pour l'erreur.
Message d'erreur |
Description |
|---|---|
L'application ne peut pas être démarrée. Contactez l'éditeur de l'application. Impossible de démarrer l'application. Contactez le vendeur de l'application pour demander une assistance. |
Ce sont des messages d'erreur génériques qui apparaissent lorsque l'application ne peut pas être démarrée, et aucune autre raison spécifique ne peut être trouvée. Cela signifie fréquemment que l'application est endommagée d'une façon ou d'une autre, ou que le magasin ClickOnce est endommagé. |
Impossible de continuer. L'application est incorrectement mise en forme. Contactez l'éditeur de l'application pour demander une assistance. La validation de l'application a échoué. Impossible de continuer. Impossible de récupérer des fichiers d'application. Les fichiers sont endommagés dans le déploiement. |
Un des fichiers manifeste de déploiement n'est syntaxiquement pas valide ou contient un hachage qui ne peut pas être rapproché du fichier correspondant. Cette erreur peut indiquer également que le manifeste incorporé à l'intérieur d'un assembly est endommagé. Recréez votre déploiement et recompilez votre application, ou recherchez et résolvez manuellement les erreurs dans vos manifestes. |
Impossible de récupérer l'application. Erreur d'authentification. L'installation de l'application a échoué. Impossible de trouver des fichiers d'applications sur le serveur. Contactez l'éditeur de l'application ou votre administrateur pour demander une assistance. |
Un ou plusieurs fichiers dans le déploiement ne peuvent pas être téléchargés parce que vous n'avez pas l'autorisation d'y accéder. Cela peut être dû à une erreur 403 (Refusé) retournée par un serveur Web qui peut se produire si l'un des fichiers dans votre déploiement se termine par une extension afin que le serveur Web le traite comme un fichier protégé. De plus, un répertoire qui contient un ou plusieurs des fichiers d'application peut requérir un nom d'utilisateur et un mot de passe pour autoriser l'accès. |
Impossible de télécharger l'application. Des fichiers requis manquent à l'application. Contactez le vendeur de l'application ou votre administrateur système pour demander une assistance. |
Un ou plusieurs des fichiers répertoriés dans le manifeste d'application ne peuvent pas être trouvés sur le serveur. Vérifiez que vous avez téléchargé tous les fichiers dépendants du déploiement, et réessayez. |
Le téléchargement de l'application a échoué. Vérifiez votre connexion réseau ou contactez votre administrateur système ou votre fournisseur de services du réseau. |
ClickOnce ne peut pas établir de connexion réseau vers le serveur. Vérifiez la disponibilité du serveur et l'état de votre réseau. |
URLDownloadToCacheFile a échoué avec HRESULT '<numéro>'. Une erreur s'est produite lors de la tentative de téléchargement de '<fichier>'. |
Si un utilisateur a défini l'option de sécurité avancée d'Internet Explorer « Avertir en cas de changement entre mode sécurisé et non sécurisé » sur l'ordinateur cible de déploiement, et si l'URL d'installation de l'application ClickOnce qui est installée est redirigée d'un site non sécurisé à un site sécurisé (ou vice versa), l'installation échouera parce que l'avertissement Internet Explorer l'interrompra. Pour remédier à ce problème, vous pouvez effectuer l'une des opérations suivantes :
|
Une erreur a eu lieu lors de l'écriture sur le disque dur. Il se peut que l'espace disponible sur le disque soit insuffisant. Contactez le vendeur de l'application ou votre administrateur système pour demander une assistance. |
Cela peut indiquer un espace disque insuffisant pour stocker l'application, mais cela 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. Espace disponible sur le disque insuffisant. |
Le disque dur est saturé. Libérez de l'espace et essayez une nouvelle fois d'exécuter l'application. |
Un nombre trop important d'activations déployées essaient de se charger simultanément. |
ClickOnce limite le nombre d'applications différentes qui peuvent démarrer en même temps. Cette limitation sert principalement à aider à se protéger contre les tentatives malveillantes consistant à provoquer 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, à intervalles courts, obtiendront seulement une seule instance de l'application. |
Les raccourcis ne peuvent pas être activés sur le réseau. |
Les raccourcis vers une application ClickOnce peuvent être activés uniquement sur le disque dur local. Ils ne peuvent pas être activés en ouvrant une URL qui pointe sur un fichier de raccourci sur un serveur distant. |
L'application est trop grande pour être exécutée en ligne en confiance partielle. Contactez le vendeur de l'application ou votre administrateur système pour demander une assistance. |
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 de 250 Mo par défaut. |