Ejercicio: Configurar el entorno de desarrollo de SharePoint Framework
- 15 minutos
En este ejercicio, configurará el entorno de desarrollo local con todo lo que necesita para empezar a crear componentes de SharePoint Framework.
Instalar un editor de código
Necesitará un editor de texto para editar los archivos de código. No hay requisitos para lo que necesita en un editor de texto.
El resto de este laboratorio, y la mayoría de los ejemplos que encontrará de Microsoft, usan Visual Studio Code.
Instalar Node.js
Las herramientas usadas para compilar, depurar y empaquetar proyectos de SharePoint Framework se compilan con Node.js, que es un entorno de ejecución que permite que JavaScript se ejecute de forma local y no en un navegador. Por lo tanto, el primer paso es instalar el entorno de ejecución, Node.js, antes de instalar las herramientas necesarias.
Nota:
Node.js está disponible en dos versiones diferentes: la versión de soporte técnico a largo plazo (también conocida como LTS) es la versión más estable que se recomienda para la mayoría de los usuarios, mientras que la versión actual contiene las características más recientes.
Antes de instalar Node.js, debe comprobar que no lo ha instalado anteriormente. Abra un símbolo del sistema o un terminal (según su plataforma para desarrolladores) y ejecute el siguiente comando:
node -v
Si se devuelve un número de versión, ya tiene Node.js. Las versiones de Node.js que puede usar dependen de los entornos de destino.
Si va a compilar proyectos para SharePoint Server 2016, debe usar el SharePoint Framework v1.1.0 debido a las dependencias de versión del lado servidor. Esto significa que debe instalar Node.js v6.x. Para obtener más información sobre el desarrollo de SharePoint Framework con SharePoint Server 2016, vea desarrollo de SharePoint Framework con SharePoint Server 2016 Feature Pack 2 y desarrollo de SharePoint Framework para SharePoint Server 2016 con Feature Pack 2. para obtener información sobre cómo solucionar un problema de control de versiones con una de las dependencias de Yeoman.
Si va a compilar proyectos para SharePoint Server 2019, debe usar el SharePoint Framework v1.4.1 debido a las dependencias de versión del lado servidor. Esto significa que debe instalar Node.js v6.x o v8.x. Para obtener más información sobre el desarrollo de SharePoint Framework con SharePoint Server 2019, consulte desarrollo de SharePoint Framework con SharePoint Server 2019 y guía definitiva para desarrolladores: SharePoint Framework para SharePoint Server 2019.
Si va a compilar proyectos para SharePoint Server Edición de Suscripción con la actualización 23H1, debe usar el SharePoint Framework v1.5.1 debido a las dependencias de versión del lado servidor. Esto significa que debe instalar Node.js v6.x o v8.x. Para obtener más información sobre SharePoint Framework desarrollo con SharePoint 2019, vea desarrollo de SharePoint Framework con SharePoint Server 2019 y Guía definitiva para desarrolladores: SharePoint Framework para SharePoint Server SE.
Si va a compilar proyectos para SharePoint Online, se recomienda instalar la versión más reciente de Node.js v18.x y la versión más reciente del SharePoint Framework, que actualmente es v1.20.0.
Si ya tiene una versión de Node.js compatible con los entornos de destino, vaya a la sección siguiente.
Abra un navegador y vaya al sitio de Node.js Foundation: https://www.nodejs.org.
Es posible que la versión actual de LTS no sea compatible con la versión actual del SharePoint Framework, por lo que navegará más por el sitio para asegurarse de descargar el instalador adecuado.
Seleccione Descargas en la navegación del menú superior, desplácese hasta la parte inferior de la página y seleccione Versiones anteriores.
En la página Versiones anteriores, seleccione la versión de Node.js que quiere instalar.
Descargue el instalador o binario adecuado para la plataforma que está usando.
Ejecute el instalador y acepte todas las opciones predeterminadas. Esto instalará Node.js y npm. npm es un administrador de paquetes que Node.js usa, de forma similar a . NuGet de NET.
Importante
El resto del material de este módulo y los demás módulos de esta ruta de aprendizaje suponen que está compilando proyectos para SharePoint Online.
Instalar las herramientas necesarias
La experiencia de desarrollo de SharePoint Framework usa un conjunto de herramientas basadas en Node.js que son populares entre los desarrolladores web. Estas herramientas se basan en Node.js, lo que significa que se pueden usar en cualquier plataforma y funcionarán de la misma manera. Esto incluye Windows, macOS y Linux.
Instalar Yeoman
Yeoman es un motor de scaffolding, que ejecuta generadores que formulan preguntas al usuario. En función de las respuestas a estas preguntas, Yeoman crea las carpetas y los archivos definidos por el generador.
Abra un símbolo del sistema o una ventana de terminal y ejecute el siguiente comando para instalar Yeoman globalmente con npm:
npm install yo --global
Instalación de la CLI de Gulp
Gulp es una utilidad del ejecutor de tareas. Es similar a MSBuild, una herramienta que usan los desarrolladores de .NET y Visual Studio para compilar proyectos, empaquetar soluciones e iniciar una experiencia de depuración.
Gulp se incluye en dos partes: la CLI de Gulp (utilidad de línea de comandos) que se instala globalmente en el equipo y, a continuación, los paquetes locales de Gulp incluidos en cada proyecto individual.
Antes del lanzamiento de SharePoint Framework v1.13.1, Microsoft recomendaba instalar Gulp globalmente. En el momento del lanzamiento de SharePoint Framework v1.13.1, dicha recomendación cambió para la instalación global de la CLI de Gulp. Esto le permite tener algunos proyectos que usan Gulp v3 y otros proyectos que usan Gulp v4.
Importante
Si anteriormente instaló Gulp globalmente, debe desinstalarlo antes de instalar la CLI de Gulp. Para comprender las diferencias entre el paquete gulp y gulp-cli, consulte Always install gulp-cli globalmente, no gulp.
Para desinstalar Gulp, abra una ventana de símbolo del sistema o terminal y ejecute el siguiente comando:
npm uninstall gulp --global
Para instalar la CLI de Gulp, abra una ventana de símbolo del sistema o terminal y ejecute el siguiente comando:
npm install gulp-cli--global
Instalar el generador de Yeoman de SharePoint Framework
Microsoft ha creado un generador de Yeoman para aplicar scaffolding a proyectos de SharePoint Framework.
Para instalar la versión más reciente del generador de SharePoint Framework Yeoman globalmente con npm, abra una ventana del símbolo del sistema o terminal y ejecute el siguiente comando:
npm install @microsoft/generator-sharepoint --global
Para instalar una versión específica del generador de SharePoint Framework Yeoman globalmente con npm, abra una ventana de símbolo del sistema o terminal y ejecute el siguiente comando:
npm install @microsoft/generator-sharepoint@[version number] --global
Por ejemplo:
npm install @microsoft/generator-sharepoint@1.5.1 --global
Resumen
En este ejercicio, configurará el entorno de desarrollo local con todo lo que necesita para empezar a crear componentes de SharePoint Framework.