Desarrollar complementos de Office con Visual Studio Code

Este artículo describe cómo usar Visual Studio Code (VS Code) para desarrollar un complemento de Office.

Requisitos previos

• Visual Studio Code

• Herramienta de creación de proyectos. Tiene las siguientes opciones.

  • Generador de Yeoman para complementos de Office (también denominado "Yo Office"). Para obtener instrucciones de instalación y uso, consulte Creación de proyectos de complementos de Office mediante el generador de Yeoman. Con esta herramienta, tiene la opción de crear complementos que usen el manifiesto de solo complemento o el manifiesto unificado para Microsoft 365. Para obtener más información sobre las diferencias, comience con el manifiesto de complementos de Office.
  • Microsoft 365 Agents Toolkit para Visual Studio Code. Para obtener instrucciones de instalación, consulte Instalación del kit de herramientas de agentes. Para obtener instrucciones de uso, consulte Creación de proyectos de complementos de Office con Microsoft 365 Agents Toolkit. Con esta herramienta puede crear complementos que usen el manifiesto unificado para Microsoft 365.

  Nota:

  El manifiesto unificado para Microsoft 365 se puede usar en complementos de Outlook de producción. Solo está disponible como versión preliminar para excel, PowerPoint y complementos de Word.

Desarrollar el complemento con VS Code

Para trabajar con el proyecto, abra la carpeta raíz del proyecto con VS Code.

Ambas herramientas crean un complemento básico con una funcionalidad limitada. Para personalizar el complemento, edite el manifiesto, HTML, JavaScript o TypeScript, y los archivos CSS en VS Code. Para obtener una descripción detallada de la estructura del proyecto y los archivos del proyecto de complemento que crea el generador Yeoman, vea las instrucciones para el generador Yeoman en el Inicio rápido de 5 minutos correspondiente al tipo de complemento que ha creado.

Ejecutar y depurar el complemento

Los métodos para probar, depurar y solucionar problemas de complementos de Office varían según la plataforma y la herramienta que se usa para crear el proyecto. Para obtener más información, vea Probar y depurar complementos de Office y Crear proyectos de complementos de Office con microsoft 365 Agents Toolkit.

Publicar el complemento

Un complemento de Office incluye dos componentes básicos: un archivo de manifiesto y su propia aplicación web. El manifiesto define diferentes opciones de configuración, como la forma en que el complemento se integra con los clientes de Office. La aplicación web sirve el CÓDIGO HTML, JavaScript y otros archivos que proporcionan la funcionalidad y la interfaz de usuario del complemento.

Cuando desarrolle el complemento, puede ejecutarlo en el servidor web local (localhost), pero cuando esté listo para publicarlo, para que otros usuarios puedan obtener acceso a él, tendrá que implementar la aplicación web en un servidor web o un servicio de hospedaje web (por ejemplo, Microsoft Azure) y actualizar el manifiesto para especificar la dirección URL de la aplicación implementada.

Si el complemento funciona como quiere y está listo para publicarlo para que otros usuarios puedan tener acceso a él, siga los siguientes pasos.

1. Desde la línea de comandos, en el directorio raíz del proyecto de complemento, ejecute el siguiente comando para preparar todos los archivos a la implementación de producción.

   npm run build
   

   Al finalizar la compilación, la carpeta dist en el directorio raíz del proyecto de complemento contendrá los archivos que implementará en los siguientes pasos.

2. Cargue el contenido de la carpeta dist en el servidor web que hospede el complemento. Puede usar cualquier tipo de servidor web o servicio de hospedaje web para hospedar el complemento.

3. En VS Code, abra el archivo de manifiesto del complemento, ubicado en el directorio raíz del proyecto. Reemplace todas las repeticiones de https://localhost:3000 por la dirección URL de la aplicación web que ha implementado en un servidor web en el paso anterior.

4. Elija el método que desea usar para implementar el complemento de Office y siga las instrucciones para publicar el complemento.

Recursos adicionales

• Conceptos básicos de complementos de Office
• Desarrollo de complementos de Office
• Diseñar complementos de Office
• Probar y depurar complementos de Office
• Publicar complementos de Office