Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Libgdx permite que voc escreva o seu cdigo uma nica vez e o implante em mltiplas
plataformas, sem modificao. Ao invs de esperar por suas ltimas modificaes a
serem implantadas no seu dispositivo, ou para ser compilado para HTML5, voc pode
se beneficiar de um ciclo de iterao extremamente rpido codificando sua aplicao,
principalmente em um desktop. Voc pode usar todas as ferramentas do ecossistema
Java para ser to produtivo quanto voc possa ser.
Libgdx permite ir to baixo nvel quanto voc queira, o que lhe d acesso direto aos
sistemas de arquivos, dispositivos de entrada, dispositivos de udio e OpenGL via uma
interface unificada OpenGL ES 2.0 e 3.0.
Sempre que necessrio, Libgdx deixa o reino de Java e recorre ao cdigo nativo para
alcanar o melhor desempenho possvel. Toda essa funcionalidade est escondida
atrs de APIs Java para que voc no precise se preocupar com multi-compilao do
cdigo nativo para todas as plataformas. Muitas partes do Libgdx trabalham em torno
de problemas conhecidos da plataforma para que voc no tenha que lidar com eles.
Libgdx est mais para um framework do que para uma engine, reconhecendo que no
h uma nica soluo para vrios problemas diferentes. Ao invs disso, ele fornece
abstraes poderosas que permitem que voc escolha como voc deseja escrever o
seu jogo ou aplicao.
1
Preparando o seu ambiente de desenvolvimento
Obs.: O sistema operacional utilizado ser o Windows 8 (64 bits), mas o Libgdx
tambm funciona em outras verses do Windows, e outros sistemas operacionais.
Neste tutorial utilizaremos o Eclipse, mas tambm pode ser usado o NetBeans ou
Intellij.
Android SDK;
LibGDX
Para este tutorial estaremos utilizando as seguintes verses das ferramentas citadas:
LibGDX 1.5.5
2
1 - Obtendo e instalando o JDK 8 (Java Development Kit 8):
http://www.oracle.com/technetwork/java/javase/downloads/index.html
3
Ser baixado um arquivo executvel de nome jdk-8u40-windows-x64.
Obs.: Lembrando que todos os nomes dos arquivos referentes s ferramentas podem
variar de acordo com verses e tempo que foram disponibilizados.
4
Execute o arquivo baixado e siga o passo-a-passo abaixo:
5
6
7
2 - Obtendo e instalando o Eclipse:
Eclipse IDE for Java Developers pode ser obtido atravs do link:
https://www.eclipse.org/downloads/packages/eclipse-ide-java-developers/lunasr2
8
Ser baixado um arquivo zipado de nome eclipse-java-luna-SR2-win32-x86_64.
Extraia para o local desejado. Recomendo que seja um diretrio de fcil acesso pois
estar em constante uso. Neste momento ainda no utilizaremos o Eclipse. Antes
precisamos instalar o Android SDK e mais algumas ferramentas.
9
3 - Obtendo e instalando o Android SDK:
http://developer.android.com/sdk/index.html#Other
10
Ser baixado um arquivo executvel de nome installer_r24.1.2-windows.
Instalando no Windows:
11
1 - Duplo-clique no arquivo executvel (.exe) para iniciar a instalao.
2 - Anote o nome e o local aonde voc salvar o SDK Voc vai precisar referenciar o
diretrio quando utilizar as ferramentas do SDK pela linha de comando.
Caso no tenha obtido sucesso com as instrues textuais, talvez queira dar uma
olhada nas instrues em telas:
12
13
14
15
O Android SDK agora est pronto para comear o desenvolvimento de apps, mas ainda
h alguns pacotes que voc deve adicionar para tornar o seu SDK mais completo.
16
Adicionando os pacotes necessrios:
17
18
19
Ao terminar de baixar os pacotes, clique no boto Close e feche o Android SDK
Manager.
Obs.: O download e instalao dos pacotes podem levar bastante tempo para serem
concludos.
20
Feito isso, agora precisamos informar ao Eclipse o diretrio do Android SDK e adicionar
o ADT Plugin e o Gradle Integration Plugin ao Eclipse.
21
Informando ao Eclipse o diretrio do Android SDK:
22
Clique no boto OK para finalizar.
23
Para adicionar o ADT plugin ao Eclipse:
Aps reiniciar o Eclipse, voc deve especificar a localizao do diretrio do seu Android
SDK:
Seu Eclipse IDE agora est pronto para desenvolver apps para Android, mas voc
deve adicionar as ferramentas de plataforma Android mais recentes e uma plataforma
Android para o seu ambiente.
24
Adicionando o Gradle Integration Plugin ao Eclipse:
25
Obtendo o LibGDX:
26
27
Especifique o nome da sua aplicao, o nome do seu pacote Java, o nome da sua
classe principal, o diretrio de sada, e o diretrio para o seu Android SDK. Depois,
escolha as plataformas que voc deseja que a sua aplicao seja disponibilizada. Para
este tutorial, escolha apenas as plataformas Desktop e Android.
Finalmente, voc pode selecionar extenses para serem includas no seu app. Alguns
podem no funcionar em todas as plataformas, para as quais receber um aviso. Por
enquanto no utilizaremos nenhuma extenso. Quando terminar de configurar tudo,
clique em "Generate". Agora voc est pronto para importar o seu projeto Gradle para
a IDE Eclipse, executar, depurar e disponibilizar!
28
29
Com o projeto Gradle gerado, agora podemos import-lo no Eclipse.
Para importar o projeto no Eclipse: File -> Import -> Gradle -> Gradle Project
30
31
32
33
34
Caso o projeto Android seja iniciado com o erro The import android.os.Bundle cannot
be resolved. Clique com o boto direito do mouse no projeto Android e v na opo
Properties. Na aba Android, selecione Google APIs e clique no boto Apply. Clique
em OK para finalizar. O erro dever ter desaparecido e tudo estar normalizado.
35
36
Agora iremos executar a aplicao demo que j vem embutida no projeto criado.
37
Executando no Windows:
38
39
Executando no dispositivo Android:
Pr-requisitos:
Seu dispositivo Android deve estar conectado ao computador via cabo USB e com a
opo Depurao USB ativada. Para ativ-la v nas configuraes do seu dispositivo
e acesse as opes de desenvolvedor. Na lista de opes apresentada, busque a
categoria Depurao e selecione a opo Depurao USB.
40
41
42
Obtendo o Tiled Map Editor:
http://www.mapeditor.org/download.html
O que o Tiled?
Tiled um editor de mapa baseado em tiles de propsito geral. Ele funciona como uma
ferramenta gratuita para permitir a fcil criao de layouts de mapa. Ele verstil o
suficiente para permitir especificaes mais abstratas, tais como reas de coliso,
posies de surgimento do inimigo, ou posies de power-up. Ele armazena todos
esses dados em um formato conveniente e pradonizado chamado TMX (map.tmx).
43
Como funciona o Tiled?
Mesmo se voc no quer que seu jogo tenha mapas baseados em tiles, o Tiled ainda
uma excelente escolha como um editor de nveis. Com Tiled voc pode especificar o
tamanho de cada tile em sua imagem; voc pode criar seu mapa sem tamanhos
rigorosos nas imagens. Voc tambm pode usar o Tiled para todas as entidades
invisveis, tais como reas de coliso, ou objetos de surgimento (spawn) dentro do seu
mapa.
Uma vez que voc capaz de interpretar os dados TMX para o seu jogo, as
ferramentas do Tiled tornam-se muito rpidas para o seu pipeline de trabalho. A criao
de mapas no Tiled to simples que experincia em programao no requerida, e
mesmo os no-desenvolvedores podem us-lo.
Outro motivo para usar o Tiled que todas as informaes de layout do mapa so
armazenadas no arquivo TMX. Isto poderoso porque ele permite que voc envie o
arquivo TMX a um jogador, e eles teriam instantaneamente o layout sem ter que baixar
novamente o cliente (assumindo que o mapa TMX j utilize texturas do computador do
jogador).
44
Instalando o Tiled Map Editor:
45
Clique no boto Browse para selecionar o diretrio em que deseja instalar o Tiled, e
em seguida clique no boto Install.
46
Ao clicar no boto Finish com a opo Lauch Tiled selecionada, o Tiled ser aberto.
47
Criando um mapa no Tiled:
Ao abrir o Tiled voc vai se deparar com a tela acima. Pode ser que a sua tela esteja
um pouco diferente, pois talvez nem todas as abas e ferramentas estejam ativadas.
Ser mostrado em breve como ativar essas abas e ferramentas.
Algumas abas:
Camadas: Esta aba exibe as camadas (layers) do seu mapa. Voc pode criar quantas
camadas desejar. Lembre-se que h uma ordem na posio dessas camadas. Fica
sempre uma em cima de outra. Caso j tenha utilizado um editor de imagens como o
Photoshop ou Gimp, j deve ter se deparado com esta funcionalidade.
48
Minimapa: Aqui o seu mapa exibido em tamanho mnimo (minimapa).
Tilesets: Esta aba exibe os tilesets carregados no seu mapa para utilizao do mesmo.
Aqui voc ser capaz de pegar os tiles desejados para inserir em seu mapa utilizando
algumas ferramentas que sero apresentadas em seguida.
Selecione todas as opes marcadas com pontos vermelhos. Caso alguma opo j
esteja selecionada, no precisa selecionar, pois ir desativ-la.
49
Agora com todas as abas e ferramentas em mos, clique em Arquivo > Novo ou
simplesmente pressione CTRL + N.
50
Orientao: Aqui escolheremos a orientao do mapa. A orientao pode ser
ortogonal ou isomtrica. Um jogo 2D (como o nosso) costuma usar orientao
ortogonal, mas caso queira dar uma impresso de 3D, a orientao isomtrica faz isso.
Tamanho do mapa:
Tamanho do tile:
51
O mapa ser criado, e em seguida vamos inserir um tileset para utilizar no mapa.
Clique em Mapa > Novo Tileset:
Obtendo o tileset:
http://opengameart.org/sites/default/files/snowWIP_12.png
Obs.: Salve o tileset na pasta Assets do seu projeto Android gerado pelo projeto
LibGDX. L tambm salvaremos o nosso mapa. Ambos tileset e mapa devem estar
armazenados no mesmo diretrio.
52
Clique no boto Explorar para procurar o tileset a ser inserido no mapa.
No campo Nome voc pode nomear o tileset. Se preferir, ao selecionar o tileset o
nome do mesmo levar o nome do prprio arquivo automaticamente. Em seguida
clique no boto OK.
53
Na aba Tilesets indicada pela seta vermelha podemos ter acesso ao nosso tileset. O
tileset nada mais que uma imagem dividida em tiles contendo todas as texturas que
sero utilizadas na criao do mapa. Dessa forma, podemos selecionar os tiles
desejados e encaix-los na grade do mapa como desejarmos.
54
Ferramentas:
Carimbo: O carimbo pinta um tile da grade por vez, utilizando o tile selecionado do
tileset.
Pincel de Terreno: A ferramenta pincel de terreno permite criar pincis mais complexos.
55
Navegue pelos tiles do tileset (indicado pela seta vermelha) e selecione um tile com
textura de neve, por exemplo. O objetivo fazer todo o cho do nosso mapa. Para
poupar tempo e esforo, utilizaremos a ferramenta de preenchimento (balde). Depois
de selecionar o tile e a ferramenta, agora s aplicar na grade e teremos o nosso
cho. Perceba que voc pode selecionar mais de um tile por vez apenas arrastando o
mouse.
Vamos aprender agora a criar pincis mais complexos tirando proveito da inteligncia
por trs do Tiled.
Queremos criar um pincis para o terrenos Terra e Neve por exemplo. Na aba
Tileset, clique no cone Editar informaes de terreno.
56
Com o boto direito do mouse, selecione o tile com textura de Neve e clique em
Adicionar Tipo de Terreno.
57
Procure todas as ocorrncias de neve em todos os tiles e as selecione. Voc deve
marcar de azul todas as bordas que possurem neve. Selecione tudo at que fique da
seguinte forma:
58
Com os pincis prontos, podemos agora selecion-los na aba Terrenos e aplicar em
nosso mapa.
Perceba que com o pincel de terreno voc pode facilmente criar terrenos. Basta
pressionar o boto esquerdo do mouse na rea desejada e arrast-lo. Algumas vezes
ser necessrio a sobreposio de terrenos e/ou objetos. Para isso basta criar uma
camada superior e desenhar sobre ela.
59
Depois de criar e editar, vamos agora salvar o nosso mapa. Clique em Arquivo > Salvar
Como:
60
Digite o nome desejado para o mapa e perceba a extenso TMX do arquivo como dito
anteriormente. Salve o arquivo no diretrio de recursos do seu projeto. Procure pela
pasta assets no projeto Android do seu projeto LibGDX para que possamos acessar o
arquivo futuramente.
Concluso:
61
Utilizando o mapa no LibGDX:
62
63
Deixando dessa forma:
64
Em seguida, edite a sua classe para que fique assim:
Obs.: Talvez voc enxergue apenas parte do mapa. Isso se d ao fato de a cmera no
ser posicionada da forma como desejamos. Ela posicionada na posio (0,0). A
origem do mapa. Trataremos de cmeras e outros objetos futuramente.
65
Veja o resultado:
66