Depuración de las funciones initialize y onReady

Nota:

En este artículo se supone que está familiarizado con Inicializar el complemento de Office.

La paradoja de depurar las funciones Office.initialize y Office.onReady es que un depurador solo puede asociarse a un proceso que se está ejecutando, pero estas funciones se ejecutan inmediatamente a medida que se inicia el proceso en tiempo de ejecución del complemento, antes de que un depurador pueda asociarse. En la mayoría de las situaciones, reiniciar el complemento después de adjuntar un depurador no ayuda porque al reiniciar el complemento se cierra el proceso en tiempo de ejecución original y el depurador adjunto e inicia un nuevo proceso que no tiene ningún depurador asociado.

Afortunadamente, hay dos maneras de depurar estas funciones que se describen en las secciones siguientes.

Depuración mediante Office en la Web

Para depurar con Office en la Web, siga estos pasos.

1. Transferir localmente y ejecutar el complemento en Office en la Web. Esto suele hacerse abriendo el panel de tareas de un complemento o ejecutando un comando de función. El complemento se ejecuta en el proceso general del explorador, no en un proceso independiente como lo haría en Office de escritorio.
2. Abra las herramientas de desarrollo del explorador. Esto suele hacerse presionando F12. El depurador de las herramientas se asocia al proceso del explorador.
3. Aplique puntos de interrupción según sea necesario al código de la Office.initialize función o Office.onReady .
4. Vuelva a iniciar el panel de tareas del complemento o el comando de función como hizo en el paso 1. Esta acción no cierra el proceso del explorador ni el depurador. La Office.initialize función o Office.onReady se ejecuta de nuevo y el procesamiento se detiene en los puntos de interrupción.

Sugerencia

Para obtener información más detallada, vea Depurar complementos en Office en la Web.

Depuración mediante Office en Windows

Para depurar la secuencia de inicialización del complemento, configure el entorno para que las herramientas de desarrollo de Microsoft WebView2 se abran automáticamente cuando se inicie el complemento.

1. Cierre la aplicación de Office donde tiene previsto depurar el complemento.
2. Establezca la variable de WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS entorno para incluir el valor --auto-open-devtools-for-tabs.
3. Abra la aplicación de Office.
4. Ejecutar el complemento.
5. Las herramientas de desarrollo de Microsoft Edge deben abrirse automáticamente. Use la herramienta de la misma manera que lo haría al depurar un panel de tareas, como se especifica en Depurar un complemento de panel de tareas mediante herramientas para desarrolladores de Microsoft Edge.

Nota:

Es posible que vea otras instancias de la apertura automática de la herramienta para desarrolladores de Microsoft Edge, ya que esta variable de entorno afectará a todas las instancias de WebView2 del sistema.

Vea también

• Tiempos de ejecución en complementos de Office