Skip to content

Contribuir com o Tiled

Laete Meireles edited this page Oct 14, 2015 · 4 revisions

Se você já sabe um pouco de C++, contribuir para a versão Qt do Tiled não é difícil! Tudo que você precisa fazer é aprender a usar o sistema de controle de versão Git e o framework de aplicações Qt.

Verificando o Código Fonte Usando Git

Instalando o Git

A instalação do Git vai ser um pouco diferente, dependendo do seu sistema operacional. Se você for para a página de download do Git, você deverá ser capaz de encontrar o link apropriado.

Check-out do Tiled

Embora você possa usar o Git GUI para verificar o repositório, nos exemplos eu só irei te mostrar o caminho através da linha de comandos (terminal). O repositório Git está localizado em github.com. Você vai encontrar o Tiled em http://github.com/bjorn/tiled.

Para fazer uma cópia local deste repositório, use o comando indicado abaixo:

git clone git://github.com/bjorn/tiled.git
cd tiled
git log

Os últimos comandos mostrados, não só lhe darão uma cópia local do código fonte, mas também incluirão todo o histórico de desenvolvimento, permitindo que você navegue rapidamente pelo histórico e descubra o que aconteceu até agora.

Introdução ao Desenvolvimento

Instale um compilador C++

  • No Linux, certifique-se de possuir o g++ instalado.
  • No Windows, eu recomendaria começar com o pacote Qt que inclui MinGW (disponível desde o Qt 5.0.1).
  • No MacOS X, eu acredito que você precisa instalar o Xcode.

Instale o Qt e zlib

Obtenha o Qt em http://www.qt.io/download-open-source/. O pacote padrão vem com Qt Creator, que fornece uma maneira fácil de compilar e executar o Tiled, e também uma IDE poderosa para fazer mudanças no Tiled.

Tiled também depende da zlib para suportar compressão. No Debian e Ubuntu, a biblioteca zlib pode ser instalada da seguinte forma:

sudo apt-get install zlib1g-dev

No Windows, não há necessidade de instalar a biblioteca zlib porque o Tiled pode contar com as funções exportadas a partir da biblioteca Qt Core.

Compilar e executar

Depois de ter tudo instalado, você deve ser capaz de simplesmente abrir tiled.qbs no Qt Creator (no OS X, abra o tiled.pro). Se o Qt Creator não auto-detectar suas bibliotecas Qt, defina-as corretamente nas preferências (em Build & Run -> Qt Versions, e, em seguida, crie um Kit para ele e adicione kit no modo 'Projects'). Então, certifique-se que o alvo de execução está definido como 'tiles' e não um dos outros aplicativos que vem com o Tiled. Finalmente, você pode clicar no botão Run para compilar e executar o aplicativo.

Se você preferir ficar com a linha de comandos, você vai pode compilar e executar o Tiled usando os seguintes comandos:

qmake        # Generate the Makefiles
make         # Compile Tiled
bin/tiled    # Run Tiled

Note que em alguns sistemas, o comando qmake não está disponível (ou pode estar definido como padrão para o Qt 3, versão à qual o Tiled não compila). Nesse caso, use qmake-qt4, qmake-qt5 ou qualquer outra coisa que seja apropriada para seu sistema.

Construindo uma versão 64-bit do Tiled no Windows

  • Obtenha o código fonte mais recente do Tiled no github
  • Instale o "Microsoft Visual Studio Express 2013 com Update 3" para o Windows - http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs
  • Use o Qt Online Installer para Windows à partir de http://qt-project.org/downloads, desmarque tudo, menos a opção "Qt 5.3 - msvc2013 64-bit OpenGL"
  • Abra o arquivo tiled.qbs no Qt Creator, o programa irá sugerir configurá-lo com o kit padrão com Qt 5.3 e VS 2013.
  • Selecione 'tiled' no seletor de destino (acima do botão Run), opcionalmente selecione 'Release' para uma versão mais rápida, em seguida, pressione Run.

Contribuir com o Tiled

O principal objetivo desta página, como o título indica, é que você contribua com patches para o Tiled. Costumava haver uma breve introdução a linha de comando do Git aqui, mas eu não acho que isso seja muito útil atualmente. Por favor, leia a página à seguir, se você for novo em relação à como contribuir com projetos hospedados no GitHub:

https://guides.github.com/activities/contributing-to-open-source/#contributing (inglês)