Západočeská univerzita v Plzni Fakulta aplikovaných věd Katedra informatiky a výpočetní techniky. Mobilní klient pro systém

Za´padoˇceska´ univerzita v Plzni Fakulta aplikovanyćh vˇed Katedra informatiky a vy´poˇcetn´ı techniky

Bakal´ aˇ rsk´ a pr´ ace Mobiln´ı klient pro syst´ em publikov´ an´ı gamebook˚ u

Plzeˇ n 2015

Pavel Pˇribán ˇ

Prohl´ aˇ sen´ı Prohlaˇsuji, ˇze jsem bakaláˇrskou práci vypracoval samostatnˇe a v´ yhradnˇe s pouˇzit´ım citovan´ ych pramen˚ u. V Plzni dne 4. kvˇetna 2015 Pavel Pˇribán ˇ

Podˇ ekov´ an´ı Rád bych podˇekoval Ing. Ladislavu Peˇsiˇckovi za vstˇr´ıcnost, trpˇelivost, odborné rady a cenné pˇripom´ınky, které mi pomohly tuto bakaláˇrskou práci vypracovat.

Abstract The purpose of this bachelor thesis is to create mobile client (application) for the Android platform, which can read gamebooks that are created in the system which is being developed. Gamebook is a book that allows reader to make decisions and partly influence the story of the book. In the first part of this work there is a comparison of applications that can read gamebooks. The second part describes the system for creating and publishing gamebooks which is being developed. Mobile client is part of this system. The last part contains design of the client and description of implementation including verification of functionality.

Abstrakt C´ılem této bakaláˇrské práce je vytvoˇrit mobiln´ıho klienta (aplikaci) pro platformu Android, kter´ y umoˇzn ˇuje procházet gamebooky vytvoˇrené ve vyv´ıjeném systému. Gamebook je kniha, ve které se ˇctenáˇr rozhoduje jak se bude pˇr´ıbˇeh vyv´ıjet. V prvn´ı ˇcásti práce jsou porovnány nˇekteré dostupné aplikace, které umoˇzn ˇuj´ı procházen´ı gamebook˚ u. Druhá ˇcást práce popisuje vyv´ıjen´ y systém, ve kterém je moˇzné gamebooky vytváˇret a publikovat. Souˇca´st´ı tohoto systému je i mobiln´ı klient. Posledn´ı ˇcást obsahuje návrh klienta a popis implementace vˇcetnˇe ovˇeˇren´ı jeho funkcionality.

Obsah ´ 1 Uvod 1.1 C´ıle práce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Existuj´ıc´ı aplikace 2.1 Charakteristika gamebooku . . . . . . . 2.2 Vybrané mobiln´ı aplikace . . . . . . . . . 2.2.1 Aplikace The Forging of a Legend 2.2.2 Aplikace Choice of Broadsides . . 2.2.3 Aplikace Lone Wolf Saga . . . . . 2.3 Srovnán´ı testovan´ ych aplikac´ı . . . . . . 3 Syst´ em pro publikov´ an´ı gamebook˚ u 3.1 Program pro tvorbu gamebooku . . 3.2 Server . . . . . . . . . . . . . . . . 3.2.1 Sluˇzby pro editor . . . . . . 3.2.2 Uˇzivatelské sluˇzby . . . . . 3.2.3 Sluˇzby pro mobiln´ıho klienta 3.3 Mobiln´ı klient . . . . . . . . . . . . 3.4 Reprezentace gamebooku . . . . . . 3.4.1 Struktura XML souboru . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

1 1

. . . . . .

2 2 3 3 5 7 10

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

. . . . . . . .

12 13 13 13 14 14 14 16 16

4 N´ avrh mobiln´ıho klienta 4.1 Návrh s´ıt’ové komunikace . . . . . . . . . 4.1.1 Moˇznosti s´ıt’ové komunikace . . . 4.1.2 Dostupné knihovny . . . . . . . . 4.1.3 Vybrané ˇreˇsen´ı s´ıt’ové komunikace 4.2 Zp˚ usob uloˇzen´ı dat . . . . . . . . . . . . 4.2.1 Sd´ılené preference . . . . . . . . . 4.2.2 Ukládán´ı soubor˚ u . . . . . . . . . 4.2.3 Databáze SQLite . . . . . . . . . 4.2.4 Zvolen´ y zp˚ usob pro uloˇzen´ı dat . 4.3 Návrh UI . . . . . . . . . . . . . . . . . 4.3.1 Aktivita MenuActivity . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

18 19 19 20 22 22 22 24 25 25 26 28

. . . . . . . .

. . . . . . . .

OBSAH

OBSAH 4.3.2 4.3.3 4.3.4 4.3.5

Aktivita GameActivity . . . Aktivita LibraryActivity . . Ostatn´ı aktivity . . . . . . . Pˇr´ıprava grafick´ ych soubor˚ u

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

. . . .

28 28 29 30

5 Realizace mobiln´ıho klienta 5.1 Struktura aplikace . . . . . . . . . . . . . . . . 5.1.1 Soubor AndroidManifest.xml . . . . . . . 5.2 Pouˇzité knihovny . . . . . . . . . . . . . . . . . 5.2.1 Knihovna logback-android . . . . . . . . 5.2.2 Knihovna ActionBarSherlock . . . . . . 5.2.3 Knihovna Nine Old Androids . . . . . . 5.2.4 Knihovna ViewPagerIndicator . . . . . . 5.2.5 Knihovna SlidingMenu . . . . . . . . . . 5.3 Implementace SQLite databáze . . . . . . . . . 5.3.1 Vytvoˇren´ı databáze . . . . . . . . . . . . 5.3.2 Pˇr´ıstup k dat˚ um . . . . . . . . . . . . . 5.4 Uˇzivatelské funkce . . . . . . . . . . . . . . . . 5.4.1 Import gamebook˚ u . . . . . . . . . . . . 5.4.2 Procházen´ı gamebooku . . . . . . . . . . 5.4.3 Knihovna . . . . . . . . . . . . . . . . . 5.5 S´ıt’ová komunikace . . . . . . . . . . . . . . . . 5.5.1 Implementace knihovny Volley . . . . . . 5.5.2 Z´ıskán´ı seznamu dostupn´ ych gamebook˚ u 5.5.3 Staˇzen´ı gamebooku . . . . . . . . . . . . 5.5.4 Hodnocen´ı gamebooku . . . . . . . . . . 5.6 Nastaven´ı aplikace . . . . . . . . . . . . . . . .

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

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

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

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

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

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

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

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

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

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

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

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

31 31 31 32 32 33 33 33 33 34 35 35 35 36 36 38 38 38 38 39 40 40

. . . . .

42 42 43 43 44 44

6 Testov´ an´ı 6.1 Pr˚ ubˇeh testován´ı . . . . . . . . . . 6.2 Testován´ı nestandardn´ıch událost´ı . 6.3 V´ ysledky testován´ı . . . . . . . . . 6.3.1 Nestandardn´ı události . . . 6.4 Moˇzná rozˇs´ıˇren´ı . . . . . . . . . . .

. . . .

. . . . .

. . . .

. . . . .

. . . .

. . . . .

. . . .

. . . . .

. . . .

. . . . .

. . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

7 Z´ avˇ er

45

Seznam pouˇ zit´ ych zkratek a v´ yraz˚ u

46

Literatura

48

Seznam pˇ r´ıloh

50

OBSAH A Uˇ zivatelsk´ a pˇ r´ıruˇ cka A.1 Poˇzadavky aplikace . . . . . . A.2 Instalace . . . . . . . . . . . . A.3 Ovládán´ı aplikace . . . . . . . A.3.1 Procházen´ı gamebooku A.3.2 Knihovna . . . . . . . A.3.3 Nastaven´ı aplikace . .

OBSAH

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

51 51 51 51 53 54 56

B Obsah CD

60

C Pouˇ zit´ e knihovny

61

´ 1 Uvod V dneˇsn´ı dobˇe vlastn´ı témˇeˇr kaˇzd´ y tzv. chytr´ y“ telefon, kter´ y kromˇe telefonován´ı ” a psan´ı zpráv poskytuje mnoho jin´ ych funkc´ı. V´ yrobci a programátoˇri se snaˇz´ı mnoho ˇcinnost´ı, u ´kon˚ u a nástroj˚ u bˇeˇzného ˇzivota pˇretransformovat do mobiln´ıch aplikac´ı tak, aby tyto funkce a nástroje byly kdekoliv a kdykoliv snadno pˇr´ıstupné pomoc´ı mobiln´ıho zaˇr´ızen´ı, napˇr. mapy, digitáln´ı fotoaparát, bud´ık, rádio a mnohé dalˇs´ı. Jinak tomu nen´ı ani u gamebook˚ u. Gamebook je kniha, ve které se ˇctenáˇr rozhoduje, jak se bude pˇr´ıbˇeh dále vyv´ıjet a do jisté m´ıry si tak pˇr´ıbˇeh knihy urˇcuje sám. Po pˇreˇcten´ı urˇcité ˇca´sti textu jsou hráˇci nab´ıdnuty moˇznosti, pro které se m˚ uˇze rozhodnout. V´ ybˇerem jedné z tˇechto moˇznost´ı je hráˇc odkázán na jinou ˇca´st textu, která na rozhodnut´ı navazuje. T´ımto stylem je vytvoˇrena celá kniha. Nˇekterá rozhodnut´ı mohou záviset také na náhodˇe, napˇr. hráˇc mus´ı hodit kostkou a podle v´ ysledku je odkázán dále. Spolu s dalˇs´ımi hern´ımi prvky, napˇr. souboji hlavn´ı postavy, je gamebook moˇzné oznaˇcit za textovou hru.

1.1

C´ıle pr´ ace

Jedn´ım z c´ıl˚ u této práce je prozkoumat vybrané mobiln´ı aplikace, které umoˇzn ˇuj´ı procházen´ı gamebook˚ u. Dalˇs´ım c´ılem této práce je popsat vyv´ıjen´ y systém, kter´ y umoˇzn ˇuje gamebooky vytváˇret a publikovat (ˇc´ıst, hrát). Smyslem popisu systému je vysvˇetlit jeho základn´ı principy fungován´ı. Souˇcást´ı vyv´ıjeného systému bude mobiln´ı klient (mobiln´ı aplikace), kter´ y umoˇzn ˇuje gamebooky vytvoˇrené pomoc´ı tohoto systému procházet. Návrh a implementace mobiln´ıho klienta je hlavn´ım c´ılem této práce. Po popisu vyv´ıjeného systému bude vybrána vhodná funkcionalita, kterou by mobiln´ı klient mˇel obsahovat. Následnˇe bude popsán návrh této funkcionality pro platformu Android. V posledn´ı ˇca´sti práce bude ukázána a vysvˇetlena implementace mobiln´ıho klienta spolu s popisem ovˇeˇren´ı jeho funkcionality. Po pˇreˇcten´ı této práce by mˇel ˇctenáˇr pochopit, jak´ ym zp˚ usobem vyv´ıjen´ y systém bude fungovat a jaké jsou jeho souˇcásti. Dále by se mˇel dozvˇedˇet jakou funkcionalitu mobiln´ı klient obsahuje a jak je tato funkcionalita navrˇzena. Z popisu implementace by mˇel b´ yt pochopen princip, jak´ ym je mobiln´ı klient (aplikace) implementován na platformˇe Android.

1

2 Existuj´ıc´ı aplikace D˚ uvodem k prozkoumán´ı vybran´ ych mobiln´ıch aplikac´ı (umoˇzn ˇuj´ıc´ıch procházen´ı gamebooku) je z´ıskat obecn´ y pˇrehled o tˇechto aplikac´ıch (popˇr. systémech pro v´ yvoj nebo publikován´ı gamebooku), jejich funkˇcnostech a moˇznostech, které nab´ız´ı. Ze z´ıskan´ ych informac´ı je pak moˇzné se pˇri implementaci vlastn´ıho mobiln´ı klienta (popˇr. celého systému) inspirovat. Mobiln´ı klient vyv´ıjeného systému bude realizován na platformˇe Android, proto byl v´ ybˇer existuj´ıc´ıch aplikac´ı, které umoˇzn ˇuj´ı procházen´ı gamebook˚ u, zamˇeˇren v´ yhradnˇe na aplikace spustitelné na platformˇe Android.

2.1

Charakteristika gamebooku

Gamebook je kniha, která umoˇzn ˇuje ˇctenáˇri pˇri ˇcten´ı pˇr´ıbˇehu provádˇet rozhodnut´ı, která ovlivn´ı v´ yvoj pˇr´ıbˇehu knihy. Zpravidla je kniha ˇclenˇena do odstavc˚ u a kaˇzd´ y odstavec je oˇc´ıslován. Po pˇreˇcten´ı odstavce má ˇctenáˇr na v´ ybˇer nˇekolik moˇznost´ı, pro které se m˚ uˇze rozhodnout. Kaˇzdá moˇznost je oˇc´ıslována. Toto ˇc´ıslo oznaˇcuje ˇ aˇr najde dan´ odstavec, ve kterém pˇr´ıbˇeh pokraˇcuje pro danou volbu. Cten´ y odstavec a pokraˇcuje v ˇcetbˇe. Pˇr´ıbˇeh se t´ımto zp˚ usobem vˇetv´ı a vzniká orientovan´ y graf. Orientovan´ y graf [4] je koneˇcná mnoˇzina, jej´ıˇz prvky naz´ yváme vrcholy (uzly) grafu a hrany grafu. Hrany spojuj´ı jednotlivé vrcholy, kaˇzdá hrana má urˇcen´ y smˇer a mezi dvˇema vrcholy existuje v jednom smˇeru pouze jedna hrana. Protoˇze ˇctenáˇr vytváˇr´ı rozhodnut´ı a dˇej se vˇetv´ı, tak kniha m˚ uˇze m´ıt v´ıce alternativn´ıch konc˚ u. Pˇri rozhoˇ aˇr pˇri ˇcten´ı m˚ dován´ı m˚ uˇze b´ yt také pouˇzit náhodn´ y jev. Cten´ uˇze narazit na pokyn od autora, aby pro dalˇs´ı volbu hodil hrac´ı kostkou. Podle toho jaké ˇc´ıslo na kostce padne, pak ˇctenáˇr pozná, ve kterém odstavci má pokraˇcovat. Hrac´ı kostka m˚ uˇze b´ yt standardn´ı ˇsestistˇenná nebo v´ıcestˇenná, záleˇz´ı na autorovi. Vu ´vodu knihy je ˇctenáˇr seznámen se zápletkou, prostˇred´ım a hlavn´ı postavou. V nˇekter´ ych knihách je moˇzné vlastnosti postavy na zaˇcátku knihy upravit. Vlastnostmi jsou myˇsleny atributy, napˇr. zdrav´ı postavy, s´ıla, inteligence nebo schopnost, kterou postava ovládá. Pouˇz´ıvané vlastnosti nejsou jednoznaˇcnˇe urˇceny a v r˚ uzn´ ych knihách se mohou liˇsit. Vlastnosti mohou b´ yt upraveny náhodnˇe pomoc´ı hrac´ı kostky a hozené hodnoty budou postavˇe pˇriˇcteny k dané vlastnosti. Druhou moˇznost´ı je, ˇze hráˇc dostane koneˇcn´ y poˇcet bod˚ u, které m˚ uˇze mezi jednotlivé vlastnosti rozdˇelit. V pr˚ ubˇehu ˇcten´ı, se vlastnosti postavy mohou na základˇe dˇeje mˇenit. Pˇr´ıbˇehy obvykle také obsahuj´ı souboje s nepˇráteli, kteˇr´ı se v pˇr´ıbˇehu vyskytuj´ı. Zda ˇctenáˇr (hráˇc) v souboji uspˇeje záleˇz´ı na jeho vlastnostech a na náhodˇe (napˇr. hodu kostkou). Proto se tˇemto knihám ˇr´ıká gamebook z anglického slova game, tedy hra. ˇ anr gamebooku je vˇetˇsinou psán Gamebook je tedy moˇzné oznaˇcit za textovou hru. Z´ 2

Existuj´ıc´ı aplikace

Vybrané mobiln´ı aplikace

ve stylu fantasy nebo sci-fi, ale nen´ı to podm´ınkou. Autor m˚ uˇze zvolit jak´ ykoliv jin´ y ˇzánr.

2.2

Vybran´ e mobiln´ı aplikace

V následuj´ıc´ıch podkapitolách budou popsány mobiln´ı aplikace, které umoˇzn ˇuj´ı procházen´ı gamebook˚ u na platformˇe Android. Vybrané aplikace pro srovnán´ı jsou následuj´ıc´ı: 1. The Forging of a Legend dostupné z https://play.google.com/store/apps/ details?id=com.gamebook, 2. Choice of Broadsides dostupné z https://play.google.com/store/apps/ details?id=com.choiceofgames.broadsides, 3. Lone Wolf Saga dostupné z https://play.google.com/store/apps/details? id=com.GDVGames.LoneWolfBiblio. V´ yˇse uvedené aplikace jsou dostupné z obchodu Google play (dostupn´ y z https: //play.google.com), kter´ y je oficiáln´ım nástrojem platformy Android pro distribuci aplikac´ı. Vˇsechny aplikace obsahuj´ı pˇr´ıbˇeh v angliˇctinˇe, popˇr. nav´ıc obsahuj´ı i jiné jazykové verze, ale nepodaˇrilo se nalézt gamebook aplikaci s pˇr´ıbˇehem v ˇceském jazyce. Aplikace byly testovány na zaˇr´ızen´ıch Samsung GT-S5839i a Samsung GTS6500 s verz´ı 2.3.6 (Gingerbread) platformy Android a na zaˇr´ızen´ı Sony Xperia M obsahuj´ıc´ı verzi 4.3 (Jelly Bean). Testován´ı bylo pˇredevˇs´ım zamˇeˇreno na pohodlnost ovládán´ı, grafickou stránku aplikace a hern´ı moˇznosti hráˇce. Pˇr´ıbˇeh a ˇzánr, kter´ y byl v dané aplikaci, nebyl posuzován, protoˇze to nen´ı c´ılem této práce.

2.2.1

Aplikace The Forging of a Legend

Prvn´ı testovaná aplikace se jmenuje The Forging of a Legend. Velikost instalace je 10 MB a minimáln´ı vyˇzadovaná verze Androidu je 1.6 (Donut). Tento gamebook je moˇzné ˇc´ıst (hrát) v katalánˇstinˇe, ˇspanˇelˇstinˇe a angliˇctinˇe. Aplikace je dostupná zdarma. Ovládán´ı aplikace nebylo bezchybné. Po kliknut´ı na tlaˇc´ıtko nebylo poznat, zda tlaˇc´ıtko bylo opravdu stisknuto, chybˇela zde reakce na stisk, napˇr. zmˇena barvy tlaˇc´ıtka. Tlaˇc´ıtka byla rozm´ıstˇena bl´ızko sebe a nˇekolikrát se stalo, ˇze bylo stisknuto tlaˇc´ıtko jiné, neˇz bylo zam´ yˇsleno. Pˇri ˇcten´ı delˇs´ıho textu bylo nutné pˇrecházet na 3



