Klient Stagu pro Android

ˇ ÍRODOVEDECK ˇ ´ FAKULTA UNIVERZITY PALACKEHO ´ PR A KATEDRA INFORMATIKY

´ RSK ˇ ´ PRACE ´ BAKALA A

Klient Stagu pro Android

2012

Radim Peˇsek

Anotace V práci popisuji problematiku vývoje aplikac´ı pro operaˇcn´ı systém Android, kde pˇredstav´ım základn´ı stavebn´ı kameny aplikac´ı kaˇzdého projektu pro tento operaˇcn´ı systém a toto vˇse pak demonstruji na kódu vlastn´ı implementace jednoduchého klienta IS/STAG pro tuto platformu. Aplikace pˇreb´ır´ a informace z veˇrejného rozhran´ı IS/STAG za vyuˇzit´ı webových sluˇzeb nad IS/STAG. Práce rovnˇeˇz obsahuje pˇredstaven´ı operaˇcn´ıho systému Android a informaˇcn´ıho systému IS/STAG.

Dˇekuji svému vedouc´ımu práce Mgr. Janu Outratovi, Ph.D. za podnˇetné rady, vstˇr´ıcnost a v neposledn´ı ˇradˇe také za vypsán´ı tohoto tématu, které mˇe zaujalo natolik, ˇze se chci v´ yvoji aplikac´ı pro operaˇcn´ı systém Android vˇenovat i v budoucnu.

Obsah 1. Pˇ redstaven´ı projektu

8

2. Informaˇ cn´ı syst´ em IS/STAG 2.1. Co je to IS/STAG . . . . . . . . . . . . . . . . . . . . . . . . . . . 2.2. Moˇznosti v´ ymˇeny dat s IS/STAG . . . . . . . . . . . . . . . . . . 2.3. Popis rozhran´ı Webov´ ych sluˇzeb . . . . . . . . . . . . . . . . . . .

8 8 9 9

3. Android 3.1. Co je Android . . . . . . . . . 3.1.1. Architektura Androidu 3.2. Vyuˇzit´ı Androidu . . . . . . . 3.3. Pˇrehled verz´ı . . . . . . . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

4. V´ yvoj aplikac´ı pro platformu Android 4.1. Jak zaˇc´ıt programovat . . . . . . . . . . . . . . . . 4.1.1. Bez ˇceho se neobejdete . . . . . . . . . . . . 4.1.2. Pˇrehled moˇzn´ ych v´ yvojov´ ych prostˇred´ı . . . 4.1.3. V´ yvojové prostˇred´ı Eclipse . . . . . . . . . . 4.1.4. Zaloˇzen´ı nového projektu v Eclipse . . . . . 4.1.5. Popis adresáˇrové struktury Android projektu 4.2. Moˇzné pˇr´ıstupy k programován´ı GUI . . . . . . . . 4.2.1. Programov´ y zp˚ usob tvorby GUI . . . . . . . 4.2.2. Deklarativn´ı ˇreˇsen´ı tvorby GUI . . . . . . . 4.3. Základn´ı stavebn´ı kameny . . . . . . . . . . . . . . 4.3.1. Activity . . . . . . . . . . . . . . . . . . . . 4.3.2. Widget . . . . . . . . . . . . . . . . . . . . . 4.3.3. Intent . . . . . . . . . . . . . . . . . . . . . 4.3.4. ListView . . . . . . . . . . . . . . . . . . . . 4.3.5. Adapter . . . . . . . . . . . . . . . . . . . . 4.4. Dalˇs´ı prvky pouˇzité v projektu . . . . . . . . . . . . 4.4.1. Menu . . . . . . . . . . . . . . . . . . . . . . 4.4.2. GridView . . . . . . . . . . . . . . . . . . . 4.4.3. WebView . . . . . . . . . . . . . . . . . . . 4.4.4. Preferences . . . . . . . . . . . . . . . . . . 4.5. Zpracován´ı dat z IS/STAG . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

. . . . . . . . . . . . . . . . . . . . .

. . . .

10 11 11 13 13

. . . . . . . . . . . . . . . . . . . . .

14 14 14 15 15 16 16 18 18 19 20 21 23 24 25 26 29 29 31 34 36 37

Z´ avˇ er

39

Conclusions

40

Reference

41

4

A. Zdrojov´ y k´ od ExamListBaseAdapter.java

42

B. Zdrojov´ y XML k´ od preferences.xml

44

C. Obsah pˇ riloˇ zen´ eho CD

45

5

Seznam obr´ azk˚ u 1. 2. 3. 4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16.

Logo operaˇcn´ıho systému Android . . . . . . . . . . . . . . Ukázka operaˇcn´ıho systému Android . . . . . . . . . . . . Menu Nastaven´ı operaˇcn´ıho systému Android . . . . . . . Pˇridán´ı ADT Pluginu . . . . . . . . . . . . . . . . . . . . . Adresáˇrová struktura projektu . . . . . . . . . . . . . . . . Rozvrh hodin . . . . . . . . . . . . . . . . . . . . . . . . . Obrazovka ukazkové Activity . . . . . . . . . . . . . . . . Ukázka widgetu EditText a Button . . . . . . . . . . . . . Ukázka widgetu RadioButton . . . . . . . . . . . . . . . . Ukázka jednoduchého seznamu ListView . . . . . . . . . . Ukázka komplexn´ıho seznamu ListView . . . . . . . . . . . Blokové schéma Adapteru . . . . . . . . . . . . . . . . . . Menu voleb (ˇcervenˇe vyznaˇceno) . . . . . . . . . . . . . . . Ukázka dvou-dimezionáln´ıho zobrazen´ı mˇr´ıˇzkou - GridView Ukázka prvku WebView . . . . . . . . . . . . . . . . . . . Ukázka Preferences . . . . . . . . . . . . . . . . . . . . . .

6

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . .

11 12 12 16 17 20 23 24 24 25 25 27 30 32 34 36

Seznam tabulek 1.

Pˇrehled kl´ıˇcov´ ych verz´ı Androidu . . . . . . . . . . . . . . . . . .

7

13

1.

Pˇ redstaven´ı projektu

Projekt seznám´ı ˇctenáˇre s problematiku v´ yvoje aplikac´ı pro operaˇcn´ı systém Android a poskytne nˇekterá málo dokumentovaná fakta o moˇznostech v´ yvoje pro tuto platformu. V´ ysledkem práce je jednoduch´ y klient STAGu, kter´ y zprostˇredkovává data uloˇzená v IS/STAG pomoc´ı webov´ ych sluˇzeb nad IS/STAG. Klient byl c´ılen pro potˇreby student˚ u, takˇze vˇetˇsina funkc´ı je urˇcena student˚ um, nicménˇe jsem se na posledn´ı chv´ıli rozhodl (v reakci na poznámku mého vedouc´ıho práce) dodˇelat i pár funkc´ı pro uˇcitele, aby mˇela aplikace ˇsirˇs´ı zábˇer potencionáln´ıch uˇzivatel˚ u.

2.

Informaˇ cn´ı syst´ em IS/STAG IS/STAG je zkratka pˇredstavuj´ıc´ı název Informaˇcn´ı Systém STudijn´ı AGendy.

2.1.

Co je to IS/STAG

Jedná se informaˇcn´ı systém, kter´ y byl vyvinut Centrem informatizace a v´ ypoˇcetn´ı techniky na Západoˇceské univerzitˇe v Plzni, kde byl také poprvé pouˇzit a nasazen do provozu. Postupnˇe se rozˇs´ıˇril na dalˇs´ı ˇskoly a v roce 2010 ho pouˇz´ıvalo jiˇz 16 ˇskol vˇcetnˇe Univerzity Palackého v Olomouci. Informaˇcn´ım systém pokr´ yvá veˇskerou studijn´ı agendu od pˇrij´ımac´ıch ˇr´ızen´ı aˇz po vydán´ı diplomu a to v prezenˇcn´ı, kombinované formˇe i formˇe celoˇzivotn´ıho vzdˇeláván´ı. Lze ho pouˇz´ıt pro vysoké ˇskoly i pro vyˇsˇs´ı odborné ˇskoly. Informaˇcn´ı systém obsahuje tyto moduly: • studijn´ı programy, obory plány a pˇredmˇety • kompletn´ı evidenci studenta • pˇrij´ımac´ı ˇr´ızen´ı • rozvrhy • pˇredzápis • zkouˇsky • semestráln´ı práce • mobility student˚ u • evaluace • pˇredpisy plateb 8

• evidenci absolvent˚ u, kvalifikaˇcn´ıch prac´ı a závˇereˇcn´ ych zkouˇsek Pro práci s IS/STAG je moˇzné zvolit nˇekterou z následuj´ıc´ıch moˇznost´ı: 1. Nativn´ı klient - aplikace nainstalovaná na pracovn´ı stanici. Je k dispozici pro operaˇcn´ı systém Microsoft Windows (XP a vyˇsˇs´ı). Nativn´ıho klienta pouˇz´ıvaj´ı pˇredevˇs´ım rozvrháˇri, studijn´ı oddˇelen´ı a správci fakult a kateder. 2. Webové stránky a portál - k pˇr´ıstupu staˇc´ı m´ıt internetov´ y prohl´ıˇzeˇc. Nab´ız´ı funkce urˇcené pˇredevˇs´ım pro studenty a uˇcitele.

2.2.

Moˇ znosti v´ ymˇ eny dat s IS/STAG

