INTRODUOAODESENVOLVIMENTODEJOGOSCOMLIBGDX

VinciusBarretodeSousaNeto

Libgdx um framework multiplataforma de visualizao e desenvolvimentode jogos.

Atualmente ele suporta Windows, Linux, Mac OS X, Android, iOS e HTML5 como
plataformasdedestino.

Libgdxpermite quevocescrevaoseucdigoumanicavezeoimplanteemmltiplas
plataformas, sem modificao. Ao invs de esperar por suas ltimas modificaes a
serem implantadasnoseu dispositivo, ou para ser compilado para HTML5, voc pode
se beneficiar de um ciclo de iterao extremamente rpidocodificandosua aplicao,
principalmente em um desktop. Voc pode usar todas as ferramentasdo ecossistema
Javaparasertoprodutivoquantovocpossaser.

Libgdx permite ir to baixo nvel quanto voc queira, o que lhe d acesso direto aos
sistemas dearquivos,dispositivosdeentrada,dispositivosdeudioeOpenGLviauma
interfaceunificadaOpenGLES2.0e3.0.

Em cima dessas instalaes de baixo nvel foi construdo um poderoso conjunto de

APIsqueajudamnastarefascomunsdedesenvolvimentodejogos,comorenderizao
de sprites e texto, a construo de interfaces com o usurio, a reproduo de efeitos
sonoros e streams de msica, lgebra linear e clculos de trigonometria, anlise de
JSONeXML,eassimpordiante.

Sempre que necessrio,Libgdxdeixa oreino de Java erecorreao cdigonativo para

alcanar o melhor desempenho possvel. Toda essa funcionalidade est escondida
atrs de APIs Java para quevoc no precisesepreocuparcommulticompilao do
cdigo nativo para todas as plataformas. Muitas partesdo Libgdx trabalhamemtorno
deproblemasconhecidosdaplataformaparaquevocnotenhaquelidarcomeles.

Libgdx est mais para um framework doqueparaumaengine, reconhecendoqueno

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

Preparandooseuambientededesenvolvimento

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.

ParadesenvolvercomoEclipsevocprecisardealgumasferramentas:

JDK7(JavaDevelopmentKit7)ousuperior

AndroidSDK

EclipseIDEforJavaDevelopers

LibGDX

Paraestetutorialestaremosutilizandoasseguintesversesdasferramentascitadas:

JDK8(JavaDevelopmentKit8)

AndroidSDK(Revision24.1.2)

EclipseIDEforJavaDevelopers(LunaSR4.4.2)

LibGDX1.5.5

1ObtendoeinstalandooJDK8(JavaDevelopmentKit8):

OJDK8podeserobtidoatravsdolink:

http://www.oracle.com/technetwork/java/javase/downloads/index.html

Serbaixadoumarquivoexecutveldenome
jdk8u40windowsx64
.

Obs.: Lembrando que todos osnomes dosarquivos referentes s ferramentas podem

variardeacordocomversesetempoqueforamdisponibilizados.

Executeoarquivobaixadoesigaopassoapassoabaixo:

2ObtendoeinstalandooEclipse:

EclipseIDEforJavaDeveloperspodeserobtidoatravsdolink:

https://www.eclipse.org/downloads/packages/eclipseidejavadevelopers/lunasr2

Serbaixadoumarquivozipadodenome
eclipsejavalunaSR2win32x86_64
.
Extraia para o local desejado. Recomendo que seja um diretrio de fcilacesso pois
estar em constante uso. Neste momento ainda no utilizaremos o Eclipse. Antes
precisamosinstalaroAndroidSDKemaisalgumasferramentas.

3ObtendoeinstalandooAndroidSDK:

AndroidSDKpodeserobtidoatravsdolink:

http://developer.android.com/sdk/index.html#Other

10

Serbaixadoumarquivoexecutveldenome
installer_r24.1.2windows
.

