Západočeská univerzita v Plzni Fakulta aplikovaných věd Katedra informatiky a výpočetní techniky. Práce s kontakty na mobilní platformě Android

Západoˇceská univerzita v Plzni Fakulta aplikovaných vˇed Katedra informatiky a výpoˇcetn´ı techniky

Bakal´ aˇ rsk´ a pr´ ace Pr´ ace s kontakty na mobiln´ı platformˇ e Android

Plzeˇn 2014

David Fiedler

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 9. kvˇetna 2014 David Fiedler

Abstract This thesis is concerned with management of different contacts on the Android platform. Currently on the android platform, contact information related to one person are often scattered in many different contacts. The goal of this project is to find a way to locate these contacts and connect them together in the same place. The application has been implemented, allowing you to select the name and photo of the linked contact. On devices with the administration rights the application can work with contacts from Facebook, it can also find more contacts to link in other tested applications. Considering all these factors, this project is making a step forward with this issue compared with other current applications that are available.

Abstrakt Tato práce se zab´ yvá správou kontakt˚ u na platformˇe Android. Na platformˇe Android b´ yvaj´ı kontaktn´ı informace vztahuj´ıc´ı se k jedné osobˇe roztrouˇseny v mnoha kontaktech. C´ılem práce je naj´ıt zp˚ usob, jak tyto kontakty vyhledat a propojit. Zvolená aplikace byla realizována, umoˇzn ˇuje vybrat název a fotografii propojeného kontaktu. Na zaˇr´ızen´ıch s administrátorsk´ ymi právy um´ı aplikace pracovat i s kontakty z Facebooku, nav´ıc najde ˇra´dovˇe v´ıce kontakt˚ u k propojen´ı neˇz ostatn´ı testované aplikace. Vˇsechny tyto faktory znamenaj´ı posun vpˇred ve srovnán´ı s ostatn´ımi dostupn´ ymi aplikacemi zab´ yvaj´ıc´ımi se touto problematikou.

Obsah ´ 1 Uvod 1.1 C´ıle bakaláˇrské práce . . . . . . . . . . . . . . . . . . . . . . . . . . 1.2 C´ıle aplikace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

1 1 2

2 Existuj´ıc´ı aplikace pro pr´ aci s kontakty 2.1 Testované aplikace . . . . . . . . . . . 2.1.1 Aplikace Merge+ . . . . . . . . 2.1.2 Contact Optimizer . . . . . . . 2.1.3 Duplicate Contacts Manager . . 2.2 Shrnut´ı existuj´ıc´ıch aplikac´ı . . . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

. . . . .

3 3 3 5 5 6

3 Pr´ ace s kontakty na platformˇ e Android 3.1 Content Provider . . . . . . . . . . . . . . . . . 3.1.1 Pˇr´ıstup k provideru . . . . . . . . . . . . 3.1.2 Content URI . . . . . . . . . . . . . . . 3.1.3 Z´ıskán´ı dat z provideru . . . . . . . . . . 3.1.4 Zobrazen´ı v´ ysledk˚ u dotazu . . . . . . . . 3.1.5 Vkládán´ı, aktualizace a mazán´ı dat . . . 3.1.6 Kontrakty . . . . . . . . . . . . . . . . . 3.2 Contact Provider . . . . . . . . . . . . . . . . . 3.2.1 Organizace kontakt˚ u . . . . . . . . . . . 3.2.2 Raw contacty . . . . . . . . . . . . . . . 3.2.3 Data . . . . . . . . . . . . . . . . . . . . 3.2.4 Kontakty . . . . . . . . . . . . . . . . . 3.2.5 Oprávnˇen´ı potˇrebná pro práci s kontakty 3.2.6 Propojován´ı kontakt˚ u. . . . . . . . . . . 3.3 Nedostatky v oficiáln´ı dokumentaci . . . . . . . 3.3.1 Práce s kontakty z Facebooku . . . . . . 3.3.2 Zmˇena názvu kontaktu . . . . . . . . . .

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

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

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

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

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

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

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

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

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

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

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

7 7 8 8 9 9 10 10 10 11 12 12 14 15 16 17 17 18

4 Struktura aplikace 4.1 Prezentaˇcn´ı vrstva . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.1 Fragmenty . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4.1.2 Vynechán´ı aktivit z historie . . . . . . . . . . . . . . . . . .

19 19 19 21

. . . . .

. . . . .

. . . . .

. . . . .

OBSAH

4.2

4.3

4.4

OBSAH

4.1.3 Struˇcn´ y popis aktivit . . . . . . . . Aplikaˇcn´ı vrstva . . . . . . . . . . . . . . . 4.2.1 Systém vyhledávac´ıch modul˚ u . . . 4.2.2 Implementované moduly . . . . . . 4.2.3 Parazitn´ı moduly . . . . . . . . . . Datová vrstva . . . . . . . . . . . . . . . . 4.3.1 Z´ıskáván´ı kontakt˚ u k porovnán´ı . . 4.3.2 Propojován´ı kontakt˚ u. . . . . . . . 4.3.3 Z´ıskáván´ı facebookov´ ych kontakt˚ uz Kompatibilita . . . . . . . . . . . . . . . .

5 Testov´ an´ı aplikace 5.1 Porovnán´ı aplikac´ı . . . . . . 5.2 Porovnán´ı r˚ uzn´ ych nastaven´ı . 5.2.1 Email module . . . . . 5.2.2 Phone number module 5.2.3 Name module . . . . . 5.2.4 Email/Name module .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . databáze . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

. . . . . . . . . .

22 27 28 29 30 30 30 31 32 35

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

36 36 36 38 38 38 39

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

6 Z´ avˇ er Pˇ r´ılohy A Instalaˇcn´ı pˇr´ıruˇcka . . . . . . . . . B Uˇzivatelská pˇr´ıruˇcka . . . . . . . . C Sloupce tabulky kontakt˚ u . . . . . C.1 Základn´ı . . . . . . . . . . . C.2 Dostupné pˇres implicit-join . D Sloupce tabulky raw kontakt˚ u . . . D.1 Základn´ı . . . . . . . . . . . D.2 Dostupné pˇres implicit-join . E Sloupce tabulky dat . . . . . . . . . E.1 Základn´ı . . . . . . . . . . . E.2 Dostupné pˇres implicit-join .

40

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

. . . . . . . . . . .

45 45 45 49 50 51 52 52 53 54 54 54

´ 1 Uvod Tématem této práce je vytvoˇrit u ´ˇcinn´ y a spolehliv´ y nástroj pro spojován´ı kontakt˚ u na platformˇe Android, patˇr´ıc´ıch k jedné fyzické osobˇe. Hlavn´ı c´ıle práce jsou inteligentn´ı vyhledáván´ı kontakt˚ u k propojen´ı, propojován´ı kontakt˚ u z v´ıce zdroj˚ u, v neposledn´ı ˇradˇe pak rychlost a jednoduchost aplikace. Kontakty na platformˇe Android v mnohém pˇripom´ınaj´ı kontakty na star´ ych telefonech bez operaˇcn´ıho systému. Uˇzivatelské rozhran´ı je sice modernˇejˇs´ı, stará struktura s dlouh´ ym seznamem kontakt˚ u pod sebou ale v kontaktn´ı aplikaci z˚ ustala. Podstatn´ y rozd´ıl, kromˇe technické stránky, která je probrána v následuj´ıc´ı kapitole, je to, ˇze se v zaˇr´ızen´ı s operaˇcn´ım systémem Android mohou nacházet nejen kontakty zadané uˇzivatelem v zaˇr´ızen´ı (telefonu, tabletu...), ale i z jin´ ych zdroj˚ u. Tˇemito zdroji mohou b´ yt napˇr´ıklad emailové u ´ˇcty, ˇci u ´ˇcty na sociáln´ıch s´ıt´ıch. Zaˇclenˇen´ı kontakt˚ u z v´ıce zdroj˚ u má své v´ yhody, uˇzivatel má vˇsechny informace na jednom m´ıstˇe, z jednoho seznamu m˚ uˇze volat, psát mail, ˇci naj´ıt kontaktn´ı informace na Facebooku. S v´ yhodami pˇricház´ı ale i u ´skal´ı rozdroben´ı informac´ı r˚ uzné u ´daje o jedné osobˇe jsou v seznamu kontakt˚ u na nˇekolika m´ıstech, podle toho, z jakého u ´ˇctu byly importovány. Na starˇs´ıch zaˇr´ızen´ıch vznikali takové kontakty jen chybou pˇri zadán´ı, nebylo jich tedy mnoho. Na zaˇr´ızen´ıch s operaˇcn´ım systémem Android, kde uˇzivatel synchronizuje emailové u ´ˇcty ˇci u ´ˇcty na sociáln´ıch s´ıt´ıch se seznamem kontakt˚ u, jde vˇsak poˇcet takov´ ych kontakt˚ u do des´ıtek, jejich hledán´ı a ruˇcn´ı spojován´ı v seznamu kontakt˚ u o nˇekolika stech poloˇzkách je pak nelehk´ ym u ´kolem. Platforma Android má pro tuto situaci ˇca´steˇcné ˇreˇsen´ı. Vˇsechny vytvoˇrené nebo importované kontakty kontroluje s jiˇz existuj´ıc´ımi, pˇri pˇresné nebo témˇeˇr pˇresné shodˇe pak nab´ız´ı propojen´ı kontakt˚ u. C´ılem moj´ı práce je pˇrekonat tento systém sloˇzitˇejˇs´ım a inteligentnˇejˇs´ım, takov´ ym, kter´ y nalezne naprostou vˇetˇsinu kontakt˚ u patˇr´ıc´ıch ke stejné osobˇe.

1.1

C´ıle bakal´ aˇ rsk´ e pr´ ace

1. Prozkoumat existuj´ıc´ı aplikace na propojován´ı kontakt˚ u na platformˇe Android a zhodnotit jejich pouˇzitelnost 2. Prozkoumat technické detaily práce s kontakty na platformˇe Android. 3. Navrhnout a realizovat aplikaci pro propojován´ı kontakt˚ u na platformˇe Android. 1

´ Uvod

1.2

C´ıle aplikace

C´ıle aplikace

1. Propojovat kontakty z v´ıce zdroj˚ u. 2. Vyˇsˇs´ı poˇcet nalezen´ ych kontakt˚ u k propojen´ı neˇz konkurenˇcn´ı aplikace. 3. Schopnost pracovat s kontakty ze sociáln´ıch s´ıt´ı. 4. Snadná rozˇsiˇritelnost aplikace - pˇredevˇs´ım o dalˇs´ı zp˚ usoby kontakt˚ u k propojen´ı 5. Jednoduché uˇzivatelské rozhran´ı.

2

2 Existuj´ıc´ı aplikace pro práci s kontakty V této kapitole budou struˇcnˇe vyjmenovány vybrané existuj´ıc´ı aplikace pro propojován´ı kontakt˚ u na platformˇe Android. Nast´ınˇen bude struˇcn´ y v´ yˇcet jejich vlastnost´ı a moˇznost´ı, na konci pak bude zd˚ uvodnˇena potˇreba vytvoˇren´ı dalˇs´ı aplikace. Pˇri v´ yzkumu moˇznost´ı a schopnost´ı ciz´ıch aplikac´ı jsem vycházel v´ yhradnˇe z ’ vlastn´ı zkuˇsenosti, nebot zdrojov´ y kód tˇechto aplikac´ı nen´ı zveˇrejnˇen. Proto se mohou ve v´ yˇctu schopnost´ı a moˇznost´ı vyskytnout chyby, hodnocen´ı tedy nelze povaˇzovat za zcela objektivn´ı.

2.1

Testovan´ e aplikace

Testovány byly celkem tˇri aplikace. Obecnˇe lze ˇr´ıci, ˇze vˇsechny aplikace maj´ı vˇetˇsinou v´ıce funkc´ı neˇz jen hledán´ı duplicitn´ıch kontakt˚ u. Také filozofie program˚ u je odliˇsná od zadán´ı a c´ıl˚ u moj´ı bakaláˇrské práce, primárn´ım c´ılem b´ yvá vˇetˇsinou odstranˇen´ı duplicit. C´ılem této práce je naproti tomu vyuˇz´ıt duplicitn´ıch informac´ı ke slouˇcen´ı v´ıce kontakt˚ u do jednoho, duplicitn´ı data neˇreˇs´ı. Tento pˇr´ıstup sice nemus´ı vést k u ´spoˇre dat ani k urychlen´ı kontaktn´ı aplikace, uˇsetˇr´ı vˇsak ˇcas uˇzivateli, kter´ y se v kontaktech lépe vyzná. Duplicitn´ı u ´daj totiˇz neb´ yvá jedin´ ym u ´dajem kontaktu, spolu s n´ım se spoj´ı i dalˇs´ı, jiˇz unikátn´ı data (viz. obrázek 2.1). Vˇsechny testované aplikace byly staˇzeny z GooglePlay (hlavn´ı centrum a obchod s aplikacemi na platformˇe Android) a jsou zdarma. Aplikace Duplicate contact manager má nˇekteré nadstandardn´ı funkce placené, tyto nebyly testovány.

2.1.1

Aplikace Merge+

Aplikace Merge+ je jednoduchá aˇz minimalistická aplikace pro propojován´ı kontakt˚ u. Dle mého názoru se jedná hlavnˇe o promo na aplikaci Contacts+. Hledán´ı je rychlé, ale nalezen´ ych v´ ysledk˚ u nen´ı mnoho. Nav´ıc nelze zvolit v´ ychoz´ı fotku ani jméno kontaktu. Uˇzivatelské rozhran´ı aplikace m˚ uˇzeme vidˇet na obrázku 2.2.

3

Existuj´ıc´ı aplikace pro práci s kontakty

Testované aplikace

Obrázek 2.1: V´ yhody propojován´ı kontakt˚ u.

´ (a) Uvodn´ ı obrazovka.

(b) Seznam nalezen´ ych kontakt˚ u patˇr´ıc´ıch k téˇze osobˇe.

Obrázek 2.2: Aplikace Merge+.

4



Testované aplikace

(b) V´ ybˇer u ´ˇctu k optima- (c) V´ ysledky hledán´ı pro lizaci/hledán´ı. kontakty v telefonu (ruˇcnˇe zadané uˇzivatelem).

Obrázek 2.3: Aplikace Contact Optimizer.

2.1.2

Contact Optimizer

Aplikace Contact Optimizer nab´ız´ı mnohem v´ıce funkc´ı neˇz jen hledán´ı duplicit a propojován´ı kontakt˚ u. Pokud se ale pod´ıváme jen na tuto funkˇcnost, v´ ysledky nejsou pˇr´ıliˇs dobré. Aplikace hledá duplicity jen v rámci jednoho u ´ˇctu (jeden emailov´ yu ´ˇcet, kontakty v telefonu..), nav´ıc nab´ız´ı jen smazat jeden z kontakt˚ u. Propojován´ı kontakt˚ u prob´ıhá oddˇelenˇe v jiné ˇca´sti programu nazvané optimalizace. Zde ovˇsem v´ ysledek v˚ ubec nelze zhodnotit, k propojen´ı jsou nab´ızené i kontakty jiˇz dávno propojené, celá logika tohoto procesu je tak pochybná. Nav´ıc pˇri pˇrepnut´ı na jinou aplikaci a zpˇet je nutno opakovat cel´ y proces od zaˇca´tku, nalezené v´ ysledky se nikam neuloˇz´ı. Aplikaci m˚ uˇzeme vidˇet na obrázku 2.3.

2.1.3

Duplicate Contacts Manager

Dalˇs´ı aplikace s mnoha funkcemi zaujme hned zpoˇcátku patkov´ ym p´ısmem, pro digitáln´ı techniku tak netypick´ ym. Na rozd´ıl od pˇredchoz´ı aplikace se vˇetˇsina funkc´ı t´ yká hledán´ı duplicitn´ıch kontakt˚ u. V hledán´ı duplicit ale program zaostává, pˇri pokusu s modulem Duplicite Contacts Detector nalezl jen nˇekolik málo shod dle ˇc´ısla. Vzhled aplikace vid´ıme na obrázku 2.4.

