Gerenciar Dependências

Como adicionar bibliotecas a uma cena

Muitas vezes, sua cena pode precisar de funcionalidades que já estão encapsuladas em uma biblioteca reutilizável. Usar bibliotecas externas pode tornar seu trabalho muito mais fácil.

Você pode importar bibliotecas externas em um projeto Decentraland e então referenciar os systems, components ou functions descritos nessas bibliotecas.

Verifique o page de Examples para encontrar uma série de bibliotecas, tanto criadas pela Decentraland Foundation quanto por membros da comunidade, que resolvem problemas comuns.

Via o CLI

Instalar

Para instalar uma biblioteca na pasta do seu projeto, execute npm i e o nome da biblioteca no caminho raiz do seu projeto. Por exemplo:

npm i @dcl-sdk/utils

📔 Nota: Pode ser necessário executar npm run start ou npm run build após instalar a biblioteca para que as dependências da biblioteca sejam instaladas.

Atualizar

Se seu package.json arquivo lista a versão da cena como @latest, então execute npm i para atualizar todas as bibliotecas para suas correspondentes versões mais recentes.

Se seu package.json referencia um número de versão específico, você pode atualizá‑lo executando o comando para instalar a biblioteca, adicionando @ e o número da versão no final. Por exemplo:

npm i @dcl-sdk/[email protected]

Desinstalar

Para remover uma biblioteca das dependências da sua cena execute npm rm e o nome da biblioteca. Por exemplo:

npm rm @dcl-sdk/utils

É uma boa prática remover quaisquer bibliotecas que você não esteja usando. Bibliotecas não utilizadas ainda ocupam espaço na cena, afetando a experiência do jogador ao baixar e executar sua cena.