Información general sobre la depuración de complementos de Office

La depuración de complementos de Office es esencialmente la misma que la depuración de cualquier aplicación web. Sin embargo, un único conjunto de herramientas no funcionará para todos los desarrolladores de complementos. Esto se debe a que los complementos se pueden desarrollar en diferentes sistemas operativos y ejecutarse en multiplataforma. Este artículo le ayuda a encontrar la guía de depuración detallada para su entorno de desarrollo.

Sugerencia

Este artículo se refiere a la depuración en el estrecho sentido de establecer puntos de interrupción y pasar por el código. Para obtener instrucciones sobre las pruebas y la solución de problemas, comience con Probar complementos de Office y Solucionar problemas de desarrollo con complementos de Office.

Nota:

Aunque debe probar el complemento en todas las plataformas que quiera admitir, en muy raras ocasiones tendrá que depurar en un entorno diferente del equipo de desarrollo. Por este motivo, este artículo usa "su equipo de desarrollo" y "su entorno de desarrollo" para hacer referencia al entorno en el que está depurando. Si un problema en el código se produce solo en una plataforma distinta de la del equipo de desarrollo y necesita establecer puntos de interrupción o paso a paso por el código para solucionarlo, el entorno en el que está depurando no es literalmente el entorno de desarrollo.

¿Del lado servidor o del lado cliente?

Depurar el código del lado servidor de un complemento de Office es lo mismo que depurar el lado servidor de cualquier aplicación web. Consulta las instrucciones de depuración del IDE u otras herramientas. A continuación se muestran ejemplos de algunas de las herramientas más comunes.

• Depurar las aplicaciones ASP.NET o ASP.NET Core en Visual Studio
• Depuración rápida
• Guía de depuración Node.js
• Depuración Node.js en VS Code
• Depuración de Webpack

El resto de este artículo hace referencia únicamente a la depuración de JavaScript del lado cliente (que se puede transpilar desde TypeScript).

Casos especiales

Hay algunos casos especiales en los que el proceso de depuración difiere del normal para una combinación determinada de plataforma, aplicación de Office y entorno de desarrollo. Si va a depurar cualquiera de estos casos especiales, use los vínculos de esta sección para encontrar orientaciones adecuadas. En otro caso, continúe con la Guía general.

• Depuración la Office.initialize o Office.onReady función: depurar las funciones initialize y onReady.
• Depuración de una función personalizada de Excel en un tiempo de ejecución no compartido: funciones personalizadas que se depuran en un tiempo de ejecución no compartido.
• Deburación de un comando de función en un tiempo de ejecución no compartido:
  • Complementos de Outlook en un equipo de desarrollo de Windows: comandos de función de depuración en complementos de Outlook
  • Otros complementos de aplicación de Office o Outlook en un equipo de desarrollo Mac: depurar un comando de función con un tiempo de ejecución no compartido.
• Depuración de un complemento de Outlook basado en eventos o de informes de correo no deseado: depuración de complementos de informes de correo no deseado y basados en eventos.
• Depuración de un complemento en el nuevo cliente de escritorio de Outlook en Windows (versión preliminar): vea la sección "Depurar el complemento" de Desarrollo de complementos de Outlook para el nuevo Outlook en Windows (versión preliminar).
• Depuración de un complemento basado en Blazor: depure el complemento de la misma manera que depuraría una aplicación web blazor. Consulte Depuración ASP.NET Core WebAssembly de Blazor.

Instrucciones generales

Para encontrar guías para depurar código del lado cliente, la primera variable es el sistema operativo del equipo de desarrollo.

• Windows
• Mac
• Linux u otra variante de Unix

Depurar en Windows

A continuación se proporcionan instrucciones generales para la depuración en Windows. La depuración en Windows depende del IDE.

• Visual Studio: Depurar con las herramientas F12 del explorador. Vea Depurar complementos de Office en Visual Studio.

• Visual Studio Code:Depurar mediante la Extensión de depurador de complementos para Visual Studio Code.

• Cualquier otro IDE (o no quiere depurar dentro del IDE): use las herramientas de desarrollo asociadas al control webview que usan los complementos en el equipo de desarrollo. Vea una de las opciones siguientes:

  • Para la vista web trident: depuración de complementos mediante herramientas de desarrollo para Internet Explorer
  • Para la vista web edgeHTML: depuración de complementos mediante herramientas para desarrolladores para Edge Legacy
  • Para la vista web web de WebView2: depurar complementos mediante herramientas para desarrolladores en Microsoft Edge (basado en Chromium)

Para obtener información sobre qué tiempo de ejecución se usa, vea Exploradores y controles de vista web usados por complementos y tiempos de ejecución de Office en complementos de Office.

Sugerencia

En las versiones recientes de Office, una manera de identificar el control de vista web que usa Office es a través del menú de personalidad en cualquier complemento donde esté disponible. (El menú personalidad no se admite en Outlook). Abra el menú y seleccione Información de seguridad. En el cuadro de diálogo Información de seguridad de Windows, runtime notifica Microsoft Edge, Microsoft Edge (versión anterior) o Internet Explorer. El tiempo de ejecución no se incluye en el cuadro de diálogo en versiones anteriores de Office.

Depurar en Mac

Use el inspector web de Safari. Las instrucciones se encuentran en Depurar complementos de Office en un Mac.

Depurar en Linux

No hay ninguna versión de escritorio de Office para Linux, por lo que tendrá que transferir localmente el complemento a Office en la web probarlo y depurarlo. La guía de depuración se encuentra en Depurar complementos en Office en la Web.

Nota:

No se recomienda desarrollar complementos de Office en un equipo Linux, excepto en el caso inusual en el que pueda estar seguro de que todos los usuarios del complemento tendrán acceso al complemento a través de Office en la Web desde un equipo Linux.

Depurar complementos en almacenamiento provisional o producción

Para depurar un complemento que ya esté en almacenamiento provisional o en producción, adjunte un depurador desde la interfaz de usuario del complemento. Para obtener instrucciones, consulte Adjuntar un depurador desde el panel de tareas.

Consulte también

• Tiempos de ejecución en complementos de Office