5



Shrnut´ı existuj´ıc´ıch aplikac´ı

(b) Nalezené v´ ysledky pˇri pouˇzit´ı funkce duplicate contact detector.

Obrázek 2.4: Aplikace Contact Optimizer.

2.2

Shrnut´ı existuj´ıc´ıch aplikac´ı

Z pr˚ uzkumu aplikac´ı jednoznaˇcnˇe vyplynula potˇreba vytvoˇrit novou aplikaci. Poˇcet nalezen´ ych shod byl ve vˇsech tˇrech programech velmi mal´ y. Nen´ı moˇzné to ovˇeˇrit, ale v´ ysledky hledán´ı nasvˇedˇcovali tomu, ˇze se testuje pouze pˇresná shoda nalezen´ ych u ´daj˚ u. Dále v aplikac´ıch nelze zvolit jméno nebo fotku propojeného kontaktu. Práce s kontakty pocházej´ıc´ımi ze s´ıtˇe Facebook pak nen´ı moˇzná opˇet v ani jednom z program˚ u. Velk´ ym rozd´ılem, jak jiˇz bylo ˇreˇceno v u ´vodu kapitoly, je rozd´ılná filozofie, kdy testované programy aˇz na v´ yjimky duplicity maˇzou, o propojen´ı kontakt˚ u se nesnaˇz´ı. Vˇsechny tyto skuteˇcnosti pak, dle mého názoru, vedou k potˇrebˇe vytvoˇrit novou aplikaci, zamˇeˇrenou pouze na propojován´ı kontakt˚ u, která bude m´ıt tyto schopnosti.

6

3 Práce s kontakty na platformˇe Android Na platformˇe Android jsou v databázi kontakt˚ u (tedy v databázi kde jsou uloˇzeny data kontakt˚ u) uloˇzeny vˇsechny informace nejen o vˇsech m´ıstn´ıch kontaktech (kontakty v telefonu, nesouvisej´ıc´ı s jinou sluˇzbou), ale i u ´daje z profil˚ u na sociáln´ıch s´ıt´ıch (Facebook) nebo u ´ˇctech r˚ uzn´ ych sluˇzeb (Google). Tyto kontakty jsou vyuˇz´ıvány kontaktn´ı a vytáˇcec´ı aplikac´ı (dialer application) telefonu, ale také dalˇs´ımi aplikacemi jako jsou emailov´ y klient, programy sociáln´ıch s´ıt´ı, kalendáˇr, atd. Pomoc´ı kontakt˚ u je v telefonu uloˇzen dokonce i profil uˇzivatele telefonu. Kontakty jsou na platformˇe Android uloˇzené v centráln´ım u ´loˇziˇsti dat[9], tedy databázi ve které jsou uloˇzena systémová data telefonu. Aplikace k tomuto u ´loˇziˇsti nemohou pˇristupovat pˇr´ımo, d´ıky ˇcemuˇz je u ´loˇziˇstˇe zabezpeˇcené proti mazán´ı ˇci zneuˇzit´ı dat[14]. K pˇr´ıstupu k tˇemto dat˚ um se pouˇz´ıvaj´ı objekty typu ContentResolver na stranˇe klientské aplikace a objekty typu ContentProvider na stranˇe u ´loˇziˇstˇe dat.[15, 14] Objektem typu content resolver (dále jen content resolver) naz´ yváme instanci tˇr´ıdy odvozené od abstraktn´ı tˇr´ıdy ContentResolver. Obdobnˇe objektem typu content provider (dále jen content provider) naz´ yváme instanci tˇr´ıdy odvozené od abstraktn´ı tˇr´ıdy ContentProvider. Content resolver je automaticky (prostˇrednictv´ım metody getContentResolver v instanci aktivity) obsaˇzen v kaˇzdé aplikaci[1]. Pro práci s daty je vˇsak tˇreba d˚ ukladnˇe prozkoumat pˇr´ısluˇsn´ y content provider.

3.1

Content Provider

Content provider slouˇz´ı k pˇr´ıstupu ke strukturovan´ ym dat˚ um v centráln´ım u ´loˇziˇsti dat. Zapouzdˇruje pˇr´ıstup k dat˚ um, k nimˇz nepˇristupujeme pˇr´ımo, ale jen skrz content provider. Nejˇcastˇeji se vyuˇz´ıvá pˇri meziprocesové komunikaci, kdy na stranˇe u ´loˇziˇstˇe dat stoj´ı objekt content provider, na druhé stranˇe pak objekt content resolver klientské aplikace. Takov´ y zp˚ usob komunikace zajiˇst’uje konzistentn´ı a bezpeˇcn´ y pˇr´ıstup k dat˚ um. Content provider obdrˇz´ı od content resolveru klientské aplikace poˇzadavky, provede poˇzadovanou akci s daty, a navrát´ı klientovi v´ ysledky. Content provider zpˇr´ıstupˇ nuje data aplikac´ı v podobˇe tabulek, tak jak jsme 7

Práce s kontakty na platformˇe Android

Content Provider

na to zvykl´ı napˇr´ıklad z relaˇcn´ıch databáz´ı. Jeden ˇra´dek tak reprezentuje instanci objektu, kter´ y databáze uchovává, sloupec pak datové pole obsahuj´ıc´ı jeden typ dat.

3.1.1

Pˇ r´ıstup k provideru

Jak bylo napsáno v´ yˇse, aplikace pˇristupuje k provideru skrze content resolver. Tento objekt má metody, které volaj´ı ekvivalentn´ı (i stejnˇe pojmenované) metody provideru[14]. Content resolver nab´ız´ı klasické ”CRUD”metody (create, retrieve, update, and delete)[14]. Content resolver v klientské aplikaci a content provider v aplikaci vlastn´ıc´ı pˇr´ıstup k dat˚ um automaticky zvládaj´ı meziprocesovou komunikaci. Content provider nav´ıc zajiˇst’uje vrstvu abstrakce pro klientskou aplikaci, kv˚ uli n´ıˇz se data jev´ı jako mnoˇzina tabulek v relaˇcn´ı databázi[14]. Typick´ y pˇr´ıstup vypadá tak jak m˚ uˇzeme vidˇet v kódu 3.1: resolver.query(uri, projection, selection, selectionArgs, sortOrder)

Kód 3.1: Ukázka metody query ze tˇr´ıdy contentResolver[14]. kde: • uri urˇcuje jméno (cestu) tabulky o kterou máme zájem - podobnˇe jako SQL FROM • projection urˇcuje sloupce které chceme vrátit - podobnˇe jako SQL col, col,col • selection a sortOrder urˇcuj´ı o které ˇra´dky tabulky máme zájem - podobnˇe jako SQL WHERE • sortOrder urˇcuje seˇrazen´ı vrácen´ ych ˇra´dk˚ u tabulky - SQL ORDER BY

3.1.2

Content URI

Content URI je cesta která identifikuje data v provideru. Content URI se skládá ze symbolického jména provideru (authority) a z názvu tabulky (path).

8


Content Provider

ContentResolver nejprve porovná jméno providera v URI se systémovou tabulkou provider˚ u, které jsou k dispozici. Následnˇe poˇsle zbylé argumenty vˇcetnˇe druhé ˇca´sti URI vybranému provideru. ContentProvider pak vyuˇzije druhou ˇca´st URI - jméno tabulky k vybrán´ı správné tabulky.

3.1.3

Z´ısk´ an´ı dat z provideru

K z´ıskán´ı dat z provideru potˇrebujeme splnit dva pˇredpoklady: 1. zajistit si právo pro pˇr´ıstup 2. sestavit správn´ y dotaz

Z´ısk´ an´ı pˇ r´ıstupov´ ych pr´ av Pro práci s daty pomoc´ı provideru je tˇreba, aby klientská aplikace mˇela pˇr´ısluˇsná oprávnˇen´ı. Tato oprávnˇen´ı nemohou b´ yt z´ıskána za bˇehu aplikace, m´ısto toho je tˇreba si je vyˇza´dat v souboru AndroidManifest.xml patˇr´ıc´ımu ke klientské aplikaci. K tomu se pouˇz´ıvá element <uses-permission>. Pˇresné jméno povolen´ı závis´ı na tom, jak´ y provider pouˇz´ıváme a jaká práva poˇzadujeme. Tato práva jsou pak poˇzadována pˇri instalaci aplikace, jej´ım schválen´ım jsou pak potvrzena.

Vytvoˇ ren´ı dotazu Dotaz vytvoˇr´ıme pˇr´ıkazem z u ´vodu kapitoly (Kód 3.1). V´ yraz, kter´ y urˇcuje jaké ˇra´dky vrátit, je rozdˇelen do dvou argument˚ u - selection a selectionArgs. Argument selection je kombinac´ı logick´ ych v´ yraz˚ u. názv˚ u sloupc˚ u a hodnot. Hodnoty lze nahradit znakem ? v tomto pˇr´ıpadˇe jsou pak doplnˇeny z pole hodnot SelectionArgs. Toto rozdˇelen´ı, aˇckoliv nen´ı vyˇzadováno, zvyˇsuje bezpeˇcnost, nebot’ zamezuje pouˇzit´ı injektáˇze pˇr´ıkazu (vloˇzen´ı pˇr´ıkaz˚ u do promˇenn´ ych, které maj´ı doplnit data).

3.1.4

Zobrazen´ı v´ ysledk˚ u dotazu

Metoda ContentResolver.query() vrac´ı vˇzdy Cursor (objekt implementuj´ıc´ı rozhran´ı Cursor, dále jen kurzor) obsahuj´ıc´ı u ´daje z tabulky urˇcené uri, pˇresnˇeji ty sloupce, které jsou specifikované argumentem projection v ˇrádc´ıch 9


Contact Provider

které jsou urˇcené argumenty selection a selectionArgs. Kurzor umoˇzn ˇuje ˇcten´ı dat, které obsahuje. Pomoc´ı kurzoru pak m˚ uˇzeme iterovat skrze navrácená data po ˇra´dc´ıch. Nˇekteré kurzory dokonce reflektuj´ı zmˇeny ve zdrojov´ ych datech, ˇci na nˇe alespoˇ n upozorˇ nuj´ı. Pro zobrazen´ı dat z kurzoru m˚ uˇzeme: 1. zobrazit data pomoc´ı adaptéru (tˇr´ıda implementuj´ıc´ı rozhran´ı Adapter), do kterého pˇredáme kurzor jako parametr 2. iterovat kurzorem pˇres metodu moveToNext(), data z´ıskáme pomoc´ı getString(index) a obdobn´ ych metod (getInt(index)...)

3.1.5

Vkl´ ad´ an´ı, aktualizace a maz´ an´ı dat

Pouˇz´ıvaj´ı se opˇet metody content resolveru, konkrétnˇe: • ContentResolver.insert() • ContentResolver.update() • ContentResolver.delete()

3.1.6

Kontrakty

Kontraktn´ı tˇr´ıda je tˇr´ıda, která definuje konstanty, které pomáhaj´ı klientsk´ ym aplikac´ım pracovat s URI, jmény sloupc˚ u, a dalˇs´ımi funkcemi content provideru. Kontraktn´ı tˇr´ıdy neexistuj´ı ke content provideru automaticky, v´ yvojáˇr pˇr´ısluˇsného provideru je mus´ı implementovat. Mnoho provider˚ u z platformy Android má svoje kontaktn´ı tˇr´ıdy v bal´ıˇcku android.provider.

3.2

Contact Provider

Content provider pro práci s kontakty je tˇr´ıda ContactProvider (dále jen contact provider). Platforma Android umoˇzn ˇuje ukládat do zaˇr´ızen´ı mnoho r˚ uzn´ ych kontaktn´ıch informac´ı, nav´ıc z v´ıce zdroj˚ u. Tomu odpov´ıdá pomˇernˇe sloˇzit´ y návrh organizace tˇechto dat, a velmi ˇsiroká paleta tˇr´ıd a rozhran´ı pro pˇr´ıstup k dat˚ um.

10


Contact Provider

Obrázek 3.1: Struktura kontakt˚ u na platformˇe Android[9]

3.2.1

Organizace kontakt˚ u

Jak m˚ uˇzeme vidˇet na obrázku 3.1, existuj´ı tˇri typy dat o kontaktech[9]: 1. Kontakty: ˇra´dky reprezentuj´ı r˚ uzné osoby na základˇe spojen´ı ˇrádk˚ u z tabulky RawContacts. Toto jsou kontakty, které se zobrazuj´ı uˇzivateli v seznamu kontakt˚ u v telefonu. 2. Raw kontakty: ˇra´dky obsahuj´ıc´ı souhrn osobn´ıch dat kontaktu vzeˇsl´ ych z jednoho u ´ˇctu (m´ıstn´ı kontakt, google, facebook. . . ). 3. Data: ˇra´dky reprezentuj´ı jeden kontaktn´ı u ´daj (email, telefon´ı ˇc´ıslo..). Ke kaˇzdému z tˇechto typ˚ u tabulek pˇristupujeme pomoc´ı jejich kontraktn´ıch tˇr´ıd. Tyto tˇr´ıdy definuj´ı konstanty pro jména tabulek, sloupc˚ u a dalˇs´ı. Obalovac´ı tˇr´ıda pro vˇsechny kontraktn´ı tˇr´ıdy pro práci s kontakty je tˇr´ıda ContactContract. Kromˇe ContactsContract.Contacts, ContactsContract.Data a ContactsContract.RawContacts existuj´ı jeˇstˇe dalˇs´ı kontraktn´ı tˇr´ıdy. Jsou to napˇr´ıklad pomocné tabulky, které contact provider pouˇz´ıvá k ˇr´ızen´ı sv´ ych ˇcinnost´ı nebo k podpoˇre specifick´ ych funkc´ı telefonn´ıch aplikac´ı.

11


3.2.2

Contact Provider

Raw contacty

Raw kontakt obsahuje vˇsechna data vztahuj´ıc´ı se k jedné osobˇe na jednom u ´ˇctu (´ uˇcet je napˇr [email protected], nebo m´ıstn´ı kontakt). Toto tvrzen´ı nemus´ı b´ yt pˇresné pokud má uˇzivatel na u ´ˇctu duplicitn´ı kontakty, pak je na jednom u ´ˇctu v´ıce raw kontakt˚ u pro jednu osobu. Protoˇze contact provider umoˇzn ˇuje pouˇz´ıvat v´ıce u ´ˇct˚ u jako zdroj˚ u kontaktn´ıch dat, m˚ uˇzeme m´ıt v´ıce raw kontakt˚ u vztahuj´ıc´ıch se k jedné fyzické osobˇe. Také je moˇzné kombinovat data z v´ıce u ´ˇct˚ u stejného typu ([email protected]., [email protected]), u ´daj z kaˇzdého takového u ´ˇctu má také sv˚ uj raw kontakt, i kdyˇz jde o stejnou osobu. Vˇetˇsina osobn´ıch dat vˇsak nen´ı uloˇzena v tabulce raw kontakt˚ u. Nacház´ı se totiˇz v tabulce dat. Kaˇzd´ y ˇrádek z této tabulky pak obsahuje sloupec Data.RAW CONTACT ID, ve kterém je uloˇzeno RawContacts. ID, které ukazuje na pˇr´ısluˇsn´ y raw kontakt - tedy na ˇra´dek v tabulce raw kontakt˚ u. D˚ uleˇzité sloupce tabulky rawContacts: • ACCOUNT NAME - Jméno u ´ˇctu ze kterého pocházej´ı data pro raw kontakt. Napˇr´ıklad emailová adresa pro u ´ˇcet na googlu. ´ˇctu, ze kterého pocház´ı data pro raw kontakt. Napˇr´ıklad • ACCOUNT TYPE - Typ u com.google pro google u ´ˇcet. • DELETED - Znaˇcka urˇcuj´ıc´ı, zdali je kontakt platn´ y. Slouˇz´ı k synchronizaci s online sluˇzbami (aby byl kontakt smazán i z cloudu). V´ yˇcet vˇsech sloupc˚ u tabulky ContactsContract.RawContacts dostupn´ ych pˇres contact provider je uveden v pˇr´ıloze D.

