Vorgurakendused 2 prax 1 2011

Esimese praktikumi sisuks on googles hostitud serverirakendusega (google app engine) suhtleva androidi rakenduse tegemine. Tööl on kaks osa:

• Esialgse Androidi rakenduse tegemine. Piisab Androidi emulaatori kasutamisest, ei pea installeerima mobiiltelefoni.
• Google app engine all serverirakenduse tegemine ja Androidi rakenduse ühendamine serverirakendusega.

Rakenduse funktsionaalsus

Rakenduse eesmärgiks on võimaldada grupil inimestel näha, kus kõik grupi liikmed asuvad. Androidi rakenduses peab seega saama:

• Koostada gruppi
• Aktsepteerida gruppi
• Vaadata kaardilt, kus asuvad kõik aktsepteerinud grupi liikmed

Ühendus grupi liikmete vahel toimub läbi serverirakenduse.

Grupi koostamine võib toimuda ka brauseri kaudu (mis peaks siis samuti olema androidilt kasutatav).

Täpsemad detailid lisanduvad septembri esimeses pooles.

Kuidas alustada

Androidi arenduse juhendid googlelt leiad siit lingilt.

Esimese asjana on sul kindlasti vaja installeerida Androidi arenduskeskkond ja saada käima minimaalne näiterakendus HelloWorld Androidi emulaatoris.

Põhikeerukus on seejuures arenduskeskkonna installatsioon. Seda saad teha omaenda masinas ja samuti on see võimalik IT maja arvutiklassides. Ametliku õpetuse leiad siit lingilt. Loe seda õpetust ja vaata kindlasti lisaks soovitusi järgmises peatükis.

Kui arenduskeskkond on käima saadud, siis HelloWorldi valmistegemiseks kasuta seda google õpetust. Seejärel tee läbi veel Hello Views tutorial ja soovi korral veel mõned siit listist.

Oluline on saada käima kaardi-näiterakendus, selleks tee läbi see tutorial. Allpool leiad juhiseid google maps key genereerimiseks ja muid tähelepanekuid kaardivärgi kasutamiseks androidis.

Androidi arenduskeskkonna installeerimine

Installeerida saab kogu komplekti nii windowsi, linuxisse kui maci. Siin peatükis on märkmed windowsi jaoks.

Vaja on installida neli asja ja seejärel tekitada emulaator:

• Java SE (vajalik on arendusversioon, JEE ei ole vajalik)
• Androidi SDK
• Eclipse (ei ole otseselt kohustuslik, kuid lihtsustab)
• Eclipse androidi developmendi plugin.

Installeerimise õpetuse leiad siit lingilt. Täiendavalt võib olla abiks see juhend, mis sisaldab Eclipse lisade/konfimise/emulaatori käivitamise ekraanipilte.

Allpool täiendavaid juhiseid, tähelepanekuid ja vajalikke fikse:

• Java SE ja Eclipse on olemas nii 32 kui 64 bitisena. Mõlemad on OK, AGA mõlemad peavad olema sama bittide arvuga (kas 32 ja 32 või 64 ja 64).
• Java SE downloadi leht (uusim versioon on OK, vanemad sobivad kuni mingi piirini)
• Eclipse downloadi leht: kui sul juba Eclipse juhtumisi pole, siis võta eclipse classic.
• Android SDK download. Windowsis vali installer_r12-windows.exe (Recommended). Täpsemalt:
  • Kui oled installeri alla tõmmanud, pane ta käima, hakkab ise tõmbama järgmisi tükke.
  • Peale esialgset tõmbamist saad suure menüü valikutega. Mida sealt võtta, seda vaata siit juhendist. Soovitused valikute osas:
    • Ülemised valikud jäta peale.
    • Valima hakkad blokist "SDK platform". Võta sealt kindlasti kõige suurema numbriga versioon (ntx 3.2) ja soovitavalt ka mõni uuem 2 seeria versioon (kui sul omal androidi mobla, võta selle versiooni variant). Teised keera maha: kliki, kuni rea ees tekib punane rist.
    • Seejärel vali "Samples" blokist need variandid, mis vastavad eelnevalt valitud platvormile (sama number). Teised keera jälle klikkides maha.
    • Seejärel vali "Google apis" blokist samuti ainult need, mis vastavad eelnevalt valitud versioonile (kliki kuni läheb roheliseks, teised kliki punaseks).
    • Vali ka "Usb driver"
    • Alumised valikud (Usb draiveri all, vaikimisi rohelised) jäta peale.
