Usar o Visual Studio Code para desenvolvimento do Salesforce
Acompanhar com o Trail Together
Deseja acompanhar um instrutor enquanto trabalha nesta etapa? Veja este vídeo que faz parte da série Trail Together no Trailhead Live.
(Este clipe começa na marca dos 19:41 minutos, caso você queira retroceder e ver o início da etapa novamente.)
Terminal vs. paleta de comandos
Assim como com qualquer boa ferramenta de desenvolvimento, há mais de uma maneira de fazer as coisas com o Visual Studio Code. As duas maneiras principais de interagir com a CLI do Salesforce são por meio do terminal integrado ou da janela de abertura rápida.
Para exibir a janela de abertura rápida, pressione Ctrl+P no Windows ou Cmd+P no macOS. Se você digitar ?
, poderá visualizar o menu de ajuda. Neste módulo, usaremos a janela de abertura rápida no modo de paleta de comandos, o que nos permite mostrar e executar comandos.
Criar um projeto
- Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
- Certifique-se de que o novo prompt começa com
>
.
- Digite
SFDX:Create Project
(SFDX: Criar projeto).
- Selecione SFDX: Create Project.
- Selecione Standard (Padrão).
- Digite o nome do projeto
VSCodeQuickstart
e pressione Enter.
- Selecione sua área de trabalho como o lugar para criar o projeto a fim de facilitar sua localização mais tarde.
- Aguarde a abertura da nova janela do Visual Studio Code. Você deve ver uma indicação de que a extensão está preparando seu projeto antes de preencher o explorador de arquivos.
Pesquisar seus arquivos
- Pressione Ctrl+P no Windows ou Cmd+P no macOS para abrir a paleta de comandos. Isso muda o foco para a pesquisa de arquivos.
- Digite
project-scratch-def.json
no campo.
- Clique no resultado para abrir o arquivo.
- Clique no menu Search (Pesquisa) ().
- Pesquise
orgName
.
- No primeiro resultado encontrado em project-scratch-def.json.
- Altere o valor de
orgName
(após : e entre as “”) paraLearning VS Code
.
- Salve o arquivo pressionando Ctrl+S no Windows ou Cmd+S no macOS.
Autenticar em seu Playground
- Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
- Digite
SFDX:Authorize an Org
(SFDX: Autorizar uma organização).
- Selecione SFDX: Authorize an Org.
- Para aceitar a URL de login padrão, pressione Enter.
- Insira o alias
VSCodePlayground
.
- Observe que seu navegador padrão abre uma nova janela de login do Salesforce. Faça login em seu Playground usando o usuário e a senha do Playground recuperados na última etapa.
- Quando o acesso ao aplicativo conectado for solicitado, clique em Allow (Permitir).
- Feche a janela do navegador.
A janela do terminal da linha de comando retorna uma mensagem de sucesso quando a transação é concluída.
Criar uma classe do Apex
- Clique no menu Explorer (Explorador) ().
- No diretório VSCODEQUICKSTART, clique em force-app para mostrar a árvore de pastas. No diretório force-app/main/default, você encontra os metadados incluídos no projeto, como aplicativos, aura, classes e muito mais.
- Clique com o botão direito do mouse na pasta classes .
- Selecione SFDX: Create Apex Class.
- Insira o nome
AccountController
.
- Se o VS Code perguntar, selecione force-app/main/default/classes como o diretório ao qual você deseja adicionar
AccountController.cls
.
- No arquivo AccountController.cls recém-aberto, substitua o código padrão pelo seguinte:
public with sharing class AccountController { public static List<Account> getAllActiveAccounts() { return [SELECT Id, Name, Active__c FROM Account WHERE Active__c = 'Yes' WITH SECURITY_ENFORCED]; } }
- Salve o arquivo.
Consulta
Nossa nova classe do Apex tem um consulta SOQL nela, mas queremos ter certeza de que ela funciona como previsto antes de implantá-la em nossa organização. Usamos a paleta de comandos para executar a consulta em relação à nossa organização.
- Na linha 3 do código, destaque a consulta
SELECT Id,Name,Active__c FROM Account WHERE Active__c = 'Yes'
(não destaque usando WITH SECURITY_ENFORCED)
- Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
- Digite
SOQL
.
- Selecione
SFDX:Execute SOQL Query with Currently Selected Text
(Consulta SFDX:Execute SOQL com texto selecionado atualmente).
- Selecione API REST e pressione Enter.
- Na guia Output (Saída) da janela do terminal integrado, visualize os resultados de sua consulta. A janela deve conter um resumo que diz: SFDX: Execute SOQL Query ... ended with exit code 0. Isso significa que ela foi executada com êxito.
Implantar
A última etapa é implantar seu código no seu Playground usando o Visual Studio Code.
- Clique com o botão direito do mouse na pasta classes .
- Clique em SFDX: Deploy Source to Org.
- Na guia Output (Saída) do terminal integrado, exiba os resultados de sua implantação. Você também deve ter recebido um aviso que diz: SFDX: Deploy Source to Org ... ended with exit code 0. Isso significa que ela foi executada com êxito.
Últimas colocações
Você aprendeu a usar o Visual Studio Code e as Extensões do Salesforce. Viu como os recursos de um IDE podem ajudar a maximizar a eficiência de seu desenvolvimento. Agora, você está pronto para explorar alguns tópicos mais complexos, como a depuração com o Depurador de repetição do Apex, a personalização do seu editor para atender às suas necessidades e a execução de seus pipelines de desenvolvedor com o Visual Studio Code.