Skip to main content

Configurar ferramentas de linha de comando

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

  • Identificar a ferramenta de linha de comando que ajuda a instalar pacotes usando a interface de linha de comando.
  • Identificar a ferramenta de software que é a sucessora do plug-in IDE Force.com para desenvolvimento no Salesforce.

Ferramentas de linha de comando do desenvolvedor

As ferramentas de linha de comando, como npm e Salesforce CLI, dão aos desenvolvedores uma força em seus projetos pela sua fácil integração com outras ferramentas de desenvolvedor. A maioria dos programas de software tem uma CLI ou plug-ins que você pode instalar para seu projeto. Decidir quais programas e ferramentas instalar depende inteiramente de você e das necessidades do seu projeto.

Nesta unidade, você instala o Visual Studio Code (VS Code) e configura as ferramentas de linha de comando Node.js, npm e Salesforce CLI.

Instalar o Visual Studio Code

O Visual Studio Code é o editor de código escolhido pela Salesforce porque é altamente personalizável e multiplataforma. No VS Code, você pode configurar e instalar as Extensões do Salesforce. As Extensões do Salesforce para Visual Studio Code são as sucessoras do plug-in IDE Force.com para desenvolvimento no Salesforce no desktop.

Vamos instalar o Visual Studio Code (VS Code) e configurar a extensão.

  1. Instale o Visual Studio Code de https://code.visualstudio.com/Download.
  2. Abra o aplicativo Visual Studio Code.

Instalar as Extensões do Salesforce do Visual Studio Code

As Extensões do Salesforce fornecem recursos como conclusão de código, destaque de sintaxe, depuração de Apex e muito mais para a Salesforce Lightning Platform.

  • No VS Code, clique no menu Exibir e selecione Extensões.
  • Na caixa de pesquisa, digite salesforce extension pack (pacote de extensões do Salesforce).
  • Clique em Instalar (ou Atualizar se você já tiver uma versão anterior do pacote de extensão instalado e ele precisar ser atualizado).
    As informações do cabeçalho do Pacote de Extensão do Salesforce incluem o número de downloads, a classificação por estrelas e uma breve descrição: Extensões para desenvolvimento na Salesforce Platform.
  • Quando o pacote de extensão for instalado, reinicie o Visual Studio Code.

Encontrar seu shell

Agora que você tem o VS Code configurado, vamos abrir uma nova janela de terminal e identificar que shell você possui em seu computador.

  1. No VS Code, clique em Terminal > Novo terminal.
  2. Acima da janela do terminal, localize o menu suspenso do shell. Selecione a lista suspensa ou leia a seleção atual para ver o shell padrão no seu computador.

No macOS/Linux, você vê bash ou zsh.

Shell BASH selecionado na barra de navegação da janela do terminal.

Shell ZSH selecionado na barra de navegação da janela do terminal.

No Windows, você vê o PowerShell.

PowerShell selecionado na barra de navegação da janela do terminal.

Mais tarde, você poderá instalar outros shells e modificar sua configuração como quiser. Por enquanto, vamos usar os shells padrão.

Configurar Node.js e npm

Existem ferramentas comuns de desenvolvedores que podem facilitar o trabalho na CLI. Por exemplo, se você estiver desenvolvendo Componentes Web do Lightning ou trabalhando em um ambiente de tempo de execução JavaScript, como o Node.js, provavelmente usará a ferramenta npm para instalar e atualizar pacotes. A ferramenta npm por meio da interface de linha de comando ajuda a instalar pacotes rapidamente e mantém esses pacotes atualizados por meio de comandos simples.

Nota

Não estamos verificando se isso está instalado no seu sistema. Node.js e npm não são mantidos pela Salesforce. Instale essas ferramentas a seu critério. Após a instalação, reinicie o VS Code.

  1. Instale o Node.js (selecione a versão LTS - Suporte a longo prazo).
  2. Teste a instalação concluída do Node.js verificando a versão instalada:
    node -v
  3. Para ver se você tem npm instalado, execute o seguinte comando:
    npm -v

Janela da linha de comando node -v, v12.2.0 e npm-v 6.14.1.

  1. Se você precisar atualizar sua versão de npm (que também atualizará sua versão do Node), execute o seguinte comando:
    npm install npm@latest -g

Se você recebeu uma mensagem de erro de acesso a npm depois de executar o comando npm install npm@latest -g, confira os documentos oficiais de npm sobre a solução de erros de permissão.

Mensagem de erro de npm na interface de linha de comando informando que a operação foi rejeitada devido ao usuário não ter permissões para acessar o arquivo. Tente executar o comando como raiz/administrador.

Para guias de instalação e dicas, confira a página Installing Node.js via package manager (Como instalar o Node.js pelo gerenciador de pacotes).

Instalar e atualizar a Salesforce CLI

Em seguida, é hora de instalar (ou atualizar) a Salesforce CLI. Você usa comandos da Salesforce CLI para criar organizações temporárias a fim de desenvolver e testar personalizações e sincronizar código-fonte entre organizações e repositórios de origem. Vamos instalar e atualizar a Salesforce CLI.

  1. Instale a Salesforce CLI de https://developer.salesforce.com/tools/sfdxcli.
  2. No VS Code, clique em Terminal > Novo terminal.
  3. Verifique se a versão do sfdx-cli está atualizada executando o seguinte comando.
    sf update (atualização do sf)

Agora você tem uma configuração poderosa que permite que fazer alguns projetos de desenvolvimento bem legais na plataforma. Uma vez instalada a Salesforce CLI, já estará tudo pronto para você começar a aprender o Salesforce DX. Para começar, confira o projeto, Início rápido: Salesforce DX.

Recursos

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback