Partage via

Désinstaller des compléments en cours de développement

  • Article

Les compléments supprimés de manière incomplète peuvent laisser des artefacts sur votre ordinateur, tels que des boutons de ruban personnalisés ou des entrées de Registre, pendant le développement. Dans cet article, nous appelons ces « compléments fantômes ».

Les compléments Outlook peuvent également ajouter ces artefacts à d’autres ordinateurs lorsque vous vous connectez à Outlook sur ceux-ci avec le même ID que celui utilisé pour développer le complément.

Importante

Lorsque vous vous connectez à Outlook, il télécharge à partir d’Exchange et charge une version test tous les manifestes de complément Outlook associés à votre ID, y compris les compléments que vous développez sur un autre ordinateur utilisant le même ID. Par exemple, tous les boutons de ruban personnalisés définis dans le manifeste s’affichent pour le complément.

Si les URL du manifeste pointent vers un serveur non localhost et que ce serveur est en cours d’exécution et accessible à l’ordinateur non-développement, Outlook met en cache les fichiers du complément dans le système de fichiers local et le complément s’exécute généralement normalement sur l’ordinateur. Sinon, le complément ne fonctionne pas, mais des parties visibles de celui-ci, telles que des boutons de ruban personnalisés, s’affichent. Les étiquettes sont définies dans le manifeste. Les icônes de bouton du complément apparaissent également si elles ont été mises en cache localement sur l’ordinateur non-développement et que le cache n’a jamais été effacé. Les fichiers d’icône ne sont pas stockés avec Exchange. Par conséquent, s’ils n’ont jamais été mis en cache sur l’ordinateur non-développement (ou si le cache a été effacé), les boutons ont des icônes par défaut.

Tant que l’inscription du complément n’est pas supprimée d’Exchange, le complément continue à apparaître. Pour plus d’informations sur la suppression de l’inscription dans Exchange, consultez Supprimer un complément fantôme .

Cet article fournit des conseils pour réduire le risque de ces problèmes et les résoudre s’ils se produisent.

Éviter les problèmes

Lorsqu’un complément est chargé de manière indépendante, plusieurs choses se produisent :

  • Un serveur web, généralement sur localhost, est démarré pour servir les fichiers du complément (tels que les fichiers HTML, CSS et JavaScript).
  • Ces mêmes fichiers sont mis en cache sur votre ordinateur de développement.
  • Le complément est inscrit auprès de l’ordinateur de développement. L’inscription s’effectue avec des entrées de Registre sur un ordinateur Windows ou avec certains fichiers enregistrés dans le système de fichiers sur un Mac.
  • La plupart des outils de chargement indépendant ouvrent automatiquement l’application Office ciblée par le complément. Les outils remplissent également l’application avec des boutons de ruban personnalisés ou des éléments de menu contextuel définis dans le manifeste du complément.
  • Pour un complément Outlook, le manifeste du complément est inscrit auprès du service Exchange.

Utiliser la fonctionnalité de désinstallation de votre outil

Pour empêcher les compléments fantômes, mettent fin à chaque session de test, de débogage et de chargement indépendant à l’aide de l’option uninstall (également appelée unacquire) fournie par l’outil que vous avez utilisé pour démarrer la session. Cela annule les effets du chargement indépendant, comme indiqué plus haut dans cet article.

La liste suivante identifie, pour chaque outil, comment désinstaller, mais ne décrit pas les procédures ou la syntaxe en détail. Veillez à utiliser les liens pour obtenir des instructions complètes.

Remarque