IS/STAG nab´ız´ı moˇznosti komunikace s dalˇs´ımy poˇc´ıtaˇcov´ ymi systémy pomoc´ı veˇrejného rozhran´ı. V pˇredchoz´ı kapitole jsem popsal komunikaci na u ´rovni uˇzivatele, ale v této kapitole to bude komunikace orientovaná na stroje. D´ıky tomuto rozhran´ı mohou napˇr´ıklad vyuˇcuj´ıc´ı, vedouc´ı si vlastn´ı databázi bod˚ u ˇci zápoˇct˚ u, na konci semestru naimportovat soubor ve formátu XLS do IS/STAG a nen´ı tedy nutné, aby tyto u ´daje opisoval do IS/STAG. Dalˇs´ı moˇznost´ı vyuˇzit´ı je um´ıstˇen´ı seznamu pˇredmˇet˚ u, uˇcitel˚ u ˇci studijn´ıch program˚ u z IS/STAG a jejich um´ıstˇen´ı na stránky kateder - seznamy tak budou vˇzdy odpov´ıdat aktuáln´ımu stavu dle IS/STAG. V´ ystupy z IS/STAG mohou b´ yt v následuj´ıc´ıch formátech: XML, XLS (Microsoft Excel), CSV (obecn´ y textov´ y soubor) ˇci kalendáˇrov´ y formát iCal.

2.3.

Popis rozhran´ı Webov´ ych sluˇ zeb

Webové sluˇzby jsou z uˇzivatelského pohledu m´ısta na internetu s konkrétn´ı adresou (URL), kde bˇeˇz´ı sluˇzba zpracovavaj´ıc´ı poˇzadavky. Poˇzadavkem m˚ uˇze b´ yt operace ˇcten´ı nebo zápisu dat do IS/STAG. Webové sluˇzby nad IS/STAG poskytuj´ı dva typy aplikaˇcn´ıho rozhran´ı: REST a SOAP. Prvnˇe jmenovan´ y typ rozhran´ı je bl´ıˇze uˇzivatel˚ um a typ SOAP je pˇreváˇznˇe pro komunikace typu strojstroj. Protoˇze ve své aplikaci Klient Stagu pro Android pouˇz´ıvám typ rozhran´ı REST a v´ ystupn´ı formát XML, uvedu pˇr´ıklad pˇr´ımo z vlatn´ı aplikace tj. rozhran´ı REST. Mˇejme tedy následuj´ıc´ı URL: https://stagservices.upol.cz/ws/services/rest/predmety/ getPredmetyByStudent?osCislo=R090374\&semestr=LS Popis jednotliv´ ych ˇcást´ı URL: • https://stagservices.upol.cz/ws/services/ - základn´ı adresa webov´ ych sluˇzeb nad IS/STAG 9

• rest/predmety/ - adresa konkrétn´ı sluˇzby • getPredmetyByStudent - název konkrétn´ı metody, kterou ziskáváme nebo zas´ıláme data (v tomto pˇr´ıpadˇe z´ıskáváme) • osCislo=R090374&semestr=LS - parametry metody (osobn´ı ˇc´ıslo studenta R090374 a parametr semest udává letn´ı semestr) Jako v´ ysledek obdrˇz´ıme od serveru odpovˇed’ ve formátu XML, která bude obsahovat vˇsechny pˇredmˇety studenta s osobn´ım ˇc´ıslem R090374 v letn´ım semestru. Obsah takového XML souboru vypadá následovnˇe: <ns1:getPredmetyByStudentResponse> <predmetyStudenta> <predmetStudenta> YSOFI Softwarov´ e inˇ zen´ yrstv´ ı KMI 2011 9 . . . <predmetStudenta> YINFS Informaˇ cn´ ı syst´ emy KMI 2011 9 Tato data jiˇz je moˇzné strojovˇe zpracovávat a pouˇz´ıt je ve sv´ ych aplikac´ıch napˇr´ıklad na webov´ ych stránkách nebo v mém pˇr´ıpadˇe v aplikaci pro platformu Android. Nejprve jsem ˇcerpal informace ohlednˇe IS/STAG z dokumentace webov´ ych sluˇzeb Univerzity Palackého [5], nicménˇe jsem se jeˇstˇe poohlédl jinde a naˇsel jsem dokumentaci webov´ ych sluˇzeb Západoˇceské Univerzity v Plzni [6], která mˇela bohatˇs´ı moˇznosti a byla k dispozici i podrobnˇejˇs´ı dokumentace. Pravdˇepodobnˇe je to d´ıky tomu, ˇze na této univerzitˇe IS/STAG vznikl, a proto je zde nejlépe zdokumentován.

3.

Android 10

3.1.

Co je Android

Android je operaˇcn´ı systém urˇcen´ y pro mobiln´ı zaˇr´ızen´ı, kter´ y je zaloˇzen´ y na Linuxovém jádˇre verze 2.6. Vznikl spojen´ım firmy Android Inc. s firmou Google Inc. a jejich spoluprác´ı - Google odkoupil p˚ uvodn´ı firmu Android Inc. a udˇelal z n´ı v roce 2005 svou dceˇrinou spoleˇcnost. V pr˚ ubˇehu roku 2007 byl prezentován prvn´ı produkt tohoto spojen´ı - Android, otevˇrená platforma pro mobiln´ı zaˇr´ızen´ı. Ten sam´ y rok byl pˇredstaven také nástroj pro v´ yvojáˇre Android SDK, kter´ y byl vydán pod licenc´ı open-source. Prvn´ı komerˇcnˇe dostupn´ y telefon s Androidem byl vyroben firmou HTC a uveden na trh koncem roku 2008 a s n´ım i SDK verze 1.0. V dobˇe vzniku této práce je nejrozˇs´ıˇrenˇejˇs´ı verz´ı Androidu verze 2.3.x s kódov´ ym oznaˇcen´ım Gingerbread - v´ıce informac´ı o vˇsech dostupn´ ych verz´ıch operaˇcn´ıho systému Android jsem shrnul do tabulky 1. v sekci Pˇrehled verz´ı. Operaˇcn´ı systém Android poznáte podle znaku zeleného robota, jak ilustruje obrázek 1. - logo operaˇcn´ıho systému Android. Tento symbol je pouˇz´ıván i v´ yrobci hardwaru, kteˇr´ı j´ım oznaˇcuj´ı zaˇr´ızen´ı s nainstalovan´ ym operaˇcn´ım systémem Android.

Obrázek 1. Logo operaˇcn´ıho systému Android Na obrázku 2. je ukázka prostˇred´ı operaˇcn´ıho systému Android zobrazuj´ıc´ı nainstalované aplikace a na obrázku 3. je zobrazeno menu Nastaven´ı, které umoˇzn ˇuje uˇzivateli nastavit chován´ı mobiln´ıho zaˇr´ızen´ı. Konkrétn´ı zobrazen´ı se m˚ uˇze liˇsit podle v´ yrobce, protoˇze kaˇzd´ y v´ yrobce si prostˇred´ı Androidu vylepˇsuje sv´ ymi nástavbami tak, aby uˇzivatel˚ um poskytli v základn´ı v´ ybavˇe mobiln´ıho zaˇr´ızen´ı v´ıce moˇznost´ı ˇci funkc´ı. 3.1.1.

Architektura Androidu

Architektura Androidu je pˇetivrstvá a tvoˇr´ı ji tyto vrstvy (vyjmenovány od nejniˇzˇs´ı vrstvy): jádro systému, knihovny, Android Runtime (Dalvik), Application framework a nejvyˇsˇs´ı vrstvu tvoˇr´ı tzv. základn´ı aplikace. Jádro systému je, jak jiˇz jsem zm´ınil, zaloˇzeno na redukovaném Linuxovém jádˇre verze 2.6 a obsahuje správu pamˇeti, s´ıt´ı, proces˚ u, zabudované ovladaˇce. Neobsahuje vˇsak grafické uˇzivatelské rozhran´ı X Window. Vrstva knihoven je poskytována v´ yvojáˇr˚ um prostˇrednictv´ım vrstvy Application framework a obsahuje knihovny pro pˇrehráván´ı multimediáln´ıch soubor˚ u, knihovny webového prohl´ıˇzeˇce, libc - pˇrizp˚ usobená pro mobiln´ı zaˇr´ızen´ı, 11

Obrázek 2. Ukázka operaˇcn´ıho systému Android

Obrázek 3. Menu Nastaven´ı operaˇcn´ıho systému Android

odhlehˇcen´ y databázov´ y engine SQLite, secure socket layer, Knihovnu pro vykreslován´ı bitmapov´ ych a vektorov´ ych font˚ u a OpenGL knihovnu pro vykreslován´ı 3D grafiky. Android Runtime vrstva má v sobˇe virtualizaˇcn´ı stroj znam´ y jako Dalvik (Dalvik Virtual Machine zkrácenˇe DVM), kter´ y vyuˇz´ıvá základn´ı funkce jádra jako je práce s vlákny a správce pamˇeti. Dalvik vznikl kv˚ uli hlavnˇe kv˚ uli licenˇcn´ım práv˚ um na Java Virtual Machine (JVM), ale také kv˚ uli efektivnˇejˇs´ımu ˇr´ızen´ı spotˇreby a v´ ykonu ˇci optimalizaci poˇzadavk˚ u na pamˇet. Vˇsechna tato kritéria hraj´ı kl´ıˇcovou u ´lohu u vˇsech mobiln´ıch zaˇrizen´ı. Zjednoduˇsenˇe ˇreˇceno kaˇzdá aplikace spuˇstˇená na Androidu má také sv˚ uj vlastn´ı proces a ten bˇeˇz´ı ve svém DVM. Vrstva Application framework je nejd˚ uleˇzitˇejˇs´ı vrstvou pro v´ yvojáˇre. Zpˇr´ıstupˇ nuje totiˇz v´ yvojáˇri napˇr´ıklad dostupné sluˇzby i prvky uˇzivatelkého rozhran´ı. Nejv´ yˇse je vrstva základn´ıch aplikac´ı, kterou vyuˇz´ıvaj´ı bˇeˇzn´ı uˇzivatelé operaˇcn´ıho systému tj. jedná se o aplikace dodané v´ yrobcem mobiln´ıho zaˇr´ızen´ı nebo pozdˇeji nainstalované bal´ıˇcky z oficiáln´ıho Obchodu Play (dˇr´ıve známého jako Android Market) ˇci z jin´ ych zdroj˚ u. Pˇrikladem aplikace z jiného zdroje je i moje aplikace Klient Stagu pro Android. Pˇri popisu architektury operaˇcn´ıho systému Android jsem vycházel z informac´ı na stránkách Wikipedie [8]. 12

