Aprender a instalar las herramientas Yeoman, Gulp, npm y Node.js es el primer paso para desarrollar en SharePoint.
Estas tres herramientas son básicas para el desarrollo de personalizaciones de SharePoint. A continuación describimos cada una de ellas:
- Yeoman: Es un generados de plantillas que nos permitirá rápidamente iniciar casi cualquier proyecto (no sólo SharePoint) creando los archivos iniciales de trabajo.
- Gulp: Es una automatizador de tareas muy útil en proyectos Web y con SharePoint.
- NPM: Es un administrador de paquetes node, que nos va a permitir intalar múltiples frameworks de forma fácil, entre ellos está Yeoman y Gulp.
- Node.js: Es un motor JavaScript asíncrono sobre el que podremos ejecutar aplicaciones. Como por ejemplo el administrador de paquetes NPM.
AVISO IMPORTANTE SOBRE NODE.JS:
Según la página de Microsoft https://docs.microsoft.com/en-us/sharepoint/dev/spfx/set-up-your-development-environment en este momento no es compatible la última versión de node.js con SharePoint.
Por lo que debemos instalar la versión NodeJS LTS version 10 (Descargar node-v10.20.1-x64.msi)
Teniendo en cuenta lo anterior. A continuación indicamos el orden de instalación. En primer lugar instalamos el motor JavaScript Node.js pero no la última versión desde https://nodejs.org/en/download/ si no como hemos dicho la versión v10.20 anteriormente comentada.
Si no lo hacemos e instalamos la última versión es posible que nos de el siguiente error: Error ReferenceError: primordials is not defined en Node.js
La propia instalación nos sugerirá instalar el administrador de paquetes npm por lo que la tarea no puede ser más fácil.
Ya dentro de la consola de comandos de Node.js (Node.js command prompt) usamos el gestor de paquetes npm para instalar Yeoman. Para ello escribimos en la consola de Node.js el siguiente comando:
npm install -g yo
Con Yeoman instalado ya podemos crear nuestros proyectos utilizando las plantillas que nos brinda.
Por ejemplo, para crear un nuevo WebPart para SharePont abrimos una ventana de PowerShell y escribimos
Finalmente también es interesante instalar el automatizador de tareas Gulp desde la consola de comandos de Node.js mediante el comando:
npm install -g gulp
