Como instalar pacotes de biblioteca do Azure para JavaScript

O SDK do Azure para JavaScript é composto por muitas bibliotecas com versão independente que podem ser instaladas em ambientes JavaScript padrão. Essa abordagem modular permite que você instale apenas os pacotes necessários e gerencie-os individualmente para melhor controle sobre dependências e atualizações.

As bibliotecas para ambientes JavaScript padrão são listadas no índice de pacotes, e todos os pacotes do Azure são publicados nos escopos @azure e @azure-rest. Esses pacotes são mantidos pela Microsoft e podem ser encontrados no npm no publicador microsoft1es. Essa estrutura permite que você provisione e gerencie facilmente os recursos do Azure usando bibliotecas de gerenciamento (com nomes começando com @azure/arm-) e interaja com esses recursos do código do aplicativo.

Pré-requisitos

• Node.js LTS.
  Saiba mais sobre Node.js compatibilidade com o Azure.
• npm ou yarn.
  Verifique se o gerenciador de pacotes está atualizado para evitar problemas de instalação.

Se você tiver problemas durante a instalação de pacotes, consulte nosso guia de solução de problemas.

Instalar a versão mais recente de uma biblioteca

Quando você instala uma biblioteca sem especificar uma versão, o gerenciador de pacotes recupera a versão mais recente disponível no índice do pacote.

npm

npm install <library>

fio

yarn add <library>

Instalar versões de biblioteca específicas

Às vezes, talvez seja necessário instalar uma versão específica ou uma versão prévia de uma biblioteca para teste de compatibilidade ou para obter acesso antecipado a novos recursos. Quando você instala uma versão específica, você está fixando sua dependência, o que significa que seu projeto continuará usando essa versão e não receberá automaticamente atualizações ou correções. Embora a fixação possa ser útil em determinados cenários, geralmente recomendamos usar a versão mais recente sempre que possível para se beneficiar de melhorias contínuas e atualizações de segurança.

npm

npm install <library>@<version-number>

fio

yarn add <library>@<version-number>

Pacotes de visualização

Ao instalar pacotes de pré-visualização, procure tags de pré-lançamento. Esses pacotes fornecem acesso antecipado a novos recursos, mas podem não ser tão estáveis quanto as versões gerais. Por exemplo:

• next: esta tag é usada para a versão beta atual do próximo lançamento.
• dev: esta tag é usada para a versão alfa atual do lançamento futuro.

Verificar uma instalação de biblioteca

Após a instalação, você pode verificar se a versão correta da biblioteca está instalada.

npm

npm list <library>

fio

yarn list <library>

Desinstalar uma biblioteca

npm

npm uninstall <library>

fio

yarn remove <library>

Resolução de problemas

• Erros de instalação: verifique se o Node.js e seu gerenciador de pacotes (npm ou yarn) estão atualizados.
• Conflitos de versão: verifique se a versão especificada está disponível no índice do pacote.
• Problemas de rede: Certifique-se de verificar as configurações de conexão à Internet e proxy se os downloads de pacotes estiverem lentos ou falharem.

Recursos adicionais

• Índice de Biblioteca do SDK do Azure Procurar pacotes disponíveis.
• Node.js Compatibilidade para o Azure – Saiba mais sobre as versões de Node.js com suporte.
• Solução de problemas de npm e yarn – diretrizes comuns de solução de problemas de erro.
• Repositório GitHub do SDK do Azure – para relatar problemas e contribuir.