Prueba y depuración de complementos de Office en un servidor no local

  • Artículo

Cuando haya completado el desarrollo y las pruebas en un host local y quiera almacenar y probar el complemento desde un servidor no local o una cuenta en la nube, puede usar la herramienta office-addin-debugging para cualquier proyecto de complemento basado en Node.js. (La herramienta no se admite en proyectos creados con Visual Studio).

Nota:

Si está trabajando en un equipo Windows, es posible que tenga otra opción para las pruebas no locales. Consulte Instalación local de complementos de Office para realizar pruebas desde un recurso compartido de red.

Proyectos creados con el kit de herramientas de Teams o el generador de Office Yeoman (Yo Office)

Si el proyecto se creó con el kit de herramientas de Teams o el generador de Office Yeoman (Yo Office), la herramienta office-addin-debugging ya está instalada y el archivo package.json tiene start y stop scripts que invocan la herramienta. Para usarlo para pruebas no locales, actualice la parte del dominio de las direcciones URL del manifiesto para que apunten al servidor de almacenamiento provisional (o a la red CDN según sea necesario). A continuación, ejecute npm run start en la línea de comandos (o terminal de Visual Studio Code) para transferir localmente el complemento para pruebas y depuración.

Importante

La herramienta office-addin-debugging registra el complemento en el registro de Windows o en una carpeta especial en un Equipo Mac. Para un complemento de Outlook, también registra el complemento en Exchange. Para evitar errores sutiles al desarrollar, finalice siempre una sesión de prueba ejecutando npm run stop para asegurarse de que estos registros se quitan y de que el proceso del servidor está totalmente detenido. Cerrar manualmente el servidor, la ventana de la línea de comandos (o TERMINAL), Visual Studio Code o la aplicación de Office no quita estos registros.

Otros proyectos

Si el proyecto no se creó con Teams Toolkit o Yo Office, ejecute la herramienta con npx en la raíz del proyecto. Invoque con su start comando seguido de la ruta de acceso relativa al manifiesto. A continuación se muestra un ejemplo.

npx office-addin-debugging start manifest.json

Este comando carga localmente el complemento para pruebas y depuración. La herramienta también funciona con un manifiesto de solo complemento.

Hay muchas opciones para el start comando. Para obtener más información, consulte EL ARCHIVO LÉAME de la herramienta en office-addin-debugging.

Importante

La herramienta office-addin-debugging registra el complemento en el registro de Windows o en una carpeta especial en un Equipo Mac. Para un complemento de Outlook, también registra el complemento en Exchange. Para evitar errores sutiles al desarrollar, finalice siempre una sesión de prueba ejecutando npx office-addin-debugging stop para asegurarse de que estos registros se quitan y de que el proceso del servidor está totalmente detenido. Cerrar manualmente el servidor, la ventana de la línea de comandos (o TERMINAL), Visual Studio Code o la aplicación de Office no quita estos registros. Si usó la --prod opción con el start comando , use la misma opción con el stop comando .