InstalandooAndroidSDK
O AndroidSDKnoincluiumambientededesenvolvimentocompletopara Android.Ele
inclui somente as principais ferramentasdo SDK,que voc podeacessar por linhade
comandoouporumpluginemalgumaIDE(quandodisponvel).
InstalandonoWindows:

O seu pacote de download um arquivo executvel que inicia um instalador. O

instalador verifica se voctemasferramentasnecessriasinstaladasemsuamquina,
como o Java SE Development Kit (JDK) e o instala se necessrio. O Android SDK
entosalvonumalocalizaodediretrioespecificadanomomentodainstalao.

11

1Duplocliquenoarquivoexecutvel(.exe)parainiciarainstalao.

2 Anote o nome eolocalaonde voc salvaroSDKVocvaiprecisarreferenciaro

diretrioquandoutilizarasferramentasdoSDKpelalinhadecomando.

3Quandoainstalaoterminar,oinstaladoriniciaoAndroidSDKManager.

Caso no tenha obtido sucesso com as instrues textuais, talvez queira dar uma
olhadanasinstruesemtelas:

12

13

14

15


OAndroidSDKagoraestprontoparacomearodesenvolvimentodeapps,masainda
halgunspacotesquevocdeveadicionarparatornaroseuSDKmaiscompleto.

16

Adicionandoospacotesnecessrios:

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.
Agora que o JDK, o Eclipse e o Android SDK j esto instalados, v ao diretrioem
que extraiu o Eclipse e o inicie. O Eclipse vai apresentar uma janela solicitando um
diretrio onde seus projetos sero salvos. Fornea o diretrio desejado (se preferir
podedeixarodiretriopadro)ecliqueemOK.

20

Feitoisso,agoraprecisamosinformaraoEclipseodiretriodoAndroidSDKeadicionar
oADTPlugineoGradleIntegrationPluginaoEclipse.

21

InformandoaoEclipseodiretriodoAndroidSDK:

22

CliquenobotoOKparafinalizar.

AdicionandooADTPluginaoEclipse:

O Android oferece um plugin customizado para o Eclipse, chamado Android

DevelopmentTools(ADT). Essepluginforneceumpoderosoeintegradoambientepara
desenvolvimento deappsAndroid. Ele aumentaas capacidades do Eclipsepermitindo
criar e configurar projetos Android mais rapidamente, construirumappUI,depurarseu
app,eexportarpacotesapp(APKs)autorizados(ounoautorizados)paradistribuio.

23

ParaadicionaroADTpluginaoEclipse:
1. InicieoEclipse,selecione
Help
>
InstallNewSoftware
.
2. Cliqueem
Add
,nocantosuperiordireito.
3. Na caixadedilogo Add Repositoryque aparecer, digite "ADT Plugin" para
ocampo
Name
easeguinteURLpara
Location
:
4. https://dlssl.google.com/android/eclipse/
5. Nota: O Android Developer Tools update site requer uma conexo segura.
TenhacertezadequeaURLquevocdigitoucomececomHTTPS.
6. Cliqueem
OK
.
7. Na caixa de dilogo Available Software, marque a caixa de seleo
DeveloperToolsecliqueem
Next
.
8. Na prxima janela, voc ver umalistadeferramentasparadownload.Clique
em
Next
.
9. Leiaeaceiteostermosdelicena,eentocliqueem
Finish
.
10. Se voc receber um aviso de segurana dizendo que a autenticidade ou
validadedosoftwarenopodeocorrer,cliqueem
OK
.
11. Quandoainstalaoterminar,reinicieoEclipse.

ConfigurandooADTPlugin:
Aps reiniciaroEclipse,vocdeveespecificaralocalizaododiretriodoseuAndroid
SDK:
1. Na janela "Welcome to Android Development" que aparece, selecione
Use
existingSDKs
.
2. Navegue e selecione a localizao do diretrio do Android SDK queacabou
debaixar.
3. Cliqueem
Next
.
Seu Eclipse IDE agora est pronto para desenvolver apps para Android, mas voc
deve adicionar asferramentasdeplataforma Android mais recentese umaplataforma
Androidparaoseuambiente.