dalˇs´ı obrazovku (otáˇcet stránku), ale aplikace obˇcas na pˇretaˇzen´ı prstu nereagovala. Bohuˇzel aplikace neumoˇzn ˇovala ˇcten´ı pˇri tzv. landscape orientaci obrazovky (zobrazen´ı obrazovky na ˇs´ıˇrku), ale pouze v portrait orientaci, tj. zobrazen´ı obrazovky na v´ yˇsku (viz [1]). V´ ybˇer moˇznosti rozhodnut´ı je um´ıstˇen na konci stránky pod textem, viz obr. 2.1. Velmi praktická byla moˇznost zmenˇsit nebo zvˇetˇsit p´ısmo textu knihy.

Obrázek 2.1: Ukázka z aplikace The Forging of a Legend

Obrázek 2.2: Ukázka animace z aplikace The Forging of a Legend

Grafick´ y vzhled aplikace p˚ usob´ı pˇr´ıjemnˇe a pˇrehlednˇe, v´ yznam jednotliv´ ych ikon na hrac´ı ploˇse je snadno rozpoznateln´ y. Aplikace obsahuje jednoduché animace, napˇr´ıklad hod kostkou (obr. 2.2) nebo efekt otoˇcen´ı stránky pˇri pˇrechodu na jinou obrazovku. Tyto animace jsou doprovázeny zvukov´ ym efektem. U nˇekter´ ych ˇcást´ı textu jsou zobrazeny obrázky souvisej´ıc´ı s textem, které jsou um´ıstˇeny na konci stránky pod textem nebo zab´ıraj´ı celou obrazovku. Tyto obrázky ˇcten´ı velmi oˇziv´ı. Vˇetˇsina postav v tomto gamebooku má sv˚ uj obrázek, kter´ y se zobraz´ı kdyˇz postavu poprvé potkáte, viz obr. 2.3. Hern´ı obrazovka, viz obr. 2.1 nebo 2.3, je rozdˇelena na tˇri ˇca´sti, v horn´ı liˇstˇe jsou um´ıstˇeny ikony, které slouˇz´ı pro uloˇzen´ı hry, procházen´ı obrázk˚ u objeven´ ych postav apod. Kromˇe ukládán´ı hry nemaj´ı tyto funkce ve hˇre ˇzádn´ y praktick´ y v´ yznam a slouˇz´ı pouze jen jako doplˇ nky a dodateˇcné informace pro hráˇce. Uprostˇred obrazovky se zobrazuje text a obrázky. Na doln´ı liˇstˇe jsou um´ıstˇeny dvˇe ikony, pomoc´ı kter´ ych lze zvˇetˇsovat nebo zmenˇsovat text a ikonka sociáln´ı s´ıtˇe facebook, která umoˇzn ˇuje sd´ılet nˇekteré události ze hry na této sociáln´ı s´ıti.

4



Obrázek 2.3: Ukázka obrázku postavy z aplikace The Forging of a Legend Na poˇca´tku hry má hráˇc moˇznost nechat si atributy postavy automaticky náhodnˇe vygenerovat nebo m˚ uˇze pro kaˇzd´ y atribut házet kostkami. Ve hˇre jsou vˇzdy pouˇz´ıvány dvˇe ˇsestistˇenné kostky. Souˇcet tˇechto dvou hozen´ ych hodnot je hráˇci pˇriˇcten k danému atributu. V pr˚ ubˇehu hry m˚ uˇze hráˇc z´ıskávat pˇredmˇety, které tyto atributy vylepˇs´ı, a nebo mohou b´ yt tyto atributy ve hˇre vylepˇseny po skonˇcen´ı nˇejaké události, napˇr. po skonˇcen´ı boje. Pˇri souboj´ıch se vyuˇz´ıvá pouze kostek. Hráˇc má lich´ y poˇcet pokus˚ u a mus´ı vyhrát vˇzdy v´ıce neˇz polovinu z nich. Pokus je vyhrán tak, ˇze hráˇc mus´ı hodit hodnotu stejnou nebo vyˇsˇs´ı neˇz je zadaná. Pokud hod´ı menˇs´ı, pokus je ne´ uspˇeˇsn´ y. V pr˚ ubˇehu hry bylo nabyto dojmu, ˇze z´ıskané atributy postavy nemaj´ı na souboje ˇza´dn´ y vliv a jsou pouze o náhodˇe. Hru je moˇzné bˇehem ˇcten´ı ukládat, ale pouze tˇrikrát za celou hru. Hra je automaticky uloˇzena pˇred kaˇzd´ ym soubojem a tˇri moˇznosti uloˇzen´ı tak nemaj´ı vˇetˇs´ı v´ yznam. Pokud by se hra neukládala automaticky a mohl ji ukládat pouze hráˇc jen tˇrikrát za celou hru, pak by hra byla mnohem obt´ıˇznˇejˇs´ı a pˇredevˇs´ım zaj´ımavˇejˇs´ı.

2.2.2

Aplikace Choice of Broadsides

Druhá testovaná aplikace se jmenuje Choice of Broadsides. Velikost jej´ı instalace je 4.6 MB a minimáln´ı potˇrebná verze Androidu je 2.3 (Gingerbread). Aplikace je dostupná v angliˇctinˇe a byla vyvinuta spoleˇcnost´ı Choice of Games LLC.

5



Tato spoleˇcnost uˇz vydala pˇres 20 podobn´ ych gamebookov´ ych aplikac´ı. Aplikace jsou v podstatˇe stejné, liˇs´ı se pouze tématem, ˇzańrem a obsahem text˚ u. Spoleˇcnost pro psan´ı pˇr´ıbˇeh˚ u vyvinula vlastn´ı skriptovac´ı jazyk ChoiceScript, v´ıce informac´ı viz [5]. Aplikace je dostupná zdarma, ale obsahuje reklamy, které je moˇzné odstranit zaplacen´ım poplatku. Ovládán´ı této aplikace je velmi jednoduché a umoˇzn ˇuje pouze ˇc´ıst text a rozhodovat se. Pod textem pro danou ˇcást odstavce jsou um´ıstˇeny volby, které hráˇc m˚ uˇze provést, viz obr. 2.4. Uˇzivatel mus´ı nejdˇr´ıve kliknout na danou volbu, a poté kliknut´ım na tlaˇc´ıtko pod tˇemito volbami v´ ybˇer potvrdit. Poté je hráˇci zobrazena obrazovka s nov´ ym textem. V aplikaci nen´ı moˇzné provádˇet ˇza´dná nastaven´ı, napˇr. velikost textu. Aplikace se skládá z hlavn´ı (hern´ı) obrazovky, dále z obrazovky, na které jsou zobrazeny statistiky postavy a z kontextového menu (na zaˇr´ızen´ıch s verz´ı 3.0 (Honeycomb) a vyˇsˇs´ıch je nahrazeno Action Barem). Action Bar je grafická komponenta (liˇsta) v horn´ı ˇca´sti obrazovky (pˇr´ıpadnˇe i doln´ı), která by uˇzivateli mˇela usnadnit navigaci v aplikaci a poskytnout pˇr´ım´ y pˇr´ıstup k d˚ uleˇzit´ ym nástroj˚ um a funkc´ım aplikace. Toto menu obsahuje tlaˇc´ıtko pro restart hry, odkazy na podobné aplikace od této firmy, zaplacen´ı za odebrán´ı reklam z aplikace a dalˇs´ı odkazy. Za v´ yhodu se dá povaˇzovat to, ˇze aplikace jako jediná z testovan´ ych umoˇzn ˇuje ˇcten´ı textu v landscape orientaci obrazovky.

Obrázek 2.4: Ukázka z aplikace Choice of Broadsides

Obrázek 2.5: Ukázka statistik v aplikaci Choice of Broadsides

6



Grafika, tzn. obrázky nebo ikony, nejsou v této aplikaci pouˇzity a aplikace neobsahuje ˇzádné animace ani zvukov´ y doprovod. Text je ˇclenˇen do pˇrehledn´ ych odstavc˚ u a ˇcten´ı delˇs´ıho textu je tak snadnˇejˇs´ı. Bohuˇzel zde chyb´ı moˇznost zvˇetˇsovat nebo zmenˇsovat velikost p´ısma jako u prvn´ı testované aplikace. Vytvoˇren´ı postavy vˇcetnˇe statistik prob´ıhá na zaˇcátku tak, ˇze hráˇci jsou poloˇzeny otázky a nab´ıdnuty moˇzné odpovˇedi, ze kter´ ych si m˚ uˇze vybrat a podle vybrané odpovˇedi se zlepˇs´ı urˇcitá vlastnost (atribut) postavy. Uˇzivatel si také mus´ı vybrat svoji slabinu, tzn. daná vlastnost se zhorˇs´ı. Schopnosti jsou ohodnoceny procenty, viz obr. 2.5. Vybrané vlastnosti pak v pˇr´ıbˇehu pˇr´ımo ovlivˇ nuj´ı ˇsanci u ´spˇechu pˇri akci, na které daná vlastnost závis´ı.

Obrázek 2.6: Ukázka z aplikace Lone Wolf Saga

2.2.3

Obrázek 2.7: Ukázka boje z aplikace Lone Wolf Saga

Aplikace Lone Wolf Saga

Dalˇs´ı testovanou aplikac´ı je Lone Wolf Saga. Velikost instalace je 7.1 MB, ale po instalaci aplikace je nutné jeˇstˇe stáhnout databázi obsahuj´ıc´ı jednotlivé gamebooky a obrázky. Tato databáze má velikost pˇribliˇznˇe 20 MB. Aplikace je lokalizovaná pouze do anglického jazyka a je urˇcená pro zaˇr´ızen´ı s operaˇcn´ım systémem Android od verze 2.1 (Eclair). Aplikace je zdarma, ale je moˇzné finanˇcnˇe podpoˇrit v´ yvojáˇre a autora gamebooku nebo si koupit sloty pro ukládán´ı pr˚ ubˇehu hry. 7



