1.3 Windows

Para a instalação das ferramentas e bibliotecas de desenvolvimento no Windows utilizaremos o MSYS2.

MSYS2 é um ambiente de terminal tipo Unix com acesso a um repositório de ferramentas e bibliotecas de desenvolvimento de aplicações nativas em Windows através do gerenciador de pacotes pacman. Essas ferramentas e bibliotecas incluem o CMake, Git, GLEW, SDL 2.0 e SDL_image 2.0, entre outras que vamos utilizar na disciplina. O MSYS2 também permite instalar o MinGW-W64. Com isso podemos usar o GCC (compilador) e o GDB (depurador) no Windows e gerar binário nativo para 64-bit e 32-bit.

Siga os passos a seguir para instalar o MSYS2 e as ferramentas/bibliotecas de desenvolvimento:

  1. Baixe o instalador de https://www.msys2.org e siga os passos descritos na página.

  2. Abra o shell do MSYS2 (aplicativo MSYS2 MSYS a partir no menu Iniciar) e execute o seguinte comando:

    pacman -S git mingw-w64-x86_64-ccache mingw-w64-x86_64-cmake mingw-w64-x86_64-gcc mingw-w64-x86_64-gdb mingw-w64-x86_64-ninja mingw-w64-x86_64-glew mingw-w64-x86_64-SDL2 mingw-w64-x86_64-SDL2_image

    Isso instalará as ferramentas Git, Ccache, CMake, Ninja (o Ninja substitui o GNU Make no Windows), GCC e GDB (do MinGW-W64), e as bibliotecas GLEW, SDL 2.0 e SDL_image 2.0.

    Opcionalmente, instale o pacote mingw-w64-x86_64-glslang com o comando a seguir. Isso instalará as ferramentas que poderão ser usadas para linting da linguagem GLSL (linguagem de shading que será abordada na disciplina):

    pacman -S mingw-w64-x86_64-glslang

    Ao terminar a instalação, feche o shell do MSYS2.

  3. Instale o Python 3.9+ para Windows. Durante a instalação, certifique-se de ativar a opção “Add Python 3.9 to PATH”.

    Após a instalação, abra o Prompt de Comando (cmd.exe) e execute o comando where python para mostrar os diferentes caminhos em que o python está sendo alcançado pela variável de ambiente Path:

    C:\>where python
    C:\Users\ufabc\AppData\Local\Programs\Python\Python39\python.exe
    C:\Users\ufabc\AppData\Local\Microsoft\WindowsApps\python.exe

    O primeiro caminho exibido deve ser o caminho do executável do Python que acabou de ser instalado. Neste caso está correto, pois o Python foi instalado no local padrão do instalador que é %LocalAppData%\Programs\Python\Python39 (neste exemplo, o nome do usuário é ufabc).

  4. No “Painel de Controle” do Windows, abra a opção “Editar as Variáveis de Ambiente do Sistema.” Edite a variável Path do usuário atual1 e inclua os caminhos para mingw64\bin e usr\bin do MSYS2. Por exemplo, se o MSYS2 foi instalado em C:\msys64, inclua os seguintes caminhos no Path:

    C:\msys64\usr\bin
    C:\msys64\mingw64\bin

    Edite a ordem dos caminhos de tal forma que o caminho do Python apareça no início da lista, seguido pelos caminhos do MSYS2, como mostra a figura a seguir:

    Para testar se o MSYS2 foi instalado corretamente, abra o Prompt de Comando e execute o comando g++ --version. A saída deverá ser parecida com a seguinte:

    g++ (Rev5, Built by MSYS2 project) 10.3.0
    Copyright (C) 2020 Free Software Foundation, Inc.
    This is free software; see the source for copying conditions.  There is NO
    warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Habilitando o OpenGL

O suporte ao OpenGL vem integrado no Windows. Apenas certifique-se de instalar os drivers mais recentes da placa de vídeo.

Instalando o Emscripten

  1. Abra o Prompt de Comando em algum caminho onde queira instalar a pasta do SDK do Emscripten (por exemplo, C:\). Note the o terminal deve ser o Prompt de Comando e não o PowerShell.

  2. Clone o repositório do SDK:

    git clone https://github.com/emscripten-core/emsdk.git
  3. Entre na pasta recém-criada:

    cd emsdk
  4. Baixe e instale o SDK atualizado (latest):

    emsdk install latest
  5. Ative o SDK latest para o usuário atual:

    emsdk activate latest
  6. Configure as variáveis de ambiente e PATH do compilador para o terminal atual:

    emsdk_env.bat

Para testar se a instalação foi bem-sucedida, execute o comando emcc --version. A saída deverá ser parecida com a seguinte:

emcc (Emscripten gcc/clang-like replacement + linker emulating GNU ld) 2.0.29 (28ca7fb7ce895b21013212e4644a5794a15a76f9)
Copyright (C) 2014 the Emscripten authors (see AUTHORS.txt)
This is free and open source software under the MIT license.
There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
Importante

Refaça o passo 6 sempre que abrir um terminal ou execute o comando a seguir para registrar permanentemente as variáveis de ambiente no registro do sistema:

emsdk_env.bat --permanent

Caso não queira modificar o registro do sistema, uma opção é criar um atalho para cmd.exe e use a opção /k para executar o arquivo emsdk_env.bat sempre que o Prompt de Comando for aberto. Por exemplo:

cmd.exe /k "C:\emsdk\emsdk_env.bat"

Mude esse caminho de acordo com o local onde emsdk_env.bat foi instalado.


  1. A variável Path existe tanto nas variáveis do usuário quanto nas variáveis do sistema. A modificação do Path do usuário geralmente é suficiente para uma instalação correta. Se ocorrer algum erro ao seguir as instruções de construção do “Hello, World!” na seção 1.5 (erro de construção ou de DLL não encontrada), experimente alterar o Path do sistema ao invés do usuário.↩︎