Instalar o SDK do Node.js
Nesta página
Visão geral
O Atlas Device SDK for Node.js permite o desenvolvimento de aplicativos utilizando as linguagens JavaScript e TypeScript. O SDK do Node.js é mais adequado para escrever aplicativos do lado do servidor. Seu aplicativo Node.js pode ser um componente em uma pilha mais ampla que também inclui aplicativos iOS e Android.
O SDK do Node.js não é adequado para o desenvolvimento de aplicativos front-end.
Devido às limitações do ambiente do navegador, não é possível construir um aplicativo da web baseado em navegador com este SDK. Para aplicativos da web de front-end, use o SDK da Web.
Para o desenvolvimento de aplicativos móveis multiplataforma, use o SDK React Native.
Pré-requisitos
Antes de começar, verifique se seu ambiente atende os pré-requisitos a seguir:
Node.js versão 12.x ou posterior (incluindo Node.js versão 14)
Linux, macOS 10,8 (ou posterior) ou Windows 8 (ou posterior)
Instalação
Siga estas etapas para criar um projeto do Node.js e adicionar o SDK do Node.js a ele.
Dica
Atlas Device SDK e Realm
O SDK usa o banco de dados do Realm Core para persistência de dados do dispositivo. Quando você instala o Node.js SDK, os nomes dos pacotes refletem o nome do Realm.
Criar um projeto Node.js
Crie seu projeto Node.js criando um novo diretório para seu projeto e executando o npm init neste diretório. No exemplo abaixo, substitua MyApp pelo seu nome de projeto desejado. Responda a todos os prompts para preencher os detalhes do seu projeto.
mkdir MyApp && cd MyApp && npm init
Habilitar TypeScript (opcional)
TypeScript é um superconjunto de JavaScript que adiciona verificação de tipo estático e outros recursos destinados a tornar o desenvolvimento em escala de aplicativo mais robusto. Se você quiser usar o TypeScript, siga o guia oficial do Node Starter da equipe do TypeScript. O SDK suporta o TypeScript de forma nativa e se integra facilmente a um projeto TypeScript.
Instalação de IoT
Dica
Atlas Device SDK e Realm
O SDK usa o banco de dados do Realm Core para persistência de dados do dispositivo. Quando você instala o Node.js SDK, os nomes dos pacotes refletem o nome do Realm.
Para criar um projeto do Node.js e adicionar o SDK do Node.js em uma plataforma de Internet das Coisas (IoT), como o Raspberry Pi 2, 3 ou 4, executando o Raspberry Pi OS (antigo Raspbian), siga as etapas abaixo:
Instalar um compilador C++
A biblioteca de IoT do Node.js SDK não está distribuída como binária, portanto, você deve construí-la a partir da origem. Para fazer isso, você precisará de um compilador C++ funcional. Para instalar esse compilador em seu dispositivo IoT, execute o seguinte comando:
sudo apt install build-essential g++ libssl-dev
Criar um projeto Node.js
Crie seu projeto Node.js criando um novo diretório para seu projeto e executando o npm init neste diretório. No exemplo abaixo, substitua MyApp pelo seu nome de projeto desejado. Responda a todos os prompts para preencher os detalhes do seu projeto.
mkdir MyApp && cd MyApp && npm init
Habilitar TypeScript (opcional)
TypeScript é um superconjunto de JavaScript que adiciona verificação de tipo estático e outros recursos destinados a tornar o desenvolvimento em escala de aplicativo mais robusto. Se você quiser usar o TypeScript, siga o guia oficial do Node Starter da equipe do TypeScript. O SDK suporta o TypeScript de forma nativa e se integra facilmente a um projeto TypeScript.
Importar o SDK
Adicione a seguinte linha ao topo dos seus arquivos-fonte (JavaScript ou TypeScript) onde você deseja usar o SDK:
import Realm from "realm";