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 (Windows) ou Cmd+P (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

1. Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
   
2. Certifique-se de que o novo prompt começa com >.
   
3. Digite SFDX: Create Project (SFDX: Criar projeto).
   
4. Selecione SFDX: Create Project (SFDX: Criar projeto).
   
5. Selecione Standard (Padrão).
   
6. Digite o nome do projeto VSCodeQuickstart e pressione Enter.
   
7. Selecione sua área de trabalho como o lugar para criar o projeto a fim de facilitar sua localização mais tarde.
   
8. 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

1. 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.
   
2. Digite project-scratch-def.json no campo.
   
3. Clique no resultado para abrir o arquivo.
   
4. Clique no menu Search (Pesquisa) ().
   
5. Pesquise orgName.
   
6. No primeiro resultado encontrado em project-scratch-def.json.
   
7. Altere o valor de orgName (após o : e entre as “”) para Learning VS Code.
   
8. Salve o arquivo pressionando Ctrl+S no Windows ou Cmd+S no macOS.
   
   
   

Autenticar em seu Playground

1. Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
   
2. Digite SFDX: Authorize an Org (SFDX: Autorizar uma organização).
   
3. Selecione SFDX: Authorize an Org (SFDX: Autorizar uma organização).
   
4. Para aceitar a URL de login padrão, pressione Enter.
   
5. Insira o alias VSCodePlayground.
   
6. 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.
   
7. Quando o acesso ao aplicativo conectado for solicitado, clique em Allow (Permitir).
   
8. 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

1. Clique no menu Explorer (Explorador) ().
   
2. 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.
   
   
   

3. Clique com o botão direito do mouse na pasta classes .
   
4. Selecione SFDX: Create Apex Class (SFDX: Criar classe do Apex).
   
5. Insira o nome AccountController.
   
6. Se o VS Code perguntar, selecione force-app/main/default/classes como o diretório ao qual você deseja adicionar AccountController.cls.
   
7. 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];
     }
   }

8. 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.

1. 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)
   
2. Pressione Ctrl+Shift+P no Windows ou Cmd+Shift+P no macOS para abrir a paleta de comandos.
   
3. Digite SOQL.
   
4. Selecione SFDX:Execute SOQL Query with Currently Selected Text.
   
5. Selecione API REST e pressione Enter.
   
6. 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 (Executar consulta SOQL)... exibindo os registros que encontrou. Isso significa que ela foi executada com êxito.
   
   
   

Implantar

A última etapa é implantar seu código no seu Playground usando o Visual Studio Code.

1. Clique com o botão direito do mouse na pasta classes .
   
   
   

2. Clique em SFDX: Deploy This Source to Org (SFDX: Implantar essa fonte na organização).
   
3. 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 This Source to Org (Implantar essa fonte na organização). 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.