3.2.

Vyuˇ zit´ı Androidu

Android byl p˚ uvodnˇe urˇcen´ y pro chytré telefony. Nicménˇe s pˇr´ıchodem nov´ ych mobiln´ıch zaˇr´ızen´ı se jeho pouˇzit´ı rozˇs´ıˇrilo i na tablety. Nˇekteˇr´ı v´ yrobci hardwaru jej také zaˇcali dodávat do cenovˇe dostupn´ ych pˇrenosn´ ych poˇc´ıtaˇc˚ u, protoˇze je pro uˇzivatele zdarma, coˇz sniˇzuje cenu tˇechto zaˇr´ızen´ı a zároveˇ n napomáhá dalˇs´ımu rozˇs´ıˇren´ı operaˇcn´ıho systému Android mezi beˇzné uˇzivatele. S popularitou Androidu se také zaˇcalo rozˇsiˇrovat portfolio produkt˚ u, které jsou na trhu dostupné, s t´ımto operaˇcn´ım systémem. Android se zaˇc´ıná dostávat do televizn´ıch pˇrij´ımaˇc˚ u, hern´ıch konzol´ı a pˇr´ıˇst´ı rok by se mˇel zaˇc´ıt uplatˇ novat také v automobilech m´ısto zastaral´ ych a velmi drah´ ych navigaˇcn´ıch systém˚ u.

3.3.

Pˇ rehled verz´ı

