Actualización a la biblioteca de API de JavaScript de Office más reciente y al esquema de manifiesto del complemento versión 1.1

  • Artículo

En este artículo se describe cómo actualizar los archivos JavaScript (Office.js y los archivos .js específicos de la aplicación) y el archivo de validación del manifiesto del complemento en el proyecto de complemento de Office a la versión 1.1.

Nota:

Los proyectos creados en Visual Studio 2019 o versiones posteriores ya usarán la versión 1.1. Sin embargo, hay actualizaciones secundarias ocasionales a la versión 1.1 que puede aplicar mediante las técnicas de este artículo.

Use los archivos de proyecto más actualizados

Si usa Visual Studio para desarrollar el complemento, para usar los miembros de API más recientes de la API de JavaScript de Office y las características v1.1 del manifiesto XML del complemento (que se valida con offappmanifest-1.1.xsd), debe descargar la versión más reciente de Visual Studio. Para descargar Visual Studio, consulte la página IDE de Visual Studio. Durante la instalación debe seleccionar la carga de trabajo de desarrollo de Office y SharePoint.

Si usa un editor de texto o IDE distinto de Visual Studio para desarrollar el complemento, debe actualizar las referencias a la red de entrega de contenido (CDN) para Office.js y la versión del esquema a la que se hace referencia en el manifiesto del complemento.

Actualizar un proyecto de complemento de Office creado con Visual Studio

Para los proyectos creados antes de la versión v1.1 de la API de JavaScript de Office y el esquema de manifiesto del complemento, puede actualizar los archivos de un proyecto mediante el Administrador de paquetes NuGet y, a continuación, actualizar las páginas HTML del complemento para hacer referencia a ellos.

Tenga en cuenta que el proceso de actualización se aplica por proyecto : tendrá que repetir el proceso de actualización para cada proyecto de complemento en el que quiera usar la versión 1.1 de Office.js y el esquema de manifiesto del complemento.

Actualizar los archivos de biblioteca de la API de JavaScript de Office en el proyecto a la versión más reciente

Los pasos siguientes actualizarán los archivos de biblioteca de Office.js a la versión más reciente. Los pasos usan Visual Studio 2019, pero son similares a las versiones anteriores de Visual Studio.

  1. En Visual Studio 2019, abra o cree un nuevo proyecto de complemento de Office .
  2. Elija Herramientas>Administrador de paquetes> NuGetAdministrar paquetes Nuget para la solución.
  3. Elija la pestaña Actualizaciones.
  4. Seleccione Microsoft.Office.js. Asegúrese de que el origen del paquete es de nuget.org.
  5. En el panel izquierdo, elija Instalar y complete el proceso de actualización del paquete.

Necesitará realizar algunos pasos adicionales para completar la actualización. En la etiqueta principal de las páginas HTML del complemento, comente o elimine las referencias de script de office.js existentes y haga referencia a la biblioteca de API de JavaScript de Office actualizada como se indica a continuación:

<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>

Nota:

El /1/ en office.js en la dirección URL de CDN especifica el uso de la versión incremental más reciente dentro de la versión 1 de Office.js.

Actualice el archivo del manifiesto en el proyecto para usar la versión 1.1 del esquema

En el archivo de manifiesto del complemento, actualice el atributo xmlns del <elemento OfficeApp> cambiando el valor de versión a 1.1 (dejando sin cambios atributos distintos del atributo xmlns ).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
  
  <!-- manifest contents -->

</OfficeApp>

Nota:

Después de actualizar la versión del esquema de manifiesto del complemento a la versión 1.1, deberá quitar los elementos Capabilities y Capability y reemplazarlos por los elementos Hosts y Host o los elementos Requirements y Requirement.

Actualizar un proyecto de complemento de Office creado con un editor de texto u otro IDE

Para los proyectos creados antes de la versión v1.1 de la API de JavaScript de Office y el esquema de manifiesto del complemento, debe actualizar las páginas HTML del complemento para hacer referencia a la red CDN de la biblioteca v1.1 y actualizar el archivo de manifiesto del complemento para usar el esquema v1.1.

El proceso de actualización se aplica por proyecto : tendrá que repetir el proceso de actualización para cada proyecto de complemento en el que quiera usar la versión 1.1 de Office.js y el esquema de manifiesto del complemento.

No necesita copias locales de los archivos de API de JavaScript de Office (Office.js y archivos de .js específicos de la aplicación) para desarrollar un complemento de Office (que hace referencia a la red CDN para Office.js descarga los archivos necesarios en tiempo de ejecución), pero si desea una copia local de los archivos de biblioteca, puede usar la Utilidad de Command-Line NuGet y el Install-Package Microsoft.Office.js comando para descargarlos.

Nota:

Para obtener una copia del XSD (definición de esquema XML) para el manifiesto del complemento v1.1, vea la lista en Referencia de esquema para manifiestos de complementos de Office.

Actualizar los archivos de biblioteca de la API de JavaScript de Office en el proyecto para usar la versión más reciente

  1. Abra las páginas HTML del complemento en su editor de texto o IDE.

  2. En la etiqueta principal de las páginas HTML del complemento, comente o elimine las referencias de script de office.js existentes y haga referencia a la biblioteca de API de JavaScript de Office actualizada como se indica a continuación:

    <script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js" type="text/javascript"></script>

    Nota:

    El /1/ delante de office.js en la dirección URL de CDN especifica el uso de la versión incremental más reciente dentro de la versión 1 de Office.js.

Actualice el archivo del manifiesto en el proyecto para usar la versión 1.1 del esquema

En el archivo de manifiesto del complemento, actualice el atributo xmlns del <elemento OfficeApp> cambiando el valor de versión a 1.1 (dejando sin cambios atributos distintos del atributo xmlns ).

<?xml version="1.0" encoding="utf-8"?>
<OfficeApp xsi:type="ContentApp"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://schemas.microsoft.com/office/appforoffice/1.1">
  
  <!-- manifest contents -->

</OfficeApp>

Nota:

Después de actualizar la versión del esquema de manifiesto del complemento a la versión 1.1, deberá quitar los elementos Capabilities y Capability y reemplazarlos por los elementos Hosts y Host o los elementos Requirements y Requirement.

Vea también