Atalhos da disciplina ELT85B

Por padrão, o Prompt de Comando, o PowerShell e o Git Bash abrem na sua pasta de usuário, e o VS Code abre a última pasta usada. Em toda aula, você perde tempo navegando até a pasta certa e corre o risco de clonar um repositório fora da pasta-mãe.

Este guia cria quatro atalhos na Área de Trabalho que já abrem dentro de %USERPROFILE%\ELT85B:

Atalho	Abre	Uso na disciplina
ELT85B - CMD	Prompt de Comando	Comandos dos guias (padrão da disciplina)
ELT85B - PowerShell	Windows PowerShell	Alternativa ao cmd
ELT85B - Git Bash	Terminal Bash do Git	Comandos no estilo Linux
ELT85B - VS Code	VS Code na pasta-mãe	Visão geral dos repositórios

Antes de começar

Confira o ambiente (faça a configuração uma vez por máquina; a verificação, a cada aula):

1. Instalar as ferramentas — git, GitHub CLI e VS Code
2. Configurar o git — nome, e-mail e editor padrão (uma vez)
3. Verificar git, gh e VS Code — deve mostrar as versões e Logged in to github.com

Verificação rápida de versão instalada:

git -v && gh --version && code -v && pio --version && wokwi-cli -V && wsl --version && docker --version

Verificação rápida de autenticação:

git config --get-regexp ^user\. && gh auth status && code --list-extensions --profile "ESP32IO"

Pré-requisito

Este guia parte da pasta-mãe ELT85B descrita no guia da máquina compartilhada. Se ela não existir, o script abaixo a cria.

Máquina compartilhada

Os atalhos ficam na sua Área de Trabalho e apontam para a sua pasta. Eles são removidos no fim da aula junto com a pasta-mãe (veja Remover os atalhos).

Objetivos

• Criar atalhos para o CMD, o PowerShell, o Git Bash e o VS Code que abram na pasta ELT85B.
• Definir o Prompt de Comando como terminal padrão dentro do VS Code.
• Verificar em qual pasta cada atalho abre.
• Remover os atalhos antes de sair do laboratório.

Como um atalho decide a pasta inicial

Todo atalho do Windows (.lnk) tem dois campos que importam aqui:

• Destino: o programa que será aberto, com seus parâmetros.
• Iniciar em: a pasta em que o programa começa.

Os atalhos da disciplina usam %USERPROFILE%\ELT85B no campo Iniciar em. Por isso, ao abrir o terminal, o comando cd (ou pwd) já mostra a pasta-mãe.

Parte 1 — Criar os atalhos

Com script (recomendado)

O script atalhos-elt85b.cmd cria os quatro atalhos de uma vez e também sabe removê-los no fim da aula.

1. Abra um Prompt de Comando (Win+R, digite cmd, Enter) e crie o arquivo dentro da pasta-mãe:

cmd

mkdir "%USERPROFILE%\ELT85B"
notepad "%USERPROFILE%\ELT85B\atalhos-elt85b.cmd"

O Bloco de Notas pergunta se deseja criar o arquivo. Clique em Sim.

2. Cole o conteúdo abaixo (ou baixe o arquivo), salve com Ctrl+S e feche o Bloco de Notas.

atalhos-elt85b.cmd

@echo off
rem ============================================================
rem  atalhos-elt85b.cmd - atalhos da disciplina ELT85B
rem
rem  Uso:
rem    atalhos-elt85b.cmd           cria os atalhos na Area de Trabalho
rem    atalhos-elt85b.cmd remover   apaga os atalhos da Area de Trabalho
rem
rem  Todos os atalhos abrem na pasta %USERPROFILE%\ELT85B
rem ============================================================
setlocal
set "PASTA=%USERPROFILE%\ELT85B"

if /i "%~1"=="remover" goto remover

if not exist "%PASTA%" mkdir "%PASTA%"
echo Pasta da disciplina: %PASTA%
echo.

rem --- CMD -------------------------------------------------------
set "A_NOME=ELT85B - CMD"
set "A_ALVO=%ComSpec%"
set "A_ARGS=/k title ELT85B"
set "A_JANELA=1"
call :criar

rem --- PowerShell ------------------------------------------------
set "A_NOME=ELT85B - PowerShell"
set "A_ALVO=%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe"
set "A_ARGS=-NoExit -NoLogo"
set "A_JANELA=1"
call :criar