Tabulka zobrazuje pˇrehled kl´ıˇcov´ ych verz´ı Androidu s jejich kódov´ ymi ´ oznaˇcen´ımi, u ´rovnˇe API, data vydán´ı a pod´ıl dané verze na trhu. Udaje o pod´ılu jednotliv´ ych verz´ı na trhu jsou ke dni 5. bˇrezna 2012 (zdroj: http://developer.android.com[4]). Z tabulky je zˇrejmé, ˇze nejrozˇs´ıˇrenˇejˇs´ı verz´ı na trhu je verze 2.3.x s kódov´ ym oznaˇcen´ım Gingerbread, která má 62% pod´ıl na trhu. S pˇrihlédnut´ım k tomuto faktu, jsem svou aplikaci vytvoˇril pro tuto nejpoˇcetnˇejˇs´ı skupinu zaˇr´ızen´ı a také proto, ˇze takové zaˇr´ızen´ı vlastn´ım a proto vˇse mohu ˇra´dnˇe vyzkouˇset. Do verze 2.3.x byl operaˇcn´ı systém Android optimalizován pouze pro chytré telefony, ale protoˇze se na trhu velmi rozˇs´ıˇril nov´ y druh mobiln´ıho zaˇr´ızen´ı - tablet, tak pˇriˇsla firma Google na trh s verz´ı 3.x.x s kódov´ ym oznaˇcen´ım Honeycomb, kde byla pˇridána optimalizace pro tablety a dalˇs´ı zaˇr´ızen´ı s velkou obrazovkou. Protoˇze je verze Honeycomb urˇcená pro tablety, tak se s n´ı témˇeˇr na chytr´ ych telefonech nesetkáte. Nejnovˇejˇs´ı chytré telefony pouˇz´ıvaj´ı aˇz verzi 4.0.x s kódov´ ym oznaˇcen´ım Ice Cream Sandwich. Verze

K´ odov´ e API Pod´ıl Datum oznaˇ cen´ı u ´ roveˇ n na trhu vyd´ an´ı Android 4.0.X Ice Cream Sandwich 14-15 1,6% 19.10.2011 Android 3.X.X Honeycomb 11-13 3,3% 22.2.2011 Android 2.3.X Gingerbread 9-10 62,0% 6.12.2010 Android 2.2.X Froyo 8 25,3% 20.5.2010 Android 2.1 Eclair 7 6,6% 26.10.2009 Android 1.6 Donut 4 0,8% 15.9.2009 Android 1.5 Cupcake 3 0,4% 30.4.2009 Tabulka 1. Pˇrehled kl´ıˇcov´ ych verz´ı Androidu

13

4.

V´ yvoj aplikac´ı pro platformu Android

Kapitola obsahuje popis vybran´ ych a pouˇzit´ ych stavebn´ıch prvk˚ u pouˇz´ıvan´ ych pˇri tvorbˇe aplikace Klient Stagu pro Android.

4.1.

Jak zaˇ c´ıt programovat

Nejv´ıce mˇe v zaˇcátc´ıch pomohla kniha Android 2 - Pr˚ uvodce programován´ım mobiln´ıch aplikac´ı od Marka L. Murphy [1], která je psaná pro zaˇca´teˇcn´ıky se základn´ı znalost´ı Javy. Javu jsem se uˇcil pˇreváˇznˇe z knihy Sharona Zakhoura a u Javy a Androidu se pro mˇe stal nejvˇetˇs´ım kolektivu[2]. Po zvládnut´ı základ˚ zdrojem informac´ı web pro v´ yvojáˇre [4], kter´ y spravuje pˇr´ımo firma Google. Stránky pro v´ yvojáˇre od Googlu jsou jako referenˇcn´ı pˇr´ıruˇcka, a proto je doporuˇcuji pouˇz´ıvat. Z praktického hlediska je uˇziteˇcn´ y seriál Vyv´ıj´ıme pro Android [3], kter´ y je skvˇel´ ym u ´vodem do názvoslov´ı a jsou zde i pˇr´ıklady praktick´ ych a pouˇz´ıvan´ ych kód˚ u. 4.1.1.

Bez ˇ ceho se neobejdete

Neobejte se bez znalost´ı jazyka Java (nemus´ı b´ yt pˇr´ıliˇs hluboká), znalosti XML, znalosti prostˇred´ı Androidu a problematiky tvorby a stuktury projekt˚ u pro operaˇcn´ı systém Android. Ze softwarové v´ ybavy budete dále budete potˇrebovat: • nainstalovat Java SE Development Kit 7 ze stránek firmy Oracle • Android SDK Tools, kter´ y je ke staˇzen´ı na http://developer.android.com/sdk/. Tento bal´ık obsahuje vˇse potˇrebné, co se t´ yka Androidu. Najdete v nˇem Android SDK Manager slouˇz´ıc´ı pro správu bal´ıˇck˚ u, kter´ ym si m˚ uˇzete stáhnout knihovny té verze Androida pro kterou bude aplikaci vyv´ıjet. Jeˇstˇe v Android SDK Tools naleznete AVD Manager (Android Virtual Device Manager). AVD Manager umoˇzn ˇuje správu vaˇsich virtuáln´ıch zaˇr´ızen´ı, na kter´ ych budete v emulátoru zkouˇset svoje aplikace. • m´ıt alespoˇ n textov´ y editor, v kterém budete psát zdrojové kódy. Pokud se tedy nerozhodnete pro nˇekteré z moˇzn´ ych v´ yvojov´ ych prostˇred´ı v kapitole 4.1.2. To, co jsem právˇe vyjmenoval je u ´plné minimum, nutné k tomu, abyste se mohli pustit do své prvn´ı aplikace.

14

4.1.2.

Pˇ rehled moˇ zn´ ych v´ yvojov´ ych prostˇ red´ı

D´ıky v´ yvojovému prostˇred´ı bude vaˇse programován´ı mnohem efektivnˇejˇs´ı a bude obsahovat ménˇe chyb, protoˇze v prostˇred´ı editoru je obsaˇzena pr˚ ubˇeˇzná syntaktická kontrola kódu, r˚ uzné nápovˇedy názv˚ u metod, automatické ˇci poloautomatické ”dokonˇcovaˇce”a mnoho dalˇs´ıho. V pˇr´ıpadˇe, ˇze se tedy rozhodnete vyuˇz´ıt komfortu v´ yvojového prostˇred´ı, coˇz vˇrele doporuˇcuji - obzvláˇstˇe pokud s Androidem zaˇc´ınáte, tak máte na v´ ybˇer nˇekolik moˇznost´ı. Jak jsem v pˇredchoz´ı kapitole 4.1.1. tvrdil, ˇze je nutná znalost jazyka Java, tak to nen´ı aˇz tak u ´plnˇe pravda a je tady jeˇstˇe jedna moˇznost - a to pokud um´ıte programovat v C#. Pokud se chcete vydat touto cestou, pak vám staˇc´ı m´ıt nainstlalován .NET a Visual Studio 2010 a do nˇej si nainstalovat add-on MonoDroid. MonoDroid nelze provozovat s Visual Studiem Express. Jak MonoDroid zprovoznit a zaˇc´ıt s n´ım programovat aplikace pro Android pˇeknˇe popsal Mahesh Chand ve svém ˇclánku Building Android Applications using C#. Protoˇze drtivá vˇetˇsina v´ yvojáˇr˚ u si zvolila programovat aplikace pro Android v jazyce Java, zvolil jsem tuto cestu i já. Dalˇs´ım zásadn´ım d˚ uvodem proˇc programovat v jazyce Java je fakt, ˇze Java kód se v Androidu spouˇst´ı ”pˇr´ımo”a váˇs kód nemus´ı procházet ”konvertorem”jak´ ym je MonoDroid. Nejpouˇz´ıvanˇejˇs´ım, a z mého pohledu i nejpropracovanˇejˇs´ım, v´ yvojov´ ym prostˇred´ım je produkt Eclipse a proto jsem si ho zvolil pro v´ yvoj své aplikace Klient Stagu pro Android. Podrobnˇeji se mu budu vˇenovat v následuj´ıc´ı kapitole 4.1.3. Dalˇs´ı moˇznost´ı je v´ yvojové prostˇred´ı Netbeans od firmy Oracle, které je open source. Podporuje v´ıce programovac´ıch jazyk˚ u, ale primárnˇe je urˇcen pro v´ yvoj aplikac´ı v jazyce Java. 4.1.3.

V´ yvojov´ e prostˇ red´ı Eclipse

Eclipse je open source v´ yvojová platforma, která se zamˇeˇruje na programován´ı v jazyce Java. Eclipse má moˇznost rozˇsiˇritelnosti pomoc´ı plugin˚ u a to je právˇe jeho silnou stránkou, protoˇze d´ıky plugin˚ um lze Eclipse rozˇs´ıˇrit tak, aby se v nˇem dalo vyv´ıjet pro platformu Android. Tento plugin se jmenuje ADT Plugin (ADT - Android Development Tools) a lze ho nainstalovat pohodlnˇe pˇr´ımo z prostˇred´ı Eclipse. Nejprve je nutné nainstalovat Eclipse, takˇze si jej nejdˇr´ıve ybˇer nˇekolik verz´ı stáhneme z http://www.eclipse.org/downloads/. Je zde na v´ produktu Eclipse - doporuˇcuji verzi Eclipse Classic. Po staˇzen´ı a naistalován´ı produktu Eclipse jej spust’te a nastavte si pracovn´ı adresáˇr k ˇcemuˇz vás Eclipse vyzve. Jakmile se dostanete do v´ yvojového prostˇred´ı nainstalujte si ADT Plugin. To udˇeláte následovnˇe: zvolte v menu Help > Install New Software, v oknˇe stisknˇete tlaˇc´ıtko Add a vyplˇ nte u ´daje dle obrázku 4. a potvrd’te. V oknˇe Available Software zatrhnˇete Developer Tools, potvrd’te a dokonˇcete instalaci pluginu. Po instalaci ADT Pluginu je nutné restartovat Eclipse. T´ımto máte prostˇred´ı

15

Obrázek 4. Pˇridán´ı ADT Pluginu Eclipse pˇripraven a m˚ uˇzete se pustit do programován´ı pro platformu Android. 4.1.4.

Zaloˇ zen´ı nov´ eho projektu v Eclipse

Zaloˇzen´ı projektu je d´ıky pr˚ uvodci jednoduché a rychlé narozd´ıl od ruˇcn´ıho vytváˇren´ı vˇsech potˇrebn´ ych soubor˚ u a adresáˇr˚ u. Nov´ y projekt vytvoˇr´ıme takto: zvol´ıme v menu poloˇzku File > New > Project, v oknˇe si nalistujem sekci Android a tam zvol´ıme Android Application Project. V dalˇs´ım kroku mus´ıme vyplnit název aplikace, jméno projektu a jméno bal´ıˇcku se nám pˇredvypln´ı automaticky, ale lze je, v pˇr´ıpadˇe potˇreby, zmˇenit. Potvrd´ıme a v následuj´ıc´ım kroku si m˚ uˇzeme zvolit ikonu naˇs´ı aplikace, pod kterou ji najdeme v seznamu program˚ u. Dalˇs´ı kroky m˚ uˇzeme potvrdit a zanechat implicitn´ı hodnoty. T´ımto jsme vytvoˇrili základn´ı adresáˇrovou strukturu naˇs´ı nové aplikace vˇcetnˇe vˇsech potˇrebn´ ych soubor˚ u, v´ ysledek je vidˇet na obrázku 5. 4.1.5.

Popis adres´ aˇ rov´ e struktury Android projektu

Kaˇzd´ y projekt obsahuje pevnˇe danou strukturu adresáˇr˚ u a soubor˚ u. Tu je vidˇet na obrázku 5. Postupnˇe si ji pˇredstav´ıme po jednotliv´ ych adresáˇr´ıch od koˇrenového adresáˇre: • AndroidManifest.xml: XML dokument popisuj´ıc´ı naˇsi aplikaci a jej´ı komponenty (vˇsechny Activity, práva aplikace - permissions, sluˇzby atp.) • /src/: v tomto adresáˇri jsou uloˇzeny vˇsechny zdrojové soubory (*.java) naˇsich Activity, vlastn´ıch tˇr´ıd atd. Pˇr´ıklad takovéhoto souboru je v kapitole 4.3.1. • /gen/: sem si pˇrekladaˇce ukládaj´ı zdrojov´ y kód, kter´ y vygeneruj´ı • /assets/: adresáˇr pro statické soubory, které chceme pˇribalit k aplikaci urˇcené k pouˇzit´ı na zaˇr´ızen´ı • /bin/: adresáˇr, kde se aplikace uchovává po jej´ım zkompilován´ı

16

• /libs/: zde se ukládaj´ı knihovny (napˇr. tˇret´ıch stran), které naˇse aplikace potˇrebuje • /res/: toto je nejpouˇz´ıvanˇejˇs´ı adresáˇr spoleˇcnˇe z adresáˇrem src. Jsou zde vˇsechny potˇrebné prostˇredky jako jsou ikony, soubory s návrhem grafického uˇzivatelského rozhran´ı - layouty, návrhy menu, seznamy ˇretˇezc˚ u atd.

Obrázek 5. Adresáˇrová struktura projektu Pojd’me se nyn´ı podrobnˇeji pod´ıvat do obsahu adresáˇre /res/: • /res/layout: zde jsou XML soubory s návrhy grafického uˇzivatelského rozhran´ı (GUI) • /res/menu: opˇet m´ısto pro XML soubory, ale tentokrát se specifikac´ı menu • /res/values: zde jsou XML soubory s ˇretˇezci, poli apod. • /res/drawable: adresáˇr pro obrázky PNG, JPG atp. • /res/xml: adresáˇr s dalˇs´ımi XML soubory, které chceme k aplikaci pˇribalit • /res/raw: urˇceno pro r˚ uzné typy soubor˚ u Pˇri odkazován´ı se na prostˇredky (resources), z adresáˇre /res/, v programovém kódu pouˇz´ıváme tento systém (názvy soubor˚ u se uvád´ı bez pˇr´ıpony): • /res/layout: R.layout.nazevsouboru • /res/menu: R.menu.nazevsouboru 17

• /res/values: R.nazevsouboru.nazevhodnotyvsouboru • /res/drawable: R.drawable.nazevsouboru • /res/xml: R.xml.nazevsouboru • /res/raw: R.raw.nazevsouboru Pˇri odkazován´ı se na prostˇredky (resources), z adresáˇre /res/, v XML layoutech pouˇz´ıváme tento systém (názvy soubor˚ u se uvád´ı bez pˇr´ıpony): • /res/values: @nazevsouboru/nazevhodnotyvsouboru napˇr´ıklad @string/btnWizardText nás odkazuje do adresáˇre /res/values na soubor string.xml (jedná se o soubor s ˇretˇezci - vhodné pro multilinguáln´ı programy) a hodnotu ˇretˇezce btnWizardText • /res/drawable: @drawable/nazevsouboru

4.2.

Moˇ zn´ e pˇ r´ıstupy k programov´ an´ı GUI

V´ yvojáˇr se m˚ uˇze postavit, k programován´ı GUI pro platformu Android, dvˇema r˚ uzn´ ymi zp˚ usoby. Prvn´ım z nich je programové ˇreˇsen´ı a druhé deklarativn´ı. Porovnán´ı obou zp˚ usob˚ u demonstruji na tvorbˇe stejného prvku GUI a to na menu. Vizuáln´ı v´ ysledek programového i deklarativn´ıho zp˚ usobu ˇreˇsen´ı je stejn´ y a je j´ım menu na obrázku 13. 4.2.1.

Programov´ y zp˚ usob tvorby GUI

Tento zp˚ usob spoˇc´ıvá v tom, ˇze celá tvorba menu je pouze v programovém kódu naˇs´ı Activity. Menu tedy generujeme pˇr´ımo kódem, kter´ y uvedeme v metodˇe onCreateOptionsMenu. V´ yhodou tohoto ˇreˇsen´ı je na prvn´ı pohled menˇs´ı mnoˇzstv´ı kódu, které je nav´ıc pˇeknˇe pohromadˇe v naˇs´ı Activity. Nev´ yhodou tototo zp˚ usobu tvorby GUI je fakt, ˇze v kódu Activity máme dohromady jak funkˇcn´ı kód, tak definici grafiky. Z toho plyne, ˇze pˇr´ıpadné zmˇeny (napˇr´ıklad poˇrad´ı poloˇzek v menu) mus´ıme ˇreˇsit zásahem v kódu Activity. Kód nutn´ y pro vytvoˇren´ı menu pomoc´ı programového ˇreˇsen´ı (um´ıstˇen´ y v naˇs´ı Activity): @Override public boolean onCreateOptionsMenu(Menu menu) { super.onCreateOptionsMenu(menu); menu.add(0,OPTIONS_ID,0,R.string.menu_options) .setIcon(android.R.drawable.ic_menu_preferences); menu.add(0,HELP_ID,0,R.string.menu_help) 18

.setIcon(android.R.drawable.ic_menu_help); menu.add(0,EXIT_ID,0,R.string.menu_exit) .setIcon(android.R.drawable.ic_menu_close_clear_cancel); menu.add(0,ABOUT_ID,0,R.string.menu_about) .setIcon(android.R.drawable.ic_menu_info_details); return true; } Dalˇs´ı, nikoliv zásadn´ı, nev´ yhodou programového ˇreˇsen´ı je jin´ y zp˚ usob identifikace jednotliv´ ych prvk˚ u. Prvky jsou identifikovány ˇc´ısly, které si mus´ıme definovat. Napˇr´ıklad OPTIONS ID=0, HELP ID=1 atd. Na toto je nutné mystet pˇri obsluze události onOptionsItemSelected. U deklarativn´ıho zp˚ usobu se pˇri obsluze této události odvoláváme na pˇr´ıstuˇsné id, které jsme si v XML souboru definovali (parametr android:id). V´ yhodou programového ˇreˇsen´ı je, ˇze s n´ım m˚ uˇzeme ˇreˇsit i situace, které deklarativn´ım zp˚ usobem v˚ ubec vytvoˇrit nelze. V´ıce se o této v´ yhodˇe zmiˇ nuji v kapitole 4.2.2. 4.2.2.

Deklarativn´ı ˇ reˇ sen´ı tvorby GUI

Toto ˇreˇsen´ı je zaloˇzeno na souˇcinnosti programového kódu Activity a XML soubor˚ u. Odstraˇ nuje nˇekteré z nedostatk˚ u programového zp˚ usobu tvorby GUI. T´ım nejzásadnˇejˇs´ım je fyzické oddˇelen´ı definice grafiky a funkˇcn´ıho kódu do dvou r˚ uzn´ ych soubor˚ u. Z hlediska praktického je deklarativn´ı ˇreˇsen´ı v´ yhodnˇejˇs´ı, i kdyˇz je pro v´ yvojáˇre o trochu pracnˇejˇs´ı. Tento zp˚ usob programován´ı jsem si zvolil i já, a proto jej uvid´ıte i v m´ ych vzorov´ ych kódech v této práci. Kód um´ıstˇen´ y v naˇs´ı Activity pro vytvoˇren´ı menu pomoc´ı deklarativn´ıho ˇreˇsen´ı: @Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflater = getMenuInflater(); inflater.inflate(R.menu.main_menu, menu); return true; } Jak je vidˇet, v kódu se pouze ”odkazujeme”na soubor main menu.xml s grafick´ ym návrhem menu (R.menu.main menu = /res/menu/main menu.xml). Kód pˇr´ısluˇsného XML souboru main menu.xml um´ıstˇeného v adresáˇri /res/menu: <menu xmlns:android="http://schemas.android.com/apk/res/android" > 19