3.2.3

Data

V tabulce ContactsContract.Data jsou uloˇzená v ˇra´dc´ıch jednotlivá data, která jsou s raw kontaktem spojena pomoc´ı sloupce ID. Takové uspoˇra´dán´ı umoˇzn ˇuje, aby mˇel jeden raw kontakt v´ıce dat stejného typu, tedy napˇr. v´ıce telefonn´ıch ˇc´ısel. V tabulce jsou uloˇzeny vˇsechny typy dat, které by mohly ke kontaktu patˇrit, jako zobrazované jméno, telefonn´ı ˇc´ıslo, email, adresa nebo fotografie. Aby nemˇela tabulka ContactsContract.Data pˇr´ıliˇs mnoho sloupc˚ u pro potˇreby r˚ uzn´ ych druh˚ u dat, má jen nˇejaké sloupce pro urˇcen´ y typ záznamu, a zbylé s generick´ ym jménem, tedy pro libovolná data. 12


Contact Provider

Sloupce s urˇcen´ ym obsahem: y spojuje data s raw kontaktem. • RAW CONTACT ID: Identifikátor, kter´ • MIMETYPE: Typ dat v ˇra´dku. Pouˇz´ıvá se MIME type, typy jsou definované v kontraktn´ı tˇr´ıdˇe ContactsContract.CommonDataKinds. • IS PRIMARY: Znaˇc´ı, jestli jsou data v rámci raw kontaktu primárn´ı. Má to v´ yznam v pˇr´ıpadˇe, ˇze jeden raw kontakt ukazuje na v´ıce instanc´ı stejného typu dat (v´ıce telefonn´ıch ˇc´ısel, mail˚ u. . . ). Dále je v tabulce 15 sloupc˚ u pro generická data pojmenovan´ ych DATA1 aˇz DATA15 a dalˇs´ı 4 generické sloupce SYNC1 aˇz SYNC4, které by mˇely b´ yt pouˇzity pouze adaptéry pro synchronizaci. K tˇemto sloupc˚ um lze vˇzdy pˇristupovat pomoc´ı generického jména, bez ohledu na to, kter´ y datov´ y typ obsahuj´ı. Stejnˇe tak lze ale k pol´ım pˇristupovat pomoc´ı konstant z kontraktn´ıch tˇr´ıd konkrétn´ıch typ˚ u dat. Sloupec DATA1 je indexován. Contacts Provider pouˇz´ıvá tento sloupec pro data, která b´ yvaj´ı poˇzadována nejˇcastˇeji (pokud se tedy jedná o email, obsahuje emailovou adresu). Podle konvence je sloupec DATA15 rezervován pro Binary Large Object (BLOB), coˇz jsou napˇr´ıklad náhledy fotek. V´ yˇcet vˇsech sloupc˚ u tabulky ContactsContract.Data dostupn´ ych pˇres contact provider je uveden v pˇr´ıloze E. Jak bylo jiˇz zm´ınˇeno v´ yˇse, jména generovan´ ych sloupc˚ u dle typu dat lze naj´ıt v pˇr´ısluˇsn´ ych kontraktn´ıch tˇr´ıdách. Tyto kontraktn´ı tˇr´ıdy jsou definovány ve tˇr´ıdˇe ContactsContract.CommonDataKinds. Konstanty v kontaktn´ıch tˇr´ıdách pomáhaj´ı pˇri identifikaci sloupc˚ u v kódu. Jak to funguje, pˇribl´ıˇz´ı obrázek 3.2. Napravo je vidˇet jeden ˇra´dek tabulky Data, tak jak je uloˇzen v databázi, nalevo je pak jeho interpretace pomoc´ı konstant ze tˇr´ıdy ContactsContract.CommonDataKinds.Email ˇ ymi datov´ Cast´ ymi typy jsou: • ContactsContract.CommonDataKinds.StructuredName • ContactsContract.CommonDataKinds.Phone • ContactsContract.CommonDataKinds.Email • ContactsContract.CommonDataKinds.Photo • ContactsContract.CommonDataKinds.GroupMembership 13


Contact Provider

Obrázek 3.2: Struktura jednoho ˇra´dku v tabulce data[9]

3.2.4

Kontakty

Kontakt kombinuje vˇsechny raw contacty vˇsech typ˚ u a jmen u ´ˇct˚ u. T´ım zobraz´ı vˇsechna uloˇzená data o jedné fyzické osobˇe. Contacts provider se stará o vytvoˇren´ı nov´ ych ˇra´dek tabulky kontakt˚ u, a spojován´ı raw kontakt˚ u pod jedn´ım ˇrádkem v tabulce contact. Aplikace ani adaptéry synchronizace nemohou pˇridávat kontakty do tabulky contact, nav´ıc nˇekteré sloupce tabulky jsou jen ke ˇcten´ı[9] . Contacts Provider vytváˇr´ı nov´ y kontakt v pˇr´ıpadˇe, ˇze byl vytvoˇren nov´ y raw kontakt, kter´ y nepatˇr´ı k ˇza´dnému z existuj´ıc´ıch kontakt˚ u. Provider vytvoˇr´ı nov´ y kontakt také tehdy, pokud se raw kontakt zmˇen´ı takov´ ym zp˚ usobem, ˇze uˇz nem˚ uˇze b´ yt pˇriˇrazen k souˇcasnému kontaktu. Pokud aplikace nebo adaptér pro synchronizaci vytvoˇr´ı nov´ y raw kontakt, kter´ y lze pˇriˇradit k existuj´ıc´ımu kontaktu, nov´ y kontakt se nevytváˇr´ı. Contacts provider pˇripojuje kontakt k raw kontaktu pomoc´ı sloupce ID v tabulce ContactsContract.Contacts, sloupec CONTACT ID v tabulce raw kontakt˚ u ContactsContract.RawContacts obsahuje hodnoty ID, které ukazuj´ı na pˇr´ısluˇsn´ y ˇrádek tabulky kontakt˚ u. Tabulka kontakt˚ u má také sloupec LOOKUP KEY, kter´ y je permanentn´ım odkazem na jeden záznam v tabulce kontakt˚ u. To je nutné z toho d˚ uvodu, ˇze contact provider m˚ uˇze zmˇenit ID kontaktu na základˇe sluˇcován´ı raw kontakt˚ u nebo dalˇs´ıch

14


Contact Provider

Obrázek 3.3: Vzájemn´ y vztah kontakt˚ u raw kontakt˚ u a dat[9] zmˇen automaticky. I kdyˇz se to stane, content URI CONTENT LOOKUP URI v yˇz kontakt. Tento kombinaci s LOOKUP KEY kontaktu bude stále odkazovat na tent´ sloupec má formátován´ı nezávislé na sloupci ID. V´ yˇcet dalˇs´ıch sloupc˚ u tabulky ContactsContract.Contacts dostupn´ ych pˇres contact provider je uveden v pˇr´ıloze C. Na obrázku 3.3 vid´ıme opˇet vztah vˇsech tˇr´ı tabulek. V telefonu (patˇr´ıc´ımu Emily Dickinsonové) se nacház´ı kontakt Thomas Higginson. Tento kontakt v sobˇe sluˇcuje tˇri raw kontakty, které se vˇsechny vztahuj´ı k osobˇe Thomase Higginsona. Dva pocház´ı z Emilyn´ ych u ´ˇct˚ u na gmailu, jeden z twitteru. Kaˇzd´ y z tˇechto raw kontakt˚ u pak ukazuje na nˇekolik ˇrádk˚ u v tabulce data (posledn´ı blok dole). Jeden ze tˇr´ı raw kontakt˚ u tak obsahuje hned tˇri emaily (na tutéˇz osobu).

3.2.5

Opr´ avnˇ en´ı potˇ rebn´ a pro pr´ aci s kontakty

Aplikace, které chtˇej´ı pouˇz´ıvat contacts provider, mus´ı poˇza´dat pˇri instalaci o následuj´ıc´ı práva: • pro ˇcten´ı kontakt˚ u: android.permission.READ CONTACTS • pro zápis do tabulky kontakt˚ u: android.permission.WRITE CONTACTS

15


Contact Provider

Tato práva je tˇreba uvést do souboru AndroidManifest.xml (do koˇrenového elementu)

3.2.6

Propojov´ an´ı kontakt˚ u

Propojen´ım kontakt˚ u na platformˇe Android rozum´ıme proces, kdy spoj´ıme dva ˇci v´ıce raw kontakt˚ u pod jeden kontakt. Systém Android takto spojuje nebo nab´ız´ı ke spojen´ı kontakty, které povaˇzuje za shodné - patˇr´ıc´ı ke stejné osobˇe. Kontakty sluˇcuje, pokud plat´ı jedna z následuj´ıc´ıch podm´ınek[22]: 1. Souhlas´ı jméno i pˇr´ıjmen´ı. 2. Souhlas´ı jméno i pˇr´ıjmen´ı, liˇs´ı se poˇrad´ı jména a pˇr´ıjmen´ı. 3. Pˇr´ıjmen´ı souhlas´ı, kˇrestn´ı jméno je zkrácené (je vˇsak d˚ uvod se domn´ıvat ˇze tato funkcionalita je omezená jen pro angliˇctinu, nebo nˇekolik hlavn´ıch svˇetov´ ych jazyk˚ u, pro ˇceˇstinu nefunguje). 4. Souhlas´ı pˇr´ıjmen´ı nebo jméno, a zároveˇ n má jeden z kontakt˚ u jen jméno nebo pˇr´ıjmen´ı a zároveˇ n souhlas´ı telefonn´ı ˇc´ıslo nebo mail. 5. Jeden z kontakt˚ u nemá jméno ani pˇr´ıjmen´ı a souhlas´ı mail nebo telefonn´ı ˇc´ıslo. Pˇr´ısluˇsná pole která je tˇreba zmˇenit, abychom kontakty propojili z vlastn´ı aplikace, nejsou bohuˇzel pˇres content provider dostupná. Jedin´ ym ˇreˇsen´ım, jak kontakty manuálnˇe spojit je tabulka AggregationExceptions.

Aggregation Exceptions Aggregation exceptions je tabulka obsahuj´ıc´ı identifikátory dvojic raw kontakt˚ u, jejichˇz propojován´ı nemá prob´ıhat automaticky. Ke kaˇzdé dvojici je ve tˇret´ım sloupci tabulky pˇriˇrazena jedna ze tˇr´ı hodnot[11]: • TYPE AUTOMATIC: Propojován´ı prob´ıhá automaticky, ˇr´ıd´ı ho contact provider. • TYPE KEEP SEPARATE: Kontakty se nepropoj´ı, pˇresto ˇze by contact provider nalezl shodu.

16


Nedostatky v oficiáln´ı dokumentaci

• TYPE KEEP TOGETHER: Kontakty se ihned spoj´ı a z˚ ustanou propojené, dokud je uˇzivatel nerozpoj´ı (a tento záznam se tak smaˇze). Kontraktn´ı tˇr´ıdou pro tuto tabulku je tˇr´ıda AggregationException. Slouˇcen´ı kontakt˚ u v Aplikaci se pak provede napˇr´ıklad tak jak to vid´ıme v kódu 3.2: ContentValues cv = new ContentValues(); cv.put(AggregationExceptions.TYPE, AggregationExceptions.TYPE_KEEP_TOGETHER); cv.put(AggregationExceptions.RAW_CONTACT_ID1, rawKontaktIdKontaku1); cv.put(AggregationExceptions.RAW_CONTACT_ID2, rawKontakIdKontaku2); getContentResolver().update(AggregationExceptions.CONTENT_URI, cv, null, null);

Kód 3.2: Pˇr´ıklad kódu pro slouˇcen´ı dvou kontakt˚ u [26].

3.3

Nedostatky v ofici´ aln´ı dokumentaci

Pˇrestoˇze je dokumentace platformy Android velice obsáhlá a pˇrehledná, nˇekteré podstatné aspekty práce s kontakty tam popsány nejsou. Právˇe tˇemto nezdokumentovan´ ym témat˚ um bude vˇenována následuj´ıc´ı ˇca´st bakaláˇrské práce.

3.3.1

Pr´ ace s kontakty z Facebooku

Pokud pˇri dotazován´ı na kontakty pˇres contact provider neuvedeme parametr selection (respektive zavoláme metodu ContentResolver.query s parametrem selection = null), mˇel by nám contact provider vrátit kurzor se vˇsemi kontakty. Ve skuteˇcnosti vˇsak vrát´ı vˇsechny kontakty s v´ yjimkou kontakt˚ u pocházej´ıc´ıch z Facebooku[20, 17]. Vlastn´ım pr˚ uzkumem v databázi kontakt˚ u jsem dospˇel k závˇeru, ˇze je za to zody je u kontakt˚ u z Facebooku nastaven na povˇedn´ y sloupec is restricted, kter´ hodnotu jedna. Tento sloupec je skryt´ y, contact provider jeho obsah neposkytuje, uˇzivatel ani programátor se tak o existenci takového sloupce v˚ ubec nedozv´ı, dokud se nepod´ıvá pˇr´ımo do databáze kontakt˚ u (která je na bˇeˇzném zaˇr´ızen´ı nepˇr´ıstupná). D˚ uvod tohoto omezen´ı ani jeho existence nejsou oficiálnˇe známi, z r˚ uzn´ ych zdroj˚ u[3, 16] lze vˇsak dovodit, ˇze se moˇzná jedná o neveˇrejnou dohodu mezi spoleˇcnost´ı Google a Facebook. 17


Nedostatky v oficiáln´ı dokumentaci

S kontakty z Facebooku tak nelze na bˇeˇzném zaˇr´ızen´ı s operaˇcn´ım systémem Android v˚ ubec pracovat. Jedinou moˇznost´ı je kontakty nejprve odemknout v databázi. Takové ˇreˇsen´ı je vˇsak dostupné pouze na zaˇr´ızen´ı, kde má uˇzivatel administrátorská práva (standardnˇe prodávaná zaˇr´ızen´ı nemaj´ı administrátorská práva, pro jejich z´ıskán´ı je tˇreba nakonfigurovat zaˇr´ızen´ı pomoc´ı PC). Zaj´ımavost´ı dále m˚ uˇze b´ yt to, ˇze defaultn´ı kontaktn´ı aplikace telefonu pˇr´ıstup ke kontakt˚ um Facebooku maj´ı (pokud uˇzivatel nastavil synchronizaci se sluˇzbou Facebook). Ze zdrojového kódu je vˇsak patrné, ˇze dotaz prostˇrednictv´ım content resolveru je zcela standardn´ı. Rozpoznávac´ı mechanismus tak bude pˇr´ımo v provideru, coˇz je logické i z hlediska bezpeˇcnosti, nebot’ takov´ y systém nelze obej´ıt.

3.3.2

Zmˇ ena n´ azvu kontaktu

Ze specifikace kontraktn´ı tˇr´ıdy pro tabulku kontakt˚ u je zˇrejmé, ˇze vˇetˇsina pol´ı v této tabulce je pouze ke ˇcten´ı, mˇenit je nelze[12]. To je pˇrekáˇzkou v pˇr´ıpadˇe ˇze chceme u propojen´ ych kontakt˚ u urˇcit zobrazovanou fotku a název (tedy chtˇeli bychom zmˇenit pole photo id a neme raw contact id). Z dokumentace kontraktn´ı tˇr´ıdy pro tabulku data ale vypl´ yvá, ˇze by mˇelo b´ yt moˇzné primárn´ı kontakt pro fotku stejnˇe jako pro název zast´ınit pomoc´ı sloupce is super primary[13]. Tento postup funguje pro kontaktn´ı fotku, pro název je ale hodnota sloupce ignorována. Nelze tak ani t´ımto zp˚ usobem urˇcit, ze kterého z kontakt˚ u se vybere zobrazovac´ı jméno pro propojen´ y kontakt. Tento problém uˇz je navrhnut k ˇreˇsen´ı nejménˇe od roku 2010[7], stále ale nen´ı vyˇreˇsen.

