Pular para o conteúdo principal

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:

AtalhoAbreUso na disciplina
ELT85B - CMDPrompt de ComandoComandos dos guias (padrão da disciplina)
ELT85B - PowerShellWindows PowerShellAlternativa ao cmd
ELT85B - Git BashTerminal Bash do GitComandos no estilo Linux
ELT85B - VS CodeVS Code na pasta-mãeVisã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):

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"
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​

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.

Verificação dos atalhos​

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

ELT85B - CMD
cd
C:\Users\aluno\ELT85B

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

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