Gestionar dependencias

Cómo agregar librerías a una escena

Muchas veces, tu escena puede necesitar funcionalidad que ya está encapsulada en una biblioteca reutilizable. Usar bibliotecas externas puede facilitar mucho tu trabajo.

Puedes importar bibliotecas externas en un proyecto de Decentraland y luego referenciar los systems, components o functions descritos en esas bibliotecas.

Consulta el página de Examples para encontrar una serie de bibliotecas, tanto creadas por la Decentraland Foundation como por miembros de la comunidad, que resuelven problemas comunes.

Vía la CLI

Instalar

Para instalar una biblioteca en la carpeta de tu proyecto, ejecuta npm i y el nombre de la biblioteca en la ruta raíz de tu proyecto. Por ejemplo:

npm i @dcl-sdk/utils

📔 Nota: Puede que necesites ejecutar npm run start u npm run build tras instalar la biblioteca para que se instalen las dependencias de la biblioteca.

Actualizar

Si tu package.json file lista la versión de la escena como @latest, entonces ejecuta npm i para actualizar todas las bibliotecas a sus correspondientes versiones más recientes.

Si tu package.json hace referencia a un número de versión específico, puedes actualizarla ejecutando el comando para instalar la biblioteca, añadiendo @ y el número de versión al final. Por ejemplo:

npm i @dcl-sdk/[email protected]

Desinstalar

Para eliminar una biblioteca de las dependencias de tu escena ejecuta npm rm y el nombre de la biblioteca. Por ejemplo:

npm rm @dcl-sdk/utils

Es una buena práctica eliminar las bibliotecas que no estés usando. Las bibliotecas no utilizadas aún ocupan espacio en la escena, afectando la experiencia del jugador al descargar y ejecutar tu escena.