Certains de ces outils ne ferment pas l’application Office qui s’est ouverte automatiquement. Dans ce cas, fermez l’application manuellement immédiatement après la fin de la session.

  • Générateur Yeoman pour les compléments Office (Yo Office) : utilisez le npm stop script sur la même ligne de commande que celle où vous avez démarré la session avec npm start. Pour plus d’informations, consultez les différents articles des sections Prise en main et Démarrage rapide et Supprimer un complément chargé de manière indépendante.
  • Kit de ressources Teams pour Visual Studio Code : sélectionnez Exécuter | Arrêter le débogage dans Visual Studio Code. Pour plus d’informations, consultez la dernière étape de Créer un projet de complément Outlook qui s’applique également aux compléments non-Outlook.
  • kit de développement du complément Office pour Visual Studio Code : une fois l’extension kit de développement du complément Office ouverte, sélectionnez Arrêter l’aperçu de votre complément Office. Pour plus d’informations, consultez Arrêter le test de votre complément.
  • outil office-addin-debugging : utilisez la office-addin-debugging stop commande à la même ligne de commande que celle où vous avez démarré la session avec office-addin-debugging start. Pour plus d’informations, voir Chargement de version test avec l’outil Office-Addin-Debugging.
  • Interface CLI du Kit de ressources Teams : utilisez la teamsapp uninstall commande sur la même ligne de commande que celle où vous avez démarré la session avec teamsapp install. Pour plus d’informations, consultez Chargement de version test avec l’interface CLI du Kit de ressources Teams.
  • Visual Studio : sélectionnez DEBUG | Arrêter le débogage dans le menu, ou appuyez sur Maj+F5, ou cliquez sur le bouton rouge carré « Arrêter » dans la barre de débogage. Sinon, la fermeture de l’application Office arrête également la session et désinstalle le complément. Pour plus d’informations, consultez Premier aperçu du débogueur Visual Studio.

Supprimer un complément fantôme

Pour supprimer un complément fantôme, vous devez supprimer les artefacts qui ont été créés lors du dernier chargement indépendant, supprimer son inscription locale et, pour les compléments Outlook, supprimer son inscription dans Exchange.

Le processus de suppression du complément varie selon que le complément est destiné à Outlook ou à une autre application Office.

Remarque

Dans le manifeste unifié pour Microsoft 365, un complément peut être configuré pour prendre en charge Outlook et une ou plusieurs autres applications Office . autrement dit, il existe plusieurs membres du tableau « extensions.requirements.scopes » dans le manifeste et l’un des membres est « mail » (ou la propriété « extensions.requirements.scopes » n’est pas présente). Traitez un complément configuré de cette façon comme un complément Outlook.

Si le complément fantôme n’est pas un complément Outlook, passez à la section Supprimer les artefacts du complément.

Supprimer l’inscription Exchange d’un complément Outlook fantôme

  1. Connectez-vous à Outlook avec le même ID que celui utilisé lors du chargement indépendant du complément.

  2. Ouvrez PowerShell en tant qu’administrateur.

  3. Exécutez les commandes suivantes. Répondez « Oui » à toutes les invites de confirmation.

    Install-Module -Name ExchangeOnlineManagement -RequiredVersion 3.4.0
Set-ExecutionPolicy RemoteSigned
Connect-ExchangeOnline

    Remarque

    Si la Connect-ExchangeOnline commande retourne l’erreur « Impossible d’instancier le contrôle ActiveX '8856f961-340a-11d0-a96b-00c04fd705a2', car le thread actuel n’est pas dans un appartement monothread », exécutez simplement la commande une deuxième fois. Il s’agit d’un bogue bien connu.

  4. Exécutez la commande suivante : Répondez « Oui » à toutes les invites de confirmation.

    Get-App | Format-Table -Auto DisplayName,AppId

    La liste des compléments installés sur Outlook s’affiche. Il s’agit notamment des compléments Microsoft intégrés et des compléments que vous avez installés. Tous les compléments Outlook fantômes seront également répertoriés.

  5. Recherchez le complément fantôme dans la liste. S’il a été créé avec Yo Office ou un autre outil Microsoft, il porte probablement le nom « Complément volet Office Contoso ».

  6. Copiez l’ID d’application (guid) du complément. Vous en avez besoin pour les étapes ultérieures.

  7. Exécutez la commande Remove-App -Identity {{The GUID OF YOUR ADD-IN HERE}} (par exemple, Remove-App -Identity 26ead0cb-10dd-4ba2-86c6-4db111876652). Cette commande supprime le complément d’Exchange.

    Avertissement

    La suppression de l’inscription doit se propager à tous les serveurs Exchange. Attendez au moins trois heures avant de passer à l’étape suivante.

  8. Poursuivez avec la section Supprimer les artefacts de complément.