Gamebooky, které jsou obsaˇzeny v této aplikaci existuj´ı také jako fyzické knihy (http://lonewolf.mytago.cz/), které jsou na rozd´ıl od aplikace pˇreloˇzeny i do ˇceského jazyka. ˇ Aplikace se ovládá pomoc´ı tlaˇc´ıtek rozm´ıstˇen´ ych na obrazovce. Cetba gamebooku prob´ıhá podobnˇe jako u ostatn´ıch testovan´ ych aplikac´ı. Text je um´ıstˇen na obrazovce a na konci textu jsou tlaˇc´ıtka s moˇzn´ ymi volbami. Hod kostkou (nebo jak´ ykoliv jin´ y náhodn´ y jev) zde prob´ıhá pouze pomoc´ı tlaˇc´ıtka (viz obr. 2.6) bez jakékoliv animace. Po stisknut´ı tlaˇc´ıtka je hráˇci oznámena vygenerovaná náhodná hodnota a podle n´ı se hráˇci zpˇr´ıstupn´ı akce, kterou m˚ uˇze provést. Podobnˇe je implementován boj, viz obr. 2.7, kter´ y je moˇzné procházet po jednotliv´ ych kolech nebo nechat boj odsimulovat cel´ y najednou. Aplikace obsahuje také nab´ıdku (Action Bar), ve které jsou tlaˇc´ıtka pro zobrazen´ı mapy, restart hry, uloˇzen´ı hry a otevˇren´ı statistik a inventáˇre postavy. Poˇrad´ı tˇechto tlaˇc´ıtek lze upravit v nastaven´ı tak, ˇze nˇekteré funkce budou zobrazeny pˇr´ımo na obrazovce. Poˇrad´ı sice nemá vliv na funkˇcnost, ale hráˇci m˚ uˇze umoˇznit pohodlnˇejˇs´ı pˇr´ıstup k dané vlastnosti.

Obrázek 2.8: Ukázka um´ıstˇen´ı obrázku z aplikace Lone Wolf Saga Grafika je v aplikaci obsaˇzena ve formˇe obrázk˚ u, které se objevuj´ı mezi textem, viz obr. 2.8, a mapy oblasti, v n´ıˇz se pˇr´ıbˇeh odehrává. Obrázky jsou obsaˇzené v databázi, kterou je potˇreba pˇred zahájen´ım hry stáhnout. Aplikace umoˇzn ˇuje nastavit r˚ uzná barevná schémata, která zmˇen´ı barvu pozad´ı a barvu p´ısma. Je také moˇzné mˇenit font p´ısma. Uˇzivatel si m˚ uˇze vybrat, zda bude text zobrazen v systémovém fontu nebo v jednom ze dvou font˚ u aplikace. Text se ale u tˇechto dvou font˚ u velmi ˇspatnˇe 8



ˇcte, coˇz je v aplikaci, která je zaloˇzena na ˇcetbˇe velká nev´ yhoda. Velikost textu je moˇzné také nastavovat, ale pouze v nastaven´ı aplikace. Urˇcitˇe by bylo vhodnˇejˇs´ı mˇenit velikost textu pˇr´ımo ve hˇre jako u prvn´ı testované aplikace. Text také nen´ı moˇzné ˇc´ıst v landscape orientaci obrazovky.

Obrázek 2.9: Ukázka vytváˇren´ı profilu hráˇce v aplikaci Lone Wolf Saga

Obrázek 2.10: Ukázka, jak schopnost umoˇzn ˇuje v´ıce voleb v aplikaci Lone Wolf Saga

Pˇri prvn´ım spuˇstˇen´ı aplikace je uˇzivatel vyzván, aby stáhl databázi obsahuj´ıc´ı gamebooky a obrázky. Dokud databáze nen´ı staˇzena nen´ı moˇzné gamebooky procházet (hrát). Staˇzen´ı databáze se provád´ı v nastaven´ı aplikace. Databázi je moˇzné uloˇzit na intern´ı u ´loˇziˇstˇe zaˇr´ızen´ı i na pamˇet’ovou kartu. Dalˇs´ım krokem je vytvoˇren´ı profilu postavy. Profil˚ u je moˇzné vytvoˇrit v´ıce. Pˇri vytváˇren´ı profilu, viz obr. 2.9, je uˇzivatel vyzván k zadán´ı jména a vygenerován´ı náhodn´ ych hodnot pro dvˇe vlastnosti a to Combat skill (bojová dovednost) a Endurance (v´ ydrˇz). Tyto vlastnosti jsou poté vyuˇz´ıvány v boji a boj pˇr´ımo ovlivˇ nuj´ı. Jako dalˇs´ı si mus´ı hráˇc zvolit 5 schopnost´ı, které bude ovládat. Vybrané schopnosti pak hráˇci pˇri nˇekter´ ych akc´ıch odemykaj´ı volbu nav´ıc, jak zobrazuje obr. 2.10, ze kterého je vidˇet, ˇze postava danou vlastnost´ı nedisponuje, a proto nem˚ uˇze vybrat posledn´ı volbu (tlaˇc´ıtko). V pr˚ ubˇehu hry se hráˇc m˚ uˇze dostat do fáze hry, ve kterém je nucen sn´ıst j´ıdlo, které má v inventáˇri. Pokud j´ıdlo nemá, jsou mu odeˇcteny 3 body z v´ ydrˇze. Aplikace obsahuje v´ıce gamebook˚ u. Tyto gamebooky se postupnˇe otev´ıraj´ı po u ´spˇeˇsném dokonˇcen´ı pˇredchoz´ıch. Pokud je aplikace ukonˇcena, postup ve hˇre je zachován, ale pˇri smrti hlavn´ı postavy mus´ı 9


Srovnán´ı testovaných aplikac´ı

b´ yt dan´ y gamebook hrán od zaˇcátku. Pouze v pˇr´ıpadˇe, ˇze je nav´ıc zakoupen slot pro ukládán´ı, je moˇzné naˇc´ıst i uloˇzenou pozici pˇred smrt´ı.

2.3

Srovn´ an´ı testovan´ ych aplikac´ı

Z porovnávan´ ych aplikac´ı lze ohodnotit jako nejpropracovanˇejˇs´ı a nejpovedenˇejˇs´ı aplikaci Lone Wolf Saga, která nab´ız´ı mnoho nastaven´ı (velikost p´ısma, pouˇzit´ y font, barevné schéma). Velikost aplikace je oproti ostatn´ım aplikac´ım pomˇernˇe vˇetˇs´ı, coˇz je dáno t´ım, ˇze obsahuje tˇri gamebooky, které jsou postupnˇe zpˇr´ıstupˇ novány po dokonˇcen´ı pˇredchoz´ıch. Vlastnosti postavy skuteˇcnˇe ovlivˇ nuj´ı pr˚ ubˇeh pˇr´ıbˇehu. Napˇr´ıklad pˇri boji atributy a vlastnosti postavy urˇcuj´ı ˇsanci na v´ yhru. To je rozd´ıl oproti aplikaci The Forging of a Legend, ve které se zdá, ˇze v´ ysledek boje záleˇz´ı pouze na náhodˇe. Jediné negativum u této aplikace je neˇcitelnost nˇekter´ ych pouˇzit´ ych font˚ u. Druhá testovaná aplikace Choice of Broadsides je po grafické i hern´ı stránce velmi jednoduchá a nelze j´ı nic vytknout, i kdyˇz aplikace neobsahuje ˇza´dnou grafiku ani ˇza´dné moˇznosti nastaven´ı (moˇzná právˇe pro jednoduchost ji nelze nic vytknout). Jednotlivé volby jsou velmi dobˇre zpracovány (mnoho moˇznost´ı, podrobnˇe popsány). Jako jediná obsahuje moˇznost procházet gamebook v landscape orientaci obrazovky. Grafika v aplikaci The Forging of a Legend ˇcetbu velmi oˇzivuje a aplikace tak vypadá velmi dobˇre. Na rozd´ıl od ostatn´ıch vybran´ ych aplikac´ı umoˇzn ˇuje sd´ılen´ı nebo vazbu na sociáln´ı s´ıt’, coˇz je v dneˇsn´ı dobˇe u mobiln´ıch aplikac´ı obvyklé. D´ıky porovnán´ı tˇechto aplikac´ı, jsme z´ıskali pˇrehled o aplikac´ıch podobn´ ych té, která bude realizována jako mobiln´ı klient. Pˇri implementaci je tak moˇzné vyhnout se negativ˚ um, která byla v testovan´ ych aplikac´ıch nalezeny. A naopak se inspirovat uˇziteˇcn´ ymi funkcemi z tˇechto aplikac´ı. Pˇrekvapuj´ıc´ı bylo zjiˇstˇen´ı, ˇze se nepodaˇrilo dohledat ˇzádnou aplikaci s gamebookem v ˇceském jazyce, ani naj´ıt veˇrejnˇe dostupn´ y systém, kter´ y se podobá vyv´ıjenému systému, a zároveˇ n by v nˇem bylo moˇzné napsat gamebook a vydat ho, at’ uˇz jako samostatnou aplikaci nebo jako ˇca´st aplikace. Spoleˇcnost (Choice of Games LLC), která vytvoˇrila aplikaci Choice of Broadsides, umoˇzn ˇuje pomoc´ı svého skriptovac´ıho jazyka ChoiceScript vytváˇret gamebooky, viz [5]. Vytvoˇren´ y gamebook, ale mus´ı b´ yt odeslán emailem této firmˇe a aˇz poté z nˇej firma vytvoˇr´ı aplikaci, kterou je moˇzné publikovat, ovˇsem vytvoˇren´ y gamebook mus´ı b´ yt pouze v anglickém jazyce. D´ıky tomu zde vzniká prostor pro vytvoˇren´ı systému, kter´ y by umoˇzn ˇoval publikovat gamebooky i v jin´ ych jazyc´ıch neˇz v anglickém. Vytváˇren´ı gamebook˚ u pomoc´ı tohoto systému by mohlo b´ yt uˇzivatelsky pˇr´ıjemnˇejˇs´ı (napˇr. pomoc´ı programu s gra10


Srovnán´ı testovaných aplikac´ı

fick´ ym rozhran´ım) a vydán´ı gamebooku by mohlo prob´ıhat automatizovanˇe. Protoˇze vyv´ıjen´ y systém by byl prvn´ı svého druhu, mohl by b´ yt u ´spˇeˇsn´ y.

11

3 Systém pro publikován´ı gamebook˚ u Vyv´ıjen´ y sytém pro publikován´ı gamebook˚ u (dále jen systém) se skládá ze tˇr´ı hlavn´ıch ˇcást´ı a je vyv´ıjen t´ ymem, kter´ y se zat´ım skládá ze dvou ˇclen˚ u, tj. Pavel Pˇribán ˇ a Jakub Sido. Prvn´ı ˇcást´ı systému je program (editor), kter´ y umoˇzn ˇuje tvorbu gamebooku. Druhou ˇca´st´ı je server, na kterém jsou gamebooky uloˇzeny. Posledn´ı ˇcást pˇredstavuje mobiln´ı klient (mobiln´ı aplikace), kter´ y umoˇzn ˇuje gamebooky procházet (hrát, ˇc´ıst) a jeho realizace je pˇredmˇetem této práce. Jednotlivé ˇca´sti systému spolu mohou komunikovat prostˇrednictv´ım serveru, viz obr. 3.1, na kterém jsou znázornˇeny jednotlivé ˇca´sti systému a naznaˇcena základn´ı komunikace. V následuj´ıc´ıch podkapitolách budou jednotlivé ˇcásti systému popsány podrobnˇeji.

Obrázek 3.1: Schéma systému pro publikován´ı gamebook˚ u

12

Systém pro publikován´ı gamebook˚ u

3.1

Program pro tvorbu gamebooku

Program pro tvorbu gamebooku

Program (dále jen editor) umoˇzn ˇuje registrovan´ ym uˇzivatel˚ um vytváˇret a publikovat gamebooky. Aby uˇzivatel mohl zaˇc´ıt psát gamebook, mus´ı se nejprve registrovat a stáhnout editor. Pˇri vytváˇren´ı gamebooku je uˇzivatel v aplikaci ovˇeˇren pomoc´ı u ´daj˚ u zadan´ ych pˇri registraci. Editor je programován v jazyce JAVA, stejnˇe jako mobiln´ı klient. Obˇe aplikace (mobiln´ı klient a editor) vyuˇz´ıvaj´ı sd´ılenou knihovnu. Sd´ılená knihovna obsahuje nˇekteré tˇr´ıdy a metody (napˇr. naˇc´ıtán´ı souboru s gamebookem), jeˇz by bylo tˇreba implementovat v obou aplikac´ıch. Je tedy v´ yhodné vyuˇz´ıt stejn´ y zdrojov´ y kód. Pouˇzit´ı sd´ılené knihovny je moˇzné, d´ıky tomu, ˇze SDK platformy Android je z ˇcásti zaloˇzené na JDK. Sd´ılená knihovna je programována pouze s vyuˇzit´ım vybran´ ych funkˇcnost´ı a nástroj˚ u, které jsou pr˚ unikem SDK a JDK. D´ıky tomu je moˇzné knihovnu vyuˇz´ıt v editoru i v mobiln´ım klientovi. SDK (Software Development Kit) je tvoˇren sadou nástroj˚ u a API umoˇzn ˇuj´ıc´ı v´ yvoj aplikac´ı (zde pro platformu Android). JDK (Java Development Kit) obsahuje sadu základn´ıch nástroj˚ u pro v´ yvoj na platformˇe JAVA. API (Application Programming Interface) je rozhran´ı pro programován´ı aplikac´ı.

3.2

Server

Server poskytuje sluˇzby mobiln´ımu klientovi, editoru a uˇzivatel˚ um, kteˇr´ı systém vyuˇz´ıvaj´ı k tvorbˇe nebo editaci gamebook˚ u. Server je implementován jako webov´ y server. Pro komunikaci se serverem se vyuˇz´ıvá protokol HTTP. Na serveru je také um´ıstˇena MySQL databáze, ve které jsou uloˇzeny jednotlivé gamebooky, jejich hodnocen´ı, uˇzivatelé, pˇreklady a korektury gamebook˚ u a dalˇs´ı informace. Pˇr´ıstup k tˇemto dat˚ um, tj. ˇcten´ı, zápis a u ´prava, je poskytován jednotliv´ ym ˇcástem systému pomoc´ı n´ıˇze popsan´ ych sluˇzeb.

3.2.1

Sluˇ zby pro editor

Hlavn´ı sluˇzbou, kterou server poskytuje editoru, je moˇznost nahrát vytvoˇren´ y gamebook na server a uloˇzit jej do databáze. Sluˇzby poskytované editoru zde nebudou uvedeny podrobnˇe, protoˇze jsou urˇceny pro potˇreby editoru, jehoˇz detailn´ı popis nen´ı souˇca´st´ı této práce.

13


3.2.2

Mobiln´ı klient

Uˇ zivatelsk´ e sluˇ zby

Sluˇzby pro uˇzivatele budou implementovány formou webov´ ych stránek, které jsou vyv´ıjené, ale zat´ım nejsou veˇrejnˇe dostupné. Po jejich dokonˇcen´ı budou dostupné z adresy http://malpal.cz/. Stránky jsou programovány pomoc´ı jazyka PHP a vyuˇzit´ı frameworku Nette. Framework pomáhá usnadnit a urychlit v´ yvoj softwaru tak, ˇze se v´ yvojáˇri snaˇz´ı poskytnout ˇreˇsen´ı rutinn´ıch ˇcinnost´ı a problém˚ u. Framework m˚ uˇze b´ yt obecnˇe knihovnou nebo ˇsablonou, která se dále rozˇsiˇruje, popˇr. je vyuˇz´ıváno jej´ıch sluˇzeb. Aby uˇzivatel mohl zaˇc´ıt vytváˇret gamebooky, bude se muset nejprve na stránkách zaregistrovat. Mezi ˇcinnosti, které budou moci registrovan´ı uˇzivatelé vykonávat, patˇr´ı: • vytváˇren´ı gamebooku, • provádˇen´ı korektury pˇred vydán´ım gamebooku, • pˇrekládán´ı gamebooku do jiného jazyka. Pro vytváˇren´ı gamebooku je potˇreba m´ıt nainstalovan´ y editor na vlastn´ım poˇc´ıtaˇci. Pˇrekládat nebo provádˇet korekturu bude moˇzné pˇr´ımo na webov´ ych stránkách. Korektura gamebooku se provád´ı pˇred jeho vydán´ım. Korektor má za u ´kol gamebook zkontrolovat, a pˇr´ıpadnˇe opravit gramatické a pravopisné chyby.

3.2.3

Sluˇ zby pro mobiln´ıho klienta

Tyto sluˇzby jsou poskytovány mobiln´ımu klientovi a jsou realizovány pomoc´ı HTTP protokolu a dotaz˚ u provádˇen´ ych na webov´ y server. Webov´ y server na poˇzadovan´ y dotaz vygeneruje HTML stránku, ze které klient z´ıská informace, o nˇeˇz v dotazu ˇza´dal. Sluˇzby, které server poskytuje pro mobiln´ıho klienta jsou: • vygenerovat seznam dostupn´ ych gamebook˚ u, • vygenerovat odkaz pro staˇzen´ı gamebooku, • pˇrijmout hodnocen´ı daného gamebooku od klienta.

3.3

Mobiln´ı klient

´ Ukolem mobiln´ıho klienta je umoˇznit uˇzivatel˚ um (nejen registrovan´ ym v systému) procházen´ı vytvoˇren´ ych gamebook˚ u na platformˇe Android. Pˇri instalaci klienta (apli14


Mobiln´ı klient

kace) by mˇela aplikace obsahovat nˇekteré jiˇz hotové gamebooky. Tyto gamebooky budou distribuovány spolu s aplikac´ı, protoˇze jejich autoˇri se pod´ıleli na testován´ı systému v jeho poˇca´tc´ıch a byli prvn´ımi autory, proto budou takto zv´ yhodnˇeni. Pˇri vydán´ı (publikován´ı) nového gamebooku by mˇela b´ yt aplikace schopna nov´ y gamebook do zaˇr´ızen´ı stáhnout. Základn´ı funkcionalitu klienta tedy budou tvoˇrit tyto dva body: • procházen´ı gamebook˚ u, • staˇzen´ı novˇe vydan´ ych gamebook˚ u. Dále by aplikace mˇela uˇzivateli umoˇznit zpˇetnou vazbu, napˇr. moˇznost ohodnotit vytvoˇren´ y gamebook. Na obrázku 3.2 je um´ıstˇen UML diagram pouˇzit´ı, kter´ y znázorˇ nuje základn´ı funkcionalitu mobiln´ıho klienta. Realizace mobiln´ıho klienta je pˇredmˇetem této bakaláˇrské práce. Klient bude programován v jazyce JAVA, a jak bylo zm´ınˇeno v kap. 3.1, vyuˇz´ıvá funkcionalitu sd´ılené knihovny. Podrobn´ y návrh mobiln´ıho klienta bude popsán v kap. 4. UML (Unified Modeling Language) je univerzáln´ı jazyk ” pro vizuáln´ı modelován´ı systém˚ u“ [16], kter´ y se pouˇz´ıvá pˇredevˇs´ım v softwarovém inˇzen´ yrstv´ı. Pˇri vytváˇren´ı UML diagram˚ u v této práci jsem ˇcerpal z [16] a [17].

Mobilní klient Procházet gamebook

Stáhnout gamebook

Uživatel

Hodnotit gamebook

Smazat gamebook

Obrázek 3.2: UML diagram pouˇzit´ı mobiln´ıho klienta

15

Server «system»


3.4

Reprezentace gamebooku


Gamebook v kniˇzn´ı (tiˇstˇené) podobˇe je uchováván jako klasická kniha, ale uloˇzit vytvoˇren´ y elektronick´ y gamebook pouze jako text nen´ı pˇr´ıliˇs vhodné a to pˇredevˇs´ım z d˚ uvodu pozdˇejˇs´ıho zpracován´ı a procházen´ı gamebooku na jiné ˇcásti systému (napˇr. mobiln´ım klientovi). Je proto potˇreba pouˇz´ıt sofistikovanˇejˇs´ı pˇr´ıstup. Proto byl pro reprezentaci gamebooku zvolen orientovan´ y graf, kter´ y je moˇzné pouˇz´ıt, jak bylo vysvˇetleno v kapitole 2.1. Vrcholem grafu je zde stav, neboli ˇcást textu, po které následuje rozhodnut´ı hráˇce. Hrany mezi vrcholy grafu pˇredstavuj´ı jednotlivé akce (rozhodnut´ı), pro které se m˚ uˇze hráˇc rozhodnout. Graf je reprezentován XML souborem, kter´ y je popsán v kapitole 3.4.1. Protoˇze je graf ukládán do souboru typu XML, kter´ y je podporován mnoha programovac´ımi jazyky, bylo doc´ıleno toho, ˇze soubor je nezávisl´ y na platformˇe, na které je zpracováván.

3.4.1

Struktura XML souboru

Koˇrenov´ ym elementem XML souboru je element ROOT, kter´ y obsahuje element Info. V tomto elementu jsou um´ıstˇeny poˇca´teˇcn´ı hodnoty atribut˚ u postavy, se kterou bude hráˇc gamebook procházet. Na stejné u ´rovni jako Info, je obsaˇzen element Graph, jehoˇz atributy obsahuj´ı informace o gamebooku (id, jméno autora, název gamebooku atd.), viz ukázka kódu 3.1, na které je pro ilustraci zobrazena zjednoduˇsená ukázka souboru (neobsahuje vˇsechny elementy a atributy). Tento element (Graph) obsahuje vˇsechna data a informace daného gamebooku. Uvnitˇr jsou vnoˇreny elementy State, které pˇredstavuj´ı jednotlivé stavy v grafu gamebooku (tj. ˇca´st textu, po které se m˚ uˇze hráˇc rozhodnout, jak bude pokraˇcovat). Kaˇzd´ y takov´ y stav obsahuje elementy Action, tedy akce, které m˚ uˇze hráˇc v daném stavu provést. V elementu Action jsou uloˇzené informace potˇrebné pro vyhodnocen´ı dané akce. Atribut id je jedineˇcn´ y identifikátor akce v gamebooku a atribut finalID udává, do jakého dalˇs´ıho stavu se má pˇr´ıbˇeh pˇresunout po vykonán´ı této akce.

16



<State id="1" desc="P´ ıs ˇe se rok 1963. Do vesm´ ıru se pr´ avˇ e dostala 1. z ˇena."> ... Ukázka kódu 3.1: Zjednoduˇsená ukázka struktury XML souboru

17

4 Návrh mobiln´ıho klienta Mobiln´ı klient je pˇredmˇetem této práce a mˇel by obsahovat základn´ı funkcionalitu, tj procházen´ı gamebooku, jeho hodnocen´ı a staˇzen´ı novˇe vydaného gamebooku, také viz kap. 3.3. Mobiln´ı klient bude navrˇzen pro platformu Android od verze 2.3 (Gingerbread). Hlavn´ım d˚ uvodem pro v´ ybˇer platformy Android je pˇredevˇs´ım jej´ı vˇetˇsinov´ y pod´ıl na trhu s chytr´ ymi telefony, viz obr. 4.1 (data pˇrevzata z [2]). Jako nejniˇzˇs´ı podporovaná verze byla zvolena verze 2.3, protoˇze pod´ıl mobiln´ıch zaˇr´ızen´ıch s operaˇcn´ım systémem s verz´ı 2.3 a v´ yˇse je také vˇetˇsinov´ y, viz tab. 4.1 (data pˇrevzata z [13]). Dalˇs´ımi platformami, které pˇricházely v u ´vahu pro v´ yvoj byly platformy iOS a Windows Phone.

Podíl operačních systémů chytrých telefonů za rok 2014 Ostatní 1%

Windows Phone 3%

iOS 15%

Android 81%

Obrázek 4.1: Pod´ıl operaˇcn´ıch systém˚ u chytr´ ych telefon˚ u za rok 2014 Nev´ yhodou pˇri v´ yvoji aplikac´ı pro platformu iOS a následném publikován´ı aplikace v oficiáln´ım obchodˇe (App store) je nutnost vlastnit zaˇr´ızen´ı s operaˇcn´ım systémem OS X (dˇr´ıve Mac OS X), na kterém prob´ıhá v´ yvoj aplikace. Nev´ yhodou platformy Windows Phone je zat´ım jej´ı pomˇernˇe n´ızké rozˇs´ıˇren´ı mezi uˇzivateli oproti platformˇe Android. Jako v´ yhodu pˇri v´ yvoji pro platformu Android lze povaˇzovat rozsáhlou dokumentaci, návody, ukázky a doporuˇcen´ı pro v´ yvojáˇre, viz [1]. D´ıky velkému rozˇs´ıˇren´ı této platformy a ˇsiroké komunitˇe v´ yvojáˇr˚ u je moˇzné nalézt ˇreˇsen´ı mnoha problém˚ u i na neoficiáln´ıch fórech, napˇr. stackoverflow viz [11].

18

Návrh mobiln´ıho klienta

Návrh s´ıt’ové komunikace

Verze

Kodov´ e jm´ eno

API

Pod´ıl

Souˇ cet

2.2 2.3.3 - 2.37 4.0.3 - 4.0.4 4.1.x 4.2.x 4.3 4.4 5.0

Froyo Gingerbread Ice Cream Sandwich

8 10 15 16 17 18 19 21

0.4% 6,9% 5,9% 17,3% 19,4% 5,9% 40,9% 3,3%

0.4%

Jelly Bean KitKat Lollipop

99,6%

Tabulka 4.1: Procentuáln´ı zastoupen´ı jednotliv´ ych verz´ı platformy Android k 2. bˇreznu 2015

4.1

N´ avrh s´ıt’ov´ e komunikace

Pro návrh s´ıt’ové komunikace mezi mobiln´ım klientem a serverem je nejdˇr´ıve potˇreba definovat jaká a jak velká data budou pˇrenáˇsena. Mezi serverem a klientem budou prob´ıhat tyto s´ıt’ové komunikace: 1. staˇzen´ı gamebooku ze serveru, 2. odeslán´ı hodnocen´ı gamebooku uˇzivatelem, 3. staˇzen´ı seznamu dostupn´ ych gamebook˚ u ze serveru. Pˇredpokládaná velikost textu gamebook˚ u je v ˇrádech stovek kB aˇz jednotek MB. U tˇechto text˚ u by ale v budoucnu mˇela pˇrib´ yt jeˇstˇe grafika (obrázky). Velikost v´ ysledného souboru, kter´ y bude stahován, tak m˚ uˇze dosáhnout aˇz des´ıtek MB. Tato (potenciáln´ı) velikost mus´ı b´ yt pˇri návrhu zohlednˇena. Soubor bude stahován ve formátu XML, pokud nebude obsahovat grafiku. Pokud bude spolu s gamebookem distribuována grafika, budou vˇsechny soubory zkomprimovány a zabaleny do archivu, kter´ y bude pˇrenáˇsen jako jedin´ y soubor. Pro body 2 a 3 by mˇelo platit, ˇze jsou to krátké textové soubory s velikost´ı v ˇra´dech jednotek kB.

4.1.1

Moˇ znosti s´ıt’ov´ e komunikace

Android API obsahuje standardn´ı bal´ık java.net z JDK, kter´ y slouˇz´ı pro s´ıt’ovou komunikaci. Základn´ı tˇr´ıdou pro s´ıt’ovou komunikaci pomoc´ı protokolu HTTP (resp. 19



HTTPS) je HttpURLConnection. Komunikovat lze také pomoc´ı tzv. socket˚ u. Pro protokol TCP existuje tˇr´ıda Socket a protokol UDP vyuˇz´ıvá tˇr´ıdu DatagramSocket. Sockety jsou nástroje (API), které se vyuˇz´ıvaj´ı v s´ıt’ové komunikaci zpravidla pro model klient - server. Oba protokoly (TCP, UDP) jsou zaˇrazeny do 4. (transportn´ı) u ´rovnˇe referenˇcn´ıho modelu ISO/OSI. HTTP je protokol 7. (aplikaˇcn´ı) vrstvy modelu ISO/OSI, viz [6].

4.1.2

Dostupn´ e knihovny

Pro zjednoduˇsen´ı s´ıt’ové komunikace pomoc´ı protokolu HTTP lze vyuˇz´ıt knihovnu Volley (dostupná z https://android.googlesource.com/platform/frameworks/ volley). Podle oficiáln´ı dokumentace [12] by knihovna mˇela implementaci s´ıt’ové komunikace zjednoduˇsovat a urychlovat. Mezi nˇekteré v´ yhody této knihovny patˇr´ı: • asynchronn´ı zpracován´ı a vykonán´ı s´ıt’ov´ ych dotaz˚ u, • implementovaná cache pamˇet’ pro opakuj´ıc´ı se dotazy, • podpora v´ıce soubˇeˇzn´ ych s´ıt’ov´ ych spojen´ı, • podpora priority jednotliv´ ych dotaz˚ u. Zjednoduˇsen´ y scénáˇr pouˇzit´ı knihovny pak m˚ uˇze prob´ıhat tak, ˇze nejprve je vytvoˇren tzv. Request (poˇzadavek, dotaz), tj. instance tˇr´ıdy Request, ve kterém je definovaná URL adresa serveru a dalˇs´ı parametry HTTP dotazu (napˇr. v´ ybˇer mezi HTTP metodami GET a POST). Dále jsou pˇri vytváˇren´ı objektu pˇredány instance dvou tˇr´ıd (tzv. posluchaˇc˚ u), které implementuj´ı rozhran´ı Response.Listener a Response.ErrorListener. Metody tˇechto rozhran´ı jsou zavolány po asynchronn´ım dokonˇcen´ı poˇzadavku. Metoda onResponse() posluchaˇce Response.Listener je zavolána pˇri u ´spˇeˇsném dokonˇcen´ı poˇzadavku a metoda onErrorResponse() druhého posluchaˇce je zavolána pˇri ne´ uspˇeˇsném dokonˇcen´ı. Vytvoˇren´ y objekt poˇzadavku je pˇridán do fronty poˇzadavk˚ u, která je reprezentována instanc´ı tˇr´ıdy RequestQueue. Poté je poˇzadavek asynchronnˇe zpracován knihovnou a je vyvolána jedna z v´ yˇse zm´ınˇen´ ych metod, viz obr. 4.2 (pˇrevzato z [12]). Dalˇs´ımi funkˇcnˇe podobn´ ymi knihovnami pro komunikaci na platformˇe Android jsou Retrofit (http://square.github.io/retrofit/) nebo také OkHttp (http: //square.github.io/okhttp/). Pro dlouhotrvaj´ıc´ı stahován´ı poskytuje Android tzv. DownloadManager, coˇz je systémová sluˇzba. Sluˇzba v systému Android je aplikace, která bˇeˇz´ı na pozad´ı a nemá vlastn´ı uˇzivatelské rozhran´ı (UI). Tato sluˇzba zajist´ı staˇzen´ı souboru i pˇri v´ ypadku 20



ˇ Obrázek 4.2: Zivotn´ ı cyklus s´ıt’ového poˇzadavku v knihovnˇe Volley spojen´ı nebo restartován´ı zaˇr´ızen´ı. Instance tˇr´ıdy DownloadManager se z´ıská volán´ım metody getSystemService() s parametrem Context.DOWNLOAD_SERVICE. Postup pro staˇzen´ı souboru je obdobn´ y jako u knihovny Volley, nejdˇr´ıve je potˇreba vytvoˇrit objekt reprezentuj´ıc´ı poˇzadavek, pˇredat mu adresu souboru a nastavit potˇrebné parametry (napˇr. m´ısto uloˇzen´ı souboru). Poté je objekt poˇzadavku pˇredán DownloadManageru, kter´ y se pokus´ı zajistit jeho staˇzen´ı. Aby sluˇzba mohla aplikaci informovat o pr˚ ubˇehu (popˇr. dokonˇcen´ı, ne´ uspˇechu), mus´ı aplikace zaregistrovat tzv. BroadcastReceiver (dále receiver). Receiver má za u ´kol reagovat na systémové události nebo na události jin´ ych aplikac´ı. Pokud nastane vybraná událost, jsou informováni vˇsechny receivery, kteˇr´ı maj´ı registrovanou tuto událost. V receiveru je implementována reakce na danou událost v pˇr´ıpadˇe DownloadManageru, tedy napˇr. reakce na u ´spˇeˇsné dokonˇcen´ı, ne´ uspˇeˇsné dokonˇcen´ı nebo na zahájen´ı stahován´ı.

21


4.1.3

Zp˚ usob uloˇzen´ı dat

Vybran´ eˇ reˇ sen´ı s´ıt’ov´ e komunikace

Z v´ yˇse popsan´ ych moˇznost´ı byla pro implementaci bod˚ u 2 (odeslán´ı hodnocen´ı) a 3 (staˇzen´ı seznamu dostupn´ ych knih) z kap. 4.1 vybrána knihovna Volley. D˚ uvodem pro v´ ybˇer této knihovny je pˇredevˇs´ım zjednoduˇsen´ı implementace s´ıt’ov´ ych poˇzadavk˚ u oproti implementaci pomoc´ı tˇr´ıdy HttpURLConnection. Od verze 3.0 (Honeycomb) mus´ı b´ yt vˇsechny s´ıt’ové operace provádˇeny mimo hlavn´ı vlákno aplikace. Knihovna vykonává poˇzadavky automaticky asynchronnˇe a v´ yvojáˇr tak nemus´ı tento problém ˇreˇsit. Velikost stahovaného gamebooku m˚ uˇze v budoucnu dosahovat aˇz des´ıtek MB, proto bude stahován´ı gamebook˚ u implementováno pomoc´ı systémové sluˇzby (DownloadManager). DownloadManager je podle [14] pˇr´ımo urˇcen pro stahován´ı velk´ ych soubor˚ u. Velkou v´ yhodou DownloadManageru je, ˇze sám dokáˇze ˇreˇsit v´ yjimeˇcné situace jako je pˇreruˇsen´ı s´ıt’ového spojen´ı nebo restart systému. Na obr. 4.3 je zobrazen UML diagram aktivit znázorˇ nuj´ıc´ı chován´ı aplikace pˇri stahován´ı gamebooku.

4.2

Zp˚ usob uloˇ zen´ı dat

Aplikace bude pracovat s daty, která reprezentuj´ı jednotlivé gamebooky (napˇr. XML soubor), s grafick´ ymi soubory a s lokáln´ımi daty reprezentuj´ıc´ı nastaven´ı aplikace. Tato data je potˇreba v aplikaci nˇejak uloˇzit. Pro perzistentn´ı uloˇzen´ı dat v zaˇr´ızen´ı, viz [15], nab´ız´ı Android tyto tˇri moˇznosti: 1. uloˇzen´ı základn´ıch datov´ ych typ˚ u ve formátu Kl´ıˇ c - Hodnota pomoc´ı tˇr´ıdy SharedPreferences, 2. uloˇzen´ı souboru do vnitˇrn´ıho nebo vnˇejˇs´ıho u ´loˇziˇstˇe, 3. uloˇzen´ı dat do SQLite databáze.

4.2.1

Sd´ılen´ e preference

Sd´ılené preference jsou urˇceny pro ukládán´ı relativnˇe mal´ ych dat, která jsou reprezentována základn´ımi datov´ ymi typy (boolean, long, int, float), nav´ıc je moˇzné ukládat objekt tˇr´ıdy String a kolekci této tˇr´ıdy (mnoˇzinu) reprezentovanou rozhran´ım Set<String>. Data jsou ukládána do souboru uloˇzeného na privátn´ım

22



Uživatel

Aplikace

Kliknutíjnajtlačítkojproj staženíjgamebooku

Webovýjserver

VygenerováníjURLj adresyjgamebooku

Vytvořeníjobjektu DownloadManager[Request

Předáníjobjektujinstanci DownloadManageru Rodesláníjpožadavkuq

Zpracováníjpožadavku ajvygenerováníjodkazu projstažení Zobrazeníjprůběhuj stahování

[stahujejse] [konecjstahování] Zpracováníjvýsledku stahování

Informováníjuživatele ojvýsledkujstahování

Obrázek 4.3: UML diagram aktivit znázorˇ nuj´ıc´ı chován´ı aplikace pˇri stahován´ı gamebooku u ´loˇziˇsti aplikace (jiné aplikace ani uˇzivatel se k tˇemto dat˚ um nemohou dostat1 ). Pro uloˇzen´ı dat je potˇreba z´ıskat instanci tˇr´ıdy SharedPreferences. Tˇr´ıda se z´ıská volán´ım metody getSharedPreferences() nad objektem tˇr´ıdy Context nebo jej´ıch podtˇr´ıd. Parametry metody jsou jméno souboru, do kterého se budou data ukládat a mód, v jakém bude soubor otevˇren (napˇr. pˇrepsán´ı pokud uˇz soubor existuje). Následn´ ym zavolán´ım metody edit() .putInt(klic, hodnota) nad z´ıskan´ ym objektem tˇr´ıdy SharedPreferences uloˇz´ıme promˇennou datového typu int, 1

Neplat´ı pro zaˇr´ızen´ı, které jsou tzv. rootnuté“, kde uˇzivatel má práva roota jako v klasickém ” linuxovém systému.

23



kde ”klic” je jedineˇcn´ y ˇretˇezec a ”hodnota” je ukládaná promˇenná. Naˇcten´ı promˇenné se provede zavolán´ım metody getInt(klic, defHodnota), kde argument ”defHodnota” je hodnota, která bude vrácena, pokud ˇc´ıslo pod zadan´ ym kl´ıˇcem nebude nalezeno. Pro ostatn´ı datové typy je postup obdobn´ y pouze se liˇs´ı názvy metod a ukládané datové typy. V´ yhodou sd´ılen´ ych preferenc´ı je jednoduchá implementace ukládán´ı a naˇc´ıtán´ı dat, ale nev´ yhodou je moˇznost ukládat jen základn´ı datové typy.

4.2.2

Ukl´ ad´ an´ı soubor˚ u

Práce se soubory na platformˇe Android prob´ıhá stejnˇe jako u jazyka JAVA, tj. pomoc´ı tˇr´ıd z bal´ıku java.io. Soubory je moˇzné ukládat na vnitˇrn´ı (internal) nebo vnˇejˇs´ı (external) u ´loˇziˇstˇe. Vnitˇrn´ım u ´loˇziˇstˇem je myˇslena vestavˇená non-volatile pamˇet’. Non-volatile pamˇet’ je druh pamˇeti, která dokáˇze uchovávat data i po odpojen´ı napájen´ı. Vnitˇrn´ı u ´loˇziˇstˇe nen´ı moˇzné ze zaˇr´ızen´ı vyjmout, je jeho souˇcást´ı. Vlastnosti vnitˇrn´ıho u ´loˇziˇstˇe jsou: • je vˇzdy dostupné, • soubory uloˇzené ve vnitˇrn´ım u ´loˇziˇsti jsou pˇr´ıstupné pouze aplikaci, které vnitˇrn´ı u ´loˇziˇstˇe náleˇz´ı, • pˇri odinstalaci aplikace jsou systémem odstranˇena vˇsechna uloˇzená data v tomto u ´loˇziˇsti, která náleˇz´ı odinstalovávané aplikaci. Vnˇejˇs´ı u ´loˇziˇstˇe je zpravidla reprezentováno vymˇenitelnou kartou typu SD a liˇs´ı se tˇemito rozd´ıly: • nemus´ı b´ yt vˇzdy dostupné (uˇzivatel m˚ uˇze vyjmout SD kartu), • pˇr´ıstup k soubor˚ um nen´ı obvykle nijak omezen a kaˇzd´ y (uˇzivatel, jiná aplikace) je m˚ uˇze ˇc´ıst a mˇenit, • pˇri odinstalaci nejsou soubory vytvoˇrené aplikac´ı odstranˇeny. Popsané vlastnosti mohou b´ yt chápány jako v´ yhody i nev´ yhody, proto se kaˇzdé u ´loˇziˇstˇe hod´ı pro jin´ y typ dat. Na intern´ı u ´loˇziˇstˇe je vhodné ukládat data, ke kter´ ym chceme, aby pˇristupovala pouze naˇse aplikace a ostatn´ım aplikac´ım z˚ ustala skryté. Naopak vnˇejˇs´ı u ´loˇziˇstˇe je vhodné pro zpˇr´ıstupnˇen´ı dat uˇzivateli nebo jin´ ym aplikac´ım.

24


4.2.3


Datab´ aze SQLite

SQLite je Open Source databáze. Open Source znamená, ˇze software má otevˇren´ y zdrojov´ y kód (zdrojov´ y kód je volnˇe dostupn´ y). V´ıce informac´ı o SQLite je dostupn´ ych z http://www.sqlite.org/. SQLite databáze je souˇcást´ı operaˇcn´ıho systému Android a kaˇzdá aplikace ji m˚ uˇze vyuˇz´ıvat. Pro manipulaci s databáz´ı (vytváˇren´ı tabulek, dotaz˚ u atd.) je potˇreba vytvoˇrit tˇr´ıdu která dˇed´ı od tˇr´ıdy SQLiteOpenHelper. V této tˇr´ıdˇe je potˇreba pˇrekr´ yt metody onCreate() a onUpgrade(). Metoda onCreate() je automaticky volána pˇri vytvoˇren´ı databáze. V této metodˇe by mˇely b´ yt provedeny DDL pˇr´ıkazy jazyka SQL pro vytvoˇren´ı tabulek databáze. DDL (Data Definition Language) jsou pˇr´ıkazy pro vytváˇren´ı a upravován´ı struktury databáze. Pokud databáze neexistuje, je pˇri z´ıskán´ı reference na databázi metodou getWritableDatabase() nebo getReadableDatabase() zavolána metoda onCreate() a vytvoˇrena databáze. DML i DDL pˇr´ıkazy jazyka SQL, jsou provádˇeny pomoc´ı metod tˇr´ıdy SQLiteDatabase. DML (Data Manipulation Language) jsou pˇr´ıkazy jazyka SQL pro manipulaci s daty v databázi, napˇr. vkládán´ı, mazán´ı nebo zmˇena dat.

4.2.4

Zvolen´ y zp˚ usob pro uloˇ zen´ı dat

Sd´ılené preference budou v aplikaci pouˇzity pro uloˇzen´ı pomocn´ ych dat (napˇr. informace o aktuálnˇe ˇctené knize). Do soubor˚ u budou doˇcasnˇe ukládány staˇzené gamebooky pˇred t´ım neˇz budou zpracovány a importovány do databáze. Pro uloˇzen´ı gamebooku v aplikaci bude pouˇzita SQLite databáze. Jedn´ım z d˚ uvod˚ u pro pouˇzit´ı databáze k uloˇzen´ı gamebooku je struktura XML souboru, ve kterém je uloˇzen gamebook pˇri stahován´ı ze serveru (viz. kap. 3.4.1). Jednotlivé elementy XML souboru budou reprezentovat tabulky v databázi a atributy tˇechto element˚ u (popˇr. nˇekteré vnoˇrené elementy) budou tvoˇrit sloupce tabulek. Dalˇs´ım d˚ uvodem pro pouˇzit´ı databáze je, ˇze nen´ı potˇreba pˇri procházen´ı gamebooku naˇc´ıtat cel´ y soubor s gamebookem do pamˇeti. Pˇri procházen´ı gamebooku pak budou v pamˇeti naˇctena jen data, která jsou právˇe pouˇz´ıvána (napˇr. jen text k aktuáln´ımu stavu, ve kterém se hra nacház´ı). ER diagram znázorˇ nuj´ıc´ı strukturu databáze je vidˇet na obr. 4.4. D˚ uleˇzitou tabulkou databáze je tabulka Books, ve které jsou uloˇzeny informace o staˇzen´ ych gamebooc´ıch. Tabulka obsahuje informace, tj. jednotlivé sloupce o daném gamebooku jako je id knihy (gamebooku), název knihy, jméno autora, id poˇca´teˇcn´ıho stavu a dalˇs´ı. Primárn´ım kl´ıˇcem této tabulky je id knihy, coˇz je ˇc´ıslo, které je v celém vyv´ıjeném systému unikátn´ı a jednoznaˇcnˇe urˇcuje gamebook. Toto id je

25


Návrh UI

kl´ıˇcové, protoˇze je pouˇzito ve vˇetˇsinˇe ostatn´ıch tabulek jako ˇcást primárn´ıho kl´ıˇce. V tˇechto tabulkách je pouˇzit sloˇzen´ y primárn´ı kl´ıˇc a id knihy je jeho ˇca´st´ı. Napˇr´ıklad tabulka States nem˚ uˇze m´ıt jako primárn´ı kl´ıˇc pouze id stavu, protoˇze to je generováno lokálnˇe v editoru, a nen´ı tak globálnˇe unikátn´ı. Primárn´ım kl´ıˇcem tabulky States je id knihy a id stavu. Podobnˇe je vytvoˇren kl´ıˇc pro tabulky jednotliv´ ych akc´ı, kde je jeˇstˇe do primárn´ıho kl´ıˇce pˇridán sloupec s id akce. Z takto vytvoˇren´ ych kl´ıˇc˚ u je moˇzné vidˇet spojitost se strukturou XML souboru, kdy pro vytvoˇren´ı primárn´ıho kl´ıˇce tabulky (vytvoˇrené z vnoˇreného elementu) jsou pouˇzity primárn´ı kl´ıˇce nadˇrazen´ ych tabulek, tj. tabulek vytvoˇren´ ych z rodiˇcovsk´ ych element˚ u XML souboru.

Saved_Figure

Books

Saved_Games

Figure

Actions_Simple

Variables

Actions_Skill

States

Actions_Selector

Actions_Fight

Actions_Random

Actions_Variable

Actions_Counter Selectors Creatures Selections

Saved_Selectors

Counters

Obrázek 4.4: Zjednoduˇsen´ y ER diagram databáze

4.3

N´ avrh UI

V této kapitole bude popsán návrh UI (User Interface - uˇzivatelské rozhran´ı) a návrh fungován´ı aplikace z pohledu uˇzivatele. Uˇzivatelské rozhran´ı aplikac´ı na platformˇe Android je tvoˇreno tzv. aktivitami. Aktivitu si lze pˇredstavit jako jednu obrazovku 26


Návrh UI

aplikace. Mobiln´ı zaˇr´ızen´ı, která vyuˇz´ıvaj´ı operaˇcn´ı systém Android se velmi ˇcasto liˇs´ı velikost´ı obrazovky, napˇr. tablet a mobiln´ı telefon. Proto byla do Android API pˇridána moˇznost vyuˇz´ıvat tzv. fragmenty. Fragmenty se zpravidla pouˇz´ıvaj´ı jako ˇcást UI, kdy se uˇzivatelské rozhran´ı vytváˇr´ı podle velikosti obrazovky. Jednotlivé fragmenty se pak skládaj´ı podle potˇreby. Na zaˇr´ızen´ı s malou obrazovkou se zobraz´ı pouze jeden fragment, zat´ımco ve stejné aplikaci na zaˇr´ızen´ı s velkou obrazovkou jsou najednou zobrazeny dva fragmenty, coˇz velmi názornˇe ilustruje obr. 4.5 (pˇrevzat z [18]). Zaˇr´ızen´ı s velkou obrazovkou budou v tomto textu povaˇzována za zaˇr´ızen´ı, která jsou podle [18] oznaˇcena jako large (min. 640dp x 480dp) a xlarge (min. 960dp x 720dp). Jednotka dp (Density-independent pixel) pˇredstavuje virtua´ln´ı pixel obrazovky, kter´ y je nezávisl´ y na hustotˇe pixel˚ u dané obrazovky, detailnˇeji viz [18]. Kaˇzd´ y fragment mus´ı b´ yt um´ıstˇen v hostitelské aktivitˇe, ale aktivita m˚ uˇze existovat nezávisle na fragmentech.

Obrázek 4.5: Pouˇzit´ı fragment˚ u na zaˇr´ızen´ıch s r˚ uznou velikost´ı obrazovky

Velkou v´ yhodou pˇri v´ yvoji aplikace pro platformu Android je, ˇze dovoluje oddˇelit logiku aplikace (zdrojov´ y kód jazyka JAVA) od definice vzhledu aplikace. Vzhled aplikace se definuje v XML souboru, ve kterém jsou obsaˇzeny jednotlivé grafické komponenty. Tyto komponenty jsou reprezentovány jednotliv´ ymi elementy v XML souboru. Pˇri manipulaci s UI ve zdrojovém kódu jsou jednotlivé elementy reprezentovány tˇr´ıdami, které jsou potomky tˇr´ıdy View. UI je moˇzné definovat i programovˇe, ale takov´ y pˇr´ıstup nen´ı pˇr´ıliˇs ˇcast´ y, pouˇzije se napˇr. pˇri dynamickém vytváˇren´ı UI.

27


Návrh UI

Dále budou popsány základn´ı a nejd˚ uleˇzitˇejˇs´ı aktivity aplikace a jejich vlastnosti, tzn. co by mˇely umoˇzn ˇovat a jak by mˇely vypadat. Pˇri návrhu bude u nˇekter´ ych aktivit zohlednˇena i podpora zaˇr´ızen´ıch s vˇetˇs´ı velikost´ı obrazovky (tablety). Aktivity budou reprezentovány tˇr´ıdami, které jsou potomky tˇr´ıdy FragmentActivity. V implementaci nebudou dˇedit pˇr´ımo od tˇr´ıdy FragmentActivity, ale od tˇr´ıd z r˚ uzn´ ych knihoven tˇret´ıch stran, které dˇed´ı od FragmentActivity. Tyto knihovny budou popsány v kap. 5.

4.3.1

Aktivita MenuActivity

Tato aktivita bude slouˇzit jako menu, které bude zobrazeno po spuˇstˇen´ı aplikace. Aktivita by mˇela umoˇzn ˇovat snadn´ y pohyb v aplikaci, tj. pokraˇcovat v rozeˇcteném gamebooku, spustit nové procházen´ı, otevˇr´ıt knihovnu (viz kap. 4.3.3) a otevˇr´ıt nastaven´ı aplikace. Pro pˇrehlednost bude um´ıstˇena ˇca´st tlaˇc´ıtek (akc´ı) na hlavn´ı obrazovku a ˇca´st jich bude pˇresunuta do komponenty Action Bar, viz obr. 4.6.

4.3.2

Aktivita GameActivity

V této aktivitˇe bude prob´ıhat prohl´ıˇzen´ı (ˇcten´ı) gamebooku. Na obrazovce se zobraz´ı text, kter´ y bude rozdˇelen do stránek. Uˇzivateli bude umoˇznˇeno se mezi stránkami pohybovat táhnut´ım prstu po obrazovce. Poˇcet stránek a indikace aktuálnˇe zobrazované stránky bude reprezentována indikátorem na doln´ım okraji obrazovky, viz obr. 4.7. Na okraji obrazovky bude um´ıstˇeno tlaˇc´ıtko pro vysunut´ı nab´ıdky s akcemi, které je moˇzné provést. Nab´ıdka s akcemi a zobrazovan´ y text budou um´ıstˇeny do fragment˚ u, ale bude pouˇzita vˇzdy jen jedna aktivita. Na zaˇr´ızen´ıch s velkou obrazovkou a v reˇzimu landscape bude nab´ıdka vˇzdy zobrazena vedle textu, jinak se bude nab´ıdka vysouvat z pravého okraje obrazovky.

4.3.3

Aktivita LibraryActivity

Aktivita LibraryActivity reprezentuje knihovnu umoˇzn ˇuj´ıc´ı zobrazit seznam staˇzen´ ych a seznam dostupn´ ych gamebook˚ u, které je moˇzné stáhnout. Tato aktivita bude vyuˇz´ıvat fragmenty. Na velk´ ych obrazovkách v landscape orientaci obrazovky bude v této aktivitˇe zobrazen fragment se seznamem gamebook˚ u a vpravo bude um´ıstˇen fragment s detailem vybraného gamebooku (viz obr. 4.5). Na menˇs´ıch obrazovkách a na vˇsech obrazovkách v portrait orientaci bude nejprve zobrazen pouze fragment se seznamem a po kliknut´ı na dan´ y gamebook bude spuˇstˇena aktivita DetailBookActivity s detailn´ımi informacemi o gamebooku. Fragment s detailem gamebooku 28


Návrh UI

Obrázek 4.6: Grafick´ y návrh aktivity MenuActivity

Obrázek 4.7: Grafick´ y návrh aktivity GameActivity

bude obsahovat tlaˇc´ıtka pro staˇzen´ı, smazán´ı a vybrán´ı gamebooku v závislosti na tom, zda se zobrazuj´ı staˇzené gamebooky nebo gamebooky ke staˇzen´ı. Fragment bude také umoˇzn ˇovat hodnocen´ı gamebooku.

4.3.4

Ostatn´ı aktivity

V aplikaci budou také implementovány dalˇs´ı aktivity. Aktivita AboutActivity zobraz´ı obecné informace o programu. GameInitActivity bude urˇcena k nastaven´ı hry pˇred jej´ım zaˇcátkem. LoadingActivity bude aktivita, která bude spuˇstˇena jako prvn´ı aktivita aplikace a bude m´ıt za u ´kol naimportovat do databáze gamebooky distribuované s aplikac´ı a poté spustit MenuActivity. SettingsActivity bude umoˇzn ˇovat u ´pravu nastaven´ı aplikace. Ve WebLicenseActivity budou vyjmenovány pouˇzité knihovny tˇret´ıch stran a licence, pod kter´ ymi jsou distribuovány. Na obr. 4.8 je vidˇet UML diagram tˇr´ıd s aktivitami, fragmenty a dalˇs´ımi d˚ uleˇzit´ ymi tˇr´ıdami, které budou implementovány (neobsahuje vˇsechny tˇr´ıdy aplikace). Pro lepˇs´ı orientaci v diagramu maj´ı tˇr´ıdy aktivit zelené pozad´ı, fragmenty modré a ostatn´ı tˇr´ıdy ˇsedé pozad´ı.

29


4.3.5

Návrh UI

Pˇ r´ıprava grafick´ ych soubor˚ u

V aplikaci bude potˇreba pouˇz´ıt obrázky a jinou grafiku napˇr. jako pozad´ı nebo ikony. Proto byly vytvoˇreny obrázky, které budou ve v´ ysledném projektu uloˇzeny v adresáˇr´ıch /res/drawable, /res/drawable-hdpi, /res/drawable-mdpi, res/drawable-xhdpi. V adresáˇr´ıch se jmény /res/drawable-xxxx jsou uloˇzeny stejné obrázky, ale v r˚ uzn´ ych rozliˇsen´ıch, protoˇze jak jiˇz bylo zm´ınˇeno, platforma Android je pouˇz´ıvána na mnoha zaˇr´ızen´ıch s r˚ uznou velikost´ı a kvalitou (hustotou pixel˚ u) obrazovky. Z tohoto d˚ uvodu je potˇreba nˇekteré obrázky distribuovat ve v´ıce rozliˇsen´ıch a aˇz na konkrétn´ım zaˇr´ızen´ı dle velikosti obrazovky je rozhodnuto, jaké rozliˇsen´ı obrázku bude pouˇzito. LoadingWaveAnimation

AboutActivity

LoadingActivity

WebLicenseActivity

MenuActivity

SettingsActivity

BookImporter GameActivity «abstract» DBQueries DecisionListFragment

DBInsertQueries

«abstract» LibraryListFragment

DBSelectQueries

DetailBookFragment

GameInitActivity

DetailBookActivity

InternetListFragment

LocalListFragment

Obrázek 4.8: UML diagram tˇr´ıd aplikace 30

LibraryActivity

5 Realizace mobiln´ıho klienta V této kapitole bude popsána implementace mobiln´ıho klienta. Klient byl programován v Jazyce JAVA, coˇz je primárn´ı jazyk pro programován´ı na platformˇe Android. Nejniˇzˇs´ı verze platformy Android, na které lze aplikaci spustit je 2.3 (Gingerbread). Aplikace je lokalizována do anglického a ˇceského jazyka, ale gamebooky jsou zat´ım napsány pouze v ˇceském jazyce. K aplikaci je dostupná uˇzivatelská pˇr´ıruˇcka, která je um´ıstˇena v pˇr´ıloze A a zdrojové soubory aplikace jsou um´ıstˇeny na pˇriloˇzeném CD (viz pˇr´ıloha B). Pˇri implementaci jsem ˇcerpal z tˇechto zdroj˚ u: [1], [7], [8], [9] a [10]. Pˇri hledán´ı ˇreˇsen´ı problém˚ u jsem vyuˇz´ıval pˇredevˇs´ım [11]. Aplikace byla vytvoˇrena ve v´ yvojovém prostˇred´ı Eclipse s nainstalovan´ ym pluginem ADT (Android Development Tools). Pˇri implementaci bylo vyuˇz´ıváno verzovac´ıho systému Git.

5.1

Struktura aplikace

Zdrojové kódy aplikace jsou um´ıstˇeny v jednotliv´ ych bal´ıˇcc´ıch v adresáˇri /src. Tˇr´ıdy jsou rozdˇeleny do bal´ıˇck˚ u podle funkˇcnosti (typu) tˇr´ıdy, napˇr. aktivity jsou v samostatném bal´ıˇcku a fragmenty jsou také ve svém samostatném bal´ıˇcku, i kdyˇz spolu nemus´ı tˇr´ıdy v jednom bal´ıˇcku logicky souviset. Toto rozdˇelen´ı se ukázalo pˇri programován´ı jako velmi praktické pro orientaci pˇri vˇetˇs´ım poˇctu zdrojov´ ych soubor˚ u. V adresáˇri /assets je um´ıstˇen soubor licenses.html, kter´ y obsahuje seznam pouˇzit´ ych open-source knihoven a licence, pod kter´ ymi je moˇzné je pouˇz´ıvat. Dále je zde um´ıstˇen konfiguraˇcn´ı soubor logback.xml pro knihovnu logback-android, která je v projektu pouˇzita pro logován´ı, viz kap. 5.2.1. Adresáˇr také obsahuje soubory s pˇr´ıponou TTF, které popisuj´ı font p´ısma. Posledn´ı sloˇzkou, ve n´ıˇz programátor upravuje a pˇridává soubory je /res, zde jsou k nalezen´ı v jednotliv´ ych adresáˇr´ıch vˇsechny definice UI ve formˇe XML soubor˚ u, veˇskerá pouˇzitá grafika, textové ˇretˇezce a dalˇs´ı potˇrebné soubory (zdroje). V adresáˇri /res/raw jsou um´ıstˇeny soubory gamebook˚ u, které jsou distribuované spolu s aplikac´ı.

5.1.1

Soubor AndroidManifest.xml

Soubor AndroidManifest.xml mus´ı b´ yt obsaˇzen v kaˇzdé aplikaci pro platformu Android. Obsahuje vˇsechny d˚ uleˇzité informace o aplikaci - jako jsou komponenty aplikace (aktivity, sluˇzby, content providery atd.), podrobnˇejˇs´ı obsah viz [19]. D˚ u31

Realizace mobiln´ıho klienta

Pouˇzité knihovny

leˇzit´ y je element uses-sdk, do kterého se zap´ıˇse ˇc´ıslo minimáln´ı verze platformy ˇ ıslo oznaˇcuje API pro daAndroid, pro kterou je aplikace urˇcena, zde verze devˇet. C´ nou verzi Androidu. Dev´ıtka znamená verzi 2.3 (Gingerbread). Dalˇs´ım d˚ uleˇzit´ ym elementem je element uses-permission, kter´ y oznaˇcuje, jaká oprávnˇen´ı aplikace vyˇzaduje. Mobiln´ı klient vyˇzaduje tato oprávnˇen´ı: 1. pˇr´ıstup k internetu - android.permission.INTERNET, 2. zápis do extern´ıho u ´loˇziˇstˇe - android.permission.WRITE_EXTERNAL_STORAGE, 3. zjiˇstˇen´ı stavu s´ıtˇe - android.permission.ACCESS_NETWORK_STATE.

5.2

Pouˇ zit´ e knihovny

Pro rychlejˇs´ı a snadnˇejˇs´ı implementaci nˇekter´ ych funkˇcnost´ı a zpˇetnou kompatibilitu aplikace na starˇs´ıch verz´ıch Androidu, konkrétnˇe verze 2.3 - 2.3.7, bylo vyuˇzito knihoven tˇret´ıch stran. V této kapitole nebudou popisovány knihovny, které jsou souˇcást´ı Android Open Source Project [3]. Pro pˇrehlednost jsou stránky, ze kter´ ych jsou knihovny dostupné, um´ıstˇeny v tab. C.1 v pˇr´ıloze C. Knihovny ActionBarSherlock a Nine Old Androids jsou od prosince 2014 deprecated a nebudou sv´ ymi autory dále vyv´ıjeny a udrˇzovány (pˇri zahájen´ı v´ yvoje nebyly deprecated).

5.2.1

Knihovna logback-android

Knihovna logback-android je vyuˇz´ıvána pro logován´ı a umoˇzn ˇuje pokroˇcilejˇs´ı nastaven´ı logovac´ıch zpráv oproti nativn´ımu logován´ı pomoc´ı tˇr´ıdy android.util.Log z Android API. Knihovna je upravenou verz´ı knihovny logback, která je vytvoˇrena tv˚ urci populárn´ı knihovny log4j. Pro pouˇzit´ı je potˇreba stáhnout JAR soubory knihoven (logback a logback-android) a pˇridat je k projektu. V adresáˇri /assets/ vytvoˇrit soubor se jménem logback.xml, ve kterém je konfigurace logován´ı (v´ ystup log˚ u, vzor log˚ u atd.). Do tˇr´ıdy, ve které chceme pouˇz´ıt logován´ı, pak jednoduˇse vloˇz´ıme kód 5.1 a logovac´ı zprávu pak zap´ıˇseme pomoc´ı kódu 5.2. static private final Logger logger = LoggerFactory.getLogger(Trida.class); Ukázka kódu 5.1: Vytvoˇren´ı statické promˇenné loger pro logován´ı

32


Pouˇzité knihovny

logger.debug("Obsah logovaci zpravy"); Ukázka kódu 5.2: Zapsán´ı logovac´ı zprávy

5.2.2

Knihovna ActionBarSherlock

Knihovna je rozˇs´ıˇren´ım Support Library z [3], ale nen´ı jej´ı souˇcást´ı. Knihovna je urˇcena k tomu, aby bylo moˇzné v aplikaci pouˇz´ıt komponentu Action Bar jiˇz od verze 2.x a v´ yˇse, protoˇze Action Bar byl pˇridán aˇz ve verzi 3.0. Knihovna automaticky pouˇzije nativn´ı implementaci Action Baru na zaˇr´ızen´ıch s verz´ı 4.0 nebo vyˇsˇs´ı. Pro pˇredeˇslé verze, které neobsahuj´ı Action Bar pouˇzije vlastn´ı implementaci zaloˇzenou na zdrojov´ ych souborech verze 4.x. Knihovna je vyuˇzita ve vˇsech aktivitách aplikace. Implementace aktivity s touto knihovnou pak prob´ıhá tak, ˇze aktivita dˇed´ı od tˇr´ıdy SherlockActivity nebo SherlockFragmentActivity. Pro z´ıskán´ı instance ActionBar se pouˇzije metoda getSupportActionBar(). S touto instanc´ı je pak moˇzné provádˇet u ´pravy a nastaven´ı Action Baru.

5.2.3

Knihovna Nine Old Androids

Tato knihovna umoˇzn ˇuje pouˇz´ıt nové API pro animace zavedené ve verzi 3.0, na vˇsech verz´ıch platformy Android, tzn. od verze 1.0. V aplikaci je vyuˇzita tˇr´ıdou LoadingWaveAnimation, která vytváˇr´ı animaci pˇri spuˇstˇen´ı aplikace.

5.2.4

Knihovna ViewPagerIndicator

Knihovna se pouˇz´ıvá spoleˇcnˇe s tˇr´ıdou (layoutem) ViewPager, která umoˇzn ˇuje uˇzivateli pohybovat se mezi v´ıce obrazovkami v jedné aktivitˇe. ViewPagerIndicator zobrazuje, na jaké obrazovce se uˇzivatel nacház´ı. V aplikaci je této vlastnosti vyuˇzito v aktivitˇe GameActivity, kde indikuje aktuáln´ı stránku a poˇcet stránek, viz obr. 5.1.

5.2.5

Knihovna SlidingMenu

Knihovna umoˇzn ˇuje snadnou implementaci vysouvac´ı nab´ıdky z okraje obrazovky, která je v aplikaci pouˇzita a obsahuje nab´ıdku s akcemi, mezi kter´ ymi se uˇzivatel pˇri procházen´ı gamebooku rozhoduje, viz obr. 5.2.

33


Implementace SQLite databáze

Obrázek 5.1: Ukázka hern´ı obrazovky s pouˇzit´ım ViewPagerIndicator

Obrázek 5.2: Ukázka nab´ıdky akc´ı implementované pomoc´ı SlidingMenu

V aplikaci dˇed´ı aktivita GameActivity od tˇr´ıdy SlidingFragmentActivity. Pˇri vytváˇren´ı aktivity je v metodˇe onCreate() zavolána metoda initSlidingMenu() a je z´ıskána reference na instanci SlidingMenu, která reprezentuje nab´ıdku. V initSlidingMenu() je nab´ıdce nastaven layout decision _fragment_view.xml a jsou provedena dalˇs´ı nastaven´ı. Pokud je zaˇr´ızen´ı v landscape orientaci a velikost obrazovky je large, nen´ı vysouvac´ı nab´ıdka pouˇzita a nab´ıdka je nahrazena klasick´ ym fragmentem.

5.3

Implementace SQLite datab´ aze

Pro uloˇzen´ı gamebook˚ u je v aplikaci implementovaná SQLite databáze. Do databáze se ukládaj´ı i informace o rozehran´ ych hrách. Struktura databáze je implementována podle návrhu ER diagramu z kap. 4.2.4, viz obr. 4.4. Databáze je vytváˇrena pˇri prvn´ım spuˇstˇen´ı aplikace a manipulace s daty databáze se provád´ı pomoc´ı potomk˚ u abstraktn´ı tˇr´ıdy DBQueries.

34


5.3.1

Uˇzivatelské funkce

Vytvoˇ ren´ı datab´ aze

Databáze je vytváˇrena pˇri prvn´ım spuˇstˇen´ı aplikace pomoc´ı kódu 5.3 v metodˇe onCreate() tˇr´ıdy GameBookApplication, která dˇed´ı od tˇr´ıdy Application. Tato tˇr´ıda je inicializována pˇri vytváˇren´ı procesu aplikace. //z´ ısk´ an´ ı tˇ rı ´dy, kter´ a slouˇ zı ´ pro komunikaci s datab´ az´ ı GameBookDataBaseHelper ghp = GameBookDataBaseHelper. getInstance(this.getApplicationContext()); //z´ ısk´ an´ ı reference na databazi ˇ cı ´mˇ z dojde k jej´ ımu vytvoˇ ren´ ı ghp.getWritableDatabase(); Ukázka kódu 5.3: Vytvoˇren´ı databáze ve tˇr´ıdˇe GameBookApplication Tˇr´ıda GameBookDataBaseHelper dˇed´ı od tˇr´ıdy SQLiteOpenHelper a je implementována podle návrhového vzoru jedináˇcek (Singleton). Návrhov´ y vzor jedináˇcek byl pouˇzit pro usnadnˇen´ı správy instance databáze, protoˇze v poˇcátku v´ yvoje docházelo pˇri pˇr´ıstupu z v´ıce instanc´ı k problém˚ um s databáz´ı, napˇr. soubˇeˇzn´ ym pˇr´ıstupem z r˚ uzn´ ych vláken. Tˇr´ıda pˇrepisuje metodu onCreate(), která je automaticky volána pˇri vytváˇren´ı databáze (kdyˇz neexistuje). V metodˇe jsou provedeny jednotlivé DDL pˇr´ıkazy jazyka SQL vytváˇrej´ıc´ı tabulky. Tˇr´ıda obsahuje veˇskeré ˇretˇezce potˇrebné k sestaven´ı pˇr´ıkazu pro vytvoˇren´ı databáze. Tˇr´ıdu vyuˇz´ıvaj´ı pˇredevˇs´ım tˇr´ıdy, které dˇed´ı od DBQueries a manipuluj´ı s daty databáze.

5.3.2

Pˇ r´ıstup k dat˚ um

Pˇr´ıstup k dat˚ um je implementován tˇr´ıdami, které dˇed´ı od abstraktn´ı tˇr´ıdy DBQueries, jedná se o: DBSelectQueries, DBInsertQueries, DBUpdateQueries a DBDeleteQueries. Tˇr´ıdy obsahuj´ı protected promˇenou tˇr´ıdy GameBookDataBaseHelper, pomoc´ı n´ıˇz otevˇrou databázi a z´ıskaj´ı instanci databáze. S touto instanc´ı a volán´ım metody query() provádˇej´ı jednotlivé dotazy do databáze.

5.4

Uˇ zivatelsk´ e funkce

Mobiln´ı klient obsahuje funkcionalitu popsanou v kap. 3.3, tj. procházen´ı gamebooku, staˇzen´ı gamebooku a nˇekteré dalˇs´ı funkce. V této kapitole bude popsána implementace tˇechto funkc´ı.

35


5.4.1


Import gamebook˚ u

Import gamebook˚ u do databáze implementuje tˇr´ıda BookImporter. Import gamebooku je rozdˇelen na tyto dvˇe ˇca´sti: 1. zpracován´ı souboru typu XML parserem, 2. zapsán´ı zpracovaného gamebooku do databáze. Parsován´ı (zpracován´ı) XML souboru s gamebookem zajiˇst’uje metoda nactiZeSouboruV2_02() tˇr´ıdy libFiles ze sd´ılené knihovny, která vrac´ı instanci tˇr´ıdy Graph<Stav>. V této instanci je obsaˇzen cel´ y gamebook, reprezentovan´ y jednotliv´ ymi tˇr´ıdami ze sd´ılené knihovny. Parser je implementován jako DOM parser. DOM (Document Object Model) parser nejprve naˇcte cel´ y XML soubor do pamˇeti a vytvoˇr´ı z nˇej stromovou strukturu, ke které se pak pˇristupuje. Stejn´ y parser vyuˇz´ıvá i editor (program pro tvorbu gamebook˚ u). V poˇca´tku v´ yvoje byl pro mobiln´ıho klienta vyuˇz´ıván samostatn´ y SAX parser, ale pˇri kaˇzdé zmˇenˇe struktury XML souboru s gamebookem musely b´ yt upraveny oba parsery. I pˇresto, ˇze je DOM parser pamˇet’ovˇe nároˇcnˇejˇs´ı, na v´ ykonu aplikace se to neprojevilo. SAX (Simple API for XML) parser zpracovává XML dokument proudovˇe, tzn. ˇze nen´ı moˇzné se vracet k jiˇz zpracovan´ ym ˇcástem souboru a v pamˇeti je uloˇzena pouze ˇca´st XML souboru. V projektu je stále uchovávána p˚ uvodn´ı verze SAX parseru (tˇr´ıda XMLPullBookParser) pro pˇr´ıpad, ˇze by v budoucnu z d˚ uvodu v´ ykonnosti bylo potˇreba tento parser znovu pouˇz´ıt. Zapsán´ı gamebooku do databáze je následnˇe provedeno ve tˇr´ıdˇe DBInsertQueries zavolán´ım metody writeWholeBook(). Zápis gamebooku je proveden jako jedna transakce, tzn. pokud by doˇslo k chybˇe pˇri zápisu nˇejaké ˇcásti, gamebook nebude zapsán, t´ım je zajiˇstˇeno, ˇze v databázi bude vˇzdy cel´ y gamebook.

5.4.2

Proch´ azen´ı gamebooku

Procházen´ı gamebooku je umoˇznˇeno uˇzivateli v aktivitˇe GameActivity. V metodˇe onCreate() je pˇri vytváˇren´ı aktivity provedeno naˇcten´ı rozehrané hry z databáze a sd´ılen´ ych preferenc´ı, pˇr´ıpadnˇe je spuˇstˇena aktivita GameInitActivity, ve které uˇzivatel provede základn´ı nastaven´ı hry. Vyhodnocován´ı akc´ı, které si uˇzivatel vyb´ırá z vysouvac´ı nab´ıdky, viz obr. 5.2, prob´ıhá ve tˇr´ıdˇe Simulator ze sd´ılené knihovny. Pˇri vytváˇren´ı objektu simulátoru je pˇredáno id gamebooku, aktuáln´ı id stavu, instance hráˇce (tˇr´ıda Postava) a dvˇe rozhran´ı IGraphDataAccessible a IActionDisplayable. IGraphDataAccessible obsahuje metody, které vracej´ı data o gamebooku. Metody druhého rozhran´ı jsou 36



volány po vyhodnocen´ı vybrané akce a maj´ı uˇzivateli zobrazit v´ ysledek akce (napˇr. zobrazen´ı nového textu), toto rozhran´ı implementuje GameActivity. IGraphDataAccessible implementuje tˇr´ıda DBSelectQueries. Protoˇze tˇr´ıda simulátoru je vyuˇz´ıvána také v editoru, jsou pouˇzita rozhran´ı. Rozhran´ı umoˇzn ˇuj´ı pˇristupovat k dat˚ um a zobrazovat prohl´ıˇzen´ı gamebooku nezávisle na aplikaci, tzn. umoˇzn ˇuj´ı pouˇzit´ı tˇr´ıdy simulátoru v mobiln´ım klientovi i v editoru. Po kliknut´ı uˇzivatele na vybranou akci ze seznamu, kter´ y je implementován fragmentem DecisionListFragment, je zavolána metoda executeAction() instance simulátoru. Zde je akce vyhodnocena a zavolána jedna z metod rozhran´ı IActionDisplayable, kterou implementuje GameActivity. V pˇr´ıpadˇe typu akc´ı AkceNahoda a AkceDovednost, je vrácena i instance tˇr´ıdy AkceVyhodnoceni, která obsahuje detailnˇejˇs´ı informace o v´ ysledku. Tyto informace jsou pak pouˇzity a uˇzivateli jsou zobrazeny kostky (viz obr. 5.3), které pˇredstavuj´ı náhodu. Stiskem a drˇzen´ım obrázku kostek se spust´ı animace hodu kostkami. Po skonˇcen´ı animace je uˇzivateli zobrazen v´ ysledek hodu, kter´ y byl spoˇc´ıtán z pˇredan´ ych informac´ı. Pˇri vyhodnocen´ı akce AkceBoj je uˇzivateli pouze zobrazen dialog s v´ ysledkem boje.

Obrázek 5.3: Ukázka zobrazen´ı hodu kostkou

Obrázek 5.4: v knihovnˇe

37

Ukázka

obrazovky


5.4.3

S´ıt’ová komunikace

Knihovna

V knihovnˇe jsou uˇzivateli zobrazeny gamebooky dostupné ke staˇzen´ı i gamebooky, které jiˇz má v zaˇr´ızen´ı staˇzené, viz obr. 5.4. V aktivitˇe LibraryActivity jsou obsaˇzeny dvˇe záloˇzky se seznamy gamebook˚ u, tj. dostupn´ ych ke staˇzen´ı a jiˇz staˇzen´ ych. Po kliknut´ı na dan´ y gamebook je zobrazen jeho detail fragmentem DetailBookFragment, kde je moˇzné tento gamebook stáhnout, smazat nebo vybrat pro hran´ı v závislosti na tom, z jaké záloˇzky byl gamebook vybrán. Na zaˇr´ızen´ı s velkou obrazovkou je detail gamebooku zobrazen vedle seznamu. Na zaˇr´ızen´ı s malou obrazovkou a v reˇzimu portrait je spuˇstˇena nová aktivita DetailBookActivity.

5.5

S´ıt’ov´ a komunikace

Aplikace vyuˇz´ıvá pro s´ıt’ovou komunikaci knihovnu Volley a pro stahován´ı gamebooku systémovou sluˇzbu DownloadManager. Aplikace provád´ı s´ıt’ové operace popsané v kapitole 4.1. Dále bude popsána jejich implementace.

5.5.1

Implementace knihovny Volley

Pro vyuˇz´ıván´ı knihovny Volley byla implementována tˇr´ıda VolleySingleton podle návrhového vzoru jedináˇcek (Singleton) a tˇr´ıda RequestFactory. Tˇr´ıda RequestFactory obsahuje metody pro vytváˇren´ı poˇzadavk˚ u na s´ıt’ové operace (seznam a hodnocen´ı gamebook˚ u) reprezentované instancemi tˇr´ıdy StringRequest. Pˇri vytváˇren´ı poˇzadavku jsou pˇredávány instance tˇr´ıd Response.Listener (´ uspˇech) a Response.ErrorListener (ne´ uspˇech), jejichˇz metody jsou po dokonˇcen´ı zavolány v závislosti na v´ ysledku dotazu. Tˇr´ıda VolleySingleton pˇridává vytvoˇrené poˇzadavky do fronty, ze které jsou automaticky vyb´ırány a asynchronnˇe zpracovávány. V´ ybˇer a zpracován´ı poˇzadavku je provádˇen knihovnou Volley a programátor ho nemus´ı ˇreˇsit.

5.5.2

Z´ısk´ an´ı seznamu dostupn´ ych gamebook˚ u

Z´ıskán´ı seznamu dostupn´ ych gamebook˚ u vyuˇz´ıvá fragment InternetListFragment, kter´ y tento seznam také zobraz´ı. Fragment dˇed´ı od abstraktn´ı tˇr´ıdy LibraryListFragment a implementuje metodu fillList(), ve které prob´ıhá zaslán´ı poˇzadavku na server o seznam dostupn´ ych gamebook˚ u.

38


S´ıt’ová komunikace

Nejprve je zkontrolována dostupnost s´ıtˇe, poté je tˇr´ıdou URLFactory vygenerována URL adresa, kde je dostupn´ y seznam gamebook˚ u. URL (Uniform Resource Locator) je ˇretˇezec, kter´ y jednoznaˇcnˇe urˇcuje um´ıstˇen´ı (adresu) zdroje dostupného na internetu. Následnˇe se zjist´ı, zda poˇzadavek na danou URL adresu nen´ı uloˇzen v pamˇeti, viz 5.4. Pokud ano, je zpracován a zobrazen seznam, jinak je vytvoˇren poˇzadavek, kter´ y je pˇridán do fronty tˇr´ıdou VolleySingleton a následnˇe zpracován. // Vygenerov´ an´ ı url pro seznam String url = URLFactory.generateURL4bookReqMalPal(); // Z´ ısk´ an´ ı cache pamˇ eti Cache cache = VolleySingleton.getInstance(getActivity()). getRequestQueue().getCache(); // Z´ ısk´ an´ ı z´ aznamu pro danou url adresu Entry entry = cache.get(url); if(entry != null){ // Zpracovan´ ı z´ aznamu z cache pamˇ eti Ukázka kódu 5.4: Vytvoˇren´ı databáze ve tˇr´ıdˇe GameBookApplication Pˇri pˇridáván´ı poˇzadavku do fronty jsou také pˇredány reference na objekty tˇr´ıd, ve kter´ ych je zpracována pˇrijatá odpovˇed’ a pˇri u ´spˇeˇsném pˇrijet´ı zprávy je zobrazen seznam gamebook˚ u, které je moˇzné stáhnout. Pˇrijat´ y seznam je odfiltrován a jsou zobrazeny pouze gamebooky, které jeˇstˇe nejsou staˇzeny.

5.5.3

Staˇ zen´ı gamebooku

Staˇzen´ı gamebooku je implementováno ve fragmentu DetailBookFragment a je implementováno s vyuˇzit´ım systémové sluˇzby DownloadManager. Staˇzen´ı prob´ıhá na stejném principu jako u knihovny Volley, nejdˇr´ıve je vytvoˇrena adresa pro staˇzen´ı a poˇzadavek, viz 5.5. Dále je poˇzadavku nastaveno kam má b´ yt soubor s gamebookem uloˇzen a nakonec je poˇzadavek zaˇrazen do fronty pro staˇzen´ı (zaˇcne stahován´ı). Pˇri z´ıskáván´ı instance DownloadManageru je registrován BroadcastReceiver, kter´ y reaguje na zprávy zaslané DownloadManagerem. Zpracován´ım tˇechto zpráv fragment reaguje na v´ ysledek dokonˇcen´ı stahován´ı, at’ jiˇz u ´spˇeˇsn´ y nebo ne´ uspˇeˇsn´ y. Po u ´spˇeˇsném dokonˇcen´ı je uloˇzen´ y gamebook importován do databáze a soubor smazán. Pokud uˇzivatel bˇehem stahován´ı opust´ı DetailBookFragment, je BroadcastReceiver odregistrován a nen´ı tedy moˇzné reagovat na zprávy od DownloadManageru, ale stahován´ı pokraˇcuje automaticky dále. Po dokonˇcen´ı stahován´ı nen´ı gamebook, v tomto pˇr´ıpadˇe automaticky importován do databáze, ale je jen staˇzen a uloˇzen. Pro import je potˇreba, aby se uˇzivatel znovu dostal do fragmentu s dan´ ym gamebookem. Pˇri vytváˇren´ı fragmentu je kontrolováno, zda nen´ı soubor s gamebookem 39


Nastaven´ı aplikace

jiˇz staˇzen. Pokud je soubor uˇz staˇzen´ y, potom je gamebook automaticky importován do databáze. // Vytvoˇ ren´ ı adresy podle id a jazyka poˇ zadovan´ e knihy Uri uri = Uri.parse(URLFactory.generatURL4DownloadBook(book.id, book.language)); // Vytvoˇ ren´ ı poˇ zadavku DownloadManager.Request request = new DownloadManager.Request(uri); Ukázka kódu 5.5: Vytvoˇren´ı poˇzadavku pro staˇzen´ı gamebooku

5.5.4

Hodnocen´ı gamebooku

Hodnocen´ı gamebooku prob´ıhá ve fragmentu DetailBookFragment. Odeslán´ı hodnocen´ı se provád´ı v metodˇe onRating(). Odeslán´ı prob´ıhá podobnˇe jako staˇzen´ı seznamu dostupn´ ych gamebook˚ u. Nejprve je vygenerována URL adresa na základˇe id hodnoceného gamebooku a vytvoˇren poˇzadavek (instance tˇr´ıdy StringRequest). Následnˇe je poˇzadavek opˇet pˇridán do fronty poˇzadavk˚ u tˇr´ıdou VolleySingleton, ze které je vybrán a zpracován.

5.6


Aplikace umoˇzn ˇuje uˇzivateli provést tato nastaven´ı: • pouˇz´ıvat kostku pˇri procházen´ı gamebooku, tzn. nechat uˇzivatele házet kostkou (zobrazit animaci), pˇri vypnut´ı nen´ı uˇzivateli animace zobrazena a je pˇr´ımo poslán do pˇr´ısluˇsného stavu, • zmˇenit font p´ısma, • nastavit základn´ı velikost p´ısma pˇri startu nové hry, • moˇznost zobrazen´ı ˇsipky (tlaˇc´ıtka) na hern´ı obrazovce pro vysunut´ı menu s nab´ıdkou. Implementace nastaven´ı je obsaˇzena v aktivitˇe SettingsActivity, která dˇed´ı od tˇr´ıdy SherlockPreferenceActivity. Z d˚ uvodu kompatibility pro zaˇr´ızen´ı s verz´ı niˇzˇs´ı neˇz 3.0 je UI s nastaven´ımi vkládáno pˇr´ımo do aktivity. Pro zaˇr´ızen´ı od verze 3.0 je pouˇzit fragment, jenˇz je reprezentován statickou vnitˇrn´ı tˇr´ıdou PrefsFragment, která dˇed´ı od tˇr´ıdy PreferenceFragment. Implementace nastaven´ı nen´ı d´ıky 40



Android API sloˇzitá. Je tˇreba vytvoˇrit XML soubor ve adresáˇri /res/xml s definic´ı dostupn´ ych nastaven´ı. Následnˇe v aktivitˇe nebo fragmentu, kter´ y dˇed´ı od pˇr´ısluˇsného rodiˇce a umoˇzn ˇuje implementaci nastaven´ı, pˇridat tento XML soubor volán´ım metody addPreferencesFromResource(). Systém automaticky zaznamenává vybrané poloˇzky uˇzivatelem a ukládá je. Kaˇzdá poloˇzka definovaná v XML souboru má sv˚ uj unikátn´ı kl´ıˇc, atribut android:key, pod t´ımto kl´ıˇcem je následnˇe nastavená hodnota pˇr´ıstupná kdekoliv v aplikaci, viz 5.6. Kl´ıˇce jsou uloˇzeny ve tˇr´ıdˇe PrefTags. Pro v´ ybˇer základn´ı velikosti fontu bylo potˇreba implementovat tˇr´ıdu NumberPickerPrefDialog, která umoˇzn ˇuje vybrat ˇc´ıslo. // Z´ ısk´ an´ ı instance pro pˇ r´ ıstup k nastaven´ ı SharedPreferences settingsPref = PreferenceManager.getDefaultSharedPreferences(this); /*Z´ ısk´ an´ ı konkr´ etn´ ı hodnoty pod kl´ ıc ˇem (String) prefKey, pokud hodnota nen´ ı nalezena bude vr´ acena hodnota defValue */ int value = settingsPref.getInt(prefKey, defValue); Ukázka kódu 5.6: Z´ıskán´ı hodnoty z nastaven´ı aplikace

41

6 Testován´ı Pro ovˇeˇren´ı funkcionality vytvoˇrené aplikace bylo provedeno testován´ı na vybran´ ych mobiln´ıch telefonech a tabletu. Aplikace byla testována na zaˇr´ızen´ıch, která jsou uvedena v tab. 6.1. V tabulce je vˇzdy uveden název zaˇr´ızen´ı, verze Androidu a rozliˇsen´ı jeho obrazovky. Testován´ı prob´ıhalo na reáln´ ych i na virtualizovan´ ych zaˇr´ızen´ıch. Virtualizovan´ ym zaˇr´ızen´ım je myˇslen emulátor zaˇr´ızen´ı, kter´ y emuluje dané zaˇr´ızen´ı s operaˇcn´ım systémem Android. Testován´ı bylo provádˇeno autorem práce, ale i uˇzivateli, kteˇr´ı se s aplikac´ı setkali poprvé. Zaˇ r´ızen´ı

Verze

Samsung S6500 Galaxy Mini II HTC One V Sony Xperia M Dual Custom Tablet (virtualizace) Samsung Galaxy S2 (virtualizace) LG P710 LG Optimus L3 II (virtualizace) Samsung Nexus S Samsung S5690 Galaxy Xcover

2.3.6 4.0.3 4.3 5.0.0 4.1.1 4.1.2 4.1.1 4.1.2 2.3.6

Rozliˇ sen´ı obrazovky v px 480 800 854 2560 800 800 320 800 480

x x x x x x x x x

320 480 480 1600 480 480 240 480 320

Tabulka 6.1: Zaˇr´ızen´ı, na kter´ ych byla aplikace testována

6.1

Pr˚ ubˇ eh testov´ an´ı

Aplikace byla pˇri v´ yvoji pr˚ ubˇeˇznˇe testována autorem. Pro zápis log˚ u byla pouˇzita knihovna logback-android, která umoˇzn ˇovala pokroˇcilejˇs´ı nastaven´ı logovac´ıch zpráv (formát, v´ ystup). Testeˇri (bˇeˇzn´ı uˇzivatelé) dostali jiˇz hotovou aplikaci a mˇeli za u ´kol aplikaci prozkoumat a vyzkouˇset vˇsechny funkce aplikace nebo alespoˇ n ty nejd˚ uleˇzitˇejˇs´ı, mezi které patˇr´ı: • procházen´ı gamebooku, • zmˇena velikosti p´ısma, • hod kostkami, • pˇrechod mezi jednotliv´ ymi obrazovkami textu, 42

Testován´ı

Testován´ı nestandardn´ıch událost´ı

• staˇzen´ı nového gamebooku, • vybrán´ı a prohl´ıˇzen´ı staˇzeného gamebooku, • hodnocen´ı gamebooku.

6.2

Testov´ an´ı nestandardn´ıch ud´ alost´ı

Dále bylo na vybran´ ych zaˇr´ızen´ıch provedeno nˇekolik test˚ u, ve kter´ ych byla aplikace vystavena nestandardn´ım situac´ım, tzn. takov´ ym situac´ım, které mohou nastat nezávisle na aplikaci pˇri jej´ım pouˇz´ıván´ı. Mezi tyto testované situace pˇri pouˇz´ıván´ı aplikace patˇr´ı: • pˇrijet´ı SMS (Short Message Service) zprávy, • pˇr´ıchoz´ı hovor, • fungován´ı aplikace pˇri nedostupné s´ıti, • smazán´ı lokáln´ıch dat aplikace a jej´ı nové spuˇstˇen´ı.

6.3

V´ ysledky testov´ an´ı

Pˇri testován´ı bylo uˇzivateli zjiˇstˇeno, ˇze pˇri zmˇenˇe orientace obrazovky v seznamu gamebook˚ u, které je moˇzné stáhnout, docházelo k pádu aplikace z d˚ uvodu neinicializované reference na objekt a vyvolán´ı v´ yjimky NullPointerException. Problém byl vyˇreˇsen otestován´ım reference na hodnotu null pˇred jeho pouˇzit´ım. Druh´ ym zjiˇstˇen´ ym problémem bylo nezobrazen´ı seznamu staˇziteln´ ych gamebook˚ u pˇri pomalém pˇripojen´ı k internetu. Rychlost internetu byla v zaˇr´ızen´ı omezena operátorem po vyˇcerpán´ı limitu. I kdyˇz pˇripojen´ı fungovalo, knihovna Volley nedokázala poˇzadavek zpracovat a v´ ysledek vyhodnotila jako nepodaˇren´ y (zavolána metoda pro obsluhu v´ ysledku, kter´ y skonˇcil chybou). Uˇzivateli pak byl zobrazen prázdn´ y seznam. Tento problém se projevil pouze u jednoho testovaného zaˇr´ızen´ı, ale ne vˇzdy, po v´ıce pokusech se seznam podaˇrilo stáhnout. Takové chován´ı aplikace nen´ı moˇzné jednoduˇse ovlivnit, protoˇze poˇzadavek zpracovává knihovna. V pˇr´ıpadˇe ne´ uspˇechu je proto uˇzivatel pouze informován, aby se pokusil znovu obnovit seznam pomoc´ı akce v Action Baru. Jiné závaˇzné problémy objeveny nebyly. Testeˇri mˇeli pouze pˇripom´ınky k UI, ale tyto pˇripom´ınky lze povaˇzovat za subjektivn´ı, protoˇze se liˇsily. Lze

43

Testován´ı

Moˇzná rozˇs´ıˇren´ı

oˇcekávat, ˇze po dlouhodobˇejˇs´ım pouˇz´ıván´ı aplikace (po jej´ı distribuci) se na základˇe reakc´ı uˇzivatel˚ u ukáˇze, které ˇcásti UI by mˇely b´ yt optimalizovány. Z v´ ykonnostn´ıho hlediska nebyl testery nalezen ˇza´dn´ y závaˇzn´ y problém. Aplikace fungovala bez problém˚ u s plynulost´ı zobrazen´ı. Pouze pˇri testován´ı aplikace na tabletu, kter´ y byl virtualizovan´ y, aplikace nefungovala zcela plynule, ale to bylo zp˚ usobeno velk´ ymi systémov´ ymi nároky na virtualizaci zaˇr´ızen´ı. Obdobné problémy maj´ı na tomto zaˇr´ızen´ı i jiné aplikace.

6.3.1

Nestandardn´ı ud´ alosti

Pˇri testován´ı nestandardn´ıch událost´ı nebyl nalezen ˇza´dn´ y problém. Aplikace zvládala vˇsechny situaci uvedené v kapitole 6.2. Pˇr´ıchoz´ı hovor je moˇzné pˇrijmout a po jeho skonˇcen´ı je aplikace vrácena do popˇred´ı. Aplikace nepotˇrebuje stálé pˇripojen´ı k s´ıti, pouze pˇri stahován´ı gamebooku nebo seznamu dostupn´ ych gamebook˚ u. Pokud uˇzivatel chce zobrazit seznam staˇziteln´ ych gamebook˚ u a nen´ı dostupná s´ıt’, je o tom informován dialogem. Pokud dojde k v´ ypadku spojen´ı bˇehem stahován´ı gamebooku, tak tento problém ˇreˇs´ı sama systémová sluˇzba DownloadManager. Pˇri smazán´ı lokán´ıch dat jsou smazány vˇsechny staˇzené knihy a veˇsker´ y postup ve hˇre, ale po opˇetovném spuˇstˇen´ı aplikace je znovu vytvoˇrena databáze a naimportovány gamebooky distribuované s aplikac´ı a aplikace m˚ uˇze opˇet fungovat.

6.4

Moˇ zn´ a rozˇ s´ıˇ ren´ı

Aplikace samozˇrejmˇe obsahuje ˇca´sti, které je moˇzné dále rozˇsiˇrovat a vylepˇsovat. K implementované funkcionalitˇe by mohla b´ yt pˇridána i nová funkcionalita (a v budoucnu by i mˇela b´ yt pˇridána). Mezi moˇzná rozˇs´ıˇren´ı, která by mohla b´ yt implementována patˇr´ı: • filtrován´ı gamebook˚ u, které je moˇzné stáhnout (podle jazyka, ˇzánru atd.), • ozvuˇcen´ı aplikace, • pˇridán´ı obrázk˚ u, které souvis´ı s pˇr´ıbˇehem gamebooku pˇr´ımo do textu, • propojen´ı aplikace se sociáln´ımi s´ıtˇemi (facebook), napˇr. moˇznost sd´ılet dosaˇzené u ´spˇechy ve hˇre, • moˇznost volit r˚ uzné vzhledy aplikace, • implementace zobrazen´ı pr˚ ubˇehu boje. 44

7 Závˇer Gamebook je kniha, ve které je moˇzné provádˇet rozhodnut´ı, jak se bude pˇr´ıbˇeh dále vyv´ıjet a do jisté m´ıry si tak pˇr´ıbˇeh knihy m˚ uˇze ˇctenáˇr urˇcovat sám. Po pˇreˇcten´ı dané ˇca´sti textu knihy jsou nab´ıdnuty moˇznosti, pro které je moˇzné se rozhodnout. Zvolen´ım jedné z tˇechto moˇznost´ı je ˇctenáˇr odkázán na jinou ˇcást, která na pˇredchoz´ı navazuje a takto pokraˇcuje aˇz do konce. C´ılem této bakaláˇrské práce bylo navrhnout, realizovat a ovˇeˇrit funkcionalitu mobiln´ıho klienta pro platformu Android, kter´ y umoˇzn ˇuje procházet gamebooky vytvoˇrené ve vyv´ıjeném systému. Tento c´ıl práce byl splnˇen. Pˇri implementaci bylo potˇreba spolupracovat (spoluvytváˇret sd´ılenou knihovnu) s autorem programu pro tvorbu gamebook˚ u (editoru). V rámci práce jsem nejprve prozkoumal vybrané mobiln´ı aplikace, které umoˇzn ˇuj´ı procházen´ı gamebook˚ u. Pˇri porovnán´ı existuj´ıc´ıch aplikac´ı jsem nenalezl ˇza´dnou aplikaci, která by obsahovala gamebook v ˇceském jazyce. Dále jsem popsal vyv´ıjen´ y systém pro publikován´ı gamebook˚ u a navrhl mobiln´ıho klienta umoˇzn ˇuj´ıc´ıho gamebooky vytvoˇrené v tomto systému procházet. Navrˇzeného mobiln´ı klienta jsem následnˇe implementoval na platformˇe Android a ovˇeˇril jeho funkcionalitu. Mobiln´ı klient umoˇzn ˇuje procházen´ı gamebook˚ u a staˇzen´ı novˇe vydan´ ych gamebook˚ u. Mobiln´ı klient bude dále rozˇsiˇrován a vyv´ıjen o funkcionalitu popsanou v kap. 6.4. Aplikace je pˇripravena na publikován´ı v obchodˇe Google play. Jakmile bude dokonˇcen dostatek gamebook˚ u, které budou spolu s aplikac´ı publikovány, bude aplikace v tomto obchodˇe dostupná. Aplikace byla otestována na vybrané mnoˇzinˇe uˇzivatel˚ u a pˇredstavuje vhodn´ y pˇrechod od kniˇzn´ı podoby gamebook˚ u k elektronické formˇe.

45

Seznam pouˇ zit´ ych zkratek a v´ yraz˚ u Action Bar

Grafická komponenta (liˇsta) na platformˇe Android um´ıstˇená v horn´ı ˇcásti obrazovky (pˇr´ıpadnˇe i doln´ı), která uˇzivateli usnadˇ nuje navigaci v aplikaci.

ADT

Android Development Tools - plugin pro Eclipse IDE umoˇzn ˇuj´ıc´ı v´ yvoj pro platformu Android.

API

Application Programming Interface - rozhran´ı pro programován´ı aplikac´ı.

DDL

Data Definition Language - pˇr´ıkazy jazyka SQL pro vytváˇren´ı a upravován´ı struktury databáze.

DML

Data Manipulation Language - pˇr´ıkazy jazyka SQL pro manipulaci s daty databáze.

DOM

Document Object Model – objektov´ y model dokumentu umoˇzn ˇuj´ıc´ı pˇr´ıstup k jednotliv´ ym objekt˚ um dokumentu.

dp

Density-independent pixel - virtuáln´ı pixel obrazovky, kter´ y je nezávisl´ y na hustotˇe pixel˚ u dané obrazovky.

Framework

Nástroj (obecnˇe) pro usnadnˇen´ı a urychlen´ı v´ yvoje aplikace.

Google play

Sluˇzba primárnˇe urˇcená pro distribuci aplikac´ı pro platformu Android, umoˇzn ˇuje ale distribuovat i jin´ y digitáln´ı obsah.

HTML

HyperText Markup Language - znaˇckovac´ı jazyk pouˇz´ıvan´ y k tvorbˇe webov´ ych stránek.

HTTP

HyperText Transfer Protocol - internetov´ y protokol pro pˇrenáˇsen´ı HTML dokument˚ u.

JDK

Java Development Kit - základn´ı nástroje pro v´ yvoj aplikac´ı na platformu JAVA.

Landscape

Zobrazen´ı obrazovky na ˇs´ıˇrku na platformˇe Android.

Non-volatile

Pamˇet’, která dokáˇze uchovat data i bez napájen´ı. 46

Závˇer Open Source

Software s otevˇren´ ym zdrojov´ ym kódem.

Portrait

Zobrazen´ı obrazovky na v´ yˇsku na platformˇe Android.

SAX

Simple API for XML - API umoˇzn ˇuj´ıc´ı proudové zpracován´ı XML souboru.

SDK

Software development kit - mnoˇzina nástroj˚ u urˇcená pro v´ yvoj aplikac´ı.

SMS

Short Message Service - sluˇzba umoˇzn ˇuj´ıc´ı poslán´ı krátké (160 znakové) textové zprávy.

SQL

Structured Query Language - jazyk pro práci s relaˇcn´ımi databázemi.

UI

User Interface - uˇzivatelské rozhran´ı.

UML

Unified Modeling Language - jazyk pro vizuáln´ı modelován´ı systém˚ u.

URL

Uniform Resource Locator - ˇretˇezec jednoznaˇcnˇe urˇcuj´ıc´ı um´ıstˇen´ı (adresu) zdroje dostupného na internetu.

XML

Extensible Markup Language - rozˇsiˇriteln´ y znaˇckovac´ı jazyk urˇcen´ y pro pˇrenos dat.

47

Literatura [1] GOOGLE. Android Developers [online]. 2015 [cit. 2015-04-01]. Dostupné z: http: //developer.android.com/ [2] Strategy Analytics: Android Shipped 1 Billion Smartphones Worldwide in 2014. In: PR Newswire [online]. 2015 [cit. 2015-04-01]. Dostupné z: http: //www.prnewswire.com/news-releases/strategy-analytics-androidshipped-1-billion-smartphones-worldwide-in-2014-300027707.html [3] GOOGLE. Android Open Source Project [online]. 2015 [cit. 2015-04-03]. Dostupné z: https://source.android.com/ ˇ ´ CEK. ˇ [4] CADA, Roman, Tomáˇs KAISER a Zdenˇek RYJA Diskrétn´ı matematika. Plzeˇ n: Západoˇceská univerzita, 204. ISBN 80-7082-939-7 [5] CHOICE OF GAMES LLC. Choice of Games [online]. 2015 [cit. 2015-04-03]. Dostupné z: https://www.choiceofgames.com/ [6] SOSINSKY, Barrie A. Mistrovstv´ı – poˇc´ıtaˇcové s´ıtˇe. Vyd. 1. Brno: Computer Press, 2010, 840 s. Mistrovstv´ı (Computer Press). ISBN 978-80-251-3363-7. [7] ALLEN, Grant. Android 4: pr˚ uvodce programován´ım mobiln´ıch aplikac´ı. 1. vyd. Pˇreklad Jakub Muˇz´ık. Brno: Computer Press, 2013, 656 s. ISBN 978-80-2513782-6. [8] MURPHY, Mark L. Android 2: pr˚ uvodce programován´ım mobiln´ıch aplikac´ı. Vyd. 1. Brno: Computer Press, 2011, 375 s. ISBN 978-80-251-3194-7. [9] TUTORIALS POINT. Android Programming Tutorial [online]. 2014 [cit. 201504-04]. Dostupné z: http://www.tutorialspoint.com/about/index.htm [10] VOGELLA COMPANY. Android Development [online]. 2015 [cit. 2015-04-04]. Dostupné z: http://www.vogella.com/tutorials/android.html [11] STACK EXCHANGE INC. Stackoverflow [online]. 2015 [cit. 2015-04-04]. Dostupné z: http://stackoverflow.com/ 48

LITERATURA

LITERATURA

[12] Transmitting Network Data Using Volley. GOOGLE. Android Developers [online]. 2015 [cit. 2015-04-18]. Dostupné z: https://developer.android.com/ training/volley/index.html [13] Dashboards. GOOGLE. Android Developers [online]. 2015 [cit. 2015-04-18]. Dostupné z: https://developer.android.com/about/dashboards/index.html? utm_source=suzunone [14] DownloadManager. GOOGLE. Android Developers [online]. 2015 [cit. 2015-0419]. Dostupné z: http://developer.android.com/reference/android/app/ DownloadManager.html [15] Saving Data. GOOGLE. Android Developers [online]. 2015 [cit. 2015-04-19]. Dostupné z: http://developer.android.com/training/basics/data-storage/ index.html [16] ARLOW, Jim a Ila NEUSTADT. UML 2 a unifikovaný proces vývoje aplikac´ı: objektovˇe orientovaná analýza a návrh prakticky. 2. akt. a dopl. vyd. Pˇreklad Bogdan Kiszka. Brno: Computer Press, 2007, 567 s. ISBN 978-80-251-1503-9. [17] HANA, Kanisová a M¨ uller MIROSLAV. UML srozumitelnˇe. Vyd. 1. Brno: Computer Press, 2004, 157 s. ISBN 80-251-0231-9. [18] Fragments. GOOGLE. Android Developers [online]. 2015 [cit. 2015-04-19]. Dostupné z: http://developer.android.com/guide/components/fragments. html [19] App Manifest. GOOGLE. Android Developers [online]. 2015 [cit. 2015-0419]. Dostupné z: http://developer.android.com/guide/topics/manifest/ manifest-intro.html

49

Seznam pˇ r´ıloh Uˇzivatelská pˇr´ıruˇcka - Pˇr´ıloha A Obsah CD - Pˇr´ıloha B Pouˇzité knihovny - Pˇr´ıloha C

50

A Uˇzivatelská pˇr´ıruˇcka Uˇzivatelská pˇr´ıruˇcka obsahuje základn´ı informace o aplikaci, tj. co aplikace umoˇzn ˇuje (jej´ı funkce), popis jej´ı instalace a ovládán´ı.

A.1

Poˇ zadavky aplikace

Pro správné fungován´ı aplikace je potˇreba, aby zaˇr´ızen´ı, na které se bude aplikace instalovat, obsahovala minimálnˇe verzi 2.3 (Gingerbread) operaˇcn´ıho systému Android a extern´ı SD kartu. Pˇri instalaci jsou vyˇzadována tato oprávnˇen´ı: 1. pˇr´ıstup k internetu, 2. zápis do extern´ıho u ´loˇziˇstˇe, 3. zjiˇstˇen´ı stavu s´ıtˇe.

A.2

Instalace

K nainstalován´ı aplikace je potˇreba zkop´ırovat pˇriloˇzen´ y soubor GameBook.apk do zaˇr´ızen´ı (na extern´ı SD kartu nebo na vnitˇrn´ı pamˇet’). Po zkop´ırován´ı naleznˇete pomoc´ı souborového manaˇzera soubor v zaˇr´ızen´ı. Pˇred instalac´ı je potˇreba na nˇekter´ ych verz´ıch Androidu v nastaven´ı povolit instalaci z neznám´ ych zdroj˚ u. Pro povolen´ı jdˇete do / Nastaven´ı / Zabezpeˇcen´ı / Neznáme zdroje a zaˇskrtnˇete poloˇzku Neznámé zdroje, viz obr. A.2. Soubor vyberte stiskem. Pokud se zobraz´ı nab´ıdka Dokonˇcit akci pomoc´ı, viz obr. A.1, pak stisknˇete volbu Instalaˇcn´ı program bal´ıˇck˚ u. Dále se objev´ı nab´ıdka, zda chcete tuto aplikaci nainstalovat, viz obr. A.3. Stisknˇete tlaˇc´ıtko Instalovat a aplikace se zaˇcne instalovat. Po u ´spˇeˇsném nainstalován´ı je moˇzné aplikaci spustit

A.3

Ovl´ ad´ an´ı aplikace

Po spuˇstˇen´ı aplikace je zobrazena obrazovka s animac´ı, viz obr. A.4, na této obrazovce by uˇzivatel mˇel vyˇckat neˇz se spust´ı obrazovka s menu, viz obr. A.5. Obrazovka 51

Uˇzivatelská pˇr´ıruˇcka

Ovládán´ı aplikace

Obrázek A.1: Ukázka z instalace aplikace

Obrázek A.2: Povolen´ı instalace z neznám´ ych zdroj˚ u

s animac´ı se nemus´ı objevit vˇzdy, zpravidla pouze pˇri prvn´ım spuˇstˇen´ı aplikace. V menu jsou um´ıstˇena tlaˇc´ıtka Nová Hra, Pokraˇcovat a Knihovna. Kliknut´ım na tlaˇc´ıtko Nová Hra, se spust´ı procházen´ı aktuálnˇe vybraného gamebooku. Jméno vybraného gamebooku je zobrazeno v levém doln´ım rohu obrazovky. V pˇr´ıpadˇe, ˇze nen´ı vybrán ˇza´dn´ y gamebook je spuˇstˇen gamebook distribuovan´ y s aplikac´ı. Tlaˇc´ıtko Pokraˇcovat je moˇzné stisknout pokud je nˇejak´ y gamebook uˇz procházen. Pokud se klikne na novou hru, je zobrazen dialog, zda má b´ yt skuteˇcnˇe spuˇstˇena nová hra a pˇrepsat p˚ uvodn´ı. V pˇr´ıpadˇe, ˇze hra nen´ı rozehraná, dialog se nezobraz´ı. Kliknut´ım na tlaˇc´ıtko Knihovna se spust´ı knihovna s gamebooky, které jsou v zaˇr´ızen´ı jiˇz staˇzeny a s gamebooky, které je moˇzné stáhnout. V menu je um´ıstˇen také Action Bar (liˇsta v horn´ı ˇcásti obrazovky), ve které jsou um´ıstˇeny akce pro zobrazen´ı informac´ı o programu, nastaven´ı aplikace a ukonˇcen´ı aplikace. Rozloˇzen´ı se m˚ uˇze na r˚ uzn´ ych verz´ıch platformy Android liˇsit, tzn. ˇze na niˇzˇs´ıch verz´ıch Androidu (verze niˇzˇs´ı neˇz 3.0) budou nˇejaké akce um´ıstˇeny v kontextové nab´ıdce vyvolané hardwarov´ ym tlaˇc´ıtkem, viz obr. A.6.

52



Obrázek A.3: Ukázka z instalace aplikace

Obrázek A.4: Ukázka u ´vodn´ı obrazovky po spuˇstˇen´ı

Po kliknut´ı na akci O Programu (ikona s p´ısmenem i) je zobrazen popis aplikace a odkaz na webové stránky celého systému.

A.3.1

Proch´ azen´ı gamebooku

K procházen´ı gamebooku je nejprve tˇreba vybrat gamebook z knihovny a kliknout na tlaˇc´ıtko Nová hra v hlavn´ım menu aplikace. Pokud nebude gamebook vybrán z knihovny bude pouˇzit gamebook distribuovan´ y s aplikac´ı. Po kliknut´ı na novou hru bude uˇzivateli zobrazena obrazovka, viz obr. A.7, na které provede základn´ı nastaven´ı hry, tj. jméno a pˇr´ıpadnˇe si vybere vlastnosti postavy, které pak ovlivˇ nuj´ı pˇr´ıbˇeh. Po stisknut´ı tlaˇc´ıtka Zaˇc´ıt hru se zobraz´ı u ´vodn´ı stav gamebooku, viz obr. A.8. Pokud text obsahuje v´ıce stránek je moˇzné táhnut´ım prstu pˇrecházet mezi nimi. V Action Baru je moˇzné kliknout na akce pro zmenˇsen´ı nebo zvˇetˇsen´ı textu a také restartovat aktuáln´ı hru. U velk´ ych obrazovek a v reˇzimu obrazovky na ˇs´ıˇrku je vedle textu zobrazena nab´ıdka s moˇznostmi, které je moˇzné vykonat, viz obr. A.10. Na ostatn´ıch konfigu53



Obrázek A.5: Ukázka hlavn´ıho menu rac´ıch obrazovky se nab´ıdka zobraz´ı kliknut´ım na ˇsipku u pravého okraje obrazovky nebo táhnut´ım prstu od pravého okraje obrazovky. Pro pokraˇcován´ı je tˇreba kliknout na jednu z moˇznost´ı. Po kliknut´ı dojde k vyhodnocen´ı a pˇresunu do nového stavu. V pˇr´ıpadˇe boje je zobrazen dialog s v´ ysledkem boje (graficky boj zat´ım nen´ı moˇzné procházet). U nˇekter´ ych akc´ı je uˇzivatel vyzván, aby hodil kostkou, viz obr. A.9. Podle v´ ysledku se odv´ıj´ı dalˇs´ı postup ve hˇre, poprvé m˚ uˇze uˇzivatel hodit v souˇctu napˇr. 5 a bude nasmˇerován do stavu A. Pokud by stejn´ y gamebook hrál podruhé a hodil vyˇsˇs´ı ˇc´ıslo neˇz 5 m˚ uˇze b´ yt nasmˇerován do jiného stavu pˇr´ıbˇehu. Stavy se mohou prol´ınat a touto vlastnost´ı je zajiˇstˇeno, ˇze pokud bude dan´ y gamebook hrán dvakrát, nemus´ı se hra vˇzdy vyv´ıjet stejnˇe.

A.3.2

Knihovna

V knihovnˇe jsou zobrazeny dvˇe záloˇzky Staˇzené a Ke staˇzen´ı, viz obr. A.11. Po kliknut´ı na vybran´ y gamebook je zobrazen detail gamebooku. V zaˇr´ızen´ıch s velkou obrazovkou a pokud je obrazovka zobrazena na ˇs´ıˇrku, je detail zobrazen vedle seznamu.

54



Obrázek A.6: Ukázka menu na zaˇr´ızen´ı s verz´ı 2.3

Obrázek A.7: Ukázka obrazovky s poˇcáteˇcn´ım nastaven´ı gamebooku

V detailu pro staˇzené gamebooky je moˇzné vidˇet obecné informace o gamebooku. Dále je zde poloˇzka s hodnocen´ım gamebooku, na kterou je moˇzné kliknout a gamebook ohodnotit. Pod touto poloˇzkou jsou tlaˇc´ıtka pro smazán´ı gamebooku a v´ ybˇer gamebooku. Pokud uˇzivatel klikne na tlaˇc´ıtko Vybrat, bude zobrazeno menu aplikace a vybran´ y gamebook bude moˇzné hrát. Hry jsou automaticky ukládány. Pokud je rozehrán napˇr. gamebook A, a je vybrán gamebook B, postup z gamebooku A je uloˇzen. Po opˇetovném vybrán´ı gamebooku A je moˇzné pokraˇcovat v p˚ uvodn´ı hˇre, ale je moˇzné m´ıt rozehranou pouze jednu hru od kaˇzdého gamebooku. Pˇri odstranˇen´ı gamebooku tlaˇc´ıtkem Smazat jsou odstranˇeny i uloˇzené hry. V detailu pro gamebooky, které je moˇzné stáhnout, viz obr. A.12, jsou také zobrazeny obecné informace o gamebooku a poloˇzka s hodnocen´ım. Zde je hodnocen´ı daného gamebooku pouze zobrazeno a nen´ı moˇzné ho hodnotit, to lze aˇz po jeho staˇzen´ı. V tomto detailu je také um´ıstˇeno tlaˇc´ıtko pro staˇzen´ı gamebooku Stáhnout, po kliknut´ı dojde k zahájen´ı stahován´ı. Pokud by bˇehem stahován´ı uˇzivatel opustil obrazovku s detailem gamebooku, pak je potˇreba po dokonˇcen´ı stahován´ı se na obrazovku vrátit, aby mohl b´ yt staˇzen´ y gamebook rozbalen. Následnˇe bude gamebook zobrazen v záloˇzce staˇzen´ ych

55



Obrázek A.8: Ukázka hern´ı obrazovky

A.3.3

Obrázek A.9: Ukázka dialogu s kostkami


Do nastaven´ı aplikace, viz obr. A.13, je moˇzné dostat se z menu aplikace kliknut´ım na akci Nastaven´ı v Action Baru (ikona ozubeného koleˇcka). V nastaven´ı jsou dvˇe oddˇelené sekce, a to Hern´ı Nastaven´ı a Aplikace a Vývojáˇr. V sekci Hern´ı Nastaven´ı je moˇzné nastavit nˇekterá nastaven´ı pro procházen´ı hry. Poloˇzka Pouˇz´ıvat kostky oznaˇcuje, zda maj´ı b´ yt ve hˇre zobrazovány dialogy s kostkou, viz obr. A.9 (je moˇzné hodit kostkami u urˇcit´ ych akc´ı). Pokud je poloˇzka vypnuta, nen´ı zobrazen dialog s kostkami a daná akce se chová jako ostatn´ı rozhodnut´ı (uˇzivatel je poslán do pˇr´ısluˇsného stavu bez moˇznosti hodu kostkou). Druhá poloˇzka zobrazuje nab´ıdku pro v´ ybˇer typu p´ısma, kter´ y bude pouˇz´ıván pro text pˇri procházen´ı gamebooku. Dalˇs´ı poloˇzka zobraz´ı dialog, viz obr. A.14, ve kterém je moˇzné vybrat velikost p´ısma, které bude pouˇzito pˇri spuˇstˇen´ı nové hry. Minimáln´ı velikost je 10 a maximáln´ı je 50. Posledn´ı poloˇzka umoˇzn ˇuje nastavit, zda má b´ yt zobrazováno tlaˇc´ıtko se ˇsipkou v hern´ı obrazovce pro vysouván´ı nab´ıdky s moˇzn´ ymi rozhodnut´ımi.

56



Obrázek A.10: Ukázka rozloˇzen´ı komponent ve hˇre pˇri orientaci na ˇs´ıˇrku u velké obrazovky Ve druhé sekci nastaven´ı Aplikace a Vývojáˇr nejsou ˇza´dná funkˇcn´ı nastaven´ı pouze informace o verzi aplikace, seznam pouˇzit´ ych open source knihoven a softwaru (zobraz´ı se po kliknut´ı na poloˇzku) a poloˇzka, která umoˇzn ˇuje odeslat email se zpˇetnou vazbou nebo zprávou o problému.

57



Obrázek A.11: Ukázka zobrazen´ı knihovny (seznamu gamebook˚ u)

Obrázek A.12: Ukázka detailu staˇzitelného gamebooku

58



Obrázek A.13: Ukázka obrazovky nastaven´ı

Obrázek A.14: Ukázka dialogu pro v´ ybˇer základn´ı velikosti p´ısma

59

B Obsah CD Pˇriloˇzené CD obsahuje text práce ve formátu pdf spolu s jeho zdrojov´ ymi LATEX soubory (adresáˇr text). Dále obsahuje v´ yslednou aplikaci ve formˇe instalaˇcn´ıho souboru GameBook.apk v adresáˇri apk a také ve formˇe zdrojov´ ych soubor˚ u. Zdrojové soubory jsou um´ıstˇeny ve sloˇzce src. V této sloˇzce jsou obsaˇzeny jednotlivé Eclipse IDE projekty knihoven a mobiln´ıho klienta. Adresáˇrová struktura je vidˇet na obr. B.1. / apk...........................Adresáˇr obsahuj´ıc´ı instalaˇcn´ı soubor aplikace typu apk. GameBook.apk...................Instalaˇcn´ı soubor mobiln´ıho klienta. src...........................Adresáˇr obsahuj´ıc´ı zdrojové soubory ve formˇe projekt˚ u z Eclipse IDE. ActionBarSherlockLibrary GameBook Android Client ...... Eclipse IDE projekt mobiln´ıho klienta. GameBook ClassLibrary ........ Eclipse IDE projekt sd´ılené knihovny. NineOldAndroidLibrary SlidingMenuLibrary ViewPagerIndicatorLibrary Volley text..........................Adresáˇr obsahuj´ıc´ı text práce. latex...........................Zdrojové soubory textu práce v LATEX. img..........................Obrázky pouˇzité v textu práce. BP_pribanp.pdf ................ Text práce ve formátu pdf. Obsah_CD.txt ............... Textov´ y soubor se strukturou CD. Obrázek B.1: Adresáˇrová struktura pˇriloˇzeného CD

60

C Pouˇzité knihovny Knihovna

Dostupn´ a z adresy

logback-android logback ActionBarSherlock Nine Old Androids ViewPagerIndicator SlidingMenu

https://github.com/tony19/logback-android http://logback.qos.ch/ http://actionbarsherlock.com/usage.html http://nineoldandroids.com/ http://viewpagerindicator.com/ https://github.com/jfeinstein10/SlidingMenu

Tabulka C.1: Adresy, ze kter´ ych jsou dostupné pouˇzité knihovny

61

Západočeská univerzita v Plzni Fakulta aplikovaných věd Katedra informatiky a výpočetní techniky. Mobilní klient pro systém

Recommend Documents