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 |
Confira o ambiente (faça a configuração uma vez por máquina; a verificação, a cada aula):
Verificação rápida das versões instaladas:
git -v & gh --version & code -v & py --version & pio --version & wokwi-cli -V & wsl --version & docker --version
Verificação rápida de autenticação e alias:
git config --get-regexp "^(user|alias)\." & gh auth status & code --list-extensions --profile "ESP32IO"
Adicionar o comando git conferir:
git config --global alias.conferir "!f() { r=$(pwd -W 2>/dev/null || pwd); echo raiz do repositorio: $r; test -z $GIT_PREFIX || echo ATENCAO: o terminal esta em $GIT_PREFIX, fora da raiz. Antes do git add, rode: cd /d $r; test $# -eq 0 && return; for a in $@; do if [ -e $a ]; then echo ok $a; else echo FALTA $a; fi; done; echo == mudancas desde o ultimo commit:; git status --short --ignored -- $@; }; f"
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.
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)
- Manualmente
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:
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.
@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:
"%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.
- 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
codee abre minimizado a janela auxiliar do cmd, que fecha sozinha.
Para cada atalho:
- Clique com o botão direito na Área de Trabalho, Novo e depois Atalho.
- Em Digite o local do item, cole o Destino da tabela abaixo e avance.
- Digite o Nome e clique em Concluir.
- Clique com o botão direito no atalho criado e abra Propriedades.
- No campo Iniciar em, digite
%USERPROFILE%\ELT85Be 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.
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
- PowerShell
- Git Bash
- VS Code
cd
C:\Users\aluno\ELT85B
O título da janela também deve mostrar ELT85B.
Get-Location
Path
----
C:\Users\aluno\ELT85B
pwd
/c/Users/aluno/ELT85B
No Git Bash, C:\ aparece como /c/ e as barras são normais (/).
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:
Ctrl+Shift+Pe execute Terminal: Select Default Profile.- Escolha Command Prompt.
- 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.
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:
{
"terminal.integrated.defaultProfile.windows": "Command Prompt"
}
Essa configuração só é aplicada quando a pasta é confiável (Workspace Trust).
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:
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.
"%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
ELT85Bprecisa 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
codeno PATH. Teste comwhere 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.cmdsalvo em%USERPROFILE%\ELT85Be executado. - Quatro atalhos
ELT85B - ...na Área de Trabalho. - CMD, PowerShell e Git Bash abrem em
ELT85B(verificado comcd,Get-Locationepwd). - Terminal padrão do VS Code definido como Command Prompt.
- No fim da aula: atalhos removidos com
atalhos-elt85b.cmd remover.
Antes de sair, faça logout para não deixar sua conta do GitHub ativa nesta máquina. Rode os comandos abaixo no Prompt de Comando (cmd), não no PowerShell.
1. Apague a credencial do GitHub salva pelo git, encerre a sessão do gh e remova seu nome e e-mail da configuração global:
(echo protocol=https&echo host=github.com) | git credential reject
gh auth logout --hostname github.com
git config --global --unset user.name
git config --global --unset user.email
Para conferir, este comando não deve mostrar nada:
cmdkey /list | findstr /i github
2. Pare os containers do lab:
for /f "delims=" %i in ('docker compose ls -q') do docker compose -p %i down
3. No navegador, saia da sua conta em github.com e feche todas as janelas.