Depuración de funciones personalizadas en un entorno de ejecución no compartido

Artículo
12/27/2024

En este artículo se describe la depuración solo para funciones personalizadas que no usan un entorno de ejecución compartido. Para depurar complementos de funciones personalizadas que usan un entorno de ejecución compartido, consulte Información general sobre la depuración de complementos de Office.

Importante

Tenga en cuenta que las funciones personalizadas están disponibles en Excel en las siguientes plataformas.

Office en la web
Office en Windows
- Suscripción a Microsoft 365
- Retail perpetual Office 2016 y versiones posteriores
- Office 2021 perpetua con licencia por volumen y versiones posteriores
Office en Mac

Las funciones personalizadas de Excel no se admiten actualmente en lo siguiente:

Office en iPad
versiones perpetuas con licencia por volumen de Office 2019 o versiones anteriores en Windows

Nota:

Se recomienda usar funciones personalizadas con un entorno de ejecución compartido, a menos que tenga una razón específica para no usar un entorno de ejecución compartido. Tenga en cuenta que el uso de un entorno de ejecución compartido significa que el complemento usará WebView2 (basado en microsoft edge Chromium) si se cumplen las condiciones y, de lo contrario, el complemento usará Trident (Internet Explorer 11), independientemente de la versión de Windows o Microsoft 365. Para obtener una descripción de las condiciones de WebView2, vea Exploradores y controles de vista web que usan los complementos de Office. Para obtener más información sobre los tiempos de ejecución, vea Runtimes in Office Add-ins.

Sugerencia

Las técnicas de depuración que se describen en este artículo no funcionan con los proyectos creados con el proyecto de complemento de Office que contiene la opción de solo manifiesto en el generador de Yeoman. Los scripts a los que se hace referencia más adelante en este artículo no se instalan con esa opción. Para depurar un complemento creado con esta opción, consulte las instrucciones de uno de los artículos siguientes, según corresponda.

El proceso de depuración de una función personalizada para complementos que no usan un entorno de ejecución compartido varía en función de la plataforma de destino (Windows, Mac o web) y de si usa Visual Studio Code o un IDE diferente. Use los vínculos de la tabla siguiente para visitar las secciones de este artículo que son relevantes para el escenario de depuración. En esta tabla, "CF-NSR" hace referencia a funciones personalizadas en un entorno de ejecución no compartido.

Plataforma de destino	Visual Studio Code	Otro IDE
Excel en la web	Uso de VS Code y las herramientas de desarrollo del explorador	Uso de las herramientas de línea de comandos
Excel en Windows	Uso de VS Code y las herramientas de desarrollo del explorador	No se admite la depuración de CF-NSR que se ejecutan en Excel en Windows fuera de VS Code. Depuración en Excel en la Web.
Excel en Mac	No se admite la depuración de VS Code de CF-NSR que se ejecutan en Excel en Mac. Depuración en Excel en la Web.	Uso de las herramientas de línea de comandos

Use las herramientas de desarrollo del explorador para depurar funciones personalizadas en Excel en la Web

Puede usar las herramientas de desarrollo del explorador para depurar funciones personalizadas que no usan un entorno de ejecución compartido en Excel en la Web. Los pasos siguientes funcionan para Windows y macOS.

Ejecute el complemento desde Visual Studio Code

Abra la carpeta del proyecto raíz de funciones personalizadas en Visual Studio Code (VS Code).
Elija TerminalRun Task (Tarea de ejecución de terminal>) y escriba o seleccione Watch (Inspección). Esto supervisará y recompilará los cambios de archivo.
Elija TerminalRun Task (Tarea de ejecución de terminal>) y escriba o seleccione Dev Server (Servidor de desarrollo).

Transferir el complemento

Abra Office en la Web.
Abra un nuevo libro de Excel.
SeleccioneComplementos deinicio> y, a continuación, seleccione Más configuración.
En el cuadro de diálogo Complementos de Office , seleccione Cargar mi complemento.
Busque en el archivo de manifiesto de complementos y, después, seleccione Cargar.

Nota:

Una vez que se haya cargado de forma local en el documento, se seguirá cargando localmente cada vez que abra el documento.

Iniciar depuración

Abra las herramientas de desarrollo en el explorador. Para Chrome y la mayoría de los exploradores, F12 abrirá las herramientas de desarrollo.
En las herramientas para desarrolladores, abra el archivo de script de código fuente mediante Cmd+P o Ctrl+P (functions.js o functions.ts).
Establezca un punto de interrupción en el código fuente de la función personalizada.

Si necesita cambiar el código, puede realizar modificaciones en VS Code y guardar los cambios. Actualice el explorador para ver los cambios cargados.

Uso de las herramientas de línea de comandos para depurar

Si no usa VS Code, puede usar la línea de comandos (como Bash o PowerShell) para ejecutar el complemento. Tendrá que usar las herramientas de desarrollo del explorador para depurar el código en Excel en la Web. No se puede depurar la versión de escritorio de Excel mediante la línea de comandos.

Desde la línea de comandos, ejecute npm run watch para watch y recompilar cuando se produzcan cambios en el código.
Abra una segunda ventana de línea de comandos (la primera se bloqueará mientras se ejecuta la watch).
Si desea iniciar el complemento en la versión de escritorio de Excel y la sección "scripts" del archivo package.json del proyecto tiene un script "start:desktop", ejecute npm run start:desktop; en caso contrario, ejecute npm run start.

O bien, si prefiere iniciar el complemento en Excel en la Web ejecute el siguiente comando.

npm run start:web -- --document {url} (donde {url} es la dirección URL de un archivo de Excel en OneDrive o SharePoint)

Nota:

Si va a desarrollar en un Equipo Mac, incluya entre {url} comillas simples. No haga esto en Windows.

Si el complemento no se carga localmente en el documento, siga los pasos descritos en Transferir localmente el complemento para transferir localmente el complemento. A continuación, continúe con la sección siguiente para iniciar la depuración.
Abra las herramientas de desarrollo en el explorador. Para Chrome y la mayoría de los exploradores, F12 abrirá las herramientas de desarrollo.
En las herramientas para desarrolladores, abra el archivo de script de código fuente (functions.js o functions.ts). El código de las funciones personalizadas puede encontrarse cerca del final del archivo.
En el código fuente de la función personalizada, seleccione una línea de código para aplicar un punto de interrupción.

Si necesita cambiar el código, puede realizar modificaciones en VS Code y guardar los cambios. Actualice el explorador para ver los cambios cargados.

Comandos para compilar y ejecutar el complemento

Hay varias tareas de compilación disponibles.

npm run watch: compila para el desarrollo y se recompila automáticamente cuando se guarda un archivo de origen.
npm run build-dev: compilaciones para el desarrollo una vez
npm run build: compilaciones para producción
npm run dev-server: ejecuta el servidor web usado para el desarrollo

Puede usar las siguientes tareas para iniciar la depuración en el escritorio o en línea.

npm run start:desktop: inicia Excel en el escritorio y descarga localmente el complemento. Si el script "start:desktop" no está presente en la sección "scripts" del archivo package.json del proyecto, ejecute npm run start en su lugar.
npm run start:web -- --document {url}(donde {url} es la dirección URL de un archivo de Excel en OneDrive o SharePoint): inicia Excel en la Web y descarga localmente el complemento.

Nota:

Si va a desarrollar en un Equipo Mac, incluya entre {url} comillas simples. No haga esto en Windows.
npm run stop: detiene Excel y depuración.

Pasos siguientes

Obtenga información sobre la autenticación para funciones personalizadas sin un entorno de ejecución compartido.

Compartir a través de