• Eclipse ADT plugina install:
  • Algul tee, nagu viidatud juhend ütleb: ava Eclipses "Help > Install New Software....", siis pane avaneval vormil Name alla ADT Plugin ja sisesta selle all väljale täpselt selline url: https://dl-ssl.google.com/android/eclipse/ ja seejärel vajuta Add. Seejärel läheb veidi ootamist, kui info alla tõmmatakse, vaja on valida uus tekkiv rida, teha mitu nexti vajutust, accepti boxe jms (vt viidatud juhendit) ja lõpuks Eclipse restart.
  • Seejärel ütleb juhendi peatükk "Configuring the ADT Plugin", et Eclipses pead seadma eelnevalt laetud Android SDK asukoha. Ava Eclipse Window menüüst altäärest preferences ja avanevas aknas vali vasakul üleval Android. Pead seadma paremal väljal SDK location. Siin on mõned nüansid! Kui sinu masinas on ADK asukoht C:\Program Files ... \android-sdk ja seal pathis on tühikud (Program Files sees ntx on) siis ei tohi sisestavas pathis olla tühikuid! Selle asemel sisesta C:\PROGRA~2\Android\android-sdk kus numbri 2 asemel proovi ka 1 (Eclipse kaebab, kui pathi ei leia). IT maja arvutiklassis sisesta väljale (tammet asemele pane oma nimi C:\Users all) aga C:\Users\tammet\AppData\local\Android\android-sdk ja seal pathis tühikuid tõenäoliselt ei ole.
  • Vajalik fix IT maja arvutiklassides: IT maja arvutiklassis A on java settingutes viga: kasutaja kodukataloogi määrang on kasutajale C:\Users\proovija mida kasutada ei saa. Seetõttu ei õnnestu hoobilt Androidi emulaatorit tekitada. Sinu isiklikus masinas seda probleemi tõenäoliselt pole! IT majas pead tegema järgmist: ava rakendus registry editor (windowsi menüüst search programs and files boksis kirjuta regedit) ja seal navigeeri kohani "HKEY_CURRENT_USER" -> "Software" -> "Microsoft" -> "Windows" -> "Current Version" -> "Explorer" -> "Shell Folders" ja paremal akna osas sea muutuja "desktop" väärtuseks C:\Users\tammet\Desktop (tammet asemel pane oma nimi). Selle probleemi ja fiksi kohta leiab võrgust hulga infot, ntx siit.
• Emulaatori tekitamiseks on HelloWorld tutorialis lühike peatükk "Create an AVD". Veidi pikemalt lahti seletades on protsess järgmine: mine Eclipse menüüs Window valikule "Android SDK and AVD manager" (see valik tekib, kui oled ADT plugina edukalt installerinud). Avaneb uus aken, kus paremal ülal kirjas "List of existing Android virtual devices ...". Vajuta "New", anna emulaatorile suvaline nimi, võta Target valikust "Google APIs ...N" (see on kaardiga versioon!) kus N on vastavalt mis varem installeerisid (variandid "Android 2.2 ...", "Android 3.2 ..." on ilma kaardita), pane SD kaardile mingi mõistlik väärtus, ntx 50. Muid asju sättima ei pea. Selle protsessi lõpuks peaks ilmuma tabelisse "List of existing Android Virtual Devices ..." rida uue emulaatoriga (AVD). Sellele saad nüüd klikata ja käivitamiseks vajutada "Start ...".
  • Kui emulaatorit ei teki, siis tõenäoliselt tekib Eclipse aknasse veateadete list. Nii või teisiti on kõige tõenäolisem veapõhjus mõne ülaltoodud fiksi tegematajätmine.
  • Emulaatori käivitamine. Kui lihtsalt emulaatori käima paned, siis ilmub värviline kena emulaatorirakendus, mis ütleb "android ..." ja midagi ei tee. Oota kannatlikult, minut või rohkem. Hulga aja pärast ilmub normaalne Androidi esileht, mida saab hiirega kasutada. Oma rakenduse käimapanekut on mõtet katsetada juba HelloWorld tutorialiga koos. Eclipses tehtud HelloWorld rakenduse paneb Eclipses proge käivitamine (üleval roheline nool Run) ise käima, pead lihtsalt jupp aega ootama. Samuti ilmub sinu rakendus Androidi rakenduste menüüsse emulaatoris.
• Rakenduse mobiili laadimine. Vaata seda stackoverflow juhendit ja lisaks google lühijuhendit.

Google maps api key genereerimine

Kaardivärgi kasutamiseks on vaja genereerida google mapsi api debugkey. Vaata hello-mapview tutorialit ja lisaks seda tutorialit ja arvesta seejuures järgmiste tähelepanekute/probleemidega:

• Java keytool on sul tõenäoliselt pathil "c:\Program Files (x86)\Java\jre7\bin\keytool.exe" vms. Igaks juhuks kirjuta keytool täispathiga, muidu võid sattuda mõnda vale keytooli kasutama.
• Java keytool võib produtseerida erinevat sorti keysid, õige on ainult MD5 variant! Pane keytoolile lisaargument -v näiteks nii: C:\Users\Tanel>"c:\Program Files (x86)\Java\jre7\bin\keytool.exe" -v -list -alias androiddebugkey -keystore C:\Users\Tanel\.android\debug.keystore -storepass android -keypass android
• Selle -v argumendiga keytooli käivitamisel kopeeri väljundist fingerprint reast, mis algab MD5-ga, umbes selline: MD5: BE:C3:11:4E:...:BC:B4:96 (MD5: stringijuppi ära muidugi kaasa kopeeri)
• Saadud fingerprint a la BE:C3:11:4E:...:BC:B4:96 kopeeri google lehel http://code.google.com/intl/et/android/maps-api-signup.html alla vormi
• Kui kõik OK, siis saad google lehelt vastuseks midagi sellist "Täname teid, et registeerusite Android Maps rakendusliidese pääsukoodi saamiseks! Teie pääsukood on: 05VV1uAjD-uy4TpUwT... 0RomPQPC5sg"
• Kui tekib ikkagi probleeme, siis võib mureks olla teie locale: on olemas teadaolev bugi, et mitte-US-English settingute korral võtmevärk ei pruugi käia. Selleks vaata soovitusi siit. adb programmi leiad umbes sellisest kohast: c:\Program Files (x86)\Android\android-sdk\platform-tools