Instalação

O FGAme utiliza os mecanismos usuais para a instalação de qualquer programa em Python. A grande dificuldade, talvez, seja instalar algumas bibliotecas externas necessárias e realizar a compilação de módulos, em especial no ambiente Windows.

Temos a seguinte lista de dependências:

  • Python >= 3.4
  • cython >= 0.22
  • six
  • smallvectors (versão de desenvolvimento)
  • smallshapes (versão de desenvolvimento)
  • pygeneric (versão de desenvolvimento)
  • pysdl2 (ou pygame)

Todas estas bibliotecas, incluindo o FGAme, possuem suporte para Python3. O FGAme provavelmente funciona em versões do Python 3 abaixo de 3.4. O suporte para Python 2, no entanto, está incompleto. Existem planos para implementar isto no futuro já que atualmente existe muito pouco suporte para Python 3 em smartphones.

Caso você não tenha nenhum motivo particular para escolher entre uma das duas versões do Python, escolha a última, que é mais moderna e bem suportada.

Linux

No Ubuntu e similares, basta utilizar o comando apt-get para instalar as dependências necessárias. Depois instale a FGAme utilizando o comando pip. Basta executar as linhas abaixo no terminal:

$ sudo apt-get install python3-pip cython3 python3-sdl2
$ sudo pip3 install FGAme -U

Para verificar que o FGAme foi instalado corretamente, execute os demos usando o comando:

$ python3 -m FGAme.demos

Bom jogo!

Outras distribuições

Os nome das dependências e os comandos de instalação variam levemente de uma distribuição para a outra.

Manjaro/Arch

Execute:

$ sudo pacman -S python-pip cython python-pysdl2
$ sudo pip3 install FGAme -U

Windows

Os usuários de Windows devem baixar a versão de Python desejada (recomendamos a versão 3.4) junto com as dependências compiladas para esta versão. Baixe e instale os arquivos na ordem mesma ordem da lista indicada abaixo:

Lembre-se sempre de escolher a versão do Pygame e do Cython correspondente à versão de Python que você utiliza e a arquitetura (x86 ou 64 bits, lembre-se que processadores Intel de 64 bits pertencem à arquitetura amd64).

Durante a instalação do Python é conveniente acionar a opção “Add python.exe to PATH”. Isto deixará o Python mais facilmente disponivel para o terminal de comando. Caso você esqueceu desta opção ou está em uma versão nova do Windows, é necessário executar os comandos a partir da pasta do Python.

Primeiramente abra o terminal do Windows apertando Win+R e digitando cmd. Dentro do comando, vá para a pasta onde o Python foi instalado (normalmente C:Python34):

$ cd c:\python34
$ python -m pip install FGAme -U

Para abrir o terminal, pressione Win+R para abrir a caixa de executar programas e digite cmd.

Desenvolvedores

Caso você queira participar do desenvolvimento da FGAme, ou está matriculado na disciplina de Física para jogos na faculdade UnB/Gama ;), é necessário utilizar a versão de desenvolvimento do FGAme e das bibliotecas auxiliares smallvectors e smallshapes. Todas estas bibliotecas estão presentes no GitHub no endereços abaixo

Caso você não esteja familiarizado com o GIT e o github, este é um bom começo: GIT - Guia Prático.