Nev´ yhodou tohoto zp˚ usobu tvorby GUI je, ˇze ho nelze pouˇz´ıt na taková zobrazen´ı, kdy pˇresnˇe neznáme poˇcet a um´ıstˇen´ı prvk˚ u. Pˇr´ıkladem z mé aplikace Klient Stagu pro Android je Rozvrh hodin (obrázek 6.) - zde dopˇredu nev´ıme kolik pˇredmˇet˚ u má dan´ y student v rozvrhu, jak jsou dlouhé ani den v t´ ydnu kaˇzdého pˇredmˇetu. Nicménˇe to lze ˇreˇsit kompromisem, kdy jako základ pouˇzijeme deklaraˇcn´ı zp˚ usob a pˇredmˇety generujeme programovˇe.

Obrázek 6. Rozvrh hodin

4.3.

Z´ akladn´ı stavebn´ı kameny 20

4.3.1.

Activity

Activity je hlavn´ı ˇca´st kaˇzdé aplikace, bez n´ı nelze ˇza´dnou aplikaci spustit. Activity si m˚ uˇzeme pˇredstavit jako mal´ıˇrské plátno nebo jednu obrazovku naˇs´ı aplikace. Activity m˚ uˇze obsahovat tˇreba jen funkˇcn´ı kód a nebo obsahuje i ovládac´ı prvky jako jsou tlaˇc´ıtka, pˇrep´ınaˇce, textová pole a dalˇs´ı. Activity jsou ukládány v rámci projektu do podadresáˇre src, kde je kaˇzdá Activity uloˇzená ve svém souboru napˇr´ıklad UkazkaActivity.java. Nejjednoduˇsˇs´ı kód Activity by mohl b´ yt napˇr´ıklad tento: package com.example.android.mojeaplikace; import android.app.Activity; import android.os.Bundle; public class UkazkaActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); } } Prvn´ı sekce package je jméno bal´ıku coˇz je vlastnˇe jméno naˇs´ı aplikace - v naˇsem pˇr´ıpadˇe mojeaplikace. V druhé ˇcasti import se vkládaj´ı potˇrebné knihovny, které v rámci naˇs´ı Aktivity budeme pouˇz´ıvat. A v posledn´ı tˇret´ı ˇca´sti je definice tˇr´ıdy UkazkaActivity, která je potomkem tˇr´ıdy android.app.Activity jenˇz importujeme v pˇredchoz´ım bloku. Z toho vypl´ıvá, ˇze kaˇzdá naˇse Activity je potomkem zmiˇ nované tˇr´ıdy android.app.Activity. Uvnitˇr naˇs´ı tˇr´ıdy definujeme metody, kde jedna z tˇech základn´ıch je metoda onCreate, která se volá ihned po vytvoˇren´ı UkazkaActivity. V onCreate je d˚ uleˇzité zavolat metodu super.onCreate(savedInstanceState), kterou je vhodné volat co nejdˇr´ıve. Následuj´ıc´ı metoda setContentView(R.layout.main) nám spojuje naˇsi UkazkaActivity s XML souborem layoutu. Layout soubor naˇseho konkrétn´ıho pˇr´ıkladu se jmenuje main.xml a najdete ho ve vaˇsem projektu v adresáˇri /res/layout. Aby UkazkaActivity nˇeco dˇelala, je nutné do zmiˇ novaného souboru main.xml vloˇzit napˇr´ıklad takov´ yto kód: 21

V XML souboru definujeme jen prvky grafického uˇzivatelského prostˇred´ı (GUI), takˇze jsou oddˇeleny programová ˇca´st a GUI. V naˇsem pˇr´ıkladu je definován jen jeden prvek TextView, kter´ y zobrazuje text uveden´ y v parametru android:text. Posledn´ı, co mus´ıme definovat, je soubor AndroidManifest.xml. V nˇem mus´ı b´ yt zapsané vˇsechny Activity a u jedné z nich mus´ı b´ yt uveden element intent-filter. Pˇr´ıklad jednoduchého souboru AndroidManifest.xml s jednou Activity UkazkaActivity: <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.android.mojeaplikace" android:versionCode="1" android:versionName="1.0" > <uses-sdk android:minSdkVersion="10" /> Vˇsechny tyto tˇri soubory tvoˇr´ı, samozˇrejmˇe po zkompilován´ı, aplikaci pro operaˇcn´ı systém Android, která po spuˇstˇen´ı zobraz´ı v levém horn´ım rohu text Ahoj svˇete!. Spuˇstˇenou aplikaci ilustruje obrázek 7.

22

Obrázek 7. Obrazovka ukazkové Activity 4.3.2.

Widget

Android nab´ız´ı sadu prvk˚ u grafického uˇzivatelského rozhran´ı (GUI), obdobnˇe jako je tomu napˇr´ıklad na platformˇe Windows, která obsahuje základn´ı Widgety. Jsou to napˇr´ıklad tyto prvky (nejedná se o kompletn´ı seznam, ale v´ ybˇer nejpouˇz´ıvanˇejˇs´ıch prvk˚ u): • TextView (popisek) - na obrazovce aplikace zobraz´ı popisn´ y text. Tento prvek je vidˇet na obrázku 7. a je reprezentován textem Ahoj svˇete! • Button (tlaˇc´ıtko) - tento prvek vytvoˇr´ı bˇeˇzné tlaˇc´ıtko, které bez potˇrebného kódu ve vaˇs´ı Activity nebude nic spouˇstˇet. • ImageView (obrázek) - jedná se o analogii prvku TextView, ale v´ ysledkem je obrázek • ImageButton (obrázkové tlaˇc´ıtko) - opˇet se jedná o analogii prvku Button, jen s t´ım rozd´ılem, ˇze je na tlaˇc´ıtku um´ıstˇen´ y obrázek • EditText (textová pole) - pomoc´ı textov´ ych pol´ı m˚ uˇzeme aplikaci zadávat jak´ ykoliv text. Na obrázku 8. je napˇr´ıklad pouˇzit v Activity pro vyhledáván´ı student˚ u. • CheckBox (zatrˇz´ıtka) - bˇeˇznˇe známé zaˇskrtávac´ı pol´ıˇcko pouˇz´ıvané pro volby ano/ne, zapnuto/vypnuto atp. Pˇr´ıkladem je poloˇzka Pr˚ uvodce nastaven´ım po spuˇstˇen´ı na obrázku 16. • RadioButton (kulaté pˇrep´ınaˇce) - jedná se o prvky, kter´ ymi se vyb´ırá z nˇekolika voleb právˇe jedna volba (viz obrázek 9.). V XML souboru se sdruˇzuj´ı pomoc´ı elementu RadioGroup.

23

Obrázek 8. Ukázka widgetu EditText a Button 4.3.3.

Obrázek 9. Ukázka widgetu RadioButton

Intent

Intent (zámˇer) je instance tˇr´ıdy android.content.Intent a jedná se vlastnˇe o asynchonn´ı zprávy, které umoˇzn ˇuj´ı poˇzadovat jedné komponentˇe systému Android funkci od jiné komponenty systému Android. Typick´ ym pˇr´ıkladem zámˇeru je zaslan´ı zprávy, aby systém Android spustil nˇejakou dalˇs´ı Activity. Pˇr´ıklad zámˇeru - spuˇstˇen´ı Activity s názvem Help.class, která m˚ uˇze b´ yt um´ıstˇena napˇr´ıklad v metodˇe onClick nˇejakého tlaˇc´ıtka v aplikaci: startActivity(new Intent(this, Help.class)); Dalˇs´ım pˇr´ıkladem vyuˇzit´ı zámˇeru je napˇr´ıklad pˇridán´ı poloˇzky do kalendáˇre. Takov´ y kód by vypadal takto: Intent intent = new Intent(Intent.ACTION_EDIT); intent.setType("vnd.android.cursor.item/event"); intent.putExtra("beginTime", cal.getTimeInMillis()); intent.putExtra("allDay", true); intent.putExtra("endTime", cal.getTimeInMillis()+60*60*1000); intent.putExtra("title", fullObject.getTxtBig().toString()); intent.putExtra("eventLocation", location); startActivity(intent); 24

Zámˇer m˚ uˇze také obsahovat data napˇr´ıklad pˇri volán´ı komponenty internetového prohl´ıˇzeˇce je souˇca´st´ı zámˇeru také URL, které má prohl´ıˇzeˇc zobrazit. Nebo m˚ uˇzeme pˇredávat pomoc´ı zámˇeru parametry z jedné Activity do druhé - toto demonstruji na následuj´ıc´ım kódu: i = new Intent(HlavniMenuActivity.this, DepartmentInfo.class); i.putExtra("requestCode", 0); startActivityForResult(i,0); Tento kód spust´ı z Activity HlavniMenuActivity dalˇs´ı Activity DepartmentInfo a pˇredává j´ı parametr requestCode. 4.3.4.

