Compartir por

Desinstalación de complementos en desarrollo

  • Artigo

Los complementos eliminados incompletamente pueden dejar artefactos en el equipo, como botones de cinta personalizados o entradas del Registro, durante el desarrollo. En este artículo, llamamos a estos "complementos fantasma".

Los complementos de Outlook también pueden agregar estos artefactos a otros equipos al iniciar sesión en Outlook con el mismo identificador que usó para desarrollar el complemento.

Importante

Al iniciar sesión en Outlook, se descarga desde Exchange y se transfieren localmente todos los manifiestos de complementos de Outlook asociados a su identificador, incluidos los complementos que está desarrollando en un equipo diferente con el mismo identificador. Por ejemplo, los botones de cinta personalizados definidos en el manifiesto aparecerán para el complemento.

Si las direcciones URL del manifiesto apuntan a un servidor que no es localhost y ese servidor se está ejecutando y es accesible para el equipo que no es de desarrollo, Outlook almacena en caché los archivos del complemento en el sistema de archivos local y el complemento normalmente se ejecuta con normalidad en el equipo. De lo contrario, el complemento no funciona, pero aparecen partes visibles del mismo, como botones de cinta personalizados. Tienen las etiquetas definidas en el manifiesto. Los iconos de botón del complemento también aparecen si alguna vez se almacenaron en caché localmente en el equipo que no es de desarrollo y la memoria caché nunca se borra. Los archivos de iconos no se almacenan con Exchange, por lo que si nunca se almacenaron en caché en el equipo que no es de desarrollo (o se ha borrado la memoria caché), los botones tienen iconos predeterminados.

Hasta que el registro del complemento se quite de Exchange, el complemento seguirá apareciendo. Consulte Eliminación de un complemento fantasma para obtener información sobre cómo quitar el registro en Exchange.

En este artículo se proporcionan algunas instrucciones para minimizar la posibilidad de estos problemas y resolverlos si se producen.

Evitar los problemas

Cuando se carga de forma local un complemento, suceden varias cosas:

  • Un servidor web, normalmente en localhost, se inicia para atender los archivos del complemento (como los archivos HTML, CSS y JavaScript).
  • Estos mismos archivos se almacenan en caché en el equipo de desarrollo.
  • El complemento se registra en el equipo de desarrollo. El registro se realiza con entradas del Registro en un equipo Windows o con determinados archivos guardados en el sistema de archivos en un Equipo Mac.
  • La mayoría de las herramientas para transferir localmente complementos abren automáticamente la aplicación de Office a la que se dirige el complemento. Las herramientas también rellenan la aplicación con los botones de la cinta de opciones personalizados o los elementos de menú contextual definidos en el manifiesto del complemento.
  • Para un complemento de Outlook, el manifiesto del complemento se registra con el servicio Exchange.

Uso de la instalación de desinstalación de la herramienta

Para evitar complementos fantasma, finalice cada sesión de prueba, depuración y transferencia local mediante la opción de desinstalación (también denominada unacquire) que proporciona la herramienta que usó para iniciar la sesión. Al hacerlo, se invierten los efectos de la instalación local, como se indicó anteriormente en este artículo.

En la lista siguiente se identifica, para cada herramienta, cómo desinstalar, pero no se describen los procedimientos ni la sintaxis en detalle. Asegúrese de usar los vínculos para obtener instrucciones completas.

Nota:

Algunas de estas herramientas no cierran la aplicación de Office que se abrió automáticamente. En ese caso, cierre la aplicación manualmente inmediatamente después de finalizar la sesión.

  • Generador de Yeoman para complementos de Office (Yo Office): use el npm stop script en la misma línea de comandos donde inició la sesión con npm start. Para obtener más información, consulte los diversos artículos de las secciones Introducción e Inicio rápido y Eliminación de un complemento descargado localmente.
  • Kit de herramientas de Teams para Visual Studio Code: seleccione Ejecutar | detener depuración en Visual Studio Code. Para obtener más información, vea el último paso de Crear un proyecto de complemento de Outlook que también se aplica a complementos que no son de Outlook.
  • Kit de desarrollo de complementos de Office para Visual Studio Code: con la extensión Kit de desarrollo de complementos de Office abierta, seleccione Detener la vista previa del complemento de Office. Para obtener más información, vea Detener la prueba del complemento.
  • herramienta office-addin-debugging: use el office-addin-debugging stop comando en la misma línea de comandos donde inició la sesión con office-addin-debugging start. Para obtener más información, vea Transferir localmente con la herramienta Office-Addin-Debugging.
  • CLI del kit de herramientas de Teams: use el teamsapp uninstall comando en la misma línea de comandos donde inició la sesión con teamsapp install. Para obtener más información, consulte Transferencia local con la CLI del kit de herramientas de Teams.
  • Visual Studio: seleccione DEPURAR | Detener depuración en el menú o presione Mayús+F5 o haga clic en el botón "Detener" de rojo cuadrado de la barra de depuración. Como alternativa, el cierre de la aplicación de Office también detiene la sesión y desinstala el complemento. Para obtener más información, vea Primer vistazo al depurador de Visual Studio.

Eliminación de un complemento fantasma

Para quitar un complemento fantasma, debe quitar los artefactos que se crearon cuando se descargó por última vez, quitar su registro local y, para los complementos de Outlook, quitar su registro en Exchange.

El proceso para quitar el complemento varía en función de si el complemento es para Outlook o para alguna otra aplicación de Office.

Nota:

En el manifiesto unificado para Microsoft 365, se puede configurar un complemento para admitir Outlook y una o varias otras aplicaciones de Office; es decir, hay más de un miembro de la matriz "extensions.requirements.scopes" en el manifiesto y uno de los miembros es "mail" (o la propiedad "extensions.requirements.scopes" no está presente). Trate un complemento configurado de esta manera como un complemento de Outlook.

Si el complemento fantasma no es un complemento de Outlook, vaya a la sección Quitar los artefactos del complemento.

Quitar el registro de Exchange de un complemento fantasma de Outlook

  1. Inicie sesión en Outlook con el mismo identificador que usó al transferir localmente el complemento.

  2. Abra PowerShell como administrador.

  3. Ejecute los siguientes comandos. Responda "Sí" a todas las solicitudes de confirmación.

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

    Nota:

    Si el Connect-ExchangeOnline comando devuelve el error "Control ActiveX '8856f961-340a-11d0-a96b-00c04fd705a2' no se puede crear una instancia porque el subproceso actual no está en un apartamento de un solo subproceso", ejecute el comando una segunda vez. Se trata de un error conocido.

  4. Ejecuta el siguiente comando. Responda "Sí" a todas las solicitudes de confirmación.

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

    Se muestra una lista de los complementos instalados en Outlook. Estos incluirán complementos y complementos integrados de Microsoft que haya instalado. También se mostrarán los complementos fantasma de Outlook.

  5. Busque el complemento fantasma en la lista. Si se creó con Yo Office u otra herramienta de Microsoft, probablemente tenga el nombre "Complemento de panel de tareas de Contoso".

  6. Copie el identificador de aplicación (un GUID) del complemento. Lo necesita para los pasos posteriores.

  7. Ejecute el comando Remove-App -Identity {{The GUID OF YOUR ADD-IN HERE}} (por ejemplo, Remove-App -Identity 26ead0cb-10dd-4ba2-86c6-4db111876652). Este comando quita el complemento de Exchange.

    Advertencia

    La eliminación del registro debe propagarse a todos los servidores de Exchange. Espere al menos tres horas antes de continuar con el paso siguiente.

  8. Continúe con la sección Quitar los artefactos de complemento.

Quitar los artefactos del complemento

Importante

Realice este procedimiento en todos los dispositivos en los que se haya cargado el complemento de forma local.

  1. Cierre la sesión de todas las aplicaciones de Office y ciérrelas todas, incluido Outlook.
  2. Borre la memoria caché de Office. Si el complemento fantasma admite Outlook, use Borrar la memoria caché de Outlook manualmente.
  3. Continúe con la sección Quitar el registro local.

Eliminación del registro local

Importante

Realice este procedimiento en todos los equipos en los que ha tenido el complemento descargado localmente.

  1. Elimine el registro local del complemento fantasma. El proceso varía en función del sistema operativo.

    1. Abra la Editor del Registro.

    2. Vaya a Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer. Esta clave enumera los complementos que se han descargado localmente o que se han cargado de forma local en el pasado y no se han desinstalado por completo. El valor Data de cada entrada es la ruta de acceso al manifiesto del complemento. El valor name varía en función de la versión de la herramienta que se usó para crear y transferir localmente el complemento. Si se usó Visual Studio, el nombre suele ser también la ruta de acceso al manifiesto. Para otras herramientas, el nombre suele ser el identificador del complemento. Cuando se inicia una aplicación de Office, vuelve a cargar todos los complementos enumerados en esta clave (que admiten la aplicación de Office). La recarga puede no tener ningún efecto práctico o discernible si los artefactos del complemento se han eliminado de la memoria caché, o si el manifiesto ya no existe en la ruta de acceso, o si un servidor no atiende los archivos del complemento.

      Busque la entrada del complemento fantasma y elimínela. Si es un complemento de Outlook, tiene el identificador de quitar el registro de Exchange. También puede usar la ruta de acceso de la columna Datos para buscar el manifiesto para ayudar a identificar el complemento al que hace referencia la entrada y leer el identificador del manifiesto. Si ya no existen manifiestos en la columna Datos en la ruta de acceso especificada, elimine las entradas de esos manifiestos.

      Registro de Windows para la clave denominada Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer.

    3. Expanda ... Nodo para desarrolladores en el árbol del Registro. Busque una subclave cuyo nombre sea el mismo identificador del complemento fantasma. Si está allí, elimínelo.

      El Registro de Windows de la clave denominada Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\Developer expandido para mostrar subclaves.

    4. Vaya a Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\WEF\Developer, donde {SID} es el SID del usuario con el que inició sesión al transferir localmente el complemento y repita los dos pasos anteriores.

    5. Vaya a Computer\HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache. En la columna Nombre , busque todas las entradas que comienzan por el identificador del complemento (un GUID) y elimínelas. A continuación, vaya a Computer\HKEY_USERS\{SID}\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache, donde {SID} es el SID del usuario con el que inició sesión al transferir localmente el complemento y repita el proceso.

      Registro de Windows para la clave denominada Computer\HKEY_USERS\SID\Software\Microsoft\Office\16.0\Common\CustomUIValidationCache**, donde SID es el SID de un usuario.

  1. Si va a quitar un complemento de Outlook, continúe con la sección Prueba para la eliminación de complementos de Outlook.

Prueba de eliminación de complementos de Outlook

Abra Outlook con la misma identidad que usó al crear el complemento. Si los artefactos del complemento (como botones de cinta personalizados) vuelven a aparecer después de unos minutos o si los controladores de eventos del complemento parecen estar activos, la eliminación del registro del complemento de Exchange no se ha propagado a todos los servidores de Exchange. Espere al menos tres horas y repita los procedimientos de las secciones Quitar los artefactos del complemento y Quitar el registro local en el equipo donde observó los artefactos.

Vea también