rem --- Git Bash --------------------------------------------------
set "A_ALVO="
if exist "%ProgramFiles%\Git\git-bash.exe" set "A_ALVO=%ProgramFiles%\Git\git-bash.exe"
if not defined A_ALVO if exist "%LOCALAPPDATA%\Programs\Git\git-bash.exe" set "A_ALVO=%LOCALAPPDATA%\Programs\Git\git-bash.exe"
if not defined A_ALVO goto sem_gitbash
set "A_NOME=ELT85B - Git Bash"
set A_ARGS="--cd=%PASTA%"
set "A_JANELA=1"
call :criar
goto vscode
:sem_gitbash
echo [aviso] Git Bash nao encontrado. Atalho nao criado.

rem --- VS Code ---------------------------------------------------
:vscode
where code >nul 2>nul
if errorlevel 1 goto sem_vscode
set "A_NOME=ELT85B - VS Code"
set "A_ALVO=%ComSpec%"
set A_ARGS=/c code "%PASTA%"
set "A_JANELA=7"
call :criar
goto pronto
:sem_vscode
echo [aviso] Comando code nao encontrado no PATH. Atalho nao criado.

:pronto
echo.
echo Pronto. Os atalhos estao na Area de Trabalho.
goto fim

rem --- Remover ---------------------------------------------------
:remover
powershell -NoProfile -Command "$d=[Environment]::GetFolderPath('Desktop'); Get-ChildItem -LiteralPath $d -Filter 'ELT85B - *.lnk' | ForEach-Object { Remove-Item -LiteralPath $_.FullName; Write-Host ('[removido] ' + $_.Name) }"
goto fim

:fim
endlocal
exit /b 0

rem --- Sub-rotina: cria um atalho a partir das variaveis A_* ------
:criar
powershell -NoProfile -Command "$d=[Environment]::GetFolderPath('Desktop'); $s=(New-Object -ComObject WScript.Shell).CreateShortcut((Join-Path $d ($env:A_NOME + '.lnk'))); $s.TargetPath=$env:A_ALVO; $s.Arguments=$env:A_ARGS; $s.WorkingDirectory=$env:PASTA; $s.WindowStyle=[int]$env:A_JANELA; $s.Description='Disciplina ELT85B'; $s.Save(); Write-Host ('[ok] ' + $env:A_NOME)"
exit /b 0

3. Execute o script:

cmd

"%USERPROFILE%\ELT85B\atalhos-elt85b.cmd"

Saída esperada:

Pasta da disciplina: C:\Users\aluno\ELT85B

[ok] ELT85B - CMD
[ok] ELT85B - PowerShell
[ok] ELT85B - Git Bash
[ok] ELT85B - VS Code

Pronto. Os atalhos estao na Area de Trabalho.

Se aparecer uma linha [aviso], o programa correspondente não foi encontrado. Os outros atalhos são criados normalmente.

Detalhes que fazem diferença

• O script é todo em ASCII (sem acentos) para não ter problema de codificação no cmd.
• Os atalhos são criados com a ajuda do PowerShell, mas você roda tudo pelo cmd: não é preciso mudar a política de execução do PowerShell.
• A Área de Trabalho é localizada automaticamente, mesmo quando está redirecionada para o OneDrive.
• O atalho do VS Code usa o comando code e abre minimizado a janela auxiliar do cmd, que fecha sozinha.

Manualmente

Para cada atalho:

1. Clique com o botão direito na Área de Trabalho, Novo e depois Atalho.
2. Em Digite o local do item, cole o Destino da tabela abaixo e avance.
3. Digite o Nome e clique em Concluir.
4. Clique com o botão direito no atalho criado e abra Propriedades.
5. No campo Iniciar em, digite %USERPROFILE%\ELT85B e clique em OK.

Nome	Destino
ELT85B - CMD	%ComSpec% /k title ELT85B
ELT85B - PowerShell	%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoExit -NoLogo
ELT85B - Git Bash	"C:\Program Files\Git\git-bash.exe"
ELT85B - VS Code	%ComSpec% /c code .

No atalho do VS Code, mude também Executar para Minimizada, para não aparecer a janela do cmd que abre o VS Code.

Git Bash

Não copie o atalho padrão do Git Bash do menu Iniciar: ele usa o parâmetro --cd-to-home, que ignora o campo Iniciar em e sempre abre na pasta de usuário.

Verificação dos atalhos

Abra cada atalho e rode o comando indicado. Preveja a saída antes de executar.

CMD