ListView

ListView je skupinové zobrazen´ı poloˇzek, které lze rolovat (scrollovat). Pouˇz´ıvá se pˇredevˇs´ım pro r˚ uzné v´ ypisy seznam˚ u poloˇzek. Jde o jeden z nejpouˇz´ıvanˇejˇs´ıch prvk˚ u v aplikac´ıch na platformˇe Android. ListView m˚ uˇze zobrauˇze zobrazovat i sloˇzitˇejˇs´ı zovat jednoduch´ y seznam (viz obrázek 10.), nicménˇe m˚ datové struktury (nˇekolik poloˇzek v jednom bloku) jako je na obrázku 11. - zobrazuje skupinu pˇeti u ´daj˚ u a jedné poznámky, která je pˇr´ıtomna jen u nˇekteré ze skupin.

Obrázek 10. Ukázka jednoduchého seznamu ListView

25

Obrázek 11. Ukázka komplexn´ıho seznamu ListView

Jednotlivé poloˇzky jsou automaticky vkládány do seznamu d´ıky objektu Adapter, kter´ y bere data z urˇceného zdroje (pole, databáze) a konvertuje je do odpov´ıdaj´ıc´ıho zobrazen´ı. V pˇripadˇe jednoduchého seznamu je vhodné vyuˇz´ıt toho, ˇze ListView je potomkem tˇr´ıdy ListActivity a pak nen´ı nutné si programovat vlastn´ı Adapter. U sloˇzitˇejˇs´ıch seznam˚ u poloˇzek, jako je jiˇz zm´ınˇen´ y ListView na obrázku 11., je nutné si napsat vlastn´ı Adapter. Toto budu bl´ıˇze popisovat v následuj´ıc´ı kapitole Adapter. Pˇr´ıklad jednoduchého ListActivity: import import import import

android.app.Activity; android.os.Bundle; android.widget.ArrayAdapter; android.widget.ListView;

public class VyberFakultuActivity extends ListActivity { ArrayList<String> facultiesList = new ArrayList<String>(); public void onCreate(Bundle icicle) { super.onCreate(icicle); ... //naplnˇ en´ ı seznamu facultiesList this.setListAdapter(new ArrayAdapter<String> (this,android.R.layout.simple_list_item_1, facultiesList.toArray(new String[0]))); } . . } Tento jednoduch´ y seznam poloˇzek dokonce ani nevyˇzaduje pˇr´ısluˇsn´ y XML soubor s layoutem narozd´ıl od sloˇzitˇejˇs´ıch seznam˚ u, kde je nutné kromˇe naprogramován´ı Adapter u jeˇstˇe vytvoˇrit 2 soubory s XML layoutem: jedné skupiny poloˇzek v seznamu (jeden ”ˇrádek”seznamu) a pak celkov´ y layout seznamu. 4.3.5.

Adapter

Adapter se pouˇz´ıvá pˇri tvorbˇe komplexn´ıch ListView seznam˚ u a jeho rol´ı je, ˇze ”sed´ı”mezi naˇsim zdrojem dat a naˇs´ı obrazovkou. Pˇr´ıkladem takového seznamu je napˇr´ıklad seznam zkouˇskov´ ych term´ın˚ u na obrázku 11., kterou pouˇziji jako demonstraˇcn´ı. Schematicky je role adaptéru znároznˇena na obrázku 12. Ve své Activity ExamList v metodˇe onCreate definujeme pomoc´ı setContentView pˇr´ısluˇsn´ y XML layout (exam list - leˇz´ıc´ı v adresáˇri /res/layout). Jeho kód je jednoduch´ y a obsahuje pouze jeden objekt a t´ım je právˇe ListView. Kód souboru exam list.xml: 26

Obrázek 12. Blokové schéma Adapteru Zmiˇ novan´ y objekt ListView je v XML souboru pojmenován parametrem android:id názvem examListView, které mus´ıme v metodˇe onCreate taktéˇz definovat, aby bylo moˇzné nastavit adaptér. Tato definice je vidˇet na následuj´ıc´ım kódu v druhém ˇra´dku (tento kód je um´ıstˇen v onCreate metodˇe naˇs´ı Activity). setContentView(R.layout.exam_list); final ListView lv = (ListView) findViewById(R.id.examListView); lv.setAdapter(new ExamListBaseAdapter(ExamList.this, itemsList)); Tˇret´ım ˇrádkem nastavujeme naˇsemu zobrazen´ı examListView, definovaném v souboru exam list.xml, sv˚ uj adaptér s názvem ExamListBaseAdapter. Argumenty naˇseho adaptéru jsou ExamList.this (název naˇs´ı Activity) a ArrayList zkouˇskov´ ych term´ın˚ u - itemsList. Jeˇstˇe neˇz se pod´ıváme na kód naˇseho adaptéru (ExamListBaseAdapter ), ukáˇzi XML kód layout souboru exam list row.xml, kter´ y definuje, jak má vypadat ˇra´dek naˇseho seznamu. Kód souboru exam list row.xml, leˇz´ıc´ıho adresáˇri /res/layout:
android:layout_height="match_parent" android:padding="5dp" >
android:layout_below="@+id/location" android:layout_marginTop="5dp" android:background="@color/white" android:textColor="@android:color/black" /> Kompletn´ı zdrojov´ y kód vlastn´ıho adaptéru najdete v pˇr´ıloze A.. V definici tˇr´ıdy adaptéru, která je potomkem tˇr´ıdy BaseAdapter, je definováno spojen´ı s vlastn´ım zdrojem dat - ArrayList objekt˚ u Exam, kter´ y jsem pojmenoval examArrayList. Následuj´ı metody potˇrebné pro správnou funkci adaptéru, pak metoda getView staraj´ıc´ı se o provázán´ı datové poloˇzky s vizuáln´ım prvkem v souboru exam list row.xml - toto má za u ´kol tento pˇr´ıkaz: convertView = mInflater.inflate(R.layout.exam_list_row, null); Ned´ılnou souˇca´st´ı adaptéru je statická tˇr´ıda ViewHolder, pˇres kterou k tomuto propojen´ı docház´ı.

4.4. 4.4.1.

Dalˇ s´ı prvky pouˇ zit´ e v projektu Menu

Menu se otv´ırá stiskem hardwarového tlaˇc´ıtka Menu na mobiln´ım zaˇr´ızen´ı. V systému Android je naz´ yvano jako Menu voleb nebo také Option menu a jedná se o nab´ıdku vyj´ıˇzdˇej´ıc´ı ze spodu obrazovky tak, jak je zobrazeno na obrázku 13.. Menu m˚ uˇze m´ıt 1 aˇz 6 poloˇzek, která jsou pˇr´ımo viditelná. V pˇr´ıpadˇe, ˇze menu obsahuje v´ıce neˇz 6 poloˇzek, pak se v menu objev´ı nová volba Dalˇs´ı, která zpˇr´ıstupn´ı zb´ yvaj´ıc´ı poloˇzky. Nejjednoduˇsˇs´ı zp˚ usob jak vytvoˇrit takovéto menu je pomoc´ı XML layoutu, kter´ y se vytváˇr´ı v adresáˇri /res/menu, a pˇr´ısluˇsného kódu ve vaˇs´ı Activity. Do své Activity vloˇz´ıte novou metodu onCreateOptionsMenu, kde definujete název XML layoutu (main menu), kter´ y chcete pouˇz´ıt jako menu. Pˇr´ısluˇsn´ y kód vypadá následovnˇe: @Override public boolean onCreateOptionsMenu(Menu menu) { MenuInflater inflater = getMenuInflater(); inflater.inflate(R.menu.main_menu, menu); return true; } Pro u ´plnost jeˇstˇe potˇrebn´ y kód XML layoutu v souboru main menu.xml:

29

Obrázek 13. Menu voleb (ˇcervenˇe vyznaˇceno) <menu xmlns:android="http://schemas.android.com/apk/res/android" > K v´ yˇse uvedenému XML layoutu menu bych jeˇstˇe doplnil, ˇze parametrem android:icon definujeme ikonu, která je v tomto pˇr´ıpadˇe systémová, ale m˚ uˇzeme pouˇz´ıt i svou vlastn´ı nebo menu udˇelat pouze textové vynechán´ım parametru. Menu m˚ uˇzeme udˇelat i jen ˇcistˇe obrázkové, vynechán´ım parametru android:title Aby bylo menu funkˇcn´ı (”klikatelné”) je nutné ve vaˇs´ı Activity vytvoˇrit obsluˇznou metodu onOptionsItemSelected. Napˇr´ıklad takto: @Override 30

public boolean onOptionsItemSelected(MenuItem item) { switch (item.getItemId()) { case R.id.options: SharedPreferences prefs = PreferenceManager.getDefaultSharedPreferences(this); global.stagservices = prefs.getString(KEY_UNIVERSITY, ""); global.faculty = prefs.getString(KEY_FACULTY, ""); global.department = prefs.getString(KEY_DEPARTMENT, ""); startActivity(new Intent(this, EditPreferences.class)); return true; case R.id.exit: finish(); return true; case R.id.help: startActivity(new Intent(this, Help.class)); return true; case R.id.info: ... return true; default: return super.onOptionsItemSelected(item); } } Toto samozˇrejmˇe nen´ı jedin´ y moˇzn´ y zp˚ usob jak vytvoˇrit menu, ale je podle mého názoru nejpˇrehlednˇejˇs´ı. Podrobnˇeji se porovnán´ı dvou r˚ uzn´ ych pˇr´ıstup˚ u k programovan´ı GUI vˇenuji v kapitole 4.2. 4.4.2.

GridView

GridView umoˇzn ˇuje dvou-dimenzionáln´ı zobrazen´ı poloˇzek v rolovatelné mˇr´ıˇzce. Poloˇzky mˇr´ıˇzky jsou naˇc´ıtány opˇet prostˇrednictv´ım adaptéru, kter´ y je ale mnohem jednoduˇsˇs´ı, neˇz tomu bylo u ListView 4.3.4. GridView je nav´ıc tak flexibiln´ı, ˇze umoˇzn ˇuje i automatické pˇrepoˇc´ıtán´ı sloupc˚ u a ˇra´dk˚ u tak, aby pˇri pˇreklopen´ı mobiln´ıho zaˇr´ızen´ı na ˇs´ıˇrku nezobrazoval poˇra´d stejnou mˇriˇzku, ale efektivnˇeji vyuˇzil celou plochu obrazovky. Toto chován´ı se definuje v XML layoutu a jedná se o parametr android:numColumns="auto fit". Vaˇse Activity by mohla vypadat napˇr´ıklad takto: public class HlavniMenuActivity extends Activity implements AdapterView.OnItemClickListener { String[] items={"Akademick´ y kalend´ aˇ r", "O katedˇ re", "Pˇ redmˇ ety katedry", "Uˇ citel´ e katedry", "Vyhled´ av´ an´ ı student˚ u", "Vyhled´ av´ an´ ı uˇ citel˚ u", "Moje zk. term´ ıny", "M˚ uj rozvrh", "Moje pˇ redmˇ ety", "O mnˇ e", 31

Obrázek 14. Ukázka dvou-dimezionáln´ıho zobrazen´ı mˇr´ıˇzkou - GridView "Rozvrh uˇ citele", "Pˇ redmˇ ety uˇ citele"}; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main_grid); GridView g=(GridView) findViewById(R.id.grid); g.setAdapter(new GridViewAdapter(this, android.R.layout.simple_list_item_1, items)); g.setOnItemClickListener(this); } } Vˇsimnˇete si v definici tˇr´ıdy vaˇs´ı Activity je implements AdapterView.OnItemClickListener, které u jin´ ych Activity neb´ yvá. Toto nám umoˇzn ˇuje zapracovat obsluhu události onItemClick a zmiˇ novaného adaptéru pˇr´ımo do tˇela Activity. V tˇele metody onCreate nastav´ıme metodou setContentView název naˇseho layoutu main grid.xml (um´ıstˇeného v adresáˇri res/layout), jehoˇz jednoduch´ y kód je následuj´ıc´ı:
android:horizontalSpacing="10dp"> Dále v tˇele Activity definujeme GridView a propoj´ıme s názvem grid, abysme mohli nastavit adaptér. Nastaven´ı adaptéru (GridViewAdapter ) s tˇremi argumenty, kde definujeme tˇret´ı - items - pole s ˇretˇezci, které chceme pomoc´ı GridView zobrazit. Tento adaptér mus´ıme doprogramovat a vloˇzit ho do tˇela naˇs´ı Activity. Adaptér je, ve srovnán´ı s vlastn´ımi adaptéry pro ListView, jednoduˇsˇs´ı a m˚ uˇze vypadat takto: private class GridViewAdapter extends ArrayAdapter { Context ctxt; GridViewAdapter(Context ctxt, int resource,String[] items) { super(ctxt, resource, items); this.ctxt=ctxt; } public View getView(int position, View convertView,ViewGroup parent) { TextView label=(TextView)convertView; if (convertView==null) { convertView=new TextView(ctxt); label=(TextView)convertView; } label.setText(items[position]); label.setTextSize(20); label.setGravity(Gravity.CENTER_HORIZONTAL); //set color for students if (position < 10) label.setTextColor(getResources().getColor(R.color.upolYellow)); return(convertView); } } Nakonec jeˇstˇe mus´ıme obslouˇzit událost onItemClick, aby byly poloˇzky GridView aktivn´ı a mohly napˇr´ıklad spouˇstˇet dalˇs´ı Activity. Tato obsluha nen´ı sloˇzitá a vypadá takto: public void onItemClick(AdapterView parent, View v,int position, long id) { switch (position) { case 0: //akademicky kalendar i = new Intent(HlavniMenuActivity.this, AcademicYear.class); i.putExtra("requestCode", 0); startActivityForResult(i,0); break; 33

case 1: ... } V tomto pˇr´ıpadˇe se po stisku prvn´ı poloˇzky zobrazen´ı GridView (Akademický kalendáˇr ) spust´ı dalˇs´ı Activity s názvem AcademicYear. Indexy jsou poˇc´ıtány z levého horn´ıho rohu mˇr´ıˇzky do prava po ˇra´dc´ıch (plynou jako bˇeˇzn´ y text). 4.4.3.

WebView

Obrázek 15. Ukázka prvku WebView WebView je zobrazen´ı, které vyuˇz´ıvá intern´ı webov´ y prohl´ıˇzeˇc - renderovac´ı engine WebKit. Engine obsahuje metody pro navigaci vpˇred a vzad v historii, zvˇetˇsován´ı nebo zmenˇsován´ı a dalˇs´ı. WebKit vyˇzaduje pˇridán´ı oprávnˇen´ı INTERNET do souboru AndroidManifest.xml, ˇcehoˇz dosáhneme vloˇzen´ım tohoto elementu: <uses-permission android:name="android.permission.INTERNET" /> Ve své aplikaci WebView vyuˇz´ıvám k zobrazen´ı uˇzivatelské pˇr´ıruˇcky - nápovˇedy (viz obrázek 15.), která je celá vytvoˇrená v HTML a uloˇzená v adresáˇri /res/raw. Pro správnou funkci WebView je opˇet nutn´ y XML layout a programov´ y kód ve vaˇs´ı Activity. Kód Activity Help (obsahuje i metodu readTextFromResource, která zpracovává HTML kód): @Override 34

public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.help); WebView webview = (WebView) findViewById(R.id.webview_help); webview.loadDataWithBaseURL("file:///android_asset/", readTextFromResource(R.raw.help), "text/html", "utf-8", ""); } private String readTextFromResource(int resourceID) { InputStream raw = getResources().openRawResource(resourceID); ByteArrayOutputStream stream = new ByteArrayOutputStream(); int i; try { i = raw.read(); while (i != -1) { stream.write(i); i = raw.read(); } raw.close(); } catch (IOException e) { ... } return stream.toString(); } Jak vid´ıme v definici promˇenné webview, máme zde definováno propojen´ı s elementem Webview jmenuj´ıc´ıho se webview help, kter´ y je um´ıstˇen v XML layoutu s názvem help (jak vid´ıme v definici metody setContentView). XML layout souboru help.xml je tento: <WebView android:id="@+id/webview_help" android:layout_width="fill_parent" android:layout_height="fill_parent"> Tyto definice staˇc´ı na to, aby bylo zobrazen´ı WebView funkˇcn´ı - naˇc´ıtalo soubor help.html z adresáˇre /res/raw a zobrazilo jej. 35