24

AdicionandooGradleIntegrationPluginaoEclipse:

ProjetosLibgdxusamoGradleparagerenciardependncias,oprocessodeconstruo
e integrao da IDE. Isso permite que voc desenvolva seu app com qualquer
ambientededesenvolvimentoque voc preferir. Omelhordetudo:seuscompanheiros
de equipe podem usar um ambiente de desenvolvimento diferente ao trabalhar no
mesmo projeto! S no d commit em seus arquivosespecficosda IDE para o seu
controledeorigem. O arquivo .gitignorecontido emprojetosLibgdxvai cuidardissose
vocusarGit.

Gradleupdatesite
:
http://dist.springsource.com/release/TOOLS/gradle

1. NoEclipsecliqueem
Help>>InstallNewSoftware
2. Digiteo
Gradleupdatesite
nocampo"Workwith".
3. CliquenobotoAddnotopodatela.
4. Garantaqueaopo"GroupItemsbyCategory"estejaativa.
5. Selecioneaprimeiracaixademarcao'Extensions/GradleIntegration'.
6. Cliqueem"Next".Issopodedemorarumpouco.
7. Revisealistadesoftwarequeserinstalada.Cliqueem"Next"novamente.
8. Leiaeaceiteostermosdelicenaecliqueem"Finish".

25

ObtendooLibGDX:
Acesse o site
http://libgdx.badlogicgames.com/download.html e clique no boto
DownloadSetupAppcomonaimagemabaixo:

Libgdx vem com um arquivo chamado gdxsetup.jar que um executvel com

interface de usurio e ferramenta de linha de comando. Voc pode simplesmente
executaroarquivoJARparaqueabraajaneladeconfigurao.
ParaexecutaroarquivoJARporlinhadecomando:
javajargdxsetup.jar

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 plataformasque voc desejaqueasuaaplicaosejadisponibilizada.Para
estetutorial,escolhaapenasasplataformasDesktopeAndroid.
Nota: uma vez escolhidas as plataformas desejadas, se quiser suportar outras
plataformasterdeadicionlasmanualmente!
Finalmente, voc pode selecionarextensesparaserem includas no seu app. Alguns
podem no funcionar em todas as plataformas,paraasquaisreceber um aviso. Por
enquanto no utilizaremos nenhuma extenso. Quando terminar de configurar tudo,
cliqueem "Generate".Agora voc est prontoparaimportar o seu projeto Gradle para
aIDEEclipse,executar,depuraredisponibilizar!
Aps clicar em Generate o LibGDX comeara baixar os arquivos necessriospara
gerar o projeto. importantelembrar queele gera um projeto Gradleenoumprojeto
Eclipse, mas graas ao Gradle Integrated Plugin que foi instalado anteriormente
poderemosimportaroprojetosemdificuldades.

28

29


ComoprojetoGradlegerado,agorapodemosimportlonoEclipse.
ParaimportaroprojetonoEclipse:File>Import>Gradle>GradleProject

30

31

32

33

34

Caso o projeto Android sejainiciado com o erro The importandroid.os.Bundlecannot

be resolved. Clique com o boto direito do mouse no projeto Androidevna opo
Properties. Na aba Android,selecioneGoogleAPIsecliquenobotoApply.Clique
emOKparafinalizar.Oerrodeverterdesaparecidoetudoestarnormalizado.

35

36

Agorairemosexecutaraaplicaodemoquejvemembutidanoprojetocriado.

37

ExecutandonoWindows:

38

39

ExecutandonodispositivoAndroid:

Prrequisitos:

Seu dispositivo Android deve estar conectado ao computador via cabo USB e coma
opoDepurao USB ativada. Para ativlavnasconfiguraesdoseudispositivo
e acesse as opes de desenvolvedor. Na lista de opes apresentada, busque a
categoriaDepuraoeselecioneaopoDepuraoUSB.

40

41

42