Creación de proyectos de complementos de Office mediante el Kit de desarrollo de complementos de Office para Visual Studio Code (versión preliminar)

El Kit de desarrollo de complementos de Office ayuda a configurar el entorno, crear complementos de Office y depurar el código en una experiencia simplificada.

Requisitos previos

• Descargue e instale Visual Studio Code.
• Node.js (la última versión de LTS). Visite el sitio deNode.js para descargar e instalar la versión correcta para el sistema operativo. Para comprobar si ya ha instalado estas herramientas, ejecute los comandos node -v y npm -v en el terminal.
• Office conectado a una suscripción de Microsoft 365. Puede calificar para una suscripción de desarrollador de Microsoft 365 E5 a través del Programa para desarrolladores de Microsoft 365, consulte Preguntas más frecuentes para obtener más información. Como alternativa, puede registrarse para obtener una evaluación gratuita de 1 mes o comprar un plan de Microsoft 365.

Instalación del kit de desarrollo

Puede instalar el Kit de desarrollo de complementos de Office mediante extensiones en Visual Studio Code o instalarlo desde Visual Studio Code Marketplace.

Crear un proyecto de complemento

El Kit de desarrollo de complementos de Office ofrece dos maneras de empezar a trabajar con un nuevo proyecto: plantillas y ejemplos. Las plantillas le permiten elegir la aplicación de Office, el lenguaje de programación y la característica de inicio. Los ejemplos son proyectos más completos que muestran un escenario realista.

Creación de un complemento a partir de una plantilla

Las plantillas ofrecen un punto de partida básico para el complemento. Agregan una cantidad mínima de funcionalidad para que pueda empezar a trabajar sin cambiar gran parte del código existente. En las instrucciones siguientes se describe cómo crear un nuevo proyecto a partir de una plantilla mediante el kit de desarrollo.

1. Abra Visual Studio Code y seleccione el icono Kit de desarrollo de complementos de Office en la barra de actividad.
2. Seleccione Crear un nuevo complemento en el panel de tareas de la extensión.
3. En el menú Selección rápida ahora activa, seleccione la aplicación de Office para el complemento.
4. Seleccione una plantilla de complemento en la lista de plantillas disponibles.
5. Seleccione "JavaScript" o "TypeScript" como lenguaje de programación.
6. En el cuadro de diálogo Carpeta del área de trabajo que se abre, seleccione la carpeta donde desea crear el proyecto.
7. Asigne un nombre al proyecto (sin espacios) cuando se le solicite. El Kit de desarrollo de complementos de Office creará el proyecto con archivos básicos y scaffolding. A continuación, abre el proyecto en una segunda ventana Visual Studio Code. Puede cerrar libremente la ventana de Visual Studio Code original.

Creación de un complemento a partir de un ejemplo

Los ejemplos muestran un complemento de trabajo que resuelve un escenario de un extremo a otro. Los ejemplos son más útiles como herramientas de aprendizaje para comprender cómo funcionan conjuntamente las características del marco de complementos de Office. También puede expandir un ejemplo para satisfacer sus necesidades específicas.

1. Abra Visual Studio Code y seleccione el icono Kit de desarrollo de complementos de Office en la barra de actividad.
2. Seleccione Ver ejemplos.
3. Seleccione el ejemplo que desea ver.
4. Seleccione el botón Crear situado encima del archivo léame de ejemplo ahora abierto.
5. En el cuadro de diálogo Carpeta del área de trabajo que se abre, seleccione la carpeta donde desea crear el proyecto. La extensión copia una versión del ejemplo en esa carpeta. A continuación, abre el proyecto en una segunda ventana Visual Studio Code. Puede cerrar libremente la ventana de Visual Studio Code original.

Prueba del complemento

Para comprender cómo funcionará el complemento en una aplicación de Office, use el Kit de desarrollo de complementos de Office para ejecutar y depurar el complemento de Office en el entorno de desarrollo local.

1. Para abrir la extensión, seleccione el icono Kit de desarrollo de complementos de Office en la barra de actividad.
2. Seleccione Vista previa del complemento de Office (F5)
3. En el menú Selección rápida, seleccione la opción {Office Host} Desktop (Edge Chromium). Esto iniciará el complemento y depurará el código.

El kit de desarrollo comprueba que se cumplen los requisitos previos antes de que se inicie la depuración. Compruebe el terminal para obtener información detallada si hay problemas con el entorno. Después de este proceso, la aplicación de escritorio de Office inicia y descarga localmente el complemento. Tenga en cuenta que la primera vez que ejecute un proyecto, puede tardar unos minutos en instalar las dependencias. Tendrá que instalar el certificado cuando se le solicite.

Detener la prueba del complemento de Office

Una vez que haya terminado de probar y depurar el complemento, cierre el complemento siguiendo estos pasos.

1. Para abrir la extensión, seleccione el icono Kit de desarrollo de complementos de Office en la barra de actividad.
2. Seleccione Detener la vista previa del complemento de Office. Esto cierra el servidor web y quita el complemento del registro y la memoria caché.
3. Cierre la ventana de la aplicación de Office a su conveniencia.

Solución de problemas

Si tiene problemas para ejecutar el complemento, siga estos pasos.

• Cierre las instancias abiertas de Office.
• Cierre el servidor web anterior iniciado para el complemento con la opción Detener la vista previa de la extensión Kit de desarrollo de complementos de Office de Office.

El artículo Solución de problemas de errores de desarrollo con complementos de Office contiene soluciones a problemas comunes. Si sigue teniendo problemas, cree un problema de GitHub y le ayudaremos.

Para obtener información sobre cómo ejecutar el complemento en Office en la Web, vea Transferir localmente complementos de Office a Office en la Web.

Para obtener información sobre la depuración en versiones anteriores de Office, vea Depurar complementos mediante herramientas de desarrollo en Microsoft Edge (versión anterior).