4.4.4.

Preferences

Preferences jsou ve spojen´ı s Shared Preferences jednou z moˇznost´ı jak ukládat data v Androidu. Preferences jsou pro kaˇzdou Activity zvláˇst’, zat´ımco Shared Preferences jsou dostupné pro celou aplikaci. Nejv´ıce se pouˇz´ıvaj´ı jako prostˇredek k nastaven´ı chován´ı programované aplikace a ukládán´ı uˇzivatelsk´ ych nastaven´ı. Pokud bysme si chtˇeli uˇzivatelskou obrazovku s nastaven´ımi (obrázek 16.) vytvoˇrit, mus´ıme si pro to zaloˇzit novou Activity. Tato vaˇse nová Activity ovˇsem nebude potomkem Activity, ale PreferenceActivity. Nav´ıc m˚ uˇzeme jeˇstˇe pˇridat implements OnSharedPreferenceChangeListener, pokud chceme, aby se zadané hodnoty nejenom zapsaly do Shared Preferences, ale i aktualizovalo zobrazen´ı na obrazovce (pokud napˇr´ıklad máme hodnoty uvedené v druhém ˇrádku konkrétn´ıho nastaven´ı) - k tomu je ale potˇrebné si doprogramovat obsluhu. V tomto pˇrikladu se, v rámci zjednoduˇsen´ı, bez této vymoˇzenosti obejdeme. Kód

Obrázek 16. Ukázka Preferences Activity EdiPreferences: import android.os.Bundle; import android.preference.Preference; import android.preference.PreferenceActivity public class EditPreferences extends PreferenceActivity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); addPreferencesFromResource(R.xml.preferences); ... 36

} Tento kód ve spojen´ı s XML layoutem v pˇr´ıloze B. vygeneruje uˇzivatelská nasyhodou taven´ı podle XML souboru, a v´ ysledkem je obrazovka na obrázku 16. V´ Shared Preferences je jednoduchá implementace a dostupnost vˇsech uloˇzen´ ych prostˇredk˚ u napˇr´ıˇc celou aplikac´ı a to i po vypnut´ı a opˇetovném spuˇstˇen´ı aplikace. Je to dáno t´ım, ˇze se jednotlivá nastaven´ı ukládaj´ı do intern´ıho u ´loˇziˇstˇe v podobˇe XML souboru obsahuj´ıc´ıho vˇsechna naˇse nastaven´ı.

4.5.

Zpracov´ an´ı dat z IS/STAG