18

4 Struktura aplikace Vyhotovená aplikace d˚ uslednˇe pouˇz´ıvá tˇr´ıvrstvou architekturu. Byla vybrána z d˚ uvodu snadné orientace ve zdrojovém kódu a snazˇs´ı nahraditelnosti jednotliv´ ych ˇca´st´ı. Dále toto rozdˇelen´ı znaˇcnˇe usnadˇ nuje platforma Android, která má vytvoˇrené dobré zázem´ı pro prezentaˇcn´ı vrstvu aplikac´ı. Zjednoduˇsené rozdˇelen´ı do tˇr´ı vrstev m˚ uˇzeme vidˇet na obrázku 4.1. Aplikace byla nazvána prost´ ym anglick´ ym pˇrekladem Contact Merge. Hlavn´ı ˇ ikonu aplikace vytvoˇrila Veronika Cesalová (Chelsea College of Art - Lond´ yn). Defeultn´ı ikona kontaktu pocház´ı ze stránek www.iconfinder.com[10], kde je k dispozici volnému pouˇzit´ı.

4.1

Prezentaˇ cn´ı vrstva

Prezentaˇcn´ı vrstva je, jak je tomu na platformˇe Android obvyklé, tvoˇrena tˇr´ıdami odvozen´ ymi od tˇr´ıdy android.app.Activity (dále jen aktivita). Kaˇzdá aktivita zastupuje jeden pohled na aplikaci. Mezi tˇemito pohledy se pohybujeme pomoc´ı tlaˇc´ıtek uˇzivatelského rozhran´ı (dále UI). Aplikace Contact Merge obsahuje ˇsest aktivit. Kaˇzdá bude krátce probrána n´ıˇze. Celé schéma presenˇcn´ı vrstvy z pohledu uˇzivatele se nacház´ı na obrázku B.1 v pˇr´ılohách.

4.1.1

Fragmenty

V uˇzivatelském rozhran´ı je na mnoha m´ıstech pouˇzito takzvan´ ych fragment˚ u. Tyto tˇr´ıdy dostupné od API 11[18] znaˇcnˇe zjednoduˇsuj´ı moˇznost v budoucnu optimalizovat aplikaci pro zaˇr´ızen´ı s vˇetˇs´ımi displayi, napˇr´ıklad tablety[5]. Dva fragmenty, které jsou na telefonu ve dvou aktivitách m˚ uˇzeme dát na tabletu do jedné aktivity vedle sebe, jak je vidˇet na obrázku 4.2. Takové pouˇzit´ı je moˇzné napˇr´ıklad u tˇr´ıd ResultListFragment a ResultDetailFragment. Tˇr´ıda ResultListFragment dˇed´ı od speciáln´ı tˇr´ıdy ListFragment, která je protˇejˇskem tˇr´ıdy ListActivity pro fragmenty[5]. Zat´ım rozhran´ı aplikace pro v´ıce velikost´ı obrazovky optimalizováno nen´ı, cesta pro to, aby to tak v budoucnu bylo, je ale d´ıky fragment˚ um pˇripravená.

19

Struktura aplikace

Prezentaˇcn´ı vrstva

Obrázek 4.1: Struktura aplikace Contact Merge.

20

Struktura aplikace


Obrázek 4.2: V´ yhoda pouˇzit´ı fragment˚ u[19]

4.1.2

Vynech´ an´ı aktivit z historie

Bˇeˇzné aplikace na platformˇe android maj´ı hierarchickou strukturu. Tlaˇc´ıtko zpˇet pak v takové aplikaci vede k nadˇrazené aktivitˇe, pˇr´ıpadnˇe zav´ırá celou aplikaci. V aplikaci Contact Merge je vˇsak pˇr´ıtomna i lineárn´ı struktura, od u ´vodn´ı aktivity pˇres aktivitu hledán´ı aˇz k aktivitˇe nalezen´ ych v´ ysledk˚ u (viz. obr B.1 v pˇr´ılohách). Pˇri navigaci pomoc´ı tlaˇc´ıtka zpˇet se v takovém pˇr´ıpadˇe nˇekdy nechceme dostat na pˇredchoz´ı aktivitu. Napˇr´ıklad dostat se z aktivity nalezen´ ych v´ ysledk˚ u k aktivitˇe hledán´ı nedává ˇza´dn´ y smysl. Tento problém se nejlépe ˇreˇs´ı deklarativn´ı cestou v souboru AndroidManifest.xml, jak je vidˇet v kódu 4.1 (atribut noHistory).

Kód 4.1: Nastaven´ı aktivity tak, aby byla ignorována pˇri navigaci pomoc´ı tlaˇc´ıtka zpˇet.

21

Struktura aplikace


´ Obrázek 4.3: Uvodn´ ı aktivita aplikace Contact Merge.

4.1.3

Struˇ cn´ y popis aktivit

´ Uvodn´ ı aktivita ´ Uvodn´ ı aktivitu m˚ uˇzeme vidˇet na obrázku 4.3. Zde má uˇzivatel moˇznost vybrat, jaké zp˚ usoby hledán´ı chce pouˇz´ıt. Zp˚ usoby jsou rozdˇeleny do modul˚ u, z nichˇz kaˇzd´ y bude porovnávat jin´ y typ dat, nebo stejn´ y typ, ale zásadnˇe odliˇsn´ ym zp˚ usobem. V´ıce zaˇskrtnut´ ych modul˚ u znamená v´ıce ˇcasu pro bˇeh programu, ale také m˚ uˇze znamenat lepˇs´ı v´ ysledky. Kaˇzd´ y modul se dá konfigurovat v nastaven´ı modulu, do kterého se dostaneme po klepnut´ı na název modulu. Moduly se naˇc´ıtaj´ı do seznamu z aplikaˇcn´ı vrstvy, m˚ uˇzeme tedy pˇridat dalˇs´ı aniˇz bychom zasahovali do UI. Tlaˇc´ıtkem v doln´ı ˇca´sti obrazovky zapoˇcne hledán´ı dle námi navolené konfigurace. Tlaˇc´ıtkem unlock facebook contacts pak m˚ uˇzeme na telefontech s administrátorsk´ ymi právy odemknout kontakty ze s´ıtˇe Facebook (nutnost odemˇcen´ı byla popsána v teoretické ˇcásti v kapitole 3.3.1, realizace dále v kapitole 4.3.3). V této aktivitˇe se pˇri spuˇstˇen´ı (v metodˇe onCreate) inicializuje ModuleManager a RootManager (jejich funkce popsána dále). Pˇri startu ak22

Struktura aplikace


Obrázek 4.4: Aktivita nastaven´ı. tivity je tˇreba zjistit, zdali uˇz oba managery neexistuj´ı, pˇri opakované inicializaci by doˇslo k v´ yjimce. Takové situace m˚ uˇze nastat napˇr´ıklad pokud uˇzivatel otoˇc´ı telefon a operaˇcn´ı systém se pokus´ı zobrazit aktivitu na ˇs´ıˇrku“ [2]. ” Aktivita nastaven´ı modulu Tato aktivita slouˇz´ı pro konfiguraci modulu. Modul by mˇel b´ yt defaultnˇe nakonfigurován tak, aby naˇsel co nejv´ıce v´ ysledk˚ u, ale nˇekteré zp˚ usoby hledán´ı, které jsou pˇr´ıliˇs nároˇcné na ˇcas nebo pˇrináˇsej´ı faleˇsné kandidáty na spojen´ı (program navrhne spojit kontakty, které nepatˇr´ı k téˇze osobˇe), mohou b´ yt implicitnˇe vypnuty. Na obrázku 4.4 vid´ıme pouze jednu moˇznost s checkboxem, ale aplikace je navrˇzena tak, aby pˇridán´ı dalˇs´ıch voleb bylo snadné. Vˇsechna nastaven´ı jsou totiˇz uloˇzena v modulech (v aplikaˇcn´ı vrstvˇe). M˚ uˇzeme tak podobnˇe jako u modul˚ u pˇridat dalˇs´ı, aniˇz bychom zasahovali do prezentaˇcn´ı vrstvy.

Aktivita hled´ an´ı kontakt˚ u ke slouˇ cen´ı Tato aktivita zobrazuje po dobu svého bˇehu dialog s informacemi o pr˚ ubˇehu hledán´ı. Proces hledán´ı bˇeˇz´ı v samostatném vláknˇe, tedy nedocház´ı k zamrznut´ı UI 23

Struktura aplikace


Obrázek 4.5: Aktivita sluˇcován´ı kontakt˚ u: 1) indikátor celkového postupu; 2) stavov´ y ˇra´dek postupu - zobrazuje jméno bˇeˇz´ıc´ıho modulu; 3) indikátor postupu modulu; 4) stavov´ y ˇra´dek modulu - zobrazuje ˇcinnost kterou modul vykonává; 5) indikátor postupu právˇe vykonávané ˇcinnosti. v dobˇe v´ ypoˇctu. Pro multithreading je pouˇzitá metoda/tˇr´ıda asyncTask[4]. Realizace byla inspirována návodem na serveru codingforandroid.com.[8]. Uˇzivatelské rozhran´ı aktivity vid´ıme na obrázku 4.5.

Aktivita v´ ysledk˚ u hled´ an´ı V této aktivitˇe se zobrazuj´ı v´ ysledky hledán´ı. Celou aktivitu vid´ıme na obrázku 4.6. Checkbox vlevo urˇcuje, zdali chceme, aby po stisku tlaˇc´ıtka v doln´ı ˇca´sti doˇslo ke spojen´ı kontakt˚ u. V pravé ˇcásti jsou pod sebou jména obou kontakt˚ u urˇcen´ ych ke spojen´ı. Pokud by nám jména k identifikaci nestaˇcila, dostaneme se po kliknut´ı k detail˚ um obou kontakt˚ u.

Aktivita detail kontaktu V této aktivitˇe se zobrazuje detail jednoho kontaktu. Do aktivity se dostaneme po klepnut´ı na ˇra´dek seznamu v´ ysledk˚ u. Celou aktivitu vid´ıme na obrázku 4.7. Po pouˇzit´ı tlaˇc´ıtka merge contacts se dostaneme na aktivitu individuáln´ıho propojen´ı 24

Struktura aplikace


Obrázek 4.6: Aktivita v´ ysledk˚ u hledán´ı. kontakt˚ u, tlaˇc´ıtko discard nás vrát´ı zpˇet do seznamu kandidát˚ u k propojen´ı, z kterého bude odstranˇena poloˇzka v jej´ımˇz detailu jsme se nacházeli.

Aktivita individu´ aln´ıho propojen´ı kontakt˚ u V této aktivitˇe docház´ı ke slouˇcen´ı jedné dvojice kontakt˚ u. Nejprve vybereme jméno a fotku kontaktu, pak klikneme na tlaˇc´ıtko ok. Vlastn´ı sluˇcován´ı kontakt˚ u prob´ıhá v samostatném vláknˇe, nedocház´ı proto ke zpomalen´ı uˇzivatelského rozhran´ı. Celou aktivitu vid´ıme na obrázku 4.8.

Aktivita sluˇ cov´ an´ı v´ıce kontakt˚ u Do této aktivity se dostaneme po klepnut´ı na tlaˇc´ıtko merge selected v seznamu nalezen´ ych v´ ysledk˚ u. Zobrazuj´ı se zde vˇsichni kandidáti k propojen´ı, které jsme zaˇskrtli v aktivitˇe v´ ysledk˚ u. Po kliknut´ı na ˇra´dek v seznamu dojde k rozbalen´ı detail˚ u dvojice kontakt˚ u. Zde máme moˇznost zvolit název kontaktu a fotku. Po kliknut´ı na tlaˇc´ıtko start merging dojde ke slouˇcen´ı vˇsech kontakt˚ u v seznamu dle naˇseho nastaven´ı. Celá operace prob´ıhá ve zvláˇstn´ım vláknˇe, nedocház´ı tak ke zpomalován´ı UI. Celou aktivitu vid´ıme na obrázku 4.9. Pro tvorbu rozbalovac´ıho seznamu byl pouˇzit návod ze stránky androidhive.info[27]. 25

Struktura aplikace


Obrázek 4.7: Aktivita detail kontaktu.

Obrázek 4.8: Aktivita individuáln´ıho propojen´ı kontakt˚ u.

26

Struktura aplikace

Aplikaˇcn´ı vrstva

Obrázek 4.9: Aktivita propojován´ı v´ıce kontakt˚ u najednou. V obou aktivitách je pouˇzit´ y pro v´ ybˇer názvu a jména prvek obecnˇe znám´ y jako radio button. Um´ıstit do tohoto prvku m´ısto textu obrázek, jak bylo potˇreba u v´ ybˇeru fotografie se ukázalo jako nároˇcn´ y u ´kol. Nakonec byl problém vyˇreˇsen pomoc´ı nastaven´ı vlastnosti drawableRight tˇr´ıdy radioButton[28]. Dalˇs´ım problémem byla skuteˇcnost, ˇze obrázky kontakt˚ u jsou v zaˇr´ızen´ı uloˇzeny ve velmi mal´ ych rozmˇerech. K jejich zvˇetˇsen´ı byla pouˇzita metoda nalezená na stránce StackOverflov[25].

4.2

Aplikaˇ cn´ı vrstva

Aplikaˇcn´ı vrstva se skládá ze tˇr´ıdy ModulManager, která ˇr´ıd´ı cel´ y proces hledán´ı kontakt˚ u, a jednotliv´ ych modul˚ u, které hledán´ı provádˇej´ı. Dále jsou zde vlákna ˇreˇs´ıc´ı asynchronn´ı procesy hledán´ı a sluˇcován´ı kontakt˚ u. Manaˇzer modul˚ u je zodpovˇedn´ y za to, v jakém poˇrad´ı jsou moduly volány, a také napˇr´ıklad za to, ˇze bˇeˇz´ı jen ty moduly, které uˇzivatel zaˇskrtl v u ´vodn´ı aktivitˇe. Tˇr´ıda je implementována jako singleton, aby nebylo tˇreba pˇredávat odkaz na instanci napˇr´ıˇc aplikac´ı. Jednotlivé moduly pak provádˇej´ı hledán´ı, pˇri kterém ˇcerpaj´ı u ´daje z datové vrstvy, a následnˇe do n´ı ukládaj´ı nalezené kandidáty na spojen´ı. 27

Struktura aplikace


Obrázek 4.10: Moduly hledán´ı - Diagram tˇr´ıd

4.2.1

Syst´ em vyhled´ avac´ıch modul˚ u

