Compartir a través de

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

  • Artículo

Los cambios clave están relacionados con la introducción del nuevo modelo plusbeta y muchas otras mejoras y capacidades adicionales.

Publicación: 5 de junio 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.1 a v1.5

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

    1. Desinstale el paquete de v1.4.1 existente:

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

    2. Instale el paquete de v1.5 actualizado:

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

  2. Instale los siguientes paquetes de declaración de tipo TypeScript:

    npm install **\@types/webpack-env@1.13.1
npm install **\@types/es6-promise@0.0.33

  3. Agregue las siguientes entradas a la matriz de types en el archivo tsconfig.json :

    {
  // omitted for brevity
  "types": [
    // omitted for brevity
    "webpack-env",
    "es6-promise"
  ]
  // omitted for brevity
}

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

Las API de envío y beta ahora están en paquetes independientes

A partir de la versión v1.5.0, los paquetes solo contendrán las API públicas finales en los archivos *.d.ts . Se eliminan todas las API beta, y tendrá que elegir explícitamente los paquetes que contienen las API beta. Para usar estas API beta, debe usar las versiones de los paquetes 1.5.0-plusbeta. Solo hay una versión de @microsoft/generator-sharepoint y puede crear soluciones beta y no beta.

Puede crear soluciones que usen las API beta de una de estas dos maneras. Puede ejecutar el generador Yeoman y agregar una marca --plusbeta en la línea de comandos, lo que creará un archivo package.json con las versiones -plusbeta, o puede actualizar las referencias en package.json para usar la versión -plusbeta.

Este enfoque es distinto al habitual, ya que, aunque en ocasiones hay paquetes enteros en la versión beta, también es común que algunas API beta estén en paquetes de envío existentes. Tampoco es necesariamente cierto que sea una versión beta de la próxima versión, ya que es posible que una característica permanezca en la versión preliminar durante más de una versión.

Datos dinámicos (versión preliminar para desarrolladores)

La mayor parte de esta versión es la versión preliminar para desarrolladores de datos dinámicos. Puede pensar en esto como una versión moderna de la característica Conexiones de elementos web en las páginas clásicas.

El objetivo final de la característica será permitir que los desarrolladores y usuarios tengan propiedades más dinámicas y se puedan vincular a propiedades de otros elementos web (por ejemplo, una tarjeta de usuario impulsada por el documento seleccionado actualmente en un elemento web de biblioteca de documentos), el estado de la página (la tarjeta de usuario muestra el autor) o el contexto de la página (la tarjeta de usuario muestra el usuario actual).

Esta versión preliminar para desarrolladores se centra principalmente en el modelo de datos subyacente. Actualmente, ningún elemento web de origen expone propiedades. Tenemos un objeto de contexto de página de ejemplo y un control de panel de propiedades aproximado (centrado en el desarrollador) en el que puede escribir la ruta de acceso a la propiedad dinámica que quiere vincular a una propiedad del elemento web.

Todavía estamos trabajando en la experiencia de usuario final, pero queríamos que los desarrolladores lo probaran mientras tanto. Puede encontrar tutoriales y ejemplos en las siguientes ubicaciones:

Compatibilidad con administradores de paquetes adicionales (Yarn & PNPM)

El generador Yeoman y las herramientas de compilación ahora son compatibles con los administradores de paquetes de Yarn y PNPM, y npm.

Para usar esto, --package-manager opción de línea de comandos en el generador y puede especificar npm, **pnpm, o yarn.

Por ejemplo:

yo @microsoft/sharepoint --package-manager pnpm

Soporte para generadores Yeoman personalizados

Hemos rediseñado el generador para seguir los procedimientos recomendados. Esto debería permitirle usar nuestro generador para sus propios generadores personalizados. Comenzaremos una nueva iniciativa de código abierto sobre esto en la comunidad de desarrolladores de SharePoint (PnP) para ofrecer nuevas plataformas compatibles, como Angular Elements y Vue.js.

Cambios en esta versión

Muchas de las actualizaciones del marco no requieren realmente una actualización de los paquetes npm. Por ejemplo, hemos eliminado la ventana emergente de autenticación en la versión inicial del código de versión preliminar para el desarrollador de la API web, pero el cambio se implementa en el marco alojado en el servicio, por lo que no se requieren cambios para los desarrolladores.

Ha habido algunas actualizaciones que requieren explícitamente actualizaciones de paquetes:

  • Se agregó información de AAD al PageContext (aadInfo)
  • Se solucionaron problemas relacionados con sp-dialog y otros paquetes que no funcionaban correctamente en el entorno de trabajo
  • Se agregaron 10 reglas tslint adicionales de tslint-microsoft-config para detectar vulnerabilidades de seguridad comunes
  • Se solucionó un problema en la solución del paquete por el que las advertencias provocaban que la compilación fallara incorrectamente