Résoudre les problèmes de déploiement de solution Office
S’applique à : Visual Studio
Cet article explique comment résoudre les problèmes courants que vous pouvez rencontrer lorsque vous déployez des solutions Office.
Les informations contenues dans cet article s’appliquent aux projets au niveau du document et aux projets de complément Visual Studio Tools pour Office (VSTO). Consultez les caractéristiques disponibles par application Office et par type de projet.
Résoudre les problèmes liés aux solutions Office à l’aide de l’observateur d’événements
Vous pouvez utiliser l’observateur d’événements dans Windows pour afficher les messages d’erreur capturés par le runtime Visual Studio Tools pour Office lorsque vous installez ou désinstallez des solutions Office. Vous pouvez utiliser ces messages à partir du journal d’événements pour résoudre les problèmes d’installation et de déploiement. Pour plus d’informations, consultez journalisation des événements pour les solutions Office.
Modifier le nom de l’assembly provoque des conflits
Si vous modifiez la valeur nom de l’assembly dans la page Application du Concepteur de projets après avoir déjà déployé une solution, les outils de publication modifient le package d’installation pour avoir un fichier Setup.exe et deux manifestes de déploiement. Si vous déployez deux fichiers manifeste, les conditions suivantes peuvent se produire :
- Si l’utilisateur final installe les deux versions, l’application charge les deux compléments VSTO.
- Si le complément VSTO a été installé avant que le nom de l’assembly ait été modifié, l’utilisateur final ne recevra jamais des mises à jour.
Pour éviter ces conditions, ne modifiez pas la valeur nom de l’assembly de la solution après le déploiement de la solution.
La vérification des mises à jour prend beaucoup de temps
Visual Studio 2010 Tools pour Office runtime fournit une entrée de Registre que les administrateurs peuvent utiliser pour définir la valeur de délai d’attente pour télécharger les manifestes et la solution.
Comment définir la valeur de délai d’attente
Dans le Registre, accédez à la clé suivante :
HKEY_CURRENT_USER\Software\Microsoft\VSTA
Dans la sous-clé AddInTimeout , définissez la valeur du délai d’attente en millisecondes.
Si la sous-clé AddInTimeout n’existe pas, créez-la comme valeur DWORD.
Impossible de mettre à jour ou de publier sur un partage de fichiers réseau
Les solutions Office qui se trouvent sur un partage de fichiers réseau peuvent afficher un message trompeur pendant les mises à jour si le fichier Setup.exe de la solution est verrouillé dans un processus pendant la publication de la mise à jour. Le message suivant peut s’afficher : « Impossible d’ajouter 'setup.exe' au site web. Le fichier 'setup.exe' existe déjà dans le site web. »
Pour empêcher le verrouillage du fichier, vous pouvez activer le partage en lecture seule pour les utilisateurs finaux. Toutefois, si des documents se trouvent sur le partage, ils deviendront également en lecture seule pour les utilisateurs finaux.
Les prérequis pour Microsoft Office ne sont pas installés
Vous pouvez ajouter le .NET Framework, le runtime Visual Studio Tools pour Office et les assemblys d’interopérabilité principaux Office à votre package d’installation en tant que prérequis déployés avec votre solution Office. Pour plus d’informations sur l’installation des assemblys d’interopérabilité principaux, consultez Configurer un ordinateur pour développer des solutions Office et comment : installer des assemblys d’interopérabilité principal Office.
La publication à l’aide de Localhost peut entraîner des problèmes d’installation
Lorsque vous utilisez http://localhost l’emplacement de publication ou d’installation pour les solutions au niveau du document, l’Assistant Publication ne convertit pas la chaîne en nom d’ordinateur réel. Dans ce cas, la solution doit être installée sur l’ordinateur de développement. Pour que des solutions déployées utilisent IIS sur l’ordinateur de développement, utilisez le nom complet pour tous les emplacements HTTP/HTTPS/FTP au lieu de localhost.
Les assemblys mis en cache sont chargés au lieu d’assemblys mis à jour
Fusion, le chargeur d’assembly .Net Framework, charge la copie mise en cache des assemblys lorsque le chemin de sortie du projet est sur un partage de fichiers réseau, que l’assembly est signé avec un nom fort et que la version d’assembly de la personnalisation ne change pas. Si vous mettez à jour un assembly qui satisfait ces conditions, la mise à jour ne s’affiche pas lors de la prochaine exécution du projet, car la copie mise en cache est chargée.
Vous pouvez configurer Visual Studio pour que Fusion télécharge les assemblys chaque fois que le projet est exécuté.
Comment télécharger des assemblys au lieu de charger des copies mises en cache
- Dans la barre de menus, sélectionnez Project,< ProjectName> Properties.
- Dans la page Application , sélectionnez Informations d’assembly.
- Définissez le numéro de révision, le troisième champ, de la version de l’assembly, sur un caractère générique (*). Par exemple, « 1.0.* ». Sélectionnez ensuite le bouton OK.
Après avoir modifié la version d’assembly, vous pouvez continuer à signer votre assembly avec un nom fort, et Fusion chargera la version de la personnalisation.
Note
À compter de Visual Studio 2017, si vous essayez d’utiliser des caractères génériques dans la version de l’assembly, une erreur de génération se produit. Cela est dû au fait que les caractères génériques dans la version de l’assembly interrompent la fonctionnalité déterministe MSBuild. Vous serez invité à supprimer les caractères génériques de la version de l’assembly ou à désactiver le déterminisme. Pour en savoir plus sur la fonctionnalité déterministe, consultez : Propriétés courantes du projet MSBuild et Personnaliser votre build
L’installation échoue lorsque l’URI comporte des caractères qui ne sont pas US-ASCII
Lorsque vous publiez une solution Office sur un emplacement HTTP/HTTPS/FTP, le chemin d’accès ne peut contenir aucun caractère Unicode qui ne sont pas en US-ASCII. Ces caractères peuvent provoquer un comportement anormal dans le programme d’installation. Utilisez des caractères US-ASCII pour le chemin d’installation.
L’invite de désinstallation manuelle s’affiche lorsque vous publiez et installez une solution sur l’ordinateur de développement
Lorsque vous générez une solution Office, la version créée est inscrite automatiquement. Si vous avez déjà publié et installé la même solution sur votre ordinateur de développement, Visual Studio Tools pour Office runtime détecte que le chemin d’installation de la version publiée et la version générée sont différents une fois la solution générée, reconstruite ou publiée. Le message d’erreur indique « la personnalisation ne peut pas être installée, car une autre version est actuellement installée et ne peut pas être mise à niveau à partir de cet emplacement ». Les clés de Registre sont mises à jour chaque fois qu’une solution est reconstruite. Par conséquent, vous devez désinstaller la version précédente avant de publier, de déboguer ou d’exécuter la nouvelle version.
Pour empêcher l’affichage de ce message, créez un autre compte d’utilisateur sur votre ordinateur de développement pour tester votre déploiement. Vous pouvez également désinstaller la version de la liste des programmes installés sur l’ordinateur avant de publier, de déboguer ou de régénérer ensuite la solution.
Exception ou méthode non détectée lors de l’installation d’une solution
Lorsque vous installez des solutions Office en ouvrant le manifeste de déploiement (fichier .vsto), application Office lication, document ou classeur, les messages d’erreur pour les conditions suivantes peuvent apparaître :
- Méthode introuvable.
- MissingMethodException.
- Exception non interceptée.
Pour que ces messages d’erreur ne s’affichent pas, installez la solution en exécutant le programme d’installation.
Lorsque vous installez la solution sans exécuter le programme d’installation, celui-ci ne recherche pas ou n’installe pas les composants requis. Le programme d’installation vérifie si la version des composants requis est correcte et les installe si nécessaire.
Clés de Registre de manifeste pour les compléments modifiées après la génération d’un projet InstallShield Limited Edition
La clé de Registre du manifeste qui fait partie d’un programme d’installation du complément VSTO passe parfois de .vsto à .dll.manifest lorsque vous générez un projet InstallShield Limited Edition.
Pour contourner ce problème, créez le projet InstallShield Limited Edition dans une autre solution ou utilisez CompanyName.AddinName comme valeur de la clé de Registre qui contient le nom du complément VSTO.
Le programme d’installation ClickOnce pour votre solution Office n’installe pas les assemblys d’interopérabilité principaux
Lorsque vous exécutez le programme d’installation que ClickOnce crée pour votre solution Office, le programme d’installation des assemblys PIA (Primary Interop Assemblies) Office s’exécute uniquement si aucun assembly PIA n’est déjà installé.
Si le programme d’installation n’installe pas correctement les informations d’identification personnelle, installez-les manuellement en exécutant le fichier d’installation nommé o2007pia.msi à partir du répertoire d’installation.
Réinstaller des solutions Office provoque une exception hors plage d’arguments
Lorsque vous réinstallez une solution Office, une exception ArgumentOutOfRangeException peut s’afficher avec le message d’erreur suivant : « L’argument spécifié n’était pas dans les limites de la plage des valeurs valides. »
Cette situation se produit si la casse de l’URL de l’emplacement d’installation est différente. Par exemple, cette erreur s’affiche si vous avez installé une solution Office à partir de http://fabrikam.com/ExcelSolution.vsto la première fois, puis utilisé http://fabrikam.com/excelsolution.vsto la deuxième fois.
Pour empêcher l’affichage de ce message, utilisez la même casse lorsque vous installez des solutions Office.
Impossible d’installer une solution ClickOnce en ouvrant le manifeste de déploiement à partir du web
Les utilisateurs peuvent installer des solutions Office en ouvrant le manifeste de déploiement à partir du web. Toutefois, certaines installations d’Internet Information Services (IIS) bloquent l’extension de nom de fichier .vsto . Vous devez définir le type MIME dans IIS avant de l’utiliser pour déployer une solution Office.
Pour plus d’informations sur la définition du type MIME dans IIS 7, consultez Ajouter un type MIME (IIS7).
Définissez l’extension sur .vsto et le type MIME sur application/x-ms-vsto.