Systém vyhledávac´ıch modul˚ u byl ˇreˇsen s d˚ urazem na snadnou rozˇsiˇritelnost. Maximum moˇzného kódu se nacház´ı v nadˇrazen´ ych abstraktn´ıch tˇr´ıdách - pro vytvoˇren´ı nového tak nen´ı tˇreba mnoho ˇcasu. Strukturu modul˚ u m˚ uˇzeme vidˇet na obrázku 4.10. Základn´ı tˇr´ıdou je tˇr´ıda SearchModule. Tato tˇr´ıda definuje základn´ı vlastnosti které mus´ı m´ıt kaˇzd´ y vyhledávac´ı modul, stejnˇe tak nab´ız´ı univerzáln´ı ˇreˇsen´ı tam, kde je jasné, ˇze ani v budoucnu nebude tˇreba ˇreˇsit vˇeci jinak. Tˇr´ıda SearchModule tak funguje nejen jako mateˇrská tˇr´ıda nab´ızej´ıc´ı zázem´ı pro svoje potomky, ale také jako rozhran´ı mezi moduly a tˇr´ıdou ModulesManager (správce modul˚ u). Kaˇzd´ y budouc´ı modul mus´ı tuto tˇr´ıdu oddˇedit, bud’ pˇr´ımo, nebo prostˇrednictv´ım jiné tˇr´ıdy. Tˇr´ıda SearchModule ˇreˇs´ı zejména: • Zdali je modul zapnut nebo vypnut - dle nastaven´ı uˇzivatel v UI. • Nastaven´ı modul˚ u - taktéˇz dle nastaven´ı uˇzivatel v UI. • Pomoc´ı abstraktn´ıch metod urˇcuje základn´ı metody potˇrebné pro kaˇzd´ y modul, od inicializace po urˇcen´ı kontaktu k propojen´ı. • Zde se nacház´ı metoda run(), kterou volá ModulesManager pokud je modul zapnut´ y, tato metoda je tak branou mezi správcem modul˚ u a modulem. Dalˇs´ı d˚ uleˇzitou tˇr´ıdou je tˇr´ıda SimpleSearchModule. Tato tˇr´ıda oddˇedˇená 28

Struktura aplikace


od tˇr´ıdy SearchModule pˇrináˇs´ı zázem´ı pro jednoduché moduly. Struktura bˇehu takov´ ychto jednoduch´ ych modul˚ u je: 1. Naˇc´ıst potˇrebná data z databáze. 2. Uloˇzit data do datov´ ych struktur vhodn´ ych pro efektivn´ı porovnáván´ı. 3. Porovnat vˇsechna data a uloˇzit nalezené kandidáty k propojen´ı do seznamu. Bˇeˇzn´ y modul pro hledán´ı kontakt˚ u k propojen´ı pak tˇr´ıdu SimpleSearchModule zdˇed´ı. Programátor nového modulu tak mus´ı doplnit pouze: 1. enum SearchSettings seznam moˇzn´ ych nastaven´ı modulu. 2. metodu getDisplayNameId() která vrac´ı id ˇretˇezce kter´ y obsahuje jméno modulu. (ˇretˇezce jsou deklarovány v XML a odkazovány pomoc´ı id, takov´ y postup je na platformˇe Android standardem) 3. metodu createSearchOptions() která vytvoˇr´ı seznam moˇzn´ ych nastaven´ı modulu. 4. metodu fillDataFromCursorLine(Cursor cursor) která pˇrevede jeden ˇra´dek dat z databáze na data vhodná k porovnáván´ı. 5. metodu getProjection() která urˇcuje jaká data (sloupce) z databáze poˇzadujeme. 6. metodu getSelection() která omezuje data z pˇredchoz´ı metody podle zadan´ ych kritéri´ı. 7. metodu dataAreAggregationCandidates(Data dataObject1, Data dataObject2) která urˇcuje zdali patˇr´ı data ke stejnému kontaktu.

4.2.2

Implementovan´ e moduly

V programu jsou vytvoˇreny vyhledávac´ı moduly. Prvn´ım modulem je telefonn´ı modul (PhoneNumberModule). Tento modul porovnává telefonn´ı ˇc´ısla kontakt˚ u. Nejprve uloˇz´ı do tˇr´ıdy PhoneNumber ˇc´ıslo bez mezinárodn´ı pˇredvolby, následnˇe ˇc´ısla porovnává. Urˇcován´ı pˇredvolby u ˇc´ısel se ukázalo jako sloˇzit´ y u ´kol, nebot’ pˇredvolba m˚ uˇze v r˚ uzn´ ych státech sestávat z jednoho aˇz tˇr´ı ˇc´ısel[23], nen´ı proto jednoduché pˇredvolbu od ˇc´ısla oddˇelit. Druh´ ym modulem je emailov´ y modul (EmailModule), kter´ y porovnává emailové adresy uˇzivatel˚ u. Pˇri defaultn´ım nastaven´ı modul oddˇeluje doménovou ˇcást. 29

Struktura aplikace

Datová vrstva

Dále modul oddˇeluje ˇca´sti emailové adresy pomoc´ı teˇcek a dalˇs´ıch znak˚ u. Tyto ˇcásti adresy pak mezi sebou porovnává, pˇriˇcemˇz v nastaven´ı lze urˇcit kolik shodn´ ych ˇca´st´ı je potˇreba, ˇci zda záleˇz´ı na jejich poˇrad´ı. Dalˇs´ım modulem je modul porovnávaj´ıc´ı názvy kontakt˚ u (NameModule). Tento modul je v mnohém podobn´ y jako modul pˇredchoz´ı, porovnává spolu ˇcásti názvu (oddˇelené mezerou) dle nastaven´ı uˇzivatele.

4.2.3

Parazitn´ı moduly

Pˇri navrhován´ı posledn´ıho modulu, kter´ y mˇel porovnávat jména s emailov´ ymi adresami vyvstala d˚ uleˇzitá otázka: Pokud pracuje modul se stejn´ ymi daty jako jin´ y modul, má data znovu naˇc´ıtat z databáze? Odpovˇed’ nebyla jednoduchá. Uˇzivatel totiˇz m˚ uˇze libovoln´ y modul deaktivovat, na data z nˇej tak nelze spoléhat. Nakonec bylo ˇreˇsen´ı nalezeno formou parazitn´ıch modul˚ u. Tyto moduly vyuˇzij´ı data z jiˇz probˇehl´ ych modul˚ u. pokud byly potˇrebné moduly deaktivovány, zavolá parazitn´ı modul metodu parasiteRun() (nacház´ı se ve tˇr´ıdˇe simpleSearchModule), která spust´ı naˇcten´ı dat v daném modulu, ale nepokraˇcuje hledán´ım kontakt˚ u k propojen´ı jako metoda run() téhoˇz modulu. Jedin´ ym parazitn´ım modulem v programu je modul pro porovnáván´ı email˚ u s názvy kontaktu (EmaiNameModule). Tento modul porovnává ˇcásti emailové adresy s ˇcásti názvu kontaktu. Takov´ y pˇr´ıstup je velk´ ym posunem vpˇred, nebot’ porovnáván´ı r˚ uzn´ ych dat kontaktu je nˇeco, co nenab´ız´ı ani vestavˇené ˇreˇsen´ı platformy Android, ani testované konkurenˇcn´ı aplikace.

4.3

Datov´ a vrstva

Centrem datové vrstvy je tˇr´ıda dataManager. Tato tˇr´ıda uchovává seznam nalezen´ ych kandidát˚ u na spojen´ı. Nav´ıc obsahuje vlastn´ı content provider a slouˇz´ı tak pro komunikaci s centráln´ım u ´loˇziˇstˇem dat v telefonu. Pro tuto komunikaci obsahuje mnoho metod, které odstiˇ nuj´ı aplikaˇcn´ı vrstvu od contact provideru. Pomoc´ı tˇechto metod z´ıskávaj´ı vyhledávac´ı moduly data potˇrebná pro bˇeh aplikace.

4.3.1

Z´ısk´ av´ an´ı kontakt˚ u k porovn´ an´ı

Tato ˇca´st aplikace vyˇzadovala velice dlouhou anal´ yzu. Nejprve byl zvaˇzován zp˚ usob z´ıskán´ı vˇsech kontaktn´ıch informac´ı z db pomoc´ı tzv. entit[22] (datová struktura 30

Struktura aplikace

Datová vrstva

obsahuj´ıc´ı data o kontaktu v podobˇe v jaké jsou potˇreba v aplikac´ıch, tedy vˇsechna data o jednom kontaktu na jednom m´ıstˇe), a následné práci nad tˇemito daty. Data by se tak nahrála do pamˇeti na zaˇca´tku procesu hledán´ı, v dobˇe práce vyhledávac´ıch modul˚ u uˇz by pak nebylo tˇreba pˇristupovat do databáze. Toto ˇreˇsen´ı nab´ızelo pˇrehledné oddˇelen´ı proces˚ u práce s databáz´ı a vyhledáván´ı, naproti tomu ale znamená vˇetˇs´ı zátˇeˇz na databázi, nebot’ by byla z´ıskávána i zcela nepotˇrebná data. Druhou zvaˇzovanou variantou byla moˇznost z´ıskávat jen potˇrebná data, ale opˇet hned na zaˇcátku procesu hledán´ı, pˇred bˇehem vyhledávac´ıch modul˚ u. Tato varianta byla taktéˇz zavrˇzena. Kritick´ ym problémem se totiˇz stal v´ yˇcet potˇrebn´ ych dat. V pˇr´ıpadˇe ˇze by byl v budoucnu vytvoˇren vyhledávac´ı modul potˇrebuj´ıc´ı nové typ dat, bylo by nutné zasahovat v´ yraznˇe i do datové vrstvy. Proto byla i tato varianta zavrˇzena. Nakonec byl zvolen takov´ y zp˚ usob, kdy kaˇzd´ y modul z´ıskává data aˇz na zaˇcátku svoj´ı práce, sám si urˇc´ı která data potˇrebuje. Zp˚ usob se ukázal jako velmi u ´ˇcinn´ y, fáze z´ıskáván´ı dat z databáze nen´ı nejpomalejˇs´ı ˇca´st´ı práce modulu, tak jak by se od databázov´ ych operac´ı oˇcekávalo, je v´ yraznˇe rychlejˇs´ı neˇz následné srovnáván´ı dat, obvykle se ani nezobraz´ı ve stavovém ˇrádku modulu (obr. 4.5 ˇc. 4). D˚ uvodem je to, ˇze vyhledávac´ı modul obvykle potˇrebuje jen jeden ˇci dva sloupce z tabulky data, coˇz je jen nepatrn´ y zlomek z informac´ı které vrac´ı entita. Záhy se ukázalo i jedno u ´skal´ı tohoto postupu, nˇekolik modul˚ u totiˇz m˚ uˇze pracovat se stejn´ ymi daty, tato data by pak byla z´ıskávána z databáze a uchovávána v´ıcekrát. Tento problém ale ˇreˇs´ı zaveden´ı parazitn´ıch modul˚ u popsan´ ych v kapitole 4.2.

4.3.2

Propojov´ an´ı kontakt˚ u

Propojován´ı kontakt˚ u prob´ıhá pomoc´ı pˇridáván´ı ˇra´dek do tabulky u které chceme propojit a s agg exceptions s identifikátory raw kontakt˚ typem TYPE KEEP TOGETHER - obdobnˇe jak to bylo ukázáno v kapitole 3.2.6. Po tom co jsou raw kontakty v aplikaci Contact Merge propojené, spust´ı se daleko nároˇcnˇejˇs´ı proces. Je totiˇz tˇreba v databázi zohlednit volbu zobrazovac´ıho jména a fotky kterou provedl uˇzivatel. Program nejdˇr´ıve otestuje jestli se volba uˇzivatele neshoduje s volbou provideru. Pokud se volba shoduje, nen´ı tˇreba dˇelat nic. Pokud se neshoduje, program volbu provideru zast´ın´ı svoj´ı volbou (zmˇenit/pˇrepsat ji nelze, jak bylo vysvˇetleno v kapitole 3.3.2) Pro zast´ınˇen´ı jména je pouˇzita technika známá z dokumentace[13] a popsaná 31

Struktura aplikace

Datová vrstva

Obrázek 4.11: Srovnán´ı postup˚ u pˇri nastaven´ı jména a fotky. V levé ˇca´sti je znázornˇen postup pro nastaven´ı fotky, v pravé pro nastaven´ı jména. kapitole 3.3.2. V téˇze kapitole je ale zm´ınˇeno ˇze obdobn´ y postup nelze pouˇz´ıt pro urˇcen´ı názvu kontaktu. Po mnoh´ ych ne´ uspˇeˇsn´ ych pokusech a dlouhém zvaˇzován´ı bylo nalezeno ˇca´steˇcné ˇreˇsen´ı. T´ım je vloˇzen´ı nového jména do dat raw kontaktu (staré jméno nemaˇzeme), kter´ y byl vybrán contact providerem a nastaven´ı tohoto jména jako primárn´ıho. Rozd´ılem je dále to, ˇze u nového záznamu nastavujeme pouze sloupec IS PRIMARY, nebot’ to ve kterém raw kontaktu se bude hledat primárn´ı jméno uˇz za nás urˇcil provider pomoc´ı sloupce NAME RAW CONTACT ID. Srovnán´ı nastaven´ı jména a fotky kontaktu je vidˇet na obrázku 4.11. T´ımto postupem je doc´ıleno ˇza´daného v´ ysledku, kontakt se nyn´ı zobrazuje v seznamu kontakt˚ u pod vybran´ ym jménem. Pot´ıˇze nastávaj´ı pokud uˇzivatel zaˇr´ızen´ı kontakt ruˇcnˇe rozdˇel´ı prostˇrednictv´ım seznamu kontakt˚ u. V takovém pˇr´ıpadˇe budou m´ıt oba oddˇelené kontakty stejné jméno. Celá procedura zahrnuje nˇekolik operac´ı modifikuj´ıc´ıch databázi. Proveden´ı kaˇzdého dotazu zvláˇst’ by bylo pomalé. Proto byla zvolena metoda, pˇri které se dotazy stˇra´daj´ı do dávky, která je spuˇstˇena pro vˇsechny sluˇcované kontakty najednou[24]. Pro uchováván´ı pˇr´ıkaz˚ u pro databázi se pouˇz´ıvá tˇr´ıda ContentProviderOperation, seznam operac´ı je pak pˇredán metodˇe ContentResolver.applyBatch.

4.3.3

Z´ısk´ av´ an´ı facebookov´ ych kontakt˚ u z datab´ aze

Jak jiˇz bylo ˇreˇceno v kapitole 3.3.1, z´ıskán´ı kontakt˚ u ze s´ıtˇe Facebook na standardn´ım zaˇr´ızen´ı bez administrátorsk´ ych práv nen´ı moˇzné. Pokud vˇsak uˇzivatel odemkl sv˚ uj telefon a uˇz´ıvá ho tedy jako administrátor, z´ıskán´ı kontakt˚ u moˇzné je. 32

Struktura aplikace

Datová vrstva

ˇ sen´ım V prohl´ıˇzen´ı kontakt˚ u z Facebooku nám brán´ı pˇr´ımo contact provider. Reˇ je tedy provider nˇejak´ ym zp˚ usobem obej´ıt. V této ˇca´sti bude popsána technika odemˇcen´ı facebookových kontakt˚ u pouˇzitá v této aplikaci, jako i moˇzné alternativn´ı techniky.

Root na Androidu Operaˇcn´ı systém Android je z bezpeˇcnostn´ıch d˚ uvod˚ u k bˇeˇznému uˇzivateli a aplikac´ım které spouˇst´ı velmi restriktivn´ı. Nav´ıc nemá uˇzivatel, na rozd´ıl od operaˇcn´ıch systém˚ u které známe ze stoln´ıch poˇc´ıtaˇc˚ u, zˇr´ızen´ y administrátorsk´ yu ´ˇcet. Nˇekteré u ´kony, které známe ze svˇeta Windows ˇci Linuxu, jsou tak pro bˇeˇzného vlastn´ıka zaˇr´ızen´ı s OS Android zapovˇezena. Pˇr´ıkazy potˇrebné k zpˇr´ıstupnˇen´ı facebookov´ ych kontakt˚ u tak, jak je to popsáno dále, bohuˇzel patˇr´ı do této mnoˇziny zapovˇezen´ ych u ´kon˚ u. Proto je tˇreba provést takzvan´ y root zaˇr´ızen´ı, po kterém z´ıská uˇzivatel telefonu administrátorsk´ y pˇr´ıstup k zaˇr´ızen´ı, kter´ y aktivuje prostˇrednictv´ım pˇr´ıkazu su (podobnˇe jako sudo na Linuxu) pˇredcházej´ıc´ım u ´kon, ke kterému je tˇreba administrátorsk´ ych práv. Zp˚ usob proveden´ı rootu se liˇs´ı podle typu zaˇr´ızen´ı, nav´ıc se jedná o odbornou problematiku net´ ykaj´ıc´ı se tématu této práce, proto zde nebude prob´ırán. D˚ uleˇzité je, ˇze root lze provést témˇeˇr na kaˇzdém zaˇr´ızen´ı, nav´ıc aplikac´ı které ho vyˇzaduj´ı je mnoho (bez rootu nebude na androidu plnˇe fungovat ani bˇeˇzn´ y souborov´ y manager typu Total Commander, nejdou odinstalovat nˇekteré aplikace...).