Protoˇze veˇskeré zprávy z IS/STAG jsou ve formátu XML, viz kód v kapitole 2.3., je nutné jej zpracovat a uloˇzit data do takové formy s kterou m˚ uˇzeme v programovém kódu aplikace (Activity) pracovat. Extrakci dat z XML pˇredvedu na jednoduchém XML s následuj´ıc´ımi daty harmonogramu akademického roku: <ns1:getHarmonogramRokuResponse> 10.9.2011 <popis>Zaˇ c´ atek ak. roku 10.9.2011 <popis>Zac´ ın´ a: Letn´ ı zkouˇ skov´ e obdob´ ı Zpracováván´ı a stahován´ı dat z IS/STAG ˇreˇs´ım privátn´ı metodou DownloadXML. Se zpracováván´ım XML mˇe pomohl ˇclánek Connecting to the Web: I/O Programming in Android [7], ˇreˇs´ıc´ı zpracováván´ı RSS kód˚ u. V následuj´ıc´ım kódu je stahován´ı XML zajiˇstˇeno metodou OpenHttpConnection, která vrac´ı InputStream. Tento je následnˇe zpracováván a jsou k tomu vyuˇz´ıvány podtˇr´ıdy javax.xml.parsers - konkrétnˇe DocumentBuilder, DocumentBuilderFactory a ParserConfigurationException. Definujeme si základn´ı element (harmonogramItem) a pak procház´ıme XML a hledáme vˇzdy dalˇs´ı element harmonogramItem a v cyklu for naˇc´ıtáme obˇe datové poloˇzky a ukládáme si je pomoc´ı objektu sr. V´ ypis metody DownloadXML s komentáˇrem v tˇele: private ArrayList DownloadXML(String URL) { InputStream in = null; ArrayList items = new ArrayList(); 37

try { in = global.OpenHttpConnection(URL,this); Document doc = null; DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance(); DocumentBuilder db; try { db = dbf.newDocumentBuilder(); doc = db.parse(in); } catch (Exception e) { ... } doc.getDocumentElement().normalize(); //tady se definuje nadˇ razen´ y element NodeList itemNodes = doc.getElementsByTagName("harmonogramItem"); TwoRowListItem sr; for (int i = 0; i < itemNodes.getLength(); i++) { Node itemNode = itemNodes.item(i); if (itemNode.getNodeType() == Node.ELEMENT_NODE) { sr = new TwoRowListItem(); Element itemElement = (Element) itemNode; //extrakce popisu z elementu harmonogramItem a uloˇ zen´ ı do objektu sr NodeList nameNodes = (itemElement).getElementsByTagName("popis"); Element nameElement = (Element) nameNodes.item(0); NodeList txtNodes = ((Node) nameElement).getChildNodes(); sr.setTxtBig(((Node) txtNodes.item(0)).getNodeValue()); //extrakce datumu z elementu harmonogramItem a uloˇ zen´ ı do objektu sr NodeList nameAbrNodes = (itemElement).getElementsByTagName("datumOd"); Element nameAbrElement = (Element) nameAbrNodes.item(0); NodeList txtNameAbrNodes = ((Node) nameAbrElement).getChildNodes(); sr.setTxtSmall(((Node) txtNameAbrNodes.item(0)).getNodeValue()); items.add(sr); } } } catch (IOException e1) { ... } return items; } Metoda DownloadXML vrac´ı ArrayList, kter´ y definuji jako argument svému adaptéru, jenˇz ho pak patˇriˇcnˇe zobraz´ı. 38

Z´ avˇ er Tvorba aplikac´ı pro operaˇcn´ı systém Android nen´ı na prvn´ı pohled jednoduchá, protoˇze v´ yvojáˇr mus´ı m´ıt hned na zaˇcátku pomˇernˇe dost znalost´ı - nav´ıc r˚ uzného druhu. Nicménˇe pokud pˇrekonáte tyto poˇcáteˇcn´ı nároky, otevˇre se vám najednou netuˇsené spektrum moˇznost´ı k vyuˇzit´ı nabit´ ych znalost´ı. Co se t´ yká aplikace Klient Stagu pro Android, kterou jsem pˇredvádˇel sv´ ym spoluˇzák˚ um a z jejich reakc´ı mohu ˇr´ıct, ˇze si uˇzivatele jistˇe najde. Uˇzivatel˚ um, stejnˇe jako mˇe, pˇriˇsly nejzaj´ımavˇejˇs´ı funkce Moje zkouˇskové term´ıny, M˚ uj rozvrh a moˇznost napsat email pˇrimo z mobiln´ıho zaˇr´ızen´ı konkrétn´ımu uˇciteli bez znalosti jeho emailové adresy.

39

Conclusions Creating applications for operating system Android is not that easy as seems to be, because developer has to have wide range of knowledge in different kinds. However if you pass initial demands, it would open to you unexpected posibilities to use knowledge in Android development. Application Stag client for Android I showed my schoolmates and I can say that it would definitely have its users. Users like the most My exam terms, My schedule and ability to send an e-mail to a teacher directly from mobile device, without exact e-mail address knowledge.

40

Reference [1] Mark L. Murphy. Android 2 – Pr˚ uvodce programov´ an´ım mobiln´ıch aplikac´ı. Computer Press, Brno, 2011. [2] Sharon Zakhour. Java - Výukový kurz. Computer Press, Brno, 2007. [3] Tomáˇs Kypta. Vyv´ıj´ıme pro Android, Seri´ al Vyv´ıj´ıme pro Android na serveru Svˇet Androida [4] Google. Android Developers [5] Dokumentace webov´ ych sluˇzeb Univerzity Palackého v Olomouci. Webové sluˇzby nad IS/STAG Univerzity Palackého v Olomouci [6] Dokumentace webov´ ych sluˇzeb Západoˇceské univerzity v Plzni. Webové sluˇzby nad IS/STAG Západoˇceské univerzity v Plzni [7] Wei-Meng Lee. Connecting to the Web: I/O Programming in Android . ˇ anek na Internetu, 2010. Cl´ [8] Wikipedia. The Free Encyklopedia

41

A.

Zdrojov´ y k´ od ExamListBaseAdapter.java

package biz.pesek.klientstagu; import java.util.ArrayList; public class ExamListBaseAdapter extends BaseAdapter { private static ArrayList<Exam> examArrayList; private LayoutInflater mInflater; public ExamListBaseAdapter(Context context, ArrayList<Exam> results) { examArrayList = results; mInflater = LayoutInflater.from(context); } public int getCount() { return examArrayList.size(); } public Object getItem(int position) { return examArrayList.get(position); } public long getItemId(int position) { return position; } public View getView(int position, View convertView, ViewGroup parent) { ViewHolder holder; if (convertView == null) { convertView = mInflater.inflate(R.layout.exam_list_row, null); holder = new ViewHolder(); holder.tvPredmet = (TextView) convertView.findViewById(R.id.name); holder.tvJmeno = (TextView) convertView.findViewById(R.id.examiner); holder.tvDatum = (TextView) convertView.findViewById(R.id.date); holder.tvCasOd = (TextView) convertView.findViewById(R.id.time); holder.tvBudova = (TextView) convertView.findViewById(R.id.location); holder.tvPoznamka = (TextView) convertView.findViewById(R.id.note); convertView.setTag(holder); } else { holder = (ViewHolder) convertView.getTag(); } holder.tvPredmet.setText(examArrayList.get(position).getPredmet()); holder.tvJmeno.setText(examArrayList.get(position).getJmeno() 42

+" "+examArrayList.get(position).getPrijmeni()); holder.tvDatum.setText(examArrayList.get(position).getDatum()); holder.tvCasOd.setText(examArrayList.get(position).getCasOd()); holder.tvBudova.setText(examArrayList.get(position).getBudova() +"-"+examArrayList.get(position).getMistnost()); if (examArrayList.get(position).getPoznamka().equals("")) holder.tvPoznamka.setVisibility(View.GONE); else { holder.tvPoznamka.setVisibility(View.VISIBLE); holder.tvPoznamka.setText(examArrayList.get(position).getPoznamka()); } return convertView; } static class ViewHolder { TextView tvPredmet; TextView tvJmeno; TextView tvPrijmeni; TextView tvTitulPred; TextView tvTitulZa; TextView tvDatum; TextView tvBudova; TextView tvMistnost; TextView tvCasOd; TextView tvPoznamka; } }

43

B.

Zdrojov´ y XML k´ od preferences.xml

<EditTextPreference android:dialogTitle="@string/enter_personal_id" android:key="personal_id" android:summary="@string/enter_personal_id" android:title="@string/personal_id" /> <EditTextPreference android:dialogTitle="@string/enter_teacher_id" android:key="ucitIdno" android:summary="@string/enter_teacher_id" android:title="@string/teachers_id" />

44

C.

Obsah pˇ riloˇ zen´ eho CD

V samotném závˇeru práce je uveden struˇcn´ y popis obsahu pˇriloˇzeného CD/DVD, tj. závazné adresáˇrové struktury, d˚ uleˇzit´ ych soubor˚ u apod. bin/ Instalaˇcn´ı bal´ıˇcek KlientStagu.apk vytvoˇrené aplikace pro operaˇcn´ı systém Android. doc/ Dokumentace práce ve formátu PDF, vytvoˇrená dle závazného stylu KI PˇrF pro diplomové práce, vˇcetnˇe vˇsech pˇr´ıloh, a vˇsechny soubory nutné pro bezproblémové vygenerován´ı PDF souboru dokumentace (v ZIP archivu), tj. zdrojov´ y text dokumentace, vloˇzené obrázky, apod. src/ Kompletn´ı zdrojové texty programu KlientStagu pro Android se vˇsemi potˇrebn´ ymi (pˇrevzat´ ymi) zdrojov´ ymi texty, knihovnami a dalˇs´ımi soubory pro bezproblémové vytvoˇren´ı spustiteln´ ych verz´ı programu. readme.txt Instrukce pro instalaci a spuˇstˇen´ı programu KlientStagu pro Android, vˇcetnˇe poˇzadavk˚ u pro jeho provoz. U veˇsker´ ych odjinud pˇrevzat´ ych materiál˚ u obsaˇzen´ ych na CD/DVD jejich zahrnut´ı dovoluj´ı podm´ınky pro jejich ˇs´ıˇren´ı nebo pˇriloˇzen´ y souhlas drˇzitele copyrightu. Pro materiály, u kter´ ych toto nen´ı splnˇeno, je uveden jejich zdroj (webová adresa) v textu dokumentace práce nebo v souboru readme.txt.

45

Klient Stagu pro Android

Recommend Documents