ELT85B - CMD

cd

C:\Users\aluno\ELT85B

O título da janela também deve mostrar ELT85B.

PowerShell

ELT85B - PowerShell

Get-Location

Path
----
C:\Users\aluno\ELT85B

Git Bash

ELT85B - Git Bash

pwd

/c/Users/aluno/ELT85B

No Git Bash, C:\ aparece como /c/ e as barras são normais (/).

VS Code

O VS Code abre com ELT85B no Explorer, listando os repositórios clonados. Se aparecer o aviso de confiança, marque a opção de confiar na pasta-mãe (veja o guia da máquina compartilhada).

Parte 2 — Configurar o terminal do VS Code

O VS Code tem um terminal integrado (Ctrl+`). Para que ele use o cmd, como os guias da disciplina:

1. Ctrl+Shift+P e execute Terminal: Select Default Profile.
2. Escolha Command Prompt.
3. Feche o terminal aberto (ícone de lixeira) e abra outro com Ctrl+`.

Para abrir outro tipo de terminal só naquele momento, use a seta ao lado do + no painel do terminal e escolha PowerShell ou Git Bash. O Git Bash aparece automaticamente quando o Git está instalado.

Configurar só no repositório

Em máquina compartilhada, prefira não alterar as configurações de usuário do VS Code. A mesma escolha pode ficar no próprio repositório, no arquivo .vscode/settings.json:

.vscode/settings.json

{
  "terminal.integrated.defaultProfile.windows": "Command Prompt"
}

Essa configuração só é aplicada quando a pasta é confiável (Workspace Trust).

PlatformIO e a pasta-mãe

O atalho ELT85B - VS Code abre a pasta-mãe, que serve para ver todos os repositórios. Para compilar e simular, o PlatformIO precisa do repositório aberto como pasta principal (onde está o platformio.ini). Nas aulas embarcadas, abra o repositório do lab pelo atalho ELT85B - CMD:

ELT85B - CMD

code lab01-grupo-a

Parte 3 — Remover os atalhos no fim da aula

Faça isso antes de apagar a pasta-mãe, porque o script está dentro dela.

cmd

"%USERPROFILE%\ELT85B\atalhos-elt85b.cmd" remover

Saída esperada:

[removido] ELT85B - CMD.lnk
[removido] ELT85B - Git Bash.lnk
[removido] ELT85B - PowerShell.lnk
[removido] ELT85B - VS Code.lnk

Se você criou os atalhos manualmente, apague os quatro arquivos ELT85B - ... da Área de Trabalho.

Depois, siga a limpeza da máquina compartilhada para sair do GitHub e apagar a pasta-mãe.

Solução de problemas

O terminal abre na pasta de usuário, não em ELT85B

• Abra Propriedades do atalho e confira o campo Iniciar em.
• A pasta ELT85B precisa existir. Se ela foi apagada, o Windows abre o terminal em outra pasta. Recrie a pasta ou rode o script de novo.
• No Git Bash, confira se o Destino não contém --cd-to-home.

O atalho do Git Bash ou do VS Code não foi criado

• Git Bash: o script procura o Git nas pastas de instalação padrão. Se o Git estiver em outro lugar, crie esse atalho manualmente.
• VS Code: o script precisa do comando code no PATH. Teste com where code. Se não encontrar, reinstale o VS Code marcando a opção Add to PATH ou crie o atalho manualmente.

Ao abrir o atalho do VS Code, aparece uma janela preta rápida

É o cmd que executa o comando code e fecha em seguida. No atalho manual, mude Executar para Minimizada nas Propriedades. O atalho criado pelo script já vem assim.

O script mostra erro de PowerShell

O script usa o Windows PowerShell que vem com o Windows, sem alterar a política de execução. Se a máquina bloquear o PowerShell, use a aba Manualmente da Parte 1.

Checklist

• Script atalhos-elt85b.cmd salvo em %USERPROFILE%\ELT85B e executado.
• Quatro atalhos ELT85B - ... na Área de Trabalho.
• CMD, PowerShell e Git Bash abrem em ELT85B (verificado com cd, Get-Location e pwd).
• Terminal padrão do VS Code definido como Command Prompt.
• No fim da aula: atalhos removidos com atalhos-elt85b.cmd remover.

Ao terminar — máquina de laboratório

Antes de sair, faça logout para não deixar sua conta do GitHub ativa na máquina (limpa a credencial salva do git e encerra a sessão do gh).