Compartir a través de

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

  • Artículo

En esta versión se presenta un nuevo evento de propiedad & en la API de elementos web para detectar el ancho de representación (y los cambios), se ha mejorado la compatibilidad con las soluciones de Microsoft Teams y se actualizan las versiones admitidas de Node.js.

Publicación: 28 de abril de 2021

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.

Actualizar proyectos de v1.11.0 a v1.12.1

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

    1. Desinstale el paquete v1.11.0 existente:

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

    2. Instale el paquete {version-release} actualizado de la versión 1.12:

      npm install @microsoft/{spfx-package-name}@1.12.1 --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

  • El botón Sincronizar con Teams del Catálogo de aplicaciones del espacio empresarial usará el manifiesto de la aplicación de Teams definido en la solución (si se presenta) para crear y publicar un paquete de aplicación de Teams en Microsoft Teams. Si un archivo de manifiesto de aplicación no está presente, SharePoint generará dinámicamente uno.
  • Se ha agregado una nueva API a la clase de elementos web SP Se ha agregado para determinar el ancho representado de un elemento web y, de manera opcional, controlar un evento cuando cambie.
  • Expanda notificaciones de lista para que funcionen tanto en listas como en bibliotecas de documentos.
  • Soporte preliminar para las aplicaciones de reunión de Microsoft Teams con SharePoint Framework: hay pendiente soporte completo para una corrección para la regresión del lado servidor

Cambios en esta versión

  • Agregar compatibilidad con Node.js v12.13.x & v14.15.x
    • Consulte Configurar el entorno de desarrollo de SharePoint Framework para obtener más información.
    • Se recomienda encarecidamente Gulp-CLI. Nuestra recomendación anterior era instalar Gulp v3 o v4 globalmente, pero la recomendación del equipo de Gulp es instalar solo la CLI de Gulp globalmente. Al usar la CLI de Gulp, puede tener proyectos que usen Gulp v3 y otros que usen Gulp v4.
  • Para todos los proyectos:
  • Para los proyectos que usen React:
    • Actualizar los paquetes react NPM (react&react-dom) a la versión 16.9.0.
    • Actualizar el paquete NPM react de la interfaz de usuario de Office / Microsoft Fluent UI (office-ui fabric-react) a la versión 7.156.0.
  • La ubicación predeterminada para los recursos usados en las implementaciones ha cambiado de ./temp/deploy a ./releases/assets. Para los proyectos creados antes de SPFx v1.12.1, debe actualizar la propiedad de archivo ./config/deploy-azure-storage.jsonworkingDir a la ubicación nueva: "workingDir": "./release/assets/". Para más información, consulte Implementar el elemento web del cliente de SharePoint en Azure CDN: Configurar los detalles de la cuenta de Azure Storage.

Desuso y elementos quitados en esta versión

  • Gulp v3 no es compatible (ni se instala global ni localmente) cuando se usa Node.js v12 +.

  • La configuración local está en desuso versión: esta es la última versión que admitirá la versión local.

  • Esta es la última versión que incluirá un solo generador que funciona para el momento y para SharePoint Online. Aún podrá crear proyectos de forma prem, simplemente con el sesos antiguos.

  • La tarea de gulp serve tarea ha quedado en desuso y ha cambiado su nombre a serve-deprecated. Para solucionarlo, se ha actualizado gulpfile.js en los proyectos nuevos de la versión 1.12.1 de SPFx para agregar un alias serve en la tarea cuyo nombre se ha cambiado a serve-deprecated. Sin embargo, si va a actualizar un proyecto a la versión 1.12.1 de SPFx, necesita editar el archivo gulpfile.js para que la tarea gulp serve siga funcionando.

    Al actualizar proyectos de SPFx a la versión 1.12.1, agregue lo siguiente antes de la línea build.initialize(require('gulp'));:

    var getTasks = build.rig.getTasks;
build.rig.getTasks = function () {
  var result = getTasks.call(build.rig);

  result.set('serve', result.get('serve-deprecated'));

  return result;
};

Versiones & de Gulp Node.js v12+

Gulp v3 no es compatible con Node.js v12 + (ref gulpjs / gulp / # 2324).

Esto no es un cambio con SPFx Se mencionó aquí para llamar la atención, ya que esta versión de SPFx agrega compatibilidad con Node.js v12.