Compartir a través de

Notas de la versión de SharePoint Framework v1.4.1

  • Artículo

Publicado: 15 de febrero de 2018

Importante

En esta página se tratan los detalles relacionados con una versión específica de SPFx. Esta página no incluye requisitos previos de SPFx adicionales que deben instalarse para desarrollar soluciones SPFx como Node.js, Yeoman y otras herramientas.

Para obtener más información acerca de estos requisitos previos, vea Configurar el entorno de desarrollo de SharePoint Framework.

Actualización de proyectos de v1.4 a v1.4.1

  1. En el archivo package.json del proyecto, identifique todos los paquetes de SPFx v1.4. Para cada paquete de SPFx:

    1. Desinstale el paquete v1.4 existente:

      npm uninstall @microsoft/{spfx-package-name}@1.4

    2. Instale el paquete v1.4.1 actualizado:

      npm install @microsoft/{spfx-package-name}@1.4.1.0 --save --save-exact

Sugerencia

La CLI para Microsoft 365 proporciona una guía paso a paso sencilla para actualizar las soluciones a la última versión de SharePoint Framework.

Nuevas características y funciones

Compatibilidad con Node v8 (LTS) y NPM v5

La compatibilidad con Node.js v8 (LTS) y NPM v5 ya está disponible en SPFx.

Problema notificado aquí: https://github.com/SharePoint/sp-dev-docs/issues/1002

También hemos actualizado el artículo Configurar el entorno de desarrollo de SharePoint Framework.

Nuevas API (versión preliminar para desarrolladores)

A continuación se muestran las nuevas API disponibles para el uso de la versión preliminar en SharePoint Online. Estas no están destinadas a ser utilizadas aun en producción.

@microsoft/sp-http

  • Versión beta inicial de la clase AadHttpClient
  • Versión beta inicial de la clase AadTokenProvider

@microsoft/sp-client-preview

  • Versión beta inicial de la clase MSGraphClient

Puede encontrar un tutorial para estas nuevas API en la documentación de desarrollo de Office SharePoint.

AadHttpClient (versión preliminar para desarrolladores)

AadHttpClient se usa para realizar llamadas REST en una aplicación Azure AD, por ejemplo, WebAPI de terceros hospedada en Azure.

  • Para comunicarse con SharePoint, use la clase SPHttpClient en su lugar.
  • Para comunicarse con Microsoft Graph, use la clase MSGraphClient.

Puede encontrar más información sobre esta nueva API en la documentación de desarrollo de Office SharePoint:

MSGraphClient (versión preliminar para desarrolladores)

MSGraphClient se usa para realizar llamadas REST en Microsoft Graph. La biblioteca cliente de JavaScript Microsoft Graph es un contenedor ligero alrededor de la API de Microsoft Graph. Esta clase permite a los desarrolladores empezar a realizar llamadas REST a MSGraph sin necesidad de inicializar la biblioteca cliente de MSGraph.

Si se desea una configuración personalizada, la función MSGraphClientAPI debe proporcionarse con esa configuración personalizada para cada solicitud.

Importante

Tenga en cuenta que esta API reemplaza a la GraphHttpClientpublicada anteriormente, que ahora se considera en desuso.

AadTokenProvider

Esta clase es una clase interna usada por AadHttpClient y MSGraphClient para obtener tokens de OAuth2 de Azure AD. Aunque la clase está marcada actualmente como pública, tenemos previsto cambiarla como interna. Por ese motivo, las soluciones solo deben basarse en clases AadHttpClient y MSGraphClient.

Cambios en esta versión

  • Se ha corregido un problema en el generador que impedía la activación de nuevas versiones de paquetes SPFx.
  • Síntomas : implemente una nueva versión de los paquetes de SharePoint Framework y ya no verá los elementos web en el selector de elementos web.

    • #775

    • Corrección: para corregir este problema correctamente, deberá realizar los pasos siguientes en los inquilinos de SharePoint Online.

      1. Quite todas las instancias de las soluciones existentes de SharePoint Framework del nivel de sitio
      2. Quite una solución de SharePoint Framework del catálogo de aplicaciones
      3. Cargue la nueva solución de SharePoint Framework compilada con la versión 1.4.1 en el catálogo de aplicaciones
      4. Vuelva a instalar soluciones de SharePoint Framework en los sitios.

      Nota:

      Este problema no sucede con las soluciones de SharePoint Framework con ámbito de espacio empresarial y no sucede con los complementos de SharePoint.

      Sugerencia

      Puede aprovecharse de las API de administración del ciclo de vida de aplicaciones (ALM) para automatizar este proceso necesario.

Desuso y elementos eliminados en esta versión

  • La API de GraphHttpClient ha quedado en desuso en favor de la nueva MSGraphClient introducida en esta versión. El GraphHttpClient se quitará en una versión futura.