Supprimer les artefacts de complément

Importante

Effectuez cette procédure sur tous les appareils sur lesquels le complément a été chargé de manière indépendante.

  1. Déconnectez-vous de toutes les applications Office, puis fermez-les toutes, y compris Outlook.
  2. Effacez le cache Office. Si le complément fantôme prend en charge Outlook, utilisez Effacer le cache dans Outlook manuellement.
  3. Passez à la section Supprimer l’inscription locale.

Supprimer l’inscription locale

Importante

Effectuez cette procédure sur tous les ordinateurs sur lesquels le complément a été chargé de manière indépendante.

  1. Supprimez l’inscription locale du complément fantôme. Le processus varie en fonction du système d’exploitation.

    1. Ouvrez le Rédacteur du Registre.

    2. Accédez à Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer. Cette clé répertorie les compléments actuellement chargés de manière indépendante ou qui ont été chargés de manière indépendante dans le passé et qui n’ont pas été entièrement désinstallés. La valeur Data de chaque entrée est le chemin d’accès au manifeste du complément. La valeur Name varie en fonction de la version de l’outil utilisé pour créer et charger une version test du complément. Si Visual Studio a été utilisé, le nom est généralement également le chemin d’accès au manifeste. Pour les autres outils, le nom est généralement l’ID du complément. Lorsqu’une application Office démarre, elle recharge tous les compléments répertoriés dans cette clé (qui prennent en charge l’application Office). Le rechargement peut n’avoir aucun effet pratique ou perceptible si les artefacts du complément ont été supprimés du cache, si le manifeste n’existe plus au niveau du chemin d’accès, ou si les fichiers du complément ne sont pas servis par un serveur.

      Recherchez l’entrée du complément fantôme et supprimez-la. S’il s’agit d’un complément Outlook, vous disposez de l’ID de suppression de l’inscription Exchange. Vous pouvez également utiliser le chemin d’accès dans la colonne Données pour rechercher le manifeste afin d’identifier le complément auquel l’entrée fait référence et de lire l’ID à partir du manifeste. Si des manifestes répertoriés dans la colonne Données n’existent plus au niveau du chemin d’accès spécifié, supprimez les entrées de ces manifestes.

      Registre Windows pour la clé nommée Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer.

    3. Développez le ... Nœud développeur dans l’arborescence du Registre. Recherchez une sous-clé dont le nom est le même ID de complément fantôme. S’il est là, supprimez-le.

      Le Registre Windows de la clé nommée Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer développé pour afficher les sous-clés.

    4. Accédez à Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\WEF\Developer, où {SID} est le SID de l’utilisateur avec lequel vous étiez connecté lorsque vous avez chargé le complément, puis répétez les deux étapes précédentes.

    5. Accédez à Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache. Dans la colonne Nom , recherchez toutes les entrées qui commencent par l’ID du complément (un GUID) et supprimez-les. Ensuite, accédez à Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache, où {SID} est le SID de l’utilisateur avec lequel vous étiez connecté lorsque vous avez chargé le complément, puis répétez le processus.

      Registre Windows pour la clé nommée Computer\HKEY_USERS\SID\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache**, où SID est le SID d’un utilisateur.

  1. Si vous supprimez un complément Outlook, passez à la section Test de suppression des compléments Outlook.

Tester la suppression des compléments Outlook

Ouvrez Outlook avec la même identité que celle utilisée lors de la création du complément. Si les artefacts du complément (tels que les boutons de ruban personnalisés) réapparaissent après quelques minutes ou si les gestionnaires d’événements du complément semblent actifs, la suppression de l’inscription du complément à partir d’Exchange n’a pas été propagée à tous les serveurs Exchange. Attendez au moins trois heures, puis répétez les procédures des sections Supprimer les artefacts de complément et Supprimer l’inscription locale sur l’ordinateur sur lequel vous avez observé les artefacts.

Voir aussi