Technika pouˇ zit´ a v aplikaci Contact Merge Aplikace Contact Merge pouˇz´ıvá k pˇr´ıstupu ke kontakt˚ um z Facebooku techniku odemykán´ı kontakt˚ u. Nejprve pouˇzijeme pˇr´ıkaz pomoc´ı nˇehoˇz celou databázi pˇresuneme do nezabezpeˇceného u ´loˇziˇstˇe, napˇr´ıklad na SD kartu. Pˇred pˇresunem je jeˇstˇe potˇreba vypnout contact provider, nebot’ budeme upravovat jeho databázi mimo nˇej, obejdeme ho. Po pˇresunu pak mus´ıme zmˇenit práva k souboru databáze, aby s n´ım mohla pracovat naˇse aplikace. Kód pˇr´ıkaz˚ u je vidˇet v kódu 4.2. pm disable com.android.providers.contacts cp /data/data/com.android.providers.contacts/databases/contacts2.db /data/data/fido.contacts.merge/contacts2.db cd /data/data/fido.contacts.merge/ user=‘ls -ld ../fido.contacts.merge | awk ’{print $3}’‘ chown $user:$user contacts2.db

Kód 4.2: Pˇr´ıkaz pro zkop´ırován´ı databáze n kartu SD.

33

Struktura aplikace

Datová vrstva

Následnˇe m˚ uˇzeme manipulovat pˇr´ımo se souborem databáze, nebot’ ho nechrán´ı ani omezen´ı na pˇr´ıstup do sloˇzek ciz´ıch aplikac´ı, ani pˇr´ıstupová práva soubor˚ u. Databázi tedy uprav´ıme pomoc´ı SQL dotazu zadaného na nejniˇzˇs´ı u ´rovni - dotazu u kterého se nekontroluje správnost, oprávnˇen´ı, referenˇcn´ı integrita apod.. Takov´ y dotaz m˚ uˇzeme zadat pomoc´ı raw query[29]. Pro odemˇcen´ı kontakt˚ u staˇc´ı jednoduch´ y dotaz, jako v kódu 4.3. UPDATE raw_contacts SET is_restricted = 0 ’)

Kód 4.3: Dotaz na databázi kontakt˚ u pro odemˇcen´ı kontakt˚ u z Facebooku. Po vykonán´ı potˇrebného SQL dotazu pˇresuneme databázi zpˇet na m´ısto. Opˇet je tˇreba zmˇenit vlastn´ıka souboru, tentokrát zpˇet na provider. Nav´ıc nesm´ıme zapnout provider zapnout. Nav´ıc je tˇreba vymazat soubor databáze a ˇzurnálu ze sloˇzky naˇs´ı aplikace. Vˇse je vidˇet v kódu 4.4. cp -f /data/data/fido.contacts.merge/contacts2.db /data/data/com.android.providers.contacts/databases/contacts2.db cd /data/data/com.android.providers.contacts/ user=‘ls -ld databases | awk ’{print $3}’‘ chown $user:$user databases/contacts2.db cd /data/data/fido.contacts.merge/ rm contacts2.db rm contacts2.db-journal pm enable com.android.providers.contacts

Kód 4.4: Pˇr´ıkaz pro zkop´ırován´ı databáze zpˇet do adresáˇre contact provideru.

Jak jiˇz bylo ˇreˇceno, odemykán´ı kontakt˚ u funguje jen na zaˇr´ızen´ı kde má uˇzivatel práva administrátora. Pˇred vykreslen´ım UI se aplikace Contact Merge pˇresvˇedˇc´ı, jestli má uˇzivatel zaˇr´ızen´ı administrátorská práva (zdali jde o rootnuté“ zaˇr´ızen´ı). ” Pokud práva nemá, tlaˇc´ıtko k odemknut´ı kontakt˚ u se v˚ ubec nezobraz´ı. K tomuto testu a k samotnému spuˇstˇen´ı v´ yˇse uveden´ ych pˇr´ıkaz˚ u byl vyuˇzit kód z´ıskan´ y ze stránky StackOverflow[21].

Dalˇ s´ı moˇ znosti Jednou z dalˇs´ıch moˇznost´ı jak se dostat ke kontakt˚ um z Facebooku je SQL injektáˇz. Jedná se o techniku, kdy jsou provideru jako souˇca´st bˇeˇzn´ ych SQL dotaz˚ u podstrˇceny dotazy, které jinak provider nepovoluje. Tuto techniku jsem do detailu nezkoumal, nebot’ by taková práce nebyla programovˇe ˇcistá, pouˇzit´ı takové techniky by mohlo m´ıt nepˇr´ıjemné právn´ı d˚ usledky, a v neposledn´ı ˇradˇe by taková 34

Struktura aplikace

Kompatibilita

aplikace byla témˇeˇr jistˇe staˇzena z obchodu Play. Dalˇs´ı zvaˇzovanou variantou bylo pouˇzit´ı programu sqlite3. Jedná se o konzolov´ y program, kter´ y vykoná SQL dotaz na databázi, v´ ystupem programu jsou pak navrácená data. Pokud pˇred samotn´ y program nap´ıˇseme v konzoli pˇr´ıkaz su, vykonáme pˇr´ıkaz s administrátorsk´ ymi právy, d´ıky tomu m˚ uˇzeme pracovat i s databáz´ı jiného programu. Tato varianta byla nakonec zavrˇzena, program sqlite3 by musel b´ yt souˇcást´ı distribuce programu Contact Merge, nebot’ jiˇz nen´ı souˇca´st´ı vˇsech distribuc´ı Android. Pˇr´ıklad pˇr´ıkazu kter´ y odemkne kontakty z platformy facebook m˚ uˇzeme vidˇet v kódu 4.5. "su sqlite3 /data/data/com.android.providers.contacts/databases/contacts2.db \"UPDATE raw_contacts SET is_restricted = 0\""

Kód 4.5: Pˇr´ıkaz pro odemˇcen´ı facebookov´ ych kontakt˚ u programem sqlite3[6].

4.4

Kompatibilita

Aplikace by mˇela b´ yt kompatibiln´ı s jak´ ymkoliv zaˇr´ızen´ım s operaˇcn´ım systémem ´ eˇsné testován´ı probˇehlo na Android od verze 3.0 - Honeycomb (API level 11). Uspˇ mobiln´ıch telefonech Sony Xperia V, Sony Xperia L, Samsung GT-S762, Samsung Galaxy S3, dále pak na tabletech Prestigio 5580C duo a Samsung Tab 3.

35

5 Testován´ı aplikace V posledn´ı kapitole pˇred závˇerem se zamˇeˇr´ıme na testován´ı aplikac´ı. Nejprve srovnáme aplikaci Contact Merge s aplikacemi pˇredstaven´ ymi v kapitole 2.1. Následnˇe pak srovnáme nalezené v´ ysledky s r˚ uzn´ ym nastaven´ım programu na telefonu Sony Xperia V.

5.1

Porovn´ an´ı aplikac´ı

N´ıˇze uvedené tabulka nab´ız´ı srovnán´ı funkc´ı a schopnost´ı aplikace Contact Merge s dalˇs´ımi testovan´ ymi aplikacemi. Nutno poznamenat ˇze funkce v tabulce byly vybrány podle zadán´ı bakaláˇrské práce, proto se zde velká ˇcást funkc´ı ostatn´ıch testovan´ ych aplikac´ı v˚ ubec nenacház´ı. Dále je nutno ˇr´ıci, jak uˇz bylo naznaˇceno v u ´vodu, ˇze se testované aplikace k problému kontakt˚ u stav´ı jinak neˇz aplikace Contact Merge. Z testován´ı tedy nevyplynul závˇer, ˇze ostatn´ı aplikace jsou horˇs´ı neˇz aplikace Contact Merge, ale sp´ıˇse to, ˇze nebyla nalezena ˇza´dná aplikace, jej´ıˇz u ´ˇcel a filozofie práce by odpov´ıdali aplikaci Contact Merge. Vˇsechny aplikace byly testovány s defaultn´ım nastaven´ım. Testovac´ım zaˇr´ızen´ım byl telefon Sony Xperia V. Celkov´ y poˇcet kontakt˚ u v telefonu byl 887. Srovnán´ı aplikac´ı vid´ıme v tabulce 5.1. Z tabulky je vidˇet ˇze v poˇctu nalezen´ ych v´ ysledk˚ u aplikace Contact Merge s pˇrehledem vede. Nav´ıc selhávaj´ı ostatn´ı aplikace i v dalˇs´ıch testovan´ ych kritéri´ıch, neumˇej´ı pracovat s facebookov´ ymi kontakty, neumˇej´ı pracovat s kontakty z v´ıce zdroj˚ u, nen´ı u nich ani moˇznost vybrat fotku ˇci název v´ ysledného kontaktu. Celkovˇe lze s jistotou ˇr´ıci ˇze aplikace Contact Merge zv´ıtˇezila ve vˇsech testovan´ ych kritéri´ıch.

5.2

Porovn´ an´ı r˚ uzn´ ych nastaven´ı

V následuj´ıc´ıch sekc´ıch jsou vypsány v´ ysledky modul˚ u s r˚ uzn´ ym nastaven´ım. Celkovˇe se jako nej´ uˇcinnˇejˇs´ı ukázal modul pro srovnáván´ı jmen, srovnáván´ı telefonn´ıch ˇc´ısel pak bylo u ´ˇcinné nejménˇe. Moduly pro srovnán´ı jmen a srovnáván´ı jmen s emailov´ ymi adresami ukázaly prudk´ y nár˚ ust poˇctu v´ ysledk˚ u, pokud srovnávaly r˚ uznˇe dlouhá jména/maily. S t´ımto nastaven´ım se ale také objevily faleˇsné nálezy - v pˇr´ıpadˇe prvn´ıho jmenovaného jedna polovina, v druhém pˇr´ıpadˇe jedna tˇretina faleˇsn´ ych nález˚ u. 36

Testován´ı aplikace

Porovnán´ı r˚ uzných nastaven´ı

anal´ yza2

Facebook3

sluˇcuje kontakty z v´ıce u ´ˇct˚ u

ano

ano

ano

ano

ano

ne

ne

ne

ne

Contact op- nelze urˇcit4 timizer

ano6

ne

ne

ne

ne

Duplicate Contacts Manager

ano6

nelze zjistit5

ne

ne

nelze zjistit5

N´ azev

poˇcet n´ alez˚ u

propojuje kontakty1

v´ ybˇer jména fotky

Contact Merge

15

ano

Merge +

6

2

a

1. Pokud ne, tak pouze maˇze duplicitn´ı kontakty. 2. Pracuje s kontakty ze s´ıtˇe Facebook - nutno root zaˇr´ızen´ı. 3. Urˇcuje, zda byly shodné kontakty nalezené dle anal´ yzy, nebo pˇresné shody databázového pole (jméno, tel. ˇc´ıslo...). Tento u ´daj je tˇreba brát s rezervou, byl urˇcen na základˇe nalezen´ ych v´ ysledk˚ u. Pokud se u ´daje u vˇsech nalezen´ ych v´ ysledk˚ u pˇresnˇe shodovaly, je zvolena hodnota ne. 4. N´ alez˚ u bylo v´ıce neˇz 40, ale z pˇeti testovan´ ych nález˚ u byly vˇsechny v telefonu jiˇz propojeny. 5. nelze zjistit, nebot’ zdarma je pouze detekce duplicit, funkce propojován´ı kontakt˚ u je placen´ a. 6. ano, ale vˇetˇsina funkc´ı aplikace smˇeˇruje k mazán´ı duplicit, nikoliv k jejich propojován´ı.

Tabulka 5.1: Srovnán´ı dostupn´ ych aplikac´ı s aplikac´ı Contact Merge v oblastech zadán´ı práce.

37



Defaultn´ı nastaven´ım je vˇzdy zv´ yraznˇeno tuˇcnˇe. Testovan´ ym telefonem byl opˇet Sony Xperia V s 887 kontakty.

5.2.1

Email module

Email module má jen pr˚ umˇerné v´ ysledky. Je to pˇredevˇs´ım proto, ˇze byl implementován jako prvn´ı, nebyly proto vytvoˇreny ˇza´dné moˇznosti hlubˇs´ı anal´ yzy. Na druhou stranu ale nˇekolik shod naˇsel, nav´ıc se nevyskytly ˇzádné faleˇsné nálezy. Nastaven´ı: • vˇse vypnuto - 3 nálezy • zapnuta moˇ znost include similar emails (testuje adresy bez dom´ eny) - 5 n´ alez˚ u.

5.2.2

Phone number module

Phone number module mnoho nález˚ u nemá. Je to proto, ˇze ˇc´ısla kontakt˚ u porovnává uˇz operaˇcn´ı systém Android, kontakty se stejn´ ymi ˇc´ısly se tak slouˇc´ı automaticky. Nastaven´ı: • vˇse vypnuto - 1 nález • test number without country calling code (testov´ an´ı bez pˇ redvolby ˇ c´ısla) - 2 n´ alezy

5.2.3

Name module

Nejvˇetˇs´ı poˇcet nález˚ u má modul pro srovnáván´ı jmen. Devˇet nález˚ u s defaultn´ım nastaven´ım je sluˇsn´ y v´ ysledek. S rozˇs´ıˇren´ ym nastaven´ım najde modul jeˇstˇe daleko vˇetˇs´ı mnoˇzstv´ı v´ ysledk˚ u, v´ıce neˇz polovina nález˚ u je ale faleˇsn´ ych, v´ ysledky takového hledán´ı proto mus´ıme peˇclivˇe proj´ıt. Nastaven´ı: • vˇ se vypnuto - 9 n´ alez˚ u 38



• ignore name order (zámˇena poˇrad´ı jméno pˇr´ıjmen´ı) - 9 nález˚ u • compare names with different length (porovnáván´ı r˚ uznˇe dlouh´ ych jmen, napˇr. jedno a dvouslovn´ ych) - 71 nález˚ u (z toho 37 faleˇsn´ ych nález˚ u)

5.2.4

Email/Name module

V´ ysledky modulu pro srovnán´ı jmen s defautn´ım nastaven´ım nejsou oslnivé. Pˇri spuˇstˇen´ı s rozˇs´ıˇren´ ym nastaven´ım ale nalezl pˇres dvacet v´ ysledk˚ u, z nichˇz pouhá tˇretina byly faleˇsné nálezy. Nastaven´ı: • vˇ se vypnuto - 3 n´ alezy • ignore name order (zámˇena poˇrad´ı ˇca´st´ı mailu/jména) - 3 nálezy • compare names with different length (porovnáván´ı r˚ uznˇe dlouh´ ych mail˚ u/jmen) - 22 nález˚ u (z toho 7 faleˇsn´ ych nález˚ u)

39

6 Závˇer Tato práce se zab´ yvá problematikou práce s kontakty na platformˇe Android. Na tomto nejrozˇs´ıˇrenˇejˇs´ım operaˇcn´ım systému na mobiln´ıch zaˇr´ızen´ıch je vˇetˇsinou uloˇzeno mnoho kontakt˚ u nejen zadan´ ych uˇzivatelem pˇr´ımo do telefonu, ale také ˇ synchronizovan´ ych z r˚ uzn´ ych s´ıt´ı a sluˇzeb. Casto je pak v telefonu uloˇzeno v´ıce kontakt˚ u patˇr´ıc´ıch ke stejné osobˇe. C´ılem práce bylo takové kontakty naj´ıt a propojit. Prvn´ım u ´kolem této práce bylo naj´ıt a zhodnotit existuj´ıc´ı aplikace s podobn´ ym zamˇeˇren´ım jako tato práce na platformˇe Android. Byly vybrány a zhodnoceny tˇri aplikace, z nichˇz ani jedna nesplˇ novala c´ıle, které si klade tato práce. Nalezen´ ych duplicit bylo málo, nˇekteré aplikace se snaˇzily takov´ ych kontakt˚ u zbavit, nikoliv je propojit, v ˇza´dné aplikaci pak nebylo moˇzné pracovat s kontakty ze s´ıtˇe Facebook. Zhodnocen´ı aplikac´ı tedy potvrdilo d˚ uleˇzitost vytvoˇren´ı vlastn´ı aplikace, nebot’ jejich v´ ysledky zaostávaly za c´ıli práce. V dalˇs´ı ˇca´sti práce se podaˇrilo analyzovat práci s kontakty na platformˇe Android. Vˇetˇsina této problematiky je pokrytá v oficiáln´ı dokumentaci, k nˇekter´ ym ale bylo nutné hledat informace jinde a vyskytla se i taková témata, u kter´ ych bylo nutné naj´ıt odpovˇedi na otázky vlastn´ım v´ yzkumem. K takov´ ym oblastem patˇrila pˇredevˇs´ım práce s facebookov´ ymi kontakty nebo zmˇena názvu a fotky kontaktu. Aplikace dle zadán´ı práce byla navrˇzena a realizována, c´ıle práce se podaˇrilo splnit. Práce s kontakty ze s´ıtˇe Facebook je sice omezená - funguje jen na zaˇr´ızen´ıch s administrátorsk´ ym pˇr´ıstupem, tato situace je vˇsak zp˚ usobena zámˇern´ ym zablokován´ım tˇechto kontakt˚ u proti pˇr´ıstupu aplikac´ı. Je tak velk´ ym u ´spˇechem, ˇze se podaˇrilo s tˇemito kontakty pracovat alespoˇ n na zaˇr´ızen´ıch s administrátorsk´ ym pˇr´ıstupem. Velk´ ym pˇr´ınosem aplikace je také moˇznost urˇcit název a fotku v´ ysledného kontaktu. Vyhledávac´ı ˇcást aplikace byla realizována pomoc´ı vyhledávac´ıch modul˚ u. Tyto moduly byly navrˇzeny pro snadnou rozˇsiˇritelnost, nen´ı tak problém vytvoˇrit moduly dalˇs´ı. D´ıky Parazitn´ım modul˚ um je pak moˇzné vyuˇz´ıt data z jiˇz existuj´ıc´ıch modul˚ u a implementovat novˇe jen porovnáván´ı kontaktn´ıch dat. Nakonec byla aplikace otestována, byla provedena testovac´ı hledán´ı kontakt˚ uk propojen´ı s r˚ uzn´ ymi moduly a r˚ uzn´ ym nastaven´ım modul˚ u. Testy ukázaly uˇziteˇcnost aplikace, i pˇri defaultn´ım nastaven´ı, kde se nevyskytuj´ı faleˇsné nálezy, bylo nalezeno v´ıce neˇz deset dvojic kontakt˚ u k propojen´ı. Celkovˇe se zadán´ı práce podaˇrilo splnit, a to jak v teoretické tak praktické rovinˇe. Praktickou ˇca´st - aplikaci je moˇzné v budoucnu rozˇs´ıˇrit o dalˇs´ı moduly 40

Závˇer

a zv´ yˇsit tak u ´ˇcinnost hledán´ı. Z teoretické ˇca´sti je pak moˇzné ˇcerpat pˇri dalˇs´ıch projektech zab´ yvaj´ıc´ıch se prac´ı s kontakty na platformˇe Android. Celkovˇe je tak, dle mého názoru moje práce pˇr´ınosem v teoretické i praktické rovinˇe.

41

Bibliografie [1] Google Inc., Open Handset Alliance. Activity [online]. url: http://developer. android.com/reference/android/app/Activity.html [cit. 2014-04-02] . [2] Allen, Grant. Beginning Android 4. New York: Apress, 2012. Kap. Handling Rotation. 582 s. isbn: 978-1-4302-3984-0. [3] [email protected]. Restricted contacts limit external Android app integration [online]. 28. srp. 2010. url: http : / / code . google . com / p / android/issues/detail?id=5176 [cit. 2013-12-26] . [4] Google Inc., Open Handset Alliance. AsyncTask [online]. url: http : / / developer.android.com/reference/android/os/AsyncTask. html [cit. 2013-12-08] . [5] Aydin, Murat. Android 4: New features for Application Development. Birmingham: Packt Publishing, 2012. Kap. Fragments. 149 s. isbn: 978-1-84951952-6. [6] Biber. Open sqlite-database of another app on Android with root-access [online]. 23. dub. 2012. url: http://stackoverflow.com/questions/16142844/ open-sqlite-database-of-another-app-on-android-withroot-access [cit. 2014-01-17] . [7] Boyle, Chris. ContactsProvider: Aggregated contact’s display name should ń. 2010. url: http://code. respect IS SUPER PRIMARY [online]. 9. u google.com/p/android/issues/detail?id=6545 [cit. 2014-03-15] . [8] Cervilla, Jose. Basic AsyncTask with a progress bar widget [online]. 16. ˇcerv. 2011. url: http://www.codingforandroid.com/2011/06/basicasynctask-with-progress-bar.html [cit. 2013-12-08] . [9] Google Inc., Open Handset Alliance. Contacts Provider [online]. url: http: //developer.android.com/guide/topics/providers/contactsprovider.html [cit. 2013-11-12] . [10] DesignerzBase. Contacts3 icon [online]. url: https://www.iconfinder. com/icons/216476/contacts3_icon#size=128 [cit. 2014-05-07] .

42

BIBLIOGRAFIE

BIBLIOGRAFIE

[11] Google Inc., Open Handset Alliance. ContactsContract.AggregationExceptions [online]. url: http : / / developer . android . com / reference / android / provider / ContactsContract . AggregationExceptions . html [cit. 2013-12-22] . [12] Google Inc., Open Handset Alliance. ContactsContract.Contacts [online]. url: http://developer.android.com/reference/android/provider/ ContactsContract.Contacts.html [cit. 2014-02-22] . [13] Google Inc., Open Handset Alliance. ContactsContract.data [online]. url: http://developer.android.com/reference/android/provider/ ContactsContract.Data.html [cit. 2014-03-08] . [14] Google Inc., Open Handset Alliance. Content Provider Basics [online]. url: http://developer.android.com/guide/topics/providers/ content-provider-basics.html [cit. 2013-11-05] . [15] Google Inc., Open Handset Alliance. Content Providers [online]. url: http: //developer.android.com/guide/topics/providers/contentproviders.html [cit. 2013-11-05] . [16] dplotnikov. How access restricted contacts in third party app [online]. 26. bˇrez. 2010. url: https : / / groups . google . com / forum / # ! topic / android-developers/u2TdwbBUpBI [cit. 2013-12-26] . [17] dplotnikov. How to get a contact’s facebook id or url from native contacts / content resolver? [online]. 22. pros. 2010. url: https://groups. google.com/forum/#!topic/android-developers/lREN16Hh4LQ [cit. 2013-12-28] . [18] Google Inc., Open Handset Alliance. Fragment [online]. url: http : / / developer.android.com/reference/android/app/Fragment. html [cit. 2013-11-10] . [19] Google Inc., Open Handset Alliance. Fragments [online]. url: http : / / developer.android.com/guide/components/fragments.html [cit. 2013-11-10] . [20] I., Roger. Cannot find Facebook contacts in RawContacts [online]. 28. kvˇet. 2011. url: http : / / stackoverflow . com / questions / 6038290 / cannot-find-facebook-contacts-in-rawcontacts [cit. 2013-12-28] . [21] Kevin. Determine if running on a rooted device [online]. 11. lis. 2011. url: http://stackoverflow.com/questions/1101380/determineif-running-on-a-rooted-device [cit. 2014-03-16] . [22] Komatineni, Satya – MacLean, Dave. Pro Android 4: Android 4 platform SDK techniques for developing smartphone and tablet apps. 4th edition. New York: Apress, 2012. Kap. Exploring the Contacts API. 991 s. isbn: 978-14302-3930-7.

43

BIBLIOGRAFIE

BIBLIOGRAFIE

[23] List of ITU-T recommendation E.164 assigned country codes. Tech. zpr. 991. International telecomunication union, 2011. url: http://www.itu.int/ dms_pub/itu-t/opb/sp/T-SP-E.164D-11-2011-PDF-E.pdf. [24] Manitoba. Android - Update a contact [online]. 29. bˇrez. 2012. url: http: //stackoverflow.com/questions/9907751/android-updatea-contact [cit. 2014-03-29] . [25] . Resize Drawable in Android [online]. 2. u ń. 2014. url: http://stackoverflow. com/questions/7021578/resize-drawable-in-android [cit. 2014-05-06] . [26] Samuel. How do you get contacts to aggregate properly when programmatically adding them? [online]. 23. u ń. 2012. url: http://stackoverflow. com / questions / 9419305 / how - do - you - get - contacts - to aggregate- properly- when- programmatically- adding- them [cit. 2013-12-22] . [27] Tamada, Ravi. Android Expandable List View Tutorial [online]. 27. ˇcvc 2013. url: http://www.androidhive.info/2013/07/android-expandablelist-view-tutorial/ [cit. 2014-02-05] . [28] Varun. How to programatically set drawableLeft on Android button? [online]. 21. pros. 2010. url: http://stackoverflow.com/questions/4502605/ how - to - programatically - set - drawableleft - on - android button [cit. 2014-05-06] . [29] Vogel, Lars. Android SQLite database and content provider - Tutorial [online]. Ver. 4.9. 19. srp. 2013. url: http://www.vogella.com/tutorials/ AndroidSQLite/article.html [cit. 2014-03-02] .

44

Pˇ r´ılohy A

Instalaˇ cn´ı pˇ r´ıruˇ cka

Zde se nacház´ı struˇcn´ y postup instalace aplikace pomoc´ı instalaˇcn´ıho bal´ıˇcku (souboru .apk). Body oznaˇcené hvˇezdiˇckou nastanou jen v nˇekter´ ych pˇr´ıpadech ˇci konfigurac´ıch telefonu 1. Odinstalujte pˇredchoz´ı verze aplikace.* 2. Nahrajte instalaˇcn´ı bal´ıˇcek do nechránˇené ˇcásti souborového systému na zaˇr´ızen´ı Android - napˇr. na kartu SD. 3. Poklepnˇete na instalaˇcn´ı bal´ıˇcek. 4. Pokud se zobraz´ı menu dostupn´ ych aplikac´ı, zvolte Nástroj k instalaci bal´ıˇck˚ u, jak je ukázáno na obrázku A.1a.* 5. Pokud se zobraz´ı informace ˇze instalace je zablokována protoˇze je jej´ı zdroj neznám´ y, je nutné povolit instalaci z neznám´ ych zdroj˚ u. Zvolte Nastaven´ı (obrázek A.2a), dále sekci zabezpeˇcen´ı A.2b) zde pak zaˇskrtnˇete moˇznost Neznámé zdroje (obrázek A.2c). Cel´ y postup je vidˇet na obrázku A.2.* 6. Odsouhlaste seznam práv která aplikace vyˇzaduje zvolen´ım tlaˇc´ıtka instalovat - obrázek A.1b.

B

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

Celé schéma aplikace z pohledu uˇzivatele vid´ıme na obrázku B.1. Nejprve spust´ıme aplikaci poklepán´ım na jej´ı ikonu v menu. Objev´ı se nám u ´vodn´ı aktivita (obrázek 4.3). Zde je moˇzné aktivovat/deaktivovat vyhledávac´ı moduly klepnut´ım na checkbox napravo vedle modulu (obrázek B.2a ˇc´ıslo 1), po klepnut´ı na modul (viz obrázek B.2a ˇc´ıslo 2) mimo checkbox se dostaneme do nastaven´ı modulu (viz. dále). Na zaˇr´ızen´ıch s administrátorsk´ ymi právy je nav´ıc moˇzné odemknout kontakty ze s´ıtˇe facebook klepnut´ım n tlaˇc´ıtko Unlock Facebook contacts (viz. obrázek B.2a ˇc´ıslo 3). Stejn´ ym tlaˇc´ıtkem je moˇzné následnˇe kontakty zamknout zpˇet. V aktivitˇe nastaven´ı modulu m˚ uˇzeme klepnut´ım na checkbox aktivovat/deaktivovat pˇr´ısluˇsné nastaven´ı (obrázek B.2b). Po nastaven´ı vˇsech modul˚ u a jejich 45

Pˇr´ılohy

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

(a) V´ ybˇer n´ astroje pro instalaci bal´ıˇck˚ u

(b) Schválen´ı oprávnˇen´ı

Obrázek A.1: Návod na instalaci

(a) Dialog zablokov´ an´ı instalace

(b) Sekce zabezpeˇcen´ı

(c) Moˇznost instalovat aplikace neznám´ ych zdroj˚ u

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

46

Pˇr´ılohy


Obrázek B.1: Schéma fungován´ı aplikace z pohledu uˇzivatele aktivován´ı dle naˇsich pˇredstav pokraˇcujeme kliknut´ım na tlaˇc´ıtko Find merge candidates (obrázek B.2a ˇc´ıslo 4). Následnˇe se zobraz´ı dialog z indikátorem stavu hledán´ı, kter´ y jiˇz známe z obrázku 4.5. Po skonˇcen´ı hledán´ı se zobraz´ı aktivita v´ ysledk˚ u (obrázek 4.6). Zde vid´ıme dvojice kontakt˚ u, u kter´ ych program zhodnotil, ˇze patˇr´ı ke stejné osobˇe. Zb´ yvá kontakty spojit. Pro spojen´ı kontakt˚ u má uˇzivatel dvˇe moˇznosti. Prvn´ı moˇznost´ı je individuáln´ı propojen´ı kontakt˚ u. Nejprve pˇrejdeme na aktivitu detailu kandidát˚ u ke spojen´ı(viz. obrázek 4.7), a to tak ˇze klepneme na ˇra´dek v seznamu na kterém jsou jména kontakt˚ u které chceme spojit (obrázek B.3a ˇc´ıslo 1). Pokud kontakty nepatˇr´ı k sobˇe, m˚ uˇzeme pouˇz´ıt tlaˇc´ıtko discard (obrázek B.3b ˇc´ıslo 1), které nás vrát´ı zpˇet na seznam v´ ysledk˚ u, ze kterého bude prohl´ıˇzená dvojice kontakt˚ u vyˇrazena. Pokud k sobˇe kontakty patˇr´ı, klepneme na tlaˇc´ıtko Aggregate contacts (obrázek B.3b ˇc´ıslo 2). Zobraz´ı se dialog s v´ ybˇerem jména (obrázek 4.8). Zde pomoc´ı radio button˚ u vybereme název a fotku kontaktu (obrázek B.4a ˇc´ıslo 1). následnˇe stiskneme tlaˇc´ıtko Merge Selected (obrázek B.4a ˇc´ıslo 2), ˇc´ımˇz dojde ke slouˇcen´ı kontakt˚ u, a my se vrát´ıme do aktivity v´ ysledk˚ u. Druhá moˇznost je slouˇcit kontakty hromadnˇe. Nejprve zaˇskrtneme kontakty, které chceme slouˇcit pomoc´ı checkbox˚ u v aktivitˇe v´ ysledk˚ u (obrázek B.3a ˇc´ıslo 2). Pak klepneme na tlaˇc´ıtko Merge selected (obrázek B.3a ˇc´ıslo 3). T´ım se dostaneme do aktivity slouˇcen´ı v´ıce kontakt˚ u (obrázek 4.9). Zobraz´ı se nám seznam vybran´ ych dvojic kontakt˚ u k propojen´ı. Pokud chceme rozhodnout, jakou fotku a název bude m´ıt v´ ysledn´ y kontakt, rozbal´ıme poloˇzku seznamu pomoc´ı poklepán´ı. V rozbalené dvojici kontakt˚ u vybereme jméno a fotku kontaktu, obdobnˇe jako v pˇr´ıpadˇe individuáln´ıho propojen´ı kontakt˚ u (obrázek B.4b ˇc´ıslo 1). Po klepnut´ı na tlaˇc´ıtko merge dojde ke slouˇcen´ı vˇsech kontakt˚ u ze seznamu a k návratu do aktivity v´ ysledk˚ u (obrázek B.4b ˇc´ıslo 2).

47

Pˇr´ılohy


(a) u ´vodn´ı aktivita

(b) aktivita nastaven´ı

Obrázek B.2: Pˇr´ıruˇcka - u ´vodn´ı aktivita a aktivita nastaven´ı.

(a) aktivita v´ ysledk˚ u

(b) aktivita detailu

Obrázek B.3: Pˇr´ıruˇcka - aktivita v´ ysledk˚ u a aktivita detailu.

48

Pˇr´ılohy

Sloupce tabulky kontakt˚ u

(a) aktivita sluˇcov´ an´ı

individuáln´ıho (b) aktivita hromadného sluˇcován´ı

Obrázek B.4: Pˇr´ıruˇcka - aktivita individuáln´ıho a aktivita hromadného sluˇcován´ı. Program je moˇzné v kterékoliv fázi bezpeˇcnˇe opustit, v nejhorˇs´ım pˇr´ıpadˇe ztrat´ıme nalezené v´ ysledky, které m˚ uˇzeme ovˇsem snadno opˇet vyhledat.

C


* Hodnota konstanty v kontraktn´ı tˇr´ıdˇe = skuteˇcné jméno tabulky.

49

Pˇr´ılohy

C.1 Typ long


Z´ akladn´ı

Jméno ID

hodnota*

v´ yznam

id

identifikátor ˇrádku

String LOOKUP KEY

lookup

long

name raw contact id

NAME RAW CONTACT ID

kl´ıˇc slouˇz´ıc´ı k nalezen´ı kontaktu, pokud se jeho id zmˇen´ı v d˚ usledku slouˇcen´ı kontakt˚ u, nebo synchronizace kl´ıˇc k raw kontaktu kter´ y poskytuje n´ azev kontaktu

String DISPLAY NAME PRIMARY

display name

long

PHOTO ID

photo id

long

PHOTO URI

photo uri

Odkaz na fotku slouˇz´ıc´ı ke zobrazen´ı

long

PHOTO THUMBNAIL URI

photo thumb uri

Odkaz na náhled fotky slouˇz´ıc´ı ke zobrazen´ı

int

IN VISIBLE GROUP

in visible group

Indikuje zdali má b´ yt kontak zobrazen. ”1”pokud má kontakt alespoˇ n jeden viditeln´ y raw kontakt, jinak ”0”.

int

HAS PHONE NUMBER

has phone number

Indikuje zdali má kontakt telefon´ı ˇc´ıslo. ”1”pokud ano, jinak ”0”

int

TIMES CONTACTED

times contacted

Kolikrát byl kontak pouˇzit.

long

LAST TIME CONTACTED

last time contacted

Datum a ˇcas posledn´ıho pouˇzit´ı kontaktu.

int

STARRED

starred

Indikuje zdali se jedná o obl´ıben´ y kontakt: ’1’ znaˇc´ı obl´ıben´ y kontakt, jinak ’0’.

String CUSTOM RINGTONE

custom ringtone

Odkaz na melodii specifickou pro kontakt.

int

SEND TO VOICEMAIL

send to voicemail

Indikuje, zdali má kontakt pˇri vol´ an´ı okamˇzitˇe spadnout do hlasové schránky’1’ pro ano, jinak ’0’.

int

CONTACT PRESENCE

contact presence

Status pro IM.

contact status

Status pro IM.

String CONTACT STATUS

zobrazené jméno kontaktu. Je to prim´ arn´ı jméno raw kontaktu, na kter´ y ukazuje NAME RAW CONTACT ID kl´ıˇc k ˇrádku v tabulce ContactsContract.Data kde je uloˇzena fotka kontaktu.

ˇ v milisekundách od posledn´ı zmˇeny statusu pro Cas IM String CONTACT STATUS RES PACKAGE contact status res package Bal´ıˇcek poskytuj´ıc´ı zdroje pro status IM: popiska a ikona long CONTACT STATUS LABEL contact status label IDd popisku statusu pro IM long

CONTACT STATUS TIMESTAMP

contact status ts

long

CONTACT STATUS ICON

contact status icon

50

ID ikony statusu pro IM.

Pˇr´ılohy

C.2 Typ


Dostupn´ e pˇ res implicit-join

Jméno

hodnota*

v´ yznam

String DISPLAY NAME ALTERNATIVE display name alt

Alternativn´ı zápis zobrazovaného jména

String DISPLAY NAME SOURCE

display name source

Typ dat pouˇzit´ y jako zobrazované jméno

String PHONETIC NAME

phonetic name

V´ yslovnost jména pomoc´ı fonetické abecedy specifikované ve sloupci PHONETIC NAME STYLE.

String PHONETIC NAME STYLE

phonetic name style

String SORT KEY ALTERNATIVE

sort key alt

String SORT KEY PRIMARY

sort key

fonetická abeceda pomoc´ı n´ıˇz je zakódov´ ano PHONETIC NAME. kl´ıˇc ˇrazen´ı dle sloupce DISPLAY NAME ALTERNATIVE. kl´ıˇc k ˇrazen´ı dle zobrazovaného jména

String CONTACT CHAT CAPABILITY

contact chat capability Schopnosti kontaktu v souvislosti s IM

String IS USER PROFILE

is user profile

Znaˇc´ı jestli je tento kontakt uˇzivatelsk´ ym profilem

String PHOTO FILE ID

photo file id

identifikátor souboru fotky v plné velikosti

51

Pˇr´ılohy

D D.1 Typ long

Sloupce tabulky raw kontakt˚ u

Sloupce tabulky raw kontakt˚ u Z´ akladn´ı

Jméno ID

hodnota* id

v´ yznam vlastn´ı kl´ıˇc raw kontaktu

long

CONTACT ID

contact id

kl´ıˇc ukazuj´ıc´ı na tabulku ContactsContract.Contacts - ukazuje na kontakt pod kter´ y raw kontakt patˇr´ı.

int

AGGREGATION MODE

aggregation mode

Pomoc´ı konstant nastavuje automatické sluˇcován´ı kontakt˚ u.

int

DELETED

deleted

znaˇc´ı zdali je kontakt urˇcen k vymazán´ı ”0”pokud ne, ”1”pokud ano.

int

TIMES CONTACTED

times contacted

Poˇcet pouˇzit´ı kontaktu.

long

ˇ LAST TIME CONTACTED last time contacted Casov´ a známka posledn´ıho pouˇzit´ı kontaktu

int

STARRED

starred

Urˇcuje zdali patˇr´ı raw kontakt mezi obl´ıbené - ’1’ pokud ano, jinak ’0’ Speciáln´ı vyzvánˇen´ı pro raw kontakt.


custom ringtone

int

send to voicemail

Urˇcuje, zdali spadne volaj´ıc´ı raw kontakt rovnou do hlasové schr´ anky (’1’) nebo ne (’0’).

String ACCOUNT NAME

account name

Jméno u ´ˇctu ze kterého raw kontakt pocház´ı (napˇr´ıklat gmail pro u ´ˇcet na googlu)

String ACCOUNT TYPE

account type

Typ u ´ˇctu ze kterého pocház´ı raw kontakt (pro u ´ˇcet na googlu com.google)

String DATA SET

data set

Vyuˇz´ıvá se pro identifikaci rw kontakt˚ u patˇr´ıc´ıch ke stejnému u ´ˇctu, ale k r˚ uzn´ ym adaptér˚ um pro synchronizaci.

String SOURCE ID

sourceid

int

VERSION

version

identifikátor vzhledem k uˇzivatelskému u ´ˇctu. Vytváˇr´ı se na stranˇe servru. znaˇc´ı kolikrát byl kontakt zmˇenˇen

int

DIRTY

dirty

SEND TO VOICEMAIL

String SYNC1

sync1

znaˇc´ı ˇze VERSION se zmˇenila, a kontakt je tˇreba synchronizovat se serverem. Generické sloupce pro potˇreby sync adaptér˚ u.

String SYNC2

sync2

Generické sloupce pro potˇreby sync adaptér˚ u.

String SYNC3

sync3


String SYNC4

sync4


52

Pˇr´ılohy

D.2 Typ

Sloupce tabulky raw kontakt˚ u


Jméno

hodnota*

v´ yznam

String DISPLAY NAME ALTERNATIVE

display name alt



display name

Zobrazované jméno kontaktu


display name source



phonetic name



phonetic name style


sort key alt


sort key


String RAW CONTACT IS USER PROFILE raw contact is user profile Oznaˇcuje jestli je tento raw kontakt souˇc´ ast´ı uˇzivatelského profilu.

53

Pˇr´ılohy

E E.1 Typ String

Sloupce tabulky dat

Sloupce tabulky dat Z´ akladn´ı

Jméno

hodnota*

ID

id

v´ yznam identifikátor ˇrádku

String MIMETYPE

mimetype

MIME typ záznamu

String RAW CONTACT ID

raw contact id

Kl´ıˇc k raw kontaktu ke kterému data patˇr´ı.

String IS PRIMARY

is primary

String DATA VERSION

data version

verze záznamu.

String DATA1

data1

Generick´ y sloupec, jeho obsah záleˇz´ı na MIMETYPE dat.

String DATA2

data2


String DATA3

data3


String DATA4

data4


String DATA5

data5


String DATA6

data6


String DATA7

data7


String DATA8

data8


String DATA9

data9


String DATA10

data10


String DATA11

data11


String DATA12

data12


String DATA13

data13


String DATA14

data14


String DATA15

data15


String SYNC1

data sync1

Generick´ y sloupec pro sync adaptéry.

String SYNC2

data sync3


String SYNC3

data sync2


String SYNC4

data sync4


Urˇcuje, zdali je tento záznam primárn´ım záznamem tohoto druhu v raw kontaktu. String IS SUPER PRIMARY is super primary Urˇcuje, zdali je tento záznam primárn´ım záznamem tohoto druhu v kontaktu - tedy ve vˇsech spojen´ ych raw kontaktech.

E.2


54

Pˇr´ılohy

Typ

Sloupce tabulky dat

Jméno

hodnota*

v´ yznam

String DISPLAY NAME ALTERNATIVE

display name alt



display name

Zobrazované jméno kontaktu


display name source



phonetic name



phonetic name style


sort key alt


sort key



custom ringtone

Odkaz na melodii specifickou pro kontakt.

String LAST TIME CONTACTED

last time contacted

Datum a ˇcas posledn´ıho pouˇzit´ı kontaktu.

String SEND TO VOICEMAIL

send to voicemail

Indikuje, zdali má kontakt pˇri volán´ı okamˇzitˇe spadnout do hlasové schránky’1’ pro ano, jinak ’0’.

String STARRED

starred

Indikuje zdali se jedná o obl´ıben´ y kontakt: ’1’ znaˇc´ı obl´ıben´ y kontakt, jinak ’0’.

String TIMES CONTACTED

times contacted

Kolikrát byl kontak pouˇzit.

String CONTACT CHAT CAPABILITY

contact chat capability

Schopnosti kontaktu v souvislosti s IM

String CONTACT PRESENCE

contact presence

Status pro IM.

String CONTACT STATUS

contact status

Status pro IM.

String CONTACT STATUS ICON

contact status icon

ID ikony statusu pro IM.

String CONTACT STATUS LABEL

contact status label

IDd popisku statusu pro IM

String CONTACT STATUS RES PACKAGE contact status res package Bal´ıˇcek poskytuj´ıc´ı zdroje pro status IM: popiska a ikona ˇ v milisekundách od posledn´ı zmˇeny statusu pro String CONTACT STATUS TIMESTAMP contact status ts Cas IM int HAS PHONE NUMBER has phone number Indikuje zdali má kontakt telefon´ı ˇc´ıslo. ”1”pokud ano, jinak ”0” int

IN VISIBLE GROUP

in visible group

Indikuje zdali má b´ yt kontak zobrazen. ”1”pokud m´ a kontakt alespoˇ n jeden viditeln´ y raw kontakt, jinak ”0”. kliˇc slouˇz´ıc´ı k nalezen´ı kontaktu, pokud se jeho id zmˇen´ı v d˚ usledku slouˇcen´ı kontakt˚ u, nebo synchronizace identifikátor souboru fotky v plné velikosti

String LOOKUP KEY

lookup

String PHOTO FILE ID

photo file id

long

PHOTO ID

photo id

long

PHOTO THUMBNAIL URI

photo thumb uri

kl´ıˇc k ˇrádku v tabulce ContactsContract.Data kde je uloˇzena fotka kontaktu. Odkaz na náhled fotky slouˇz´ıc´ı ke zobrazen´ı

long

PHOTO URI

photo uri

Odkaz na fotku slouˇz´ıc´ı ke zobrazen´ı

55

Pˇr´ılohy

long

Sloupce tabulky dat

CONTACT ID

contact id

kl´ıˇc ukazuj´ıc´ı na tabulku ContactsContract.Contacts - ukazuje na kontakt pod kter´ y raw kontakt patˇr´ı.

String DATA SET

data set

Vyuˇz´ıvá se pro identifikaci rw kontakt˚ u patˇr´ıc´ıch ke stejnému u ´ˇctu, ale k r˚ uzn´ ym adaptér˚ um pro synchronizaci. String RAW CONTACT IS USER PROFILE raw contact is user profile Oznaˇcuje jestli je tento raw kontakt souˇc´ ast´ı uˇzivatelského profilu. String CHAT CAPABILITY

chat capability

Schopnosti kontaktu (audio, video. . . )

String PRESENCE

mode

Posledn´ı u ´roveˇ n pˇr´ıtomnosti kontaktu

String STATUS

status

Posledn´ı aktualizace statusu

String STATUS ICON

status icon

id na ikonu statusu

String STATUS LABEL

status label

id textu statusu

String STATUS RES PACKAGE

status res package

zdroj pro ikonu a text statusu

String STATUS TIMESTAMP

status ts

ˇcas posledn´ı zmˇeny statusu

String ACCOUNT NAME

account name

Jméno u ´ˇctu ze kterého raw kontakt poch´ az´ı (napˇr´ıklat gmail pro u ´ˇcet na googlu)

String ACCOUNT TYPE

account type

Typ u ´ˇctu ze kterého pocház´ı raw kontakt (pro u ´ˇcet na googlu com.google)

int

dirty

znaˇc´ı ˇze VERSION se zmnˇenila, a kontakt je tˇreba synchronizovat se servrem.

String SOURCE ID

sourceid

int

version

identifikátor vzhledem k uˇzivatelskému u ´ˇctu. Vytv´ aˇr´ı se na stranˇe servru. znaˇc´ı kolikrát byl kontakt zmˇenˇen

DIRTY

VERSION

String GROUP SOURCE ID

group sourceid

56

sourceid skupiny ke které patˇr´ı tento ˇclen. Mus´ı b´ yt specifikováno, nebo mus´ı b´ yt specifikov´ ano GROUP ROW ID.

Západočeská univerzita v Plzni Fakulta aplikovaných věd Katedra informatiky a výpočetní techniky. Práce s kontakty na mobilní platformě Android

Recommend Documents