Notas de la versión de SharePoint Framework v1.6
Esta versión contiene dos características principales:
- La versión final de la característica WebAPI vista por primera vez en v1.4.1
- Compatibilidad con las extensiones que se configurarán en todo el espacio empresarial sin necesidad de activar o configurar todos los sitios.
Publicado: 5 de septiembre 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.5.1 a v1.6
- En el archivo package.json del proyecto, identifique todos los paquetes SPFx v1.5.1. Para cada paquete SPFx:
Desinstale el paquete v1.5.1 existente:
npm uninstall @microsoft/{spfx-package-name}@1.5.1
Instale el paquete v1.6 actualizado:
npm install @microsoft/{spfx-package-name}@1.6.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
API web (disponibilidad general)
Para la característica WebAPI, hay algunos cambios introducidos en el trabajo de disponibilidad general (disponibilidad general). Todo el acceso a los recursos protegidos de AAD se controla mediante una aplicación de AAD de terceros y una entidad de servicio. La aplicación se crea la primera vez que un administrador de inquilinos aprueba un ámbito de permisos y se crea sin permisos. Por lo tanto, cualquier conexión que realice a los datos (ya sea a través del Microsoft Graph o una llamada a un punto de conexión que use AAD para sus permisos) debe permitirse explícitamente.
Importante
Se deberán volver a conceder todos los permisos concedidos anteriormente a la versión v1.6.0, ya que hemos cambiado la aplicación de AAD que se usa.
- Use el
MSGraphClient
. Existe en el contexto del componente (elemento web o extensión). Por motivos de rendimiento, el código completo se carga a petición, por lo que se accede a él a través de una promesa. - Deténgalo con
GraphHttpClient
(si aún no lo ha detenido). En algún momento del mes siguiente, lo quitaremos completamente del código. Cualquier solución que tenga que usar dejará de funcionar. - De forma similar a
MSGraphClient
, hay unaAadHttpClient
general fuera del contexto para realizar llamadas a puntos de conexión protegidos de AAD y un AadTokenProvider que puede usar para obtener tokens de autenticación manualmente.
Implementación de extensiones en todo el espacio empresarial
Ahora puede realizar configuraciones para extensiones para todo el espacio empresarial. La manera más fácil (como desarrollador) de implementar en el inquilino es modificar el archivo \SharePoint\ClientInstance.xml (creado con una nueva solución v1.6.0). Esto crea una entrada en una nueva lista en el catálogo de aplicaciones (extensiones para todo el espacio empresarial). También puede modificar esa lista directamente como propietario del catálogo de aplicaciones.
Cambios en esta versión
Cambios de compilación y herramientas
Estamos intentando distanciarnos de algunos de los contenedores en torno a las herramientas de compilación comunes. Los dos primeros son los pasos del compilador tslint y ts. Debido a estos cambios, el código anterior no se compilará sin algunos cambios.
- En primer lugar, debe tener un archivo *.ts en la raíz del directorio de origen (de forma predeterminada, ahora creamos uno en \src denominado index.ts que está vacío).
- En segundo lugar, el archivo tslint.json ha cambiado la ubicación (de \config a la raíz del proyecto) y el formato. ahora es solo un archivo tslint.json estándar. Lo más fácil es crear un nuevo proyecto y copiar el archivo tslint.json desde él.
- En tercer lugar, tome el archivo tsconfig.json de la raíz del nuevo proyecto en el paso 2 y cópielo en la raíz del proyecto original. Si ha realizado cambios en el archivo tsconfig.json, querrá combinarlos.
Promoción de clases CSS a disponibilidad general
Encontramos algunas clases en el paquete @microsoft/sp-dialog que se marcaron como Beta. Las hemos trasladado al público.
Nota
Esta es la última versión en la que las herramientas de compilación admitirán Node.js v6.