Atalhos da disciplina ELT73A
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%\ELT73A:
| Atalho | Abre | Uso na disciplina |
|---|---|---|
| ELT73A - CMD | Prompt de Comando | Comandos dos guias (padrão da disciplina) |
| ELT73A - PowerShell | Windows PowerShell | Alternativa ao cmd |
| ELT73A - Git Bash | Terminal Bash do Git | Comandos no estilo Linux |
| ELT73A - 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 ELT73A 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
ELT73A. - 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%\ELT73A 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-ELT73A.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%\ELT73A"
notepad "%USERPROFILE%\ELT73A\atalhos-ELT73A.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-ELT73A.cmd - atalhos da disciplina ELT73A
rem
rem Uso:
rem atalhos-ELT73A.cmd cria os atalhos na Area de Trabalho
rem atalhos-ELT73A.cmd remover apaga os atalhos da Area de Trabalho
rem
rem Todos os atalhos abrem na pasta %USERPROFILE%\ELT73A
rem ============================================================
setlocal
set "PASTA=%USERPROFILE%\ELT73A"
if /i "%~1"=="remover" goto remover
if not exist "%PASTA%" mkdir "%PASTA%"
echo Pasta da disciplina: %PASTA%
echo.
rem --- CMD -------------------------------------------------------
set "A_NOME=ELT73A - CMD"
set "A_ALVO=%ComSpec%"
set "A_ARGS=/k title ELT73A"
set "A_JANELA=1"
call :criar
rem --- PowerShell ------------------------------------------------
set "A_NOME=ELT73A - 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=ELT73A - 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=ELT73A - 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 'ELT73A - *.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 ELT73A'; $s.Save(); Write-Host ('[ok] ' + $env:A_NOME)"
exit /b 0
3. Execute o script:
"%USERPROFILE%\ELT73A\atalhos-ELT73A.cmd"
Saída esperada:
Pasta da disciplina: C:\Users\aluno\ELT73A
[ok] ELT73A - CMD
[ok] ELT73A - PowerShell
[ok] ELT73A - Git Bash
[ok] ELT73A - 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%\ELT73Ae clique em OK.
| Nome | Destino |
|---|---|
ELT73A - CMD | %ComSpec% /k title ELT73A |
ELT73A - PowerShell | %SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -NoExit -NoLogo |
ELT73A - Git Bash | "C:\Program Files\Git\git-bash.exe" |
ELT73A - 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\ELT73A
O título da janela também deve mostrar ELT73A.
Get-Location
Path
----
C:\Users\aluno\ELT73A
pwd
/c/Users/aluno/ELT73A
No Git Bash, C:\ aparece como /c/ e as barras são normais (/).
O VS Code abre com ELT73A 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 ELT73A - 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 ELT73A - 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%\ELT73A\atalhos-ELT73A.cmd" remover
Saída esperada:
[removido] ELT73A - CMD.lnk
[removido] ELT73A - Git Bash.lnk
[removido] ELT73A - PowerShell.lnk
[removido] ELT73A - VS Code.lnk
Se você criou os atalhos manualmente, apague os quatro arquivos
ELT73A - ... 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 ELT73A
- Abra Propriedades do atalho e confira o campo Iniciar em.
- A pasta
ELT73Aprecisa 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-ELT73A.cmdsalvo em%USERPROFILE%\ELT73Ae executado. - Quatro atalhos
ELT73A - ...na Área de Trabalho. - CMD, PowerShell e Git Bash abrem em
ELT73A(verificado comcd,Get-Locationepwd). - Terminal padrão do VS Code definido como Command Prompt.
- No fim da aula: atalhos removidos com
atalhos-ELT73A.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.