Ebook Android PDF

Spis treci
Licencja na wykorzystanie materiaw.......................................................................................2

Instalacja i konfiguracja.......................................................................................................................3
Instalacja.....................................................................................................................................3
Konfiguracja wirtualnych urzdze..........................................................................................11
Struktura katalogw w aplikacji...............................................................................................14
Tworzenie podstawowej aplikacji.............................................................................................18
Elementy wizualne.............................................................................................................................33
Przegld podstawowych komponentw graficznych................................................................33
Korzystanie z komponentw wizualnych w kodzie..................................................................35
Obsuga i konfiguracja podstawowych komponentw graficznych.........................................40
Zasoby tekstowe wykorzystanie pliku strings.xml................................................................43
Szablony kolorw.....................................................................................................................52
Style komponentw...................................................................................................................58
To ekranu aplikacji..................................................................................................................62
Konfiguracja wasnego menu....................................................................................................70
Rne layouty w rnych orientacjach.....................................................................................76
Wyczenie obracania ekranu w aplikacji.................................................................................77
Ukady elementw na ekranie rodzaje layoutw...................................................................79
Parametr wrap_content vs fill_parent.......................................................................................95
Scroll View ekran przewijany................................................................................................97
Czas na programowanie!..................................................................................................................105
Wykorzystanie Log.d w debugowaniu....................................................................................105
Cykl ycia aplikacji.................................................................................................................106
Komunikaty Toast...................................................................................................................109
Podpowiedzi w oknach edycyjnych........................................................................................115
Obsuga zdarzenia kliknicia na komponent...........................................................................117
Intencje wywoywanie ekranw i akcji w systemie.............................................................126
Otwieranie przegldarki WWW z aplikacji............................................................................142
Poczmy to wszystko! Podsumowanie podstaw....................................................................148
Wielowtkowo w Androidzie........................................................................................................195
Wykorzystanie klas Thread i AsyncTask................................................................................195
Utrwalanie i przechowywanie danych..............................................................................................205
Wykorzystanie bazy danych SQLite w Androidzie................................................................205
Sprawdzanie zawartoci katalogu i wasnoci plikw............................................................231
Sprawdzanie iloci wolnego miejsca na karcie SD.................................................................238
Lokalizacja i mapy...........................................................................................................................240
Wykorzystanie GPS..........................................................................................................................240
Uywanie map OpenStreetMaps.............................................................................................248
Android te czuje czujniki.............................................................................................................253
Sprawdzanie jakie czujniki mamy dostpne...........................................................................253
Czujnik orientacji (poziomica + kompas )..............................................................................256
Wysyanie i odbieranie SMSw.......................................................................................................260
Wysyanie pojedynczego SMSa..............................................................................................260
Wysyanie wieloczciowego SMSa.......................................................................................261
Odbieranie SMSw.................................................................................................................263
Multimedia.......................................................................................................................................265
Odwarzanie dwiku...............................................................................................................265
Wykorzystanie aparatu fotograficznego do robienia zdj.....................................................267
Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl
1/227
Odtwarzanie Video..................................................................................................................278
Nagrywanie video...................................................................................................................281
Grafika 2D...............................................................................................................................286
Bluetooth czyli niebieskie pogaduszki.................................................................................293
Licencja na wykorzystanie materiaw

Niniejsze materiay moesz pobra bezpatnie, bez adnych zobowiza i poczucia winy. Nie ma
tutaj nic to powiedzenia aden ZAIKS, adne organizacje rzdowe ani pozarzdowe. Nad ranem nie
wpadnie Ci do mieszkania ABW, GROM ani grupa ekologw. Moesz t publikacj
rozpowszechnia w dowolnej iloci kopii, w postaci cyfrowej lub elektronicznej, moesz te wyry
j na glinianych tablicach i powiesi na przystanku. Moesz podzieli si zarwno tymi materiaami
jak i wiedz z ni pozyskan z kim chcesz. Moe nawet pomoesz w ten sposb zda komu
kolokwium albo dasz mu szans na rozwj zawodowy. Chciabym tylko jako twrca tej publikacji
by nie robi dwch rzeczy:
nie zarabia w aden sposb na tej publikacji. To znaczy, e np. nie mona jej wykorzysta
na komercyjnych szkoleniach , ani bra za jej kopie pienidzy.
nie rozpowszechnia tej ksiki we fragmentach. Jeli chcesz j komu przesa albo
opublikowa na swojej stronie, to dopki udostpniasz j jako cao w takim formacie w
jakim j udostpniamy wszystko jest w porzdku.
Mam nadziej e t drobn prob uszanujesz.
Andrzej Klusiewicz
2/227
Instalacja i konfiguracja
Instalacja
Do rozpoczcia przygody z programowaniem dla platformy Android bd nam potrzebne dwie
rzeczy: Java Developer Kit, oraz zestaw Android SDK. JDK to po prostu Java z narzdziami dla
programistw (np. kompilator Javy). Android SDK zawiera kompilator programw na platform
Android, narzdzia do tworzenia i zarzdzania wirtualnymi urzdzeniami (na ktrych moemy
testowa nasze programy), a take rodowisko programistyczne Eclipse. Eclipse jako taki jest
bardzo popularnym IDE wrd programistw Javy, tutaj dostajemy jego nieco zmodyfikowan pod
programowanie na Androida wersj. Nic nie stoi na przeszkodzie abymy uywali innych
rodowisk, ale wykorzystanie takiej spreparowanej, gotowej wersji Eclipse bdzie najprostszym
rozwizaniem.
W pierwszej kolejnoci pobieramy i instalujemy JDK. Moemy je pobra ze strony
http://www.oracle.com/technetwork/java/javase/downloads/index.html
Wybieramy Java Platform(JDK), pierwsz od lewej. Druga rni si od pierwszej dodatkowym
narzdziem NetBeans ktry nie bdzie nam tutaj potrzebny.
3/227
Po klikniciu przechodzimy do ekranu wyboru wersji. Wybieramy wersj dla naszego systemu
operacyjnego.
Dalej pobieramy Android SDK ze strony : http://developer.android.com/sdk/index.html
4/227
Po pobraniu i rozpakowaniu, w rozpakowanym katalogu powinnimy zobaczy katalogi eclipse,

sdk, oraz program SDK Manager.
W katalogu eclipse znajduje si IDE z ktrego bdziemy korzysta, sdk to narzdzia takie jak
kompilator. Cao warto umieci w jakim katalogu ktrego nie bdziemy pniej nigdzie
przenosi, poniewa bdziemy za moment dodawa podkatalogi katalogu sdk do zmiennej
rodowiskowej PATH. Zmiana pooenia tego katalogu wizaaby si z koniecznoci ponownej
modyfikacji zmiennej rodowiskowej.
5/227
Aby ustawi zmienn rodowiskow w systemie Windows, klikamy prawym przyciskiem myszy na
ikon Mj Komputer, wybieramy Waciwoci. Przechodzimy do zakadki zaawansowane i
klikamy przycisk Zmienne rodowiskowe. Zaznaczamy zmienn Path spord zmiennych
systemowych i klikamy edytuj. Do zmiennej dopisujemy cieki do podkatalogw tools,
platform-tools oraz build-tools katalogu jdk rozdzielajc cieki rednikami. Zatwierdzamy zmiany.
6/227
Uruchamiamy rodowisko Eclipse z podkatalogu eclipse. Podczas uruchamiania program zapyta

nas o pooenie naszego workspace. Workspace to przestrze w ktrej bdzie zapisywany tworzony
przez nas kod rdowy. Oczywicie najlepiej byoby gdybyby wskazali jaki katalog (moemy go
utworzy przy okazji) ktrego pniej nie bdziemy przenosi.
Po pierwszym uruchomieniu powinnimy zobaczy taki ekran powitalny:
7/227
Zamykamy go. Powinnimy teraz zobaczy mniej wicej taki widok:
8/227
Gdy zaczniemy tworzy nieco bardziej zaawansowane programy, moe okaza si e domylne
ustawienia pamici dla Eclipse s niewystarczajce i rodowisko zacznie chodzi bardzo wolno,
wiesza si. Warto wic ju na starcie zadba o to, by Eclipse mia wystarczajc ilo pamici.
Aby to skonfigurowa, edytujemy plik eclipse.ini znajdujcy si w katalogu Eclipse. Modifikujemy
parametry pamiciowe np. tak:
Nowe parametry bd obowizywa on nastpnego uruchomienia Eclipse, warto wic go

zrestartowa. Efekt zmian powinien by zauwaalny ju teraz, w postaci rnicy czasu
uruchamiania rodowiska.
9/227
Konfiguracja wirtualnych urzdze

Aby testowa nasze programy moemy uywa realnych fizycznych urzdze, albo wykorzysta
wirtualne. Dziki takim wirtualnym urzdzeniom bdziemy te mogli przetestowa dziaanie
naszego programu przy rnych konfiguracjach urzdze i rnych wielkociach ekranu. Aby
stworzy takie wirtualne urzdzenie, wybieramy z menu window w Elipsie element Android
Virtual Device Manager.
Pojawi nam si lista dostpnych wirtualnych urzdze, tymczasowo pusta.
10/227
Klikamy przycisk New i wprowadzamy konfiguracj urzdzenia. Moesz wzorowa si na tym

co ja wprowadziem. To urzdzenie ma symulowa model telefonu SamsungAce3 przynajmniej
jeli chodzi o konfiguracj ekranu. W rzeczywistoci ten telefon ma znacznie wicej pamici
operacyjnej, ale na komputerze na ktrym to konfiguruj jest 2GB ramu, a trzeba jeszce obsuy
inne programy.
11/227
Po zatwierdzeniu powiniene zobaczy taki widok. Takich urzdze moemy stworzy dowoln
ilo i np. testowa program na rnych wielkociach ekranu.
12/227
Struktura katalogw w aplikacji

Przyjrzyjmy si zawartoci katalogw naszej aplikacji.
Katalog src zawiera klasy ktre bdziemy tworzy do obsugi dziaania naszego programu,
przykadowo klasy aktywnoci.
Katalog gen zawiera elementy wynegerowane przez kompilator. Pooenie elementw okrelamy
w plikach Xml, zasoby typu obrazki czy dwiki bdziemy wrzuca jako pliki. Program po
skompilowaniu nie bdzie zawiera tych elementw w postaci plikw takich jakie wrzucimy, a pod
postaci pliku R.java ktry jest zrozumiay dla rodowiska uruchomieniowego. Generalnie
zawartoci tego katalogu nie powinnimy modyfikowa.
Katalog bin zawiera skompilowane klasy i nasz aplikacj w postaci gotowego archiwum aplikacji
apk. Zawartoci tego katalogu te nie ruszamy.
Katalog libs zawiera niezbdne do dziaania programu biblioteki. Moemy tam wrzuci np. jary
google maps jeli bdziemy z nich korzysta.
Katalog res (od resources) wszystkie statyczne zasoby obrazki, pliki dwikowe, video etc.
Widzimy te wolno lecy plik AndroidManifest.xml w ktrym znajduj si ustawienia takie jak
okrelenie ktra aktywno (ekran) jest gowna, wasnoci caej aplikacji jako takiej (typu ikonka
etc), uprawnienia jakie s wymagane przez program (np. do korzystania z internetu czy odbiornika
GPS).
13/227
14/227
Przyjrzyjmy si jeszcze zawartoci katalogu res. Cokolwiek wrzucisz do tego katalogu, stanie si do
zasobem widocznym i dostpnym z dowolnego miejsca aplikacji. To wanie tutaj powinny trafi
wszystkie obrazki, filmiki etc. Katalogi drawable-xxxxx s przeznaczone na obrazki. Jest ich kilka
bo moemy mie kilka wersji tego samego obrazka dla rnych rozdzielczoci. Nazwy s dosy
intuicyjne do katalogu drawable-ldpi wrzucamy obrazki przeznaczone dla maych rozdzielczoci
- low dot per inch. Do drawable-hdpi wrzucamy obrazki przeznaczone dla duych rozdzielczoci high dot per inch. W katalogu layout mamy pliki xml okrelajce wygld poszczeglnych
aktywnoci. W katalogu menu mamy pliki okrelajce wygld menu na rnych ekranach.
W katalgou values mamy np. plik strings.xml. Tutaj okrelamy wszelkie napisy ktre pojawiaj si
w aplikacji. Napisy takie mona oczywicie ustawia i w kodzie javy, jednak jeli bdziemy je
umieszcza w tym pliku, bdzie nam atwiej pniej zarzdza napisami majc je w jednym
miejscu. Przechowywanie napisw w osobnym pliku XML ma szczeglne znaczenie dla wygody
pniejszej internacjonalizacji programu.
15/227
Tworzenie podstawowej aplikacji

Tworzenie aplikacji rozpoczynamy od kliknicia prawym przyciskiem myszy na znajdujcym si
po lewej stronie polu package explorer i wybraniu New-->Android Application. Powinien nam
si pojawi taki ekran:
16/227
W tym miejscu musimy nada nazwy aplikacji, projektowi oraz pakietowi w ktrym bd
znajdowa si nasze klasy. Nazwa projektu najlepiej by bya taka jak nazwa aplikacji (cho nie jest
to konieczne). Jeli posiadasz domen internetow, to najlepiej bdzie odwrci fraz i na kocu
doda nazw nowo tworzonej aplikacji. Przykadowo jeli mam domen jsystems.pl i tworz
aplikacj KebabFinder to tworz pakiet pl.jsystems.kebabfinder. Taka jest powszechna praktyka i
zapewnia unikalno nazw. Nie dojdzie do sytuacji e bd dwie klasy KlasaGlowna znajdujce si
w pakietach o takiej samej nazwie com.example, cho bd pochodzi od rnych dostawcw i
robi rne rzeczy.
17/227
Przechodzimy dalej, a pojawi nam si ekran wyboru ikony aplikacji. Domylnie ikon aplikacji
bdzie logo Androida. Moemy je zmieni na jaki wasny obraz (wybieramy go wtedy z dysku),
jaki obrazek z Clip Arta, albo logo tekstowe. Ja nacisnem Clipart, nastpnie choose i
wybraem znak kciuka. Dalej zmieniem domylny bkitny kolor logo na czerwony klikajc na
Foreground Color.
18/227
Przechodzimy dalej. Na kolejnym ekranie mamy moliwo wyboru sposobu wywietlania

aplikacji. Czy bdzie to zwyka aplikacja z widocznym menu systemowym (Domylny wybr) czy
wywietlanie penoekranowe (np. kiedy piszemy jak gr), czy te formularz typu master/detail.
19/227
Po przejciu do kolejnego ekranu wybieramy nazw klasy aktywnoci gwnej, oraz nazw pliku
xml w ktrym okrelony bdzie wygld aktywnoci gwnej. Aktywno mona to rozumie w
sporym uproszczeniu jako ekran dane okno w aplikacji. Aktywnoci aplikacja moe mie wiele,
uytkownik moe porusza si midzy aktywnociami ( midzy ekranami uruchom np. swoj
aplikacj i przyjrzyj si procedurze ustawiania celu a zrozumiesz co mam na myli). Kada
aplikacja musi za to mie jak aktywno (ekran) ktra pojawi si jako pierwsza po uruchomieniu
programu. Z tak aktywnoci wie si klasa j obsugujca, a nazw tej klasy okrelamy w polu
Activity Name. W tej klasie bdziemy pniej okrela jak dany ekran ma si zachowywa.
Kolejne pole layout Name okrela nazw pliku XML w ktrym bdzie zapisany wygld tego
ekranu. W tym pliku bdzie zapisane rozmieszczenie elementw oraz ich wasnoci.
20/227
Po zakoczeniu powinnimy zobaczy klas naszej aktywnoci:
Na razie bez szczegw tak tylko informacyjnie: metoda onCreate jest uruchamiana kiedy dany
ekran zostaje wywietlony, metoda onCreateOptionsMenu kiedy uytkownik nacinie przycisk
menu.
21/227
Kiedy klikniemy na zakadk z naszym plikiem layoutu ( na poprzedniej ilustracji u mnie to

activity_ekran_glowny.xml ) zobaczymy projekt naszego gwnego ekranu. Po lewej stronie mamy
menu z elementami ktre moemy przykleja na ekranie.
Na ten moment zostawiamy tradycyjne Hello World i uruchomimy aplikacj na emulatorze i

prawdziwym telefonie.
22/227
Aby uruchomi aplikacj, klikamy prawym przyciskiem myszy na katalogu projektu w polu
Package Explorer, dalej Run As-->Android Application. Powinno nam si pojawi takie
okno:
23/227
Moemy tutaj wybra uruchomienie z uyciem wirtualnego lub realnego urzdzenia. Na ten
moment mam stworzone wirtualne urzdzenia, ale adne nie jest uruchomione. Odpalimy wic
aplikacj jednoczenie uruchamiajc wirtualne urzdzenie. Zaznaczam Launch a new Android
Virtual Device , zaznaczam wybrane urzdzenie i wciskam Ok.
Virtualne urzdzenie moe uruchamia si nawet 2-3 minuty, wszystko zaley od sprztu ktrym
dysponujemy. Po uruchomieniu na urzdzeniu wirtualnym:
24/227
Tym razem uruchomimy program na realnym urzdzeniu. Podobnie jak i wczeniej klikamy PPM
na projekcie, wybieramy Run > Run as Anroid Application. Pojawi si okno jak wczeniej. W
sekcji Choose a running Android device widzimy dwa urzdzenia. Jedno to wczeniej
uruchomione urzdzenie wirtualne, drugie to realne urzdzenie Samsung ACE3. Aby mc std
wrzuca aplikacje na takie urzdzenie, musimy je wczeniej przygotowa wczajc na nim opcje
programistyczne. Aby to zrobi, wchodzimy w Ustawienia , dalej szukamy na dole opcji opcje
programisty w ktre wchodzimy i aktywujemy. Bez tego nie bdzie moliwoci debuggowania
aplikacji, czyli nie wdroymy jej z Eclipsa na dany telefon. Po wczeniu opcji, podczamy telefon
przewodem do komputera. Przy kolejnym uruchomieniu aplikacji nasz telefon powinien by ju
tutaj widoczny. Zauwayem ju e niektre urzdzenia w ogle nie chc rozmawia z Eclipsem w
ten sposb, choby wszystko byo powczane i poczone jak naley. Miaem tak np. z telefonem
Prestigio. Zanim wic zaczniesz grzeba w opcjach i si irytowa, po prostu sprawd z innym
urzdzeniem.
25/227
Zaznaczam swj telefon i wybieram Ok. Po odpaleniu:
26/227
Elementy wizualne
Przegld podstawowych komponentw graficznych
Tutaj zajmiemy si najczciej uywanymi, podstawowymi komponentami graficznymi. Na ekranie
przykleiem kilka takich elementw i poniej kady z nich opisuj.
TextView
Pierwszy komponent od gry. Suy do wywietlania tekstu. Uytkownik aplikacji nie moe
zmodyfikowa jego zawartoci. Na palecie komponentw mamy rne jego wariacje w tym
LargeText, MediumText i SmallText. W rzeczywistoci te trzy niby rne elementy to ta sama
klasa, ale z rnie ustawionymi parametrami wielkoci czcionki. Dostpny jest w palecie w panelu
Form Widgets.
Button
Drugi element od gry. Przycisk. Moemy zaprogramowa w Javie sposb jego zachowania po
przyciniciu. Dostpny jest w palecie w panelu Form Widgets.
27/227
EditText
Pole edycyjne w ktre uytkownik aplikacji moe wprowadza tekst. Dostpny jest w palecie w
panelu TextFields. Znajdziemy tam rwnie kilka wariacji tego komponentu, umoliwiajcych np.
wprowadzanie wycznie liczb, albo tylko dat. Wszystkie one s obiektami klasy EditText, jednak z
rnie ustawionymi parametrami wywietlania i wprowadzania danych.
ImageView
Element trzeci od dou. Suy do wywietlania obrazkw. Dostpny jest w palecie w panelu
Images & Media.
ImageButton
Widoczny jest pod ImageView. Jest czym porodku midzy Buttonem a ImageView. Moemy na
nim wywietli obrazek, a jednoczenie oprogramowa jego zachowanie po klikniciu. Dostpny
jest w palecie w panelu Images & Media.
CheckBox
Umoliwia zaznaczenie lub odznaczenie jakiej opcji (np. akceptacja regulaminu). Dostpny jest w
palecie w panelu Form Widgets.
28/227
Korzystanie z komponentw wizualnych w kodzie

Umieszczanie komponentw na ekranach aplikacji odbywa si najczciej poprzez ich
przecignicie na ekran (co tak naprawd generuje kod XML w pliku layoutu) lub rczne
definiowanie ich w pliku layoutu. Poza tym, e figuruj jako obiekty XML, nie ma do nich adnego
dowizania w kodzie aktywnoci. Jeli zechcemy w jaki sposb z tych komponentw korzysta,
musimy w klasie aktywnoci podpi do nich referencje.
Zaczynamy od przyklejenia na ekran jakich przykadowych komponentw:
29/227
Gdy zajrzymy do pliku layoutu, zobaczymy e zostao wygenerowane troch dodatkowego kodu
zwizanego z tymi nowymi komponentami:
30/227
Przejdmy teraz do kodu aktywnoci. Aby korzysta z przyklejonych komponentw, musimy

przede wszystkim posiada obiekty klas ktrych s komponenty. Definiuj je wic w liniach 12 i
13. Mgbym to zrobi rwnie dobrze w metodzie onCreate (wywoywanej przy uruchamianiu
aktywnoci), ale taka globalna deklaracja sprawi, e bd mia do tych obiektw dostp rwnie w
innych metodach. W liniach 19 i 20 podpinam do tych obiektw referencj do komponentw. Suy
do tego metoda findViewById. Jako jej parametr podaj wskanik do zdefiniowanego komponentu.
Zauwa e kady kompontent okrelony w pliku layoutu ma parametr android:id. To wanie on
jednoznacznie identyfikuje dany komponent. Nasz guzik na ten przykad ma identyfikator
button1. Chcc wic podpi referencj do tego obiektu pisz w parametrze metody
findViewById R.id. i po tym podaj identyfikator komponentu o ktry mi chodzi. Od tego
momentu mog ustawi czy czyta parametry podpitych ju komponentw wizualnych.
31/227
Po uruchomieniu wyglda to tak:
32/227
Obsuga i konfiguracja podstawowych komponentw graficznych.

Zasadniczo kady z elementw omawianych w tej publikacji mona zwyczajnie przecign z
palety na ekran. Omawiajc poszczeglne elementy bd te wskazywa sposb umieszczenia ich
bezporednio poprzez plik XML layoutu. Ma to na celu lepsze zrozumienie zasady dziaania i
parametryzacji komponentw. Naley jedynie pamita, e jest to tylko jedna z moliwoci.
TextView
<TextView
android:id="@+id/textView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="Tekst tylko do odczytu" />
Tekst jaki ma zosta wywietlony na komponencie moemy ustawi przy pomocy parametru
android:text w pliku layoutu, tak jak to wida na przykadzie powyej, lub poprzez metod setText
klasy TextView, jak to wida poniej:
TextView tv = (TextView) findViewById(R.id.textView1);
tv.setText("Napisik tylko do odczytu...");
Button
<Button
android:id="@+id/button1"
android:text="Przycisk" />
Tekst jaki ma zosta wywietlony na komponencie moemy ustawi przy pomocy parametru
android:text w pliku layoutu, tak jak to wida na przykadzie powyej, lub poprzez metod setText
klasy Button, jak to wida poniej:
Button b=(Button) findViewById(R.id.button1);
b.setText("Napis na guziku");
Obsuga zdarzenia kliknicia na komponentach (nie tylko na przycisku) zostaa opisana w osobnej
publikacji to do spory temat.
33/227
EditText
<EditText
android:id="@+id/editText1"
android:text="Pole do wprowadzania danych" >
Tekst domylny jaki ma zosta wywietlony na komponencie moemy ustawi przy pomocy
parametru android:text w pliku layoutu, tak jak to wida na przykadzie powyej, lub poprzez
metod setText klasy EditText, jak to wida poniej:
EditText et=(EditText)findViewById(R.id.editText1);
et.setText("Domylny tekst");
Tekst wprowadzony przez uytkownika moemy odebra przy pomocy metody getText klasy
EditText:
EditText et=(EditText)findViewById(R.id.editText1);
String coWpisano=et.getText()+"";
Poniewa metoda getText zwraca obiekt klasy Editable (a nie jak bymy si mogli spodziewa String), dodaem fragment + wymuszajcy niejawn konwersj na String. Bez tego aplikacja si
nie kompiluje.
ImageView
<ImageView
android:id="@+id/imageView1"
android:src="@android:drawable/star_on" />
ciek obrazka ktry ma zosta wywietlony ustawiamy przy uyciu parametru android:src w
pliku layoutu. Obrazek ktry ma zosta wywietlony wrzucamy do dowolnego z katalogw
drawable-xxxx bdcych podkatalogami katalogu res, a nastpnie odnosimy si poprzez wskanik
zbudowany na tej zasadzie: @android:drawable/nazwa_pliku_bez_rozszerzenia
34/227
ImageButton
<ImageButton
android:id="@+id/imageButton1"
android:src="@android:drawable/sym_action_email" />
ciek obrazka ktry ma zosta wywietlony ustawiamy przy uyciu parametru android:src w
pliku layoutu. Obrazek ktry ma zosta wywietlony wrzucamy do dowolnego z katalogw
drawable-xxxx bdcych podkatalogami katalogu res, a nastpnie odnosimy si poprzez wskanik
zbudowany na tej zasadzie: @android:drawable/nazwa_pliku_bez_rozszerzenia
CheckBox
<CheckBox
android:id="@+id/checkBox1"
android:text="CheckBox" />
Tekst ktry ma zosta wywietlony obok pola zaznaczania okrelamy przy uyciu parametru
android:text w pliku layoutu lub przy uyciu metody setText klasy CheckBox, tak jak to wida
poniej:
CheckBox cb=(CheckBox) findViewById(R.id.checkBox1);
cb.setText("Przeczytaem i akceptuj regulamin");
Odczyt stanu zaznaczenia moemy przeprowadzi przy uyciu metody isChecked klasy CheckBox,
tak jak to wida poniej:
CheckBox cb=(CheckBox) findViewById(R.id.checkBox1);
if(cb.isChecked()){
//zaznaczone
}else{
//nie zaznaczone
}
35/227
Zasoby tekstowe wykorzystanie pliku strings.xml

Wyobramy sobie tak sytuacj. Wyklejam formularz taki jak np. ten na dole. Podobnych ekranw
w aplikacji jest np. 30. W kadym pojawiaj si przyciski Zatwierd i Anuluj. W niektrych
pojawia si te fraza Imi:, Nazwisko etc.
Teraz musimy zrobi niemieckojzyczn wersj programu, albo choby zmieni wszystkie nazwy
na pisane ma liter....
36/227
Dopuki teksty te okrelam na sztywno w pliku layoutu, tak jak to wida poniej (linie 15,25,34),
doputy bd musia przy kadej tego typu zmianie modyfikowa plik layoutu kadej aktywnoci
ktrej zmiana ma dotyczy.
37/227
Lepszym rozwizaniem bdzie odnalezienie pliku strings.xml znajdujcego si w katalogu values

bdcego podkatalogiem katalogu res i skorzystanie z moliwoci jakie daje.
38/227
Kiedy go wyedytujemy, powinnimy zobaczy tak zawarto:
Dodajmy tam kilka elementw. Od teraz teksty ktre pojawiaj si nam na formularzu bd
definiowane tutaj. Do kadej frazy przypisana jest nazwa np. do frazy Imi: przypisana jest
nazwa name:
39/227
Teraz w elemencie android:text zamiast pisa na sztywno tekst ktry ma si pojawi, pisz
odwoanie po nazwie do wpisw w pliku strings.xml (linie 15,25,34):
Moemy takie wskaniki zrobi we wszystkich plikach layoutw. Dziki takiemu zabiegowi,
zmiana tekstu na wszystkich guzikach sucych do zatwierdzania formularza, czy nawet
dorobienie alternatywnej wersji jzykowej aplikacji wymaga bdzie zmian w jednym tylko
miejscu i bez wielokrotnej zmiany tego samego tekstu w rnych plikach layoutw.
40/227
Szablony kolorw
Jeli zechcemy czsto uywa w naszej aplikacji jakiego koloru, lub np. zrobi dwukolorow
aplikacj, moemy wszdzie podawa kodowo kolor np. #FF0033, albo stworzy szablon i
odwolywac si do koloru na zasadzie kolor_tla. Informacja o kodzie koloru dla kolor_tla
znajduje si w osobnym pliku xml. Dziki takiemu rozwizaniu moemy szybko modyfikowa
kolory w caej aplikacji, np. jeli zechcemy zrobi skrk witeczn dla naszego programu :)
Zaczynamy od utworzenia pliku xml w katalogu values bdcym podkatalogiem katalogu res.
Klikamy na nim PPM new new Android XML file. Wyskakuje nam takie okienko. Podajemy
nazw pliku i zatwierdzamy.
41/227
W pliku powinny znale si wpisy podobne do tych:
To jest przypisanie koloru do nazwy. Gdziekolwiek w aplikacji odwoam si teraz @color/barbie,

wywietli mi si kolor #CC66FF. atwiej te bdzie zmienia kolorystyk aplikacji wystarczy e
zmieni kod koloru w tym pliku XML, a zmiana bdzie obowizywaa dla wszystkich elementw
gdzie odwouj si do nazw z etego pliku. Przetestujemy dziaanie. Do ekranu przyklejam guziczka:
42/227
A w pliku layoutu tej aktywnoci odwouj si do tych kolorw w taki sposb:

@color/nazwa_koloru :
Przyjrzyj si limion 9 i 20. Odwoaem si po nazwach do wczeniej zdefiniowanych w pliku

kolory.xml kolorw. W linii nr 9 ustawiem to dla ekranu, w linii nr 20 ustawiem kolor dla
przycisku.
43/227
Przeczam si teraz na widok projektowania graficznego i widz to:
Wyszo paskudnie, chocia wierz e gdzie na wiecie s ludzie ktrzy maj dom urzdzony w
takich kolorach. Na szczcie w przypadku aplikacji na Androida (w przeciwiestwie do domu)
mona to atwo i szybko zmieni.
44/227
Style komponentw
Przypumy e mam tak sytuacj, mam trzy napisy na ekranie i dla wszystkich chc okreli taki
sam kolor czcionki, wielko czcionki, ewentualnie inne parametry.
Mgbym to robi osobno dla kadego komponentu ustawiajc parametry w pliku layoutu danej
aktywnoci. To wicej pracy ni to warte, a ponadto gdybym zechcia co zmieni, musiabym
zmienia dla kadego komponentu osobno. Kady kto napisa cho jedn podstron w HTML
powinien doskonale rozumie w czym rzecz. Podobnie jak w HTML, tak i tutaj moemy
zdefiniowa style i z ich uyciem stosowa okrelone wasnoci dla wielu komponentw naraz.
Filozofia jest podobna do stosowanych przy tworzeniu stron internetowych plikw css.
45/227
Zaczynam od stworzenia pliku XML ze stylem. Klikam PPM na katalogu values bdcym
podkatalogiem katalogu res. Wybieram new-->Android XML File. Pojawia mi si takie okno:
46/227
Podaj nazw pliku w ktrym opisz styl komponentw. Nazwaem go styl_napisow. Teraz w pliku
wprowadzam kilka zmian. Dodaj dwa rne style napisw. Zawarto mojego pliku ze stylami:
<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:android="http://schemas.android.com/apk/res/android">
<style name="wielki_napis">
<item name="android:textSize">50dp</item>
<item name="android:textColor">#0000FF</item>
</style>
<style name="maly_napis">
<item name="android:textSize">20dp</item>
<item name="android:textColor">#FF0000</item>
</style>
</resources>
Jak widac okrelam wielko i kolor czcionek. S dwa style dla duego niebieskiego napisu, oraz
mniejszego czerwonego. Mona tutaj oczywicie okreli znacznie wicej rzeczy np. szeroko i
wysoko komponentu, napis na nim, a nawet metod ktra obsuguje kliknicie komponentu. W
pliku layoutu dla danej aktywnoci dodaj do komponentw nowy parametr: style, oraz wskazuj
nazw stylu sprzed momentem stworzonego pliku:
<TextView
android:layout_alignParentLeft="true"
android:layout_alignParentTop="true"
android:layout_marginLeft="25dp"
android:layout_marginTop="35dp"
android:text="Napis numer 1"
style="@style/wielki_napis"
/>
<TextView
android:layout_alignLeft="@+id/textView1"
android:layout_below="@+id/textView1"
android:text="Napis numer 2"
style="@style/maly_napis"
/>
47/227
Efekt po uruchomieniu:
Style moemy stosowa dla wszelakich komponentw, nie tylko dla napisw.
48/227
To ekranu aplikacji
Zaczniemy od ustawienia koloru ta, to jest zdecydowanie najprostsze. Stworzyem nowy projekt.
Cao sprowadza si do ustawienia parametru android:background (linia 9) w XMLowym pliku
layoutu.
Jeli chcesz wybra jaki kolor, moesz znale zestawienie kolorw dla HTML (np. tutaj:
http://www.kurshtml.edu.pl/html/wykaz_kolorow,kolory.html) Ustawiem przypadkowy kod koloru
FF0044 i wyszo mi co takiego(fuj):
49/227
Tem moe by rwnie obrazek. Wrzuciem obraze do podkatalogu drawable-hdpi:
Tym razem zamiast podawa kod koloru, podaj w pliku layoutu w parametrze android:background
wskanik do obrazka (patrzymy na lini nr 9):
50/227
Efekt:
51/227
Piese nam si troch rozcign. W zalenoci od rozmiaru i proporcji ekranu bdziemy mie
wikszego albo mniejszego, chudszego albo grubszego piesea. To nie zawsze musi dobrze
wyglda. Moe lepiej byoby by obrazek ta si powtarza? Aby uzyska taki efekt, musimy
stworzy plik XML ktry bdzie opisywa sposb prezentacji obrazka. W tym celu klikamy PPM na
katalogu drawable-hdpi i wybieramy New-->Android XML File. Pojawi nam si takie okno:
52/227
Zaznaczamy bitmap i wpisujemy nazw pliku xml:
Zatwierdzamy. Zawarto pliku uzupeniamy tak by wyglda w taki sposb:

<bitmap xmlns:android="http://schemas.android.com/apk/res/android"
android:src="@drawable/doge"
android:tileMode="repeat"
>
</bitmap>
Oczywicie w parametrze android:src podajemy wskanik do swojego obrazka. Parametr

android:background w pliku layoutu modyfikujemy tak, by wskazywa na nasz nowo utworzony
plik XML a nie plik obrazka:
53/227
Po tych zabiegach ekran programu po uruchomieniu wyglda tak:
54/227
Konfiguracja wasnego menu

W wikszoci urzdze z Androidem (telefony, tablety) mamy dostpny przycisk menu. Warto
byoby oprogramowa to co si dzieje po jego wciniciu. Moemy tam wstawi np. opcj wejcia
w ustawienia programu, informacje o autorze, albo pomoc. Jeli przyjrzymy si domylnie
automatycznie tworzonej klasie gwnej aktywnoci, zobaczymy e zawiera ona metod
onCreateOptionsMenu:
W niej wskazywany jest plik zawierajcy opis zawartoci menu. Powyszy (domylny) wpis
wskazuje na plik main.xml znajdujcy si w katalogu menu bdcym podkatalogiem katalogu res:
55/227
Moemy go przerobi pod wasne potrzeby, lub stworzy nowy i przerobi metod
onCreateOptionsMenu tak by wskazywaa nowo stworzony. Domylnie jego zawarto wyglda
tak:
Mamy jedn opcj w menu, z napisem okrelonym w pliku strings.xml znajdujcym si w katalogu
res --> values pod nazw action_settings. Przygldamy si mu:
Widzimy, e napis na tej opcji w menu to Settings. Teraz zmienimy plik main.xml, by
wprowadzi wasne opcje menu. Nic nie stoi te na przeszkodzie bysmy stworzyli osobny plik,
musimy jedynie pamita o zmianie ustawie w metodzie onCreateOptionsMenu aktywnoci. Do
pliku strings.xml dodaj jeden wpis:
56/227
Dalej modyfikuj zawarto pliku main.xml wg wasnych potrzeb:
Kady element <item> to kolejna opcja w menu. Zrobiem trzy elementy z napisami wpradzonymi
bezporednio w tym pliku, a jeden z napisem pobieranym z pliku strings.xml Napis na opcji okresla
parametr android:title. Parametr android:orderInCategory okrela kolejno wywietlania w menu
od gry. Opcja android:id to identyfikator danej opcji w menu. Musimy zadba o to by byy one
rne dla kadego elementu menu, inaczej nie bdziemy pniej w stanie odrni ktra opcja
zostaa wybrana. Na ten moment menu po uruchomieniu wyglda tak:
57/227
Jeli tak wolisz, nie musisz definiowa zawartoci menu w pliku XML. Moesz to zrobi
bezporednio w kodzie Javy:
Metoda add dla obiektu klasy Menu (czyli naszego menu) wywoywana tutaj ma 4 parametry.
Wedug kolejnoci: Numer grupy, numer elementu, kolejnoc wywietlania, napis. Kod w dziaaniu:
58/227
Wracam jednak do starej metody z plikiem XML. Teraz dodamy obsug kliknicia. Dorzucam
metod onOptionsItemSelected ktra jest automatycznie wywoywana za kadym razem gdy
uytkownik kliknie w menu. Przez parametr tej metody przekazywany jest obiekt elementu menu
ktry zosta kliknity. Mog pobra jego identyfikator, jednak nie bdzie to identyfikator typu
opcja1 , opcja2 czyli takie jak zdefiniowaem w pliku main.xml, a identyfikator liczbowy, ktry
dopiero mog porwna z identyfikatorami liczbowymi moich opcji menu. Tak to niestety trzeba na
okoo robi:
W zalenoci od identyfikatora wywietlam waciwy tekst. Wywietlam te identyfikator liczbowy.

Kliknem najpierw pierwsz opcj menu, potem trzeci. Tak wygldaj efekty:
59/227
Rne layouty w rnych orientacjach

Poniewa ekrany telefonw i tabletw z reguy nie s kwadratowe, a nasze aplikacje mog dziaa
zarwno w pionie jak i poziomie, warto byoby uwzgldni takie dwie moliwoci. Wbrew
ostatnim trendom, w tym przypadku mamy wycznie dwie orientacje ;) Ukad komponentw na
ekranie projektowany dla orientacji pionowej, najprawdopodobniej rozjedzie si, gdy obrcimy
ekran do orientacji pionowiej. Mamy moliwo zrobienia rnych layoutw, ktre bd uywane
w zalenoci od tego jak bdziemy trzyma urzdzenie. Jeli pozostaniemy przy domylnym
jednym pliku layoutu, bdzie on uywany w obu przypadkach. Aby rozrni ukad komponentw
w zalenoci od sposobu trzymania telefonu, wystarczy doda w katalogu res katalog o nazwie
layout-land i w nim umieci alternatywny plik layoutu. Wszystko odbywa si automatycznie.
W przypadku pooenia pionowego, wczytywany bdzie layout z katalogu layout, w przypadku

poziomego z layout-land. Pamitaj tylko, e w metodzie onCreate aktywnoci jest wskazywana
nazwa pliku z layoutem, jeli wic chcielibysmy aby to dziaao w zaoony sposb, musimy zadba
o to by oba pliki layoutu nazyway si tak samo.
setContentView(R.layout.activity_main);
60/227
Wyczenie obracania ekranu w aplikacji

Podczas obracania ekranu nastpuje automatyczne wywoanie metod onPause, onSaveInstance,
onStop a nastpnie onRestoreInstance i onResume. Zasadniczo zawarto pl takich jak
komponenty klasy EditText nie czyszcz si, wszystko wraca do pierwotnej postaci po obrocie
ekraniu. Nie dotyczy to pl takich klas jak TextView ani zdeklarowanych przez nas zmiennych.
Wszystko jest zerowane do takiej postaci jak przy uruchomieniu aplikacji. Oczywicie moemy
zaimplementowa metody onSaveInstance i onRestoreInstance, a nastpnie przekazywa dane ktre
maj zosta odtworzone przez obiekt klasy Bundle, jednak przy wikszej iloci zmiennych moe to
by czasochonne. Innym wyjciem jest zablokowanie moliwoci obracania ekranu. Zachowanie
jak przy resetowaniu aplikacji w ogle nie bdzie miao wtedy miejsca. Niektre aplikacje
wymagaj jakiej okrelonej pozycji ekranu bez jej obracania. Np. dziwnie by si ogldao film
wywietlany na pionowo ustawionym ekranie. Cao sprowadza si do dodania wpisu
android:screenOrientation="portrait"
W elementcie Application w pliku manifestu. Powysze ustawnienie (portrait) blokuje ekran w

pozycji pionowej, mona te ustawi na landscape czyli poziome. Podgld na element aplpication,
czyli jak to jest zmontowane cae:
<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="com.example.gpsinfo.MainActivity"
android:label="@string/app_name"
android:screenOrientation="portrait"
>
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
61/227
Ukady elementw na ekranie rodzaje layoutw

Rozkad elementw na ekranie opisany jest w xml'owym pliku layoutu. Moemy go edytowa
rcznie, lub przykleja kompotenty na zasadzie przecignij i upu. To w jaki sposb okrelane
jest pooenie poszczeglnych elementw zaley od lodzaju layoutu. Poszczglne rodzaje layoutw
opisuj poniej. W pierwszej kolejnoci musimy znale waciwy plik layoutu dla aktywnoci
ktrej ukad elementw chcemy zmienia. Stworzyem now aplikacj PrzykladTableLayout. W
jej katalogu res-->layout znajduje si plik xml w ktrym bdzie opisany layout naszej gwnej
aktywnoci. Jeeli tworzc projekt zaakceptowae domyln nazw aktywnoci, to Twj plik
bdzie si nazywa activity_main.xml
62/227
Table layout ukad tabelaryczny

Skoro zabrae/a si za programowanie na Androida to zakadam, e takie rzeczy jak podstawy
HTML s dla Ciebie banalne. Ten rodzaj ukadu jest bardzo zbliony do elementu Table znanego z
jzyka HTML. Definiujemy poszczeglne wiersze i kolumny. Skasuj ca zawarto swojego pliku
layoutu i wklej taki kod:
<TableLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/tableLayout1"
android:layout_width="fill_parent"
android:layout_height="fill_parent" >
<TableRow
android:id="@+id/tableRow1"
android:padding="5dip" >
<TextView
android:text="Kolumna nr 1"/>
<Button
android:text="Kolumna nr 2" />
</TableRow>
<TableRow
android:id="@+id/tableRow1"
android:padding="5dip" >
<EditText
android:text="kolumna nr 1"/>
<EditText
android:text="kolumna nr 2"/>
</TableRow>
</TableLayout>
Kolejne elementy <TableRow> okrelaj kolejne wiersze w tabeli. Kolumn bdzie tyle, ile bdzie
elementw w wierszu w ktrym jest najwicej elementw dokadnie jak w HTML.
63/227
Domylnie wywietlana jest formatka do montowania elementw metod drag & drop. Aby przej
do edycji rcznej pliku kliknij zakadk activity_main.xml znajdujc si u dou.
Po wklejeniu kodu moesz wrci do ekranu drag & drop i powiniene zobaczy taki widok:
Moesz przeciga elementy z menu znajdujcego si po lewej stronie, a nastpnie modyfikowa

ich pooenie rcznie , lub umieszcza elementy przy uyciu kodu a przesuwa graficznie. Nie ma
to znaczenia, poniewa wszystkie zmiany i tak zachodz w pliku XML edytor graficzny jest tylko
nakadk :)
64/227
Linear layout ukad liniowy, obiekty uoone pod sob lub obok siebie
Ten rodzaj layoutu dziaa w oparciu o zasad, e elementy znajduj si kolejno pod sob lub obok
siebie. Podobnie jak poprzednio, stwrz nowy projekt i zawarto pliku layoutu zamie na ten kod:
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:orientation="horizontal" >
<TextView
android:text="Element nr 1" />
<TextView
<TextView
</LinearLayout>
Okrelilimy tutaj 3 pola wywietlajce tekst. Zwr przy okazji uwag na element:
android:orientation="horizontal"
znajdujcy si w tagu <LinearLayout... Horizontal okrela, e elementy bd si znajdoway obok

siebie, a nie pod sob. Po uruchomieniu aplikacja wyglda tak:
65/227
W ramach eksperymentu dodaem przy tych ustawieniach jeszcze dwa elementy TextView. Jak
wida, nie wyglda to najlepiej. Do takiego efektu moe doj np. na telefonach o mniejszych
ekranach lub rozdzielczoci:
Modyfikuj teraz nieco element LinearLayout, konkretnie wasno orientation z horizontal na

vertical:
android:orientation="vertical" >
66/227
Ta zmiana sprawi, e elementy nie bd ze sob ssiadoway obok siebie, a jeden pod drugim.
Efekt:
67/227
RelativeLayout pooenie elementw wzgldem innych elementw

Jeli wykleisz sobie elementy na aktywnoci przy uyciu przecigania komponentw z palety,
domylnie ich pooenia zostan okrelone jako pooenie wzgldem innego elementu. Dla
przykadu przykleiem dwa komponenty:
68/227
System domylnie ustawia RelativeLayout. Tutaj zawarto wygenerowanego pliku layoutu:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:paddingBottom="@dimen/activity_vertical_margin"
android:paddingLeft="@dimen/activity_horizontal_margin"
android:paddingRight="@dimen/activity_horizontal_margin"
android:paddingTop="@dimen/activity_vertical_margin"
tools:context=".MainActivity" >
<TextView
android:layout_alignParentLeft="true"
android:layout_alignParentTop="true"
android:text="TextView" />
<Button
android:layout_toRightOf="@+id/textView1"
android:text="Button" />
</RelativeLayout>
Jak wida, pooenie elementu klasy TextView jest wskazane jako odlegoci od grnego i lewego
marginesu, a pooenie elementu Button jako odlegoci wzgldne od elementu TextView. Takie
podejcie jest zrozumiae przy przeciganiu elementw, ale takie rozmieszczanie przy uyciu
kodowania rcznego nie byoby specjalnie wygodne. Warto zna ten typ layoutu jedynie ze wzgldu
na moliwo nanoszenia rcznych poprawek do automatycznie generowanego kodu. Chodzi o
sytuacje gdy przecigamy graficznie komponenty, ale nie moemy ustawi elementw tak jak
bymy sobie tego yczyli, bo nam si wszystko rozjeda.
69/227
AbsoluteLayout pooenia na sztywno

AbsoluteLayout jest takim rodzajem layoutu, gdzie ustalamy na sztywno x i y grnej lewej
krawdzi elementu. Stwrz kolejny projekt i zamiast dotychczasowego kodu w pliku layoutu wstaw
ten:
<AbsoluteLayout xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_height="fill_parent">
<Button
android:layout_width="100dp"
android:text="Absolute"
android:layout_x="50px"
android:layout_y="261px" />
<Button
android:layout_width="100dp"
android:text="Layout"
android:layout_x="225px"
android:layout_y="120px" />
</AbsoluteLayout>
70/227
Po uruchomieniu aplikacji:
Z jednej strony, rozkad elementw nam si nie rozjedzie, ale z drugiej ustawienie wsprzdnych
elementu obowizuje zarwno przy pionowym jak i poziomym pooeniu ekranu. Jest te
niezalene od wielkoci i rozdzielczoci ekranu. Moe si wic okaza e na niektrych telefonach,
albo po obrceniu ekranu, cz komponentw znalaza si poza widocznym obszarem.
71/227
Parametr wrap_content vs fill_parent

Kiedy przyklejamy element taki jak guzik, w pliku layoutu dodawany jest wpis odnoszcy si do
tego obiektu. Taki jak ten:
<Button
Parametry typu marginTop czy tekst s jasne, ale mamy turaj layout_height i layout_width
okrelone nie jak si mona by byo spodziewa w pikselach, a jako wrap_content. Takie
ustawienie jest domylne i oznacza ono, e element ma by tak szeroki i wysoki by zmieci
znajdujcy si w nim napis (lub obrazek w przypadku elementu imageView, czy inn zawarto w
przypadku inych komponentw). Efekt wizualnie wyglda tak:
Alternatywnie zamiast wrap_content moemy wpisa fill_parent:

<Button
Takie ustawienie oznacza, e komponent ma si dopasowa szerokoci/wysokoci do kontenera w

ktrym si znajduje (w tym przypadku w ogle na ekranie). Ustawilem parametr fill_parent dla
szerokoci.
72/227
Efekt prezentuje si tak:
Ponownie wprowadzam zmian w konfiguracji. Tym razem ustawiam fill_parent rwnie dla
wysokoci komponentu:
<Button
android:layout_height="fill_parent"
Mamy w efekcie duuuy guzik :
73/227
Scroll View ekran przewijany

Niekiedy nie wystarczy nam ekranu na wszystkie elementy ktre chcielibymy umieci.
Przykadowo mamy aplikacj z du iloci guzikw w ramach menu wyboru. Guzikw jest za
duo w stosunku do dugoci ekranu by mogy si zmieci. W takich przypadkach stosuje si scroll
view, czyli rodzaj layoutu ktry pozwala na przewijanie. Wejd do menu ustawie w Androidzie a
zrozumiesz o co chodzi. Aby przygotowa taki wygld, w pierwszej kolejnoci zmieniam layout w
pliku xml layoutu na scroll view:
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_height="wrap_content" >
<TextView
android:text=" " />
</ScrollView>
Umieciem te tam element tekstowy do ktrego wrzuc troch tekstu, tak by byo wida efekt
przesuwania ekranu. W klasie aktywnoci dodaj kawaek kodu ktry do elementu tekstowego
zdefiniowanego przed momentem wstawia kolejne liczby w kolejnych liniach:
74/227
Po uruchomieniu mog przeciga ekran suwaczkiem znajdujcym si po prawej stronie:
75/227
Czas na programowanie!
Wykorzystanie Log.d w debugowaniu
W normalnej Javie jeli zechcielibymy sprawdzi co si dzieje w programie i gdzie si
przewraca, najpewniej uylibymy metody typu
System.out.println(Trololo, jestem po obliczeniach);
:)
W Androidzie nie ma konsoli systemowej (javovej), mamy za to moliwo wyrzucania
komunikatw na konsol LogCat w rwnie prosty sposb. Wystarczy takie wywoanie:
Log.d("debuggowanie programu", "Jestem komunikatem");
a w konsoli LogCata zobaczymy komunikat :
To co podamy do metody d jako pierwszy parametr trafi do kolumng Tag, to co podamy jako
drugi parametr trafi do kolumny Text. Metoda ta dziaa zarwno przy uruchamianiu programu na
wirtualnym urzdzeniu, jak i fizycznym sprzcie podpitym do komputera.
76/227
Cykl ycia aplikacji

Aktywno moe znajdowa si w czterech stanach :
1. Jest na pierwszym planie
2. Jest wywietlana, ale nie znajduje si na pierwszym planie np. kiedy wywietlimy jakie mae
okienko z komunikatem
3. Jest wyczona. Nie dziaa, nie ma jej w pamici operacyjnej.
4. Wstrzymana. Nie jest zamknita, ale te nie jest widoczna. Dziaa w tle. Tak si stanie kiedy
przejdziemy z jednej aktywnoci do drugiej. Aktywno pozostajca w tym stanie moe w kadej
chwili zosta zabita przez system, w razie gdyby ten potrzebowa pamici ktr ta aktywno
wykorzystuje.
Klasa dziedziczca po klasie Activity bdzie dziedziczya kilka metod ktre s uruchamiane przy
przechodzeniu aktywnoci midzy stanami. Moemy je przesoni. Wprowad taki kod jak na
poniszej ilustracji, uruchom aplikacj a nastpnie pobaw si urzdzeniem tj. poobracaj je, zamknij
aplikacj, otwrz jeszcze raz, nacinij przycisk Home itp. Popatrz co si dzieje podczas
wykonywania tych czynnoci na konsoli LogCat (znajduje si w dolnej czci ekranu Eclipse).
77/227
Metoda onCreate jest wywoywana wtedy, kiedy aktywno jest uruchamiana po raz pierwszy. Z
tego powodu to wanie j wykorzystuje si najczciej i to wanie w niej ustawiamy wygld
ekranu oraz ustawienia pocztkowe.
Metoda onStop jest wywoywana kiedy aplikacja jest zamykana. Moesz tutaj wprowadzi kod
ktry zapisze stan aplikacji np. do bazy danych.
Metoda onPause jest wywoywana np. kiedy obracamy ekran, a take przed metod onStop w
przypadku zamknicia aplikacji.
Metoda onResume jest wywoywana rwnie kiedy obracamy ekran, lub przy powrocie do
dziaania po wczeniejszym zapazowaniu.
78/227
Peen diagram przechodzenia aplikacji przez rne stany (pochodzi z dokumentacji Androida):
79/227
Komunikaty Toast
Komunikaty Toast su do krtkotrwaego wywietlania mao wanych komunikatw.
Komunikat pojawia si na kilka sekund i znika, uytkownik moe nawet tego nie zauway, wic
nie powiniene w ten sposb wywietla np. komunikatw o bdach. Doskonale si za to nadaje to
wywietlania np. podpowiedzi.
Wszystko sprowadza si tak naprawd do linii:

Toast.makeText(getApplicationContext(), "Jestem wiadomoci...",
Toast.LENGTH_SHORT).show();
Ktra to jest odpowiedzialna za cay komunikat. Pozostaa cz kodu widoczna na obrazie

powyej nie jest dla nas istotna.
80/227
Tutaj zrobiem tak, e komunikat pojawia si zaraz po uruchomieniu programu. Parametr

Toast.LENGTH_SHORT okrela czas wywietlania komunikatu. Zamiast Toast.LENGTH_SHORT
moemy te da Toast.LENGTH_LONG ,wtedy komunikat bdzie si wywietla nieco duej. W
pierwszej wersji jest to okoo 2 sekund, w drugiej okoo 4. Niestety nie ma moliwoci prostej
rcznej konfiguracji czasu wywietlania takiego komunikatu dla pojedynczej aplikacji. Efektem jest
wywietlenie u dou aplikacji takiego komunikatu:
81/227
Podpowiedzi w oknach edycyjnych

Na niektrych urzdzeniach z Androidem mamy may ekran. W takich sytuacjach nie ma miejsca na
dodatkowe dymki z podpowiedziami lub pola opisowe. Alternatyw mog by podpowiedzi w
samych oknach edycyjnych. Podpowied bdzie wyszarzona i bdzie mwia co w danym oknie
naley wprowadzi.
Zaczynam od przyklejenia na ekranie jednego komponentu klasy PlainText :
82/227
Dalej w klasie aktywnoci wykorzystuj metod setHint klasy EditText. Zawarto linii nr 14
suy jedynie podpiciu referencji do obiektu (musz si jako do niego odnie). Samo ustawienie
w zwizku z umieszczeniem go w metodzie onCreate bdzie dziaao ju od uruchomienia.
Efekt:
83/227
Obsuga zdarzenia kliknicia na komponent

Obsugiwa zdarzenie kliknicia komponentu mona na kilka sposobw. Przedstawi trzy
najpopularniejsze. Do wszystkich trzech sposobw bdzie nam potrzebny jaki komponent na
ktrego kliknicie bdziemy reagowa. Z tego powodu przyklejam na ekranie jeden przycisk.
Pierwszy najprostszy w przygotowaniu i chyba najbardziej przejrzysty, ale te najmniej czytelny i

wymagajcy duo kodu. Tworzymy osobno listener kliknicia (czyli suchacza zdarzenia kliknicia
czeka a klikniesz i reaguje) i podpinamy go do guzika:
84/227
To co si ma wydarzy w wyniku kliknicia jest opisane w metodzie onClickk listenera. W tym

przypadku jest to wywietlenie komunikatu Toast z tekstem om nom nom (linia 23). Samo
podpicie stworzonego listenera odbywa si w linii 27.
Po klikniciu:
85/227
Alternatywnie cho na podobnej zasadzie moemy utworzy obiekt listenera w momencie jego
tworzenia linia 19. Mniej kodu, ale czytelno na tym traci. Efekt dziaania identyczny jak
poprzednio.
Trzecia alternatywna metoda jest chyba najmniej intuicyjna, ale jak si zrozumie zasad dziaania to
kod przy wikszej iloci guzikw do obsugi bdzie najbardziej przejrzysty i bardzo wygodny w
rozwijaniu. Tym razem nie definiuj adnego listenera! Wszystko co ma si zdarzy po klikniciu
przycisku jest opisane w metodzie obslugaKlikniecia. Wazne by metoda ta przyjmowala jako
parametr obiekt klasy View (po tej klasie dziedzicz wszystkie komponenty takie jak guzik i to
wanie pod postaci tego parametru jest przekazywany obiekt komponentu do metody) i nic nie
zwracaa. Pozornie metoda jako taka nie jest w aden sposb zwizana z obsug kliknicia na
przycisk:
86/227
Magia zaczyna dzia si dopiero w pliku layoutu zwizanym z t aktywnoci:
Pojawi nam si tutaj (linia 19) nowy element: android:onClick. Zamiast zwizywa na poziomie
kodu javowego metod obslugaKlikniecia z specjalnie do tego tworzonym listenerem, wskazujemy
nazw metody przy uyciu parametru przycisku w pliku layoutu. Takie rozwizanie ma ten plus, e
pisze si znacznie mniej kodu, a sam kod przy wikszej liczbie obsugiwanych przyciskw jest
czytelniejszy. Z drugiej strony, jeli nie bdziemy pamita o takim rozwizaniu, moemy za jaki
czas zachodzi w gow jak to zostao zrobione :)
Pamitajmy e obsuga kliknicia nie dotyczy tylko przyciskw, ale kadego komponentu
dziedziczcego po View w tym napisy i pola edycyjne.
87/227
Intencje wywoywanie ekranw i akcji w systemie

Intencja to zamiar wykonania jakiej akcji, dziaanie np. wylij SMS, wywietl stron www, zrb
zdjcie,wywietl inny ekran. Intencje mog by rnego typu. W zalenoci od potrzeb tworzymy
intencj danego typu (do zrobienia zdjcia, uruchomienia przegldarki, wywoania jakiejkolwiek
innej akcji) a nastpnie uruchamiamy j. Przy okazji moemy przekaza jakie parametry przez
intencj. Np. z widoku listy wszystkich faktur uruchamiamy ekran z podgldem jednej wybranej.
Musimy wtedy przekaza id faktury do wyswietlenia.
Pierwszy przykad to bdzie zwyke wyswietlenie innego ekranu aplikacji. Zaczynam od stworzenia
zwykego projektu na Androida. Nastpnie dodaj now aktywno klikajc PPM na pakiecie i
wybierajc New-->Other i z okna ktre si pojawi wybieram Android Activity:
88/227
Nadaj nazwy klasie tej aktywnoci oraz plikowi XML w ktrym bdzie opisany Layout.
89/227
Po zatwierdzeniu w projekcie pojawiaj mi si owe dwa pliki:
90/227
A w pliku manifestu nowy wpis:
Na ekranie aktywnoci gwnej przyklejam jeden przycisk:
91/227
Przejdmy teraz do kodu:
Linie 24-31 to podpicie wywoania metody reakcja() pod nacinicie guzika. W samej metodzie
reakcja jest napisane co si ma w takiej sytuacji zadzia. Jak wida tworz nowy obiekt klasy Intent
(linia 14) i w kolejnej linii uruchamiam intencje metod startActivity (dziedziczon po klasie
Activity). Poniewa intencj ktr wywouj jest inna aktywno, musz przekaza jej kontekst,
oraz wskaza klas aktywnoci ktra ma zosta wywoana. Nie zapominamy oczywicie by po
stworzeniu intencji j wywoa :) Druga aktywno ta ktr wywouj to zwyky najprostszy
ekran z napisem Hello World!.
92/227
Zobaczmy dziaanie aplikacji. Aplikacja tu po uruchomieniu wczytuje moj gwn aktywno:
Po klikniciu powyszego przycisku mamy taki widok:
Zostaa wywoana inna aktywno.
93/227
Rozbudujmy nieco nasz aplikacj. Do wywoania innego ekranu dodam teraz przekazanie
zmiennej. Wykorzystuj do tego metod intencji putExtra. Musimy pamita by wywoywa j
przed startActivity(Intent i). W tym przypadku przekazuj tekst : siema jestem zmienn! pod
postaci zmiennej o nazwie zmienna. Tekst ten zostanie przekazany do wanie wywoywanej
aktywnoci i wywietlony na konsoli ( o wyswietlenie tego tekstu zadbam ju na poziomie tej
nowej aktywnoci):
Aby odebra przekazany obiekt, tworz po stronie wywoywanej aktywnoci obiekt klasy Bundle z
ktrego pobieram zbir przekazanych obiektw przy uyciu metody getExtras(). Z wizki tej
musz teraz wybra obiekt ktry mnie interesuje (linia 16). Odebrany tej tekst wywietlam teraz na
konsoli LogCata:
94/227
Efekt po uruchomieniu i klikniciu przycisku:
Przyjrzyjmy si teraz innemu przykadowi aktywnoci. Tym razem bdzie to wywoanie strony
internetowej. Podaj do systemu intencj bdc daniem otwarcia strony internetowej:
Platforma Android sprawdza jaki program odpowiada za obsug takich intencji i przekazuje mu j.
Poniewa chcemy nawiza poczenie z internetem, musimy zadba o dodanie stosownych
uprawnie do pliku manifestu:
95/227
Efekt:
96/227
Otwieranie przegldarki WWW z aplikacji
W tym przykadzie poka w jaki sposb moemy otworzy zewntrzn (domyln) przegldark z
poziomu aplikacji. Zaczynam jak zawsze od najprostszego przykadu. Stworzyem nowy projekt i
przykleiem guzik z napisem Gugiel!. Po naciniciu przycisku powinna zosta uruchomiona
przegldarka z uruchomionym adresem http://google.pl
Przechodzimy teraz do kodu aktywnoci. Linia 18 to podpicie referencji do guzika. Musz to

zrobi by mc sido niego odwoywa. Linie 19-27 to podpicie listenera pod kliknicie guzika
Waciwa akcja dzieje si w linijkach 22-24 i w zasadzie tylko do nich si ogranicza. Adres ktry
ma zosta otwarty bd musia przekaza jako obiekt klasy Uri, tworz wic go w oparciu o adres
http://google.pl. Tu moe by np. strona Twojej firmy, albo link do wyszukiwarki z przekazanymi
przez pasek parametrami. Aby uruchomi przegldark musimy stworzy podajc adres uri i
wywoa now intencj co zawiera si w liniach 23,24.
97/227
98/227
Ekran po uruchomieniu:
Po naciniciu przycisku uruchomia mi si domylna przegldarka z uruchomionym wskazanym

adresem:
99/227
Troszk przerobimy teraz nasz aplikacj. Uytkownik sam wpisze adres strony ktra ma zosta
wywoana. Dodaj do widoku element EditText i zmieniam tekst na guziku:
Musi za tym i maa przerbka w kodzie. Interesuj nas linie 23 i 24. W linii 23 dodaem uchwyt
do okienka edycyjnego. W linii 24 konkatenuj adres url na podstawie pocztku http:// (bo o tym
pewnie kady uytkownik zapomni, a bez tego nie zadziaa) oraz tekstu wpisanego w oknie
edycyjnym. Pozostaa cz programu pozostaje bez zmian.
100/227
Uruchomiem program i wpisaem adres strony internetowej:
Po uruchomieniu:
101/227
Jeszcze jedna ciekawostka, aczkolwiek bardziej w charakterze bajeru. Jeli odnajdziemy w pliku
okrelajcym layout element odpowiedzialny za nasz EditText i dopiszemy
android:inputType=textUri, to po klikniciu na okienko do wprowadzania tekstu wyskoczy nam
klawiatura ze specjalnymi guzikami do wprowadzania adresw URL np. www :)
Tych inputType'w jest znacznie wicej rodzajw, midzy innymi do wprowadzania adresw email,
liczb etc .
102/227
Poczmy to wszystko! Podsumowanie podstaw.

W tej lekcji zajmiemy si wywoywaniem nowych aktywnoci (czyli przechodzeniem pomidzy
ekranami), a take elementami Button, EditText oraz TextView. Stworzymy przy okazji prosty
program do obliczania pl figur geometrycznych.
Zaczynamy od stworzenia projektu. Z menu wybieramy Android Application Project:
103/227
Dalej nadajemy naszej aplikacji nazw:
104/227
Przy tworzeniu projektu, tworzymy rwnie od razu pierwsz aktywno. Bdzie to po prostu
pierwszy ekran jaki si pojawi po uruchomieniu aplikacji. Decydujemy o jego pokroju zostawiamy domylne Blank Activity:
105/227
Podajemy nazw klasy bdcej pierwsz aktywnoci (ekranem) w polu Activity Name. Do
naszej klasy bdzie te potrzebny plik XML w ktrym to okrelimy jak maj by rozmieszczone
elementy w danej aktywnoci (guziki, okienka etc). Nazw tego pliku okrelamy w polu Layout
Name:
106/227
Gdy projekt zostanie utworzony, zostanie otwarta klasa gwnej aktywnoci. Bdzie zawiera dwie
metody. Pierwsza onCreate to metoda ktra jest uruchamiana w momencie startu aktywnoci.
Druga onCreateOptionsMenu to metoda uruchamiana kiedy kto wybierze przycisk menu. T
drug usuwamy, nie jest nam na razie potrzebna.
Nasza klasa powinna wyglda teraz mniej wicej tak:
107/227
Zadbamy teraz o wygld pierwszego ekranu. Przechodzimy do pliku layoutu. Powinnimy

zobaczy taki ekran. Po prawej mamy nasz aktywno, po lewej palet komponentw. Gdyby
zamiast aktywnoci widoczny by kod XML, wybierz z zakadek na dole Graphical Layout:
108/227
Zawczasu przygotowaem sobie kilka obrazkw ktre bd mi potrzebne w aplikacji (narysowaem

w Paincie :p ). Bdziemy ich uywa w naszej aplikacji. Zrobimy sobie list figur pojawiajc si
na Dzie dobry wraz z obrazkami. Po klikniciu na nazw figury program przejdzie do
formularza sucego obliczaniu pola danej figury.
Musz je teraz umieci w projecie. Zaznaczam je w katalogu, robi CTRL+C, w projekcie

wchodz w podkatalog res, nastpnie drawable-hdpi (lub inny drawable-....) i robi CRTL+V:
109/227
Przechodz teraz do edycji pliku XML okrelajcego layout naszej gwnej aktywnoci. Bdziemy
edytowa rcznie, wic tym razem nie wybieramy Graphical Layout a activity_main.xml (lub
jak tam nazwae swj plik :) ).
Bdzie tam ju troch tekstu, ale nie jest nam potrzebny wic go w caoci kasujemy. Teraz
doprowadzamy zawarto pliku do takiej mniej wicej formy:
Table Layout to tabelaryczny ukad elementw na ekranie aktywnoci , co jak w HTML. Kolejne
TableRow to po prostu kolejne wiersze w tabeli. Elementy zawarte w elemencie TableRow
bd ze sob ssiadowa w ramach danego poziomu w tabeli. Mamy tutaj dwa elementy:
ImageView, oraz TextView. Pierwszy suy do wywietlania obrazkw, drugi do wywietlania (ale
nie wprowadzania) tekstu. W obu mamy parametr android:id. Nadajemy nim unikaln nazw
elementowi w ramach danej aktywnoci. Warto tego parametru musi si zaczyna od @+id/ po
ktrych nastpuje nasz identyfikator. Ten identyfikator jest niezbdny do rozrniania elementw i
jednoznacznego wskazywania jednego z nich. W obu te wystpuj parametry layout_width i
layout_height. Okrelaj one szeroko i wysoko elementu. Jednostka DP to piksele niezalene
od rozdzielczoci ekranu.
110/227
W elemencie ImageView jest jeszcze parametr android:src. Poprzez niego podajemy jaki obrazek
ma zosta wywietlony. Jeli chodzi o obrazek zawarty w projecie (a nie znajdujcy si np. na
zdalnym serwerze czy karcie pamici) to zaczynamy warto od @drawable/ po ktrym nastpuje
nazwa obrazka wrzuconego w jednym z poprzednich krokw do katalogu drawable-hdpi. Nie
podajemy rozszerzenia (tutaj .png) w nazwie pliku.
W elemencie TextView mamy dodatkowo element android:text przy uyciu ktrego ustawiamy
tekst jaki ma by wywietlany na elemencie. Zwizany z nim jest jeszcze element
android:textSize, ktry okrela wielko czcionki. Uyem tutaj te parametrw
android:layout_marginLeft, oraz android:layout_marginTop. Okrelaj one margines lewy ,
oraz grny.
Wracamy do widoku projektowania graficznego. Nasza aplikacja powinna w tej chwili wyglda
mniej wicej tak:
111/227
Dodaem analogicznie kolejne wiersze tabeli z kolejnymi elementami. Zmieniem te wielko

czcionki na 20dp poniewa niektre opisy nie mieciy si w jednej linii:
112/227
Po tym zabiegu program wyglda tak:
113/227
Przysza pora na dodanie nowej aktywnoci tj. ekranu na ktry aplikacja powinna przej po
klikniciu na napis pole kwadratu. Klikam prawym przyciskiem myszy na pakiecie w ktrym
znajduje si moja pierwsza aktywno i wybieram NEW--> OTHER:
Dalej Android Activity:
114/227
Podobnie jak i wczeniej nadaje klasie aktywnoci i plikowi layoutu nazwy:
Klasa nowej aktywnoci:
Zauwa e w metodzie onCreate jest wywoanie metody setContentView, ktra suy do wizania
115/227
aktywnoci z opisem wygldu zawartym w pliku XML. Kada aktywno domylnie bdzie miaa
swj plik xml i po stworzeniu bdzie wywoanie jej wasnego pliku, ale moesz do zmieni
wskazujc w parametrze inny layout. Tutaj mamy R.layout.activity_pole_kwadratu, poniewa taki
wanie plik zosta utworzony podczas generowania nowej aktywnoci:
Domylnie zawarto tego pliku wyglda tak:
116/227
Na ten moment ta aktywno bdzie po prostu wywietlaa napis Hello World!. My w tej
aktywnoci dodamy par elementw, bdzie to formularz do obliczania pola kwadratu.
Przechodzimy do graficznej formy edycji layoutu:
Napis ktry ju tam si znajduje nieco zmodyfikujemy. Klikamy na prawym przyciskiem myszy i
wybieramy Edit Text:
117/227
Wczeniej tekst wpisywalimy niejako bezporednio, teraz przyjmiemy nieco inn konwencj. W
projekcie obecny jest plik strings.xml:
Znajduj si w nim identyfikatory, oraz przypisane do nich teksty. Chcc wywietli jaki tekst na
elemencie, bdziemy si odwoywa poprzez identyfikator do tekstu zawartego w tym pliku.
Po co nam to wszystko? Dziki temu mamy wszystkie informacje tektstowe w jednym miejscu,
duo atwiej jest je dziki temu zmienia. Ponadto znacznie atwiej bdzie pniej robi rne
wersje jzykowe naszego programu, bo wystarczy potem tylko podmieni ten jeden plik.
\
118/227
Ustawimy teraz napis na TextView, jednoczenie dodajc go do pliku strings.xml:
Wybieramy edycj i przechodzimy do takiego ekranu:
119/227
Klikamy przycisk New String. Powinnimy teraz zobaczy taki ekran:
120/227
W polu String wpisujemy tekst ktry ma zosta dodany do pliku strings.xml. Oraz wywietlony
na komponencie. W polu New R.string podajemy identyfikator tekstu, pod ktry zostanie
wpisany tekst do pliku.
Zatwierdzamy. Zobaczymy taki ekran:
121/227
Pojawi si nowy wpis w pliku strings.xml, a napis na komponencie si zmieni:
Dobrze. Mamy teraz ekran pocztkowy z list elementw do wyboru, oraz zalek nowego ekranu
ktry docelowo bdzie suy obliczaniu pola kwadratu. Trzeba teraz te elementy poczy. Po
klikniciu napisu pole kwadratu na naszej aplikacji powinna pojawi si aktywno do obliczania
pola kwadratu. Przyszed czas na dodanie reakcji na kliknicie napisu.
122/227
Zmieniem nieco zawarto klasy mojej gwnej aktywnoci. Dodaem zmienn t1 ktra bdzie
reprezentowaa komponent TextView z napisem Pole kwadratu. W linii 19 do tej zmiennej
przypinam realny komponent. Robi to przy uyciu wbudowanej metody findViewById. Ma j
kada klasa dziedziczca po Activity. Ta metoda suy do zwracania referencji komponentu z
aktywnoci. Do zmiennej t1 zostaje przypisany element o identyfikatorze textView1 (czyli nasz
napis pole kwadratu z ekranu gwnego:
Obsug zdarzenia kliknicia realizujemy poprzez podstawienie listenera dla obiektu t1. Listener to
taki proces nasuchu ktry czeka na jakie zdarzenie. Tworzymy nasz listener jako obiekt klasy
OnClickListener i jednoczenie defuniujemy dla niego reakcj na kliknicie (metoda onClick).
Tymczasowo reakcja na kliknicie komponentu ma polega na zmianie napisu Pole kwadratu na
napis AA!!!!. Stworzony listener ustawiamy dla obiektu t1 poprzez metod tego obiektu
setOnClickListener.
123/227
Uruchamiam projekt i sprawdzam dziaanie. Reakcja na kliknicie jest taka jaka by powinna. Nasz
program jest nadwraliw beks :)
Skoro ju dziaa obsuga kliknicia, to teraz jako reakcj wepniemy uruchomienie innej aktywnoci
w miejsce zmiany tekstu.
124/227
Wykomentowaem zmian tekstu. Dodaem obiekt klasy Context do ktrego w linii 28 przypisuj
kontekst aplikacji. W linii 29 tworz now intencj. Intencje to komunikaty czce ze sob rne
komponenty.W tym przypadku nasza intencja bdzie suya wywoaniu innej aktywnoci. W tej
samej linii podaj te informacj, aktywno jakiej klasy ma zosta wywoana. W linii 30 odpalam
t aktywno.
125/227
Sprawdzam dziaanie caoci. Tym razem po klikniciu napisu Pole kwadratu nie zmienia si
tekst na komponencie, a zostaje wywietlony ten ekran:
Skoro wywoania dziaaj, trzeba przerobi t aktywno tak, aby faktycznie suya obliczaniu pola
kwadratu. Przechodz wic do pliku layoutu tej aktywnoci:
126/227
by nastpnie w trybie projektowania graficznego poprzykleja do niej niezbdne komponenty.
127/227
Pojawiy si tu nowe rzeczy. Komponent klasy Button, komponent klasy LargeText, oraz
komponent klasy EditText. Button to po prostu przycisk. LargeText to element wywietlajcy tekst,
ale o powikszonej czcionce. EditText to komponent w ktrym moemy wywietli jaki tekst, ale
uytkownik programu bdzie mg go zmieni.
128/227
Po rozmieszczeniu elementw przechodzimy do edycji klasy aktywnoci :
W analogiczny sposb jak dla kliknicia napisu Pole kwadratu oprogramowaem tutaj kliknicie
przycisku z napisem Oblicz. Zdefiniowaem w liniach 14-16 obiekty ktre bd reprezentowa
uywane przeze mnie komponenty. W liniach 23-25 przypisuj do tych obiektw referencje do
komponentw. W liniach 27-36 mam oprogramowan reakcj na kliknicie przycisku. Dziaa to
analogicznie jak wczeniejszy przykad. Z nowoci jest tutaj tylko rodzaj reakcji. W liniach 31-33
jest opisane co dokadnie ma si zdarzy. Generalnie ustawiam tekst na komponencie wynik (to ten
komponent klasy LargeText ktry ma domylnie ustawione trzy mylniki. Ustawiany tekst to
kwadrat wartoci podanej poprzez obiekt bok czyli obiekt klasy EditText, do ktrego uytkownik
wprowadzi dugo boku kwadratu. Po drodze pojawiaj si te rzutowania z tekstu na liczb i
odwrotnie :)
129/227
Program po uruchomieniu:
130/227
Po wprowadzeniu dugoci boku i klikniciu przycisku Oblicz mamy taki efekt:
Jako wiczenie pozwalajce naby nieco praktyki i oswoi si z now technologi, proponuj
dokoczy opisywany w tym rozdziale projekt.
131/227
Wielowtkowo w Androidzie
Wykorzystanie klas Thread i AsyncTask
Jak bardzo potrafi irytowa zawieszanie si aplikacji wie kady z nas. Teraz wyobra sobie, e
Twoja aplikacja na Androida ma do wykonania jakie czasochonne czynnoci, wystarczy e bdzie
musiaa pobra jakie dane czy obraz z internetu. Jeli zrobisz to w ramach gwnej wtku
programu, UI przestanie odpowiada, a uytkownik Twojego programu bdzie yczy Ci wanie
tego, czego zapewne Ty yczysz czasem programistom Internet Explorera :) Aby si o tym
przekona, wystarczy przyklei na ekranie przycisk, a jako jego reakcj oprogramowa zdarzenie
oczekiwania. Przyklej guzik:
a jako obsug jego nacinicia wpisz taki kod:
132/227
W zasadzie interesuj nas tylko linie 24-32. Reszta to otoczka. Jak widzimy, w chwili nacinicia
przycisku wywoywana jest instrukcja Thread.sleep(10000). To sprawi e aplikacja zaczeka 10
sekund. Sprbuj to uruchomi na dowolnym urzdzeniu i np. wywoa menu pogramu (tym
dedykowanym guzikiem do menu). Zobaczysz e nic si nie stanie, aplikacja po prostu si
zawiesia.
Trzeba wic wydzieli osobny wtek i puci go w tle do realizowania czasochonnych zada.
Mona zrobi to tradycyjnie po javowemu:
Moesz uruchomi tak przerobiony program, a przekonasz si e wtek dziaajcy w tle nie blokuje
innych elementw interfejsu. Jest oczywicie pewne ale. Jeli sprbujesz sign z poziomu
kodu do jakichkolwiek komponentw wizualnych z poziomu takiego wtku, dostaniesz taki
wyjtek:
133/227
Myl e komunikat tego wyjtku jest zrozumiay.

Na potrzeby Androida powsta zupenie osobny mechanizm wielowtkowoci. Wykorzystamy tutaj
klas AsyncTask ktra jak sama nazwa wskazuje, suy do wykonywania zada asynchronicznie.
Wykorzystamy te jeden ciekawy gadet ProgressBar. Jest dostpny na palecie Form Widgets.
Chcemy eby uytownik widzia, e program co wykonuje, a nie po prostu zwis. Taki ProgressBar
domylnie jest widoczny i wykonuje si animacja. My zrobimy tak, eby na poczku nie by
widoczny, pokaemy go gdy pucimy wtek i schowamy gdy go zakoczymy.
134/227
Wykorzystanie wczeniej wspomnianej klast AsyncTask polega na stworzeniu klasy ktra po niej
dziedziczy i zaimplementowaniu paru metod. Do klasy naszej aktywnoci dodaj wewntrzn klas
OsobnyWtek dziedziczc po AsyncTask. Nic nie stoi na przeszkodzie by bya to w ogle osobna
klasa. Pojawio si tutaj te co nowego element <Void,Void,Void> oraz dziwna parametryzacja
metod doInBackground i onPostExecute. Zwizane jest to z pojciem klas generycznych, oglnych.
Tym zagadnieniem nie bdziemy si tutaj zajmowa, nie jest zwizane bezporednio z tematem
wielowtkowoci w Androidzie. Obiekty klasy OsobnyWatek bd stanowiy osobne wtki w
ramach aplikacji. Zauwa e mamy tutaj trzy metody przesaniajce takie metody z klasy po ktrej
dziedziczymy. Metoda onPreExecute jest automatycznie wywoywana przy starcie wtku.
Wywietlam tutaj nasz ProgressBar. Kko staje si widoczne i zaczyna pracowa. Daj te
komunikat na konsol. W tej metodzie, oraz w metodzie onPostExecute moemy bez obaw
odwoywa si do komponentw graficznych w naszej aktywnoci. Nie robimy tego za to w
metodzie doInBackground. To co ma si dzia w ramach wtku te dugotrwae czynnoci piszemy
wanie w metodzie doInBackground. Tutaj wyrzucam na konsol informacj, oraz wstawiam 10
sekundowe oczekiwanie. Metoda onPostExecute jest wywoywana automatycznie w chwili
zakoczenia wtku. Wywietlam tutaj informacj o zakoczeniu i chowam ProgressBar.
135/227
Zobaczmy teraz co si dzieje w metodzie onCreate:
W linii 55 na pocztek chowam ProgressBar. Bdzie on wywietlany tylko w trakcie dziaania

wtku w tle. Jako reakcj na nacinicie przycisku uruchamiam nasz wtek (linia 60).
Program po uruchomieniu i klikniciu przycisku wyglda tak:
136/227
Zawarto konsoli LogCata po zakoczeniu caego procesu:
137/227
Utrwalanie i przechowywanie danych

Wykorzystanie bazy danych SQLite w Androidzie
Android zapewnia wbudowan obsug baz SQLite. Nie potrzebujemy adnych dodatkowych
bibliotek, wszystko co niezbdne jest dla Androida natywne. SQLite jest atw w obsudze lekk
baz danych i wykorzystywana jest nie tylko w systemie Android. Rwnie w zwykej Javie czy
JEE moemy t baz wykorzysta. Jest jednak kilka rnic w obsudze. Po pierwsze w zwykej
Javie/JEE potrzebujemy dodawa biblioteki SQLite, po drugie z sam baz czymy si z uyciem
JDBC czy jakiego ORMa np. Hibernate. Tutaj caa baza zawiera si w jednym pliku ktry na
dodatek jest generowany automatycznie :)
W niniejszym przykadzie stworzymy prost baz kontaktw. W pierwszej kolejnoci musz
stworzy klas dziedziczc po SQLiteOpenHelper i przesoni metody onCreate i onUpgrade, oraz
stworzy konstruktor sparametryzowany. Klasa ta bdzie suya do tworznia bazy danych i
niezbdnych tabel.
138/227
Konstruktor jako taki przyjmuje tylko jeden parametr kontekst, ktry zreszt przekazuje nastpnie
do konstruktora klasy po ktrej dziedziczy. Kontakty.db to nazwa pliku bazy danych ktry
zostanie utworzony. Jedynka w konstruktorze to wersja bazy danych. Moemy t warto
zwiksza przy kolejnych zmianach w strukturze bazy.
Podczas pierwszego skorzystania z obiektu naszej klasy ZarzadcaBazy, SQLiteOpenHelper
zauway brak pliku bazy (tutaj kontakty.db) i go utworzy a nastpnie wywoa metod onCreate. W
mojej metodzie onCreate, posugujc si metod execSQL obiektu klasy SQLiteDatabase tworz
tabel w ktrej bd przechowywa dane. Nic nadzwyczajnego zwyky SQL. Metoda onUpgrade
zostanie wywoana jeli bdziemy si odnosi do przestarzaej wersji bazy danych (silnik bazy
bdzie to wiedzia na podstawie numeru wersji ktr podajemy jako parametr konstruktora).
Moemy tutaj np. zaimplementowa wywoanie jakich polece rozbudowujcych czy
zmieniajcych struktury bazy.
Teraz dodamy funkcjonalno odpowiedzialn za dodawanie, modyfikowanie, kasowanie i

wywietlanie danych. Na razie jest bardzo ubogo :) Kolejne dwie metody rwnie dodaj do klasy
ZarzdcaBazy. Oczywicie schemat ten jest bardzo uprowadzony, raczej powinnimy stosowa
oddzielne klasy DAO do zada tego typu. Taka uproszczona forma uatwi zrozumienie samej
zasady dziaania, potem kady moe sobie to przerobi wg wasnego uznania. Dodaem metod
dodajKontakt ktra bdzie suya do dodawania nowych kontaktw. Metoda ta przyjmuje 3
parametry ktre stanow dane dodawane pniej do tabeli tj imi, nazwisko, telefon.
W linii 34 uzyskuj uchwyt do bazy. Korzystam tutaj z metody getWritableDatabase, poniewa
bd wprowadza zmiany w bazie. W sytuacji gdybym chcia jedynie odczytywa dane,
wywoabym metod getReadableDatabase. Linie 36-38 su podstawieniu wartoci do
poszczeglnych kolumn. Pierwszy parametr metody put to nazwa kolumny do ktrej wstawiamy
dane, drugi to warto ktra ma do niej trafi. Nie musz uzupenia wszystkich. Swoj drog
przykadowo kolumny nr nie uzupeniam wcale. To jest kolumna typu autoincrement, a wic
wartoci w niej bd generowane automagicznie. W linii 16 wywouj metod insertOrThrow ktrej
przekazuj jako parametry nazw tabeli do ktrej wstawiane s dane, oraz list wartoci klasy
ContentValues ktr uzupeniaem wczeniej. Metoda ta suy do wstawienia wiersza do tabeli.
139/227
W razie problemw wyrzuci wyjtek typu SQLExcepion, ale moemy go wyapa obejmujc to
wywoanie blokiem try catch.
Do klasy ZarzadcaBazy dodalem tez metod dajWszystkie. Sluzy ona pobieraniu danych z bazy.
W linii 43 zdeklarowaem kolumny jakie chc odczyta, oraz ich kolejno. Nie musz odczytywa
wszystkich kolumn, ani te nie musz wyciga ich w takiej kolejnoci w jakiej s w tabeli. W linii
44 pobieram uchwyt do bazy. Tym razem wywouj jednak metod getReadableDatabase, poniewa
nie bd w bazie nic modyfikowa, a jedynie czyta. Zasadniczo pobranie danych jest realizowane
metod query w linii 45. Podaj tutaj nazw tabeli z ktrej bd czyta dane, oraz jako parametr
list kolumn ktre bd pobiera. Pozostae parametry (ktre s tutaj nullami) su do stsowania
warunkw WHERE, Having, grupowania, sortowania etc.
Przyszed czas na dorobienie warstwy prezentacji. Przyklejam wic na swojej gwnej aktywnoci
komponent klasy TextView:
W ramach tego przykadu, do tabeli telefony dodam z uyciem dotychczas stworzonych funkcji 3
nowe kontakty, a nastpnie je wywietl.
140/227
W metodzie onCreate aktywnoci gwnej zasadniczy najwaniejszy dla nas element mieci si w
liniach 18-28. Linia 18 to stworzenie obiektu zarzdcy bazy danych a wic tej klasy ktra jest
odpowiedzialna za czenie si z baz i operacje na niej. Konstruktor tej klasy wymaga podania
konktekstu. Tutaj jako kontekt wskazuj this, a wic biec aktywno. Z uyciem metody
dodajKontakt zawartej w owej klasie, dodaj trzy nowe kontakty. W dalszej kolejnoci chc je
pobra z bazy i wywietli na ekranie. Korzystam z metody dajWszystkie, ktra jednak zwraca
obiekt klasy Cursor. Przetwarzanie takiego kursora nie jest najwygodniejsze wic za chwil
zajmiemy si przerobieniem wszystkiego w taki sposb by metoda dajWszystkie zwracaa list
obiektw np. klasy Kontakt. Krok po kroku. Na razie mamy spartaskie warunki.
W ptli while (linia 23) widzimy metod moveToNext(), wykorzystanie tej metody pozwala nam na
przesuwanie si po wyniku zapytania po linii w d tak dugo jak dugo s jeszcze jakie dane do
przeczytania. W liniach 24-27 do definiowanych w ptli zmiennych przypisuj zawarto kolumn z
kolejnych wierszy wg pozycji tej kolumny od lewej std wywoania typu getInt(0), getString(3)
chodzi o numer kolumny od lewej strony wg kolejnoci jak wymienilimy w metodzie
dajWszystkie klasy ZarzadcaBazy. Zauwa e posuguj si te rnymi metodami w zalenoci od
spodziewanego typu danych zwracanych z zapytania mam na myli metody getString i getInt.
Pilnuj tego, poniewa jeli sprbujesz zrobi getInt lub np. getLong a w wyniku dostaniesz cig
tekstowy , program wyrzuci wyjtek. W linii 28 zwyczajnie konkatenuj uzyskane informacje i
wywietlam je w kompononecie klasy TextView ktry przykleiem tam przed momentem. Aby nie
posklejao mi si to w jeden dugi pozawijany cig przed kadym kolejnym kontaktem doklejam
\n czyli znak nowej linii.
141/227
Efekt :
142/227
Poka teraz ciekaw waciwo na bazie pewnego przykadu. Zawarto tej bazy danych bdzie
trwaa pomidzy kolejnymi uruchomieniami programu. Jeli wic teraz uruchomi jeszcze raz ten
program, a co za tym idzie po raz kolejny dodam trzy te same nowe kontakty, powinienem teraz
zobaczy zdublowane rekordy. Jedyne co powinno je odrnia to identyfikatory rekordw tj.
zawarto kolumny nr bdcej kluczem gwnym tabeli telefony a majcej wasno
autoincrement. Dokonuj wic drobnej kosmetycznej zmiany w kodzie:
W linii 28 dodaj jedynie wywietlanie kolumny nr adnych innych zmian nie nanosz. Efekt jest
wic taki jak przewidywalimy:
Aby program by w jakikolwiek sposb uyteczny, oraz aby kod by przejrzysty, trzeba bdzie
dokona kilku kolejnych zmian:
Pozby si tego paskudnego TextView na samym pocztku listy.
Doda moliwo kasowania kontaktw
Doda moliwo aktualizowania kontaktw
Stworzy klas Kontakt i posugiwa si obiektami tej klasy a nie list elementw typu
String.
Dorobi metody pozwalajce wyciga dane kontakty wg wskazanych kryteriw (np.

numeru identyfikacyjnego, numeru telefonu czy nazwiska).
Doda jakie okienka umoliwiajce wygodne dodawanianie, akatualizacj i kasowanie

kontaktw przez uytkownika.
Odseparowa kod odpowiedzialny za odczyt, zapis, aktualizacj i kasowanie kontaktw do

osobnej klasy.
143/227
Rozwizanie problemu nr 1. sprowadza si tylko do wyczyszczenia wywietlanego w komponencie

klasy TextView tekstu przed jego uzupenianiem w ptli. Widzimy to w linii nr 22
:
Przy okazji widzimy e nasze 3 kontakty zostay dodane po raz kolejny ;) Z tym te musimy co
zrobi. In plus e mamy rne numery identyfikacyjne.
144/227
Dodam wic prost metod suc do kasowania zbdnych rekordw.
Oczywicie baz podpinamy w trybie do zapisu, co widzimy w linii 50. W linii 51 definiuj list
elementw argumentw dla warunkw where. Musi to by lista argumentw klasy String. Myl e
najlepiej bdzie to wyjani na przykadzie. Przyjrzyjmy si linii 52. Pierwszy warunek to nazwa
tabeli z ktrej chcemy kasowa wiersze. Drugi to warunki ktre maj trafi po klauzuli where.
Samego where ju tutaj nie wymieniamy. Zamiast wartoci liczbowych czy tekstowych ktre
miayby si pojawi w warunkach, stawiamy znak zapytania. Gdybymy mili wicej ni jeden
parametr, to ten cig tekstowy mgby wyglda np. tak: department_id=? and manager_id=? and
salary>?. System oczekiwaby w takiej sytuacji podania mu trzech wartoci ktre trafi pod nasze
znaki zapytania. List tyche wanie wartoci podaj w postaci kolekcji String zdefiniowanej w
linii 51 poprzez trzeci parametr metody delete. W moim przypadku lista skada si z caego
jednego elementu ktry na dodatek w sposb mao elegancki, aczkolwiek popularny rzutuj na typ
String. Czyli podsumowujc:
Argument nr 1 to nazwa tabeli z ktrej kasujemy
Argument 2 to warunki dla klauzuli where
Argument 3 to lista wartoci ktre maj trafi do parametrw warunkw where okrelonych jako
argument nr 2 metody delete :)
Przetestujmy teraz dziaanie naszej nowej metody.
145/227
Troszk przerobiem kod naszej gwnej aktywnoci. Linie od 19 do 21 odpowiedzialne za

dodawanie nwych wierszy po prostu wykomentowaem, za to 2 liniach 25-27 dodaem kasowanie
wszystkich kontaktw o identyfikatorach od 4 do 9. Wywietlanie kontaktw pozostao takie jakie
byo na pocztku. Aktualny stan :
Przydaaby si teraz metoda pozwalajca na modyfikowanie wpisw w bazie.
146/227
Troszk przemieciem metody w klasie ZarzadcaBazy, poniewa nowo dodana metoda

aktualizujKontakt ma par elementw wsplnych z wczeniej napisanymi metodami
kasujKontakt i dodajKontakt. W linii 49 okreliem jakie parametry przyjmuje metoda.
Pierwszy to identyfikator wiersza (unikalny numer z kolumny nr) wg ktrego bd wybiera wiersz
do aktualizacji. Pozostae to wartoci do aktualizacji. Przyjem e nie bd rozgranicza aktualizji
poszczeglnych kolumn , robi osobnych metod ani skomplikowanych blokw warunkowych eby
aktualizowa tylko te faktycznie zmienione kolumny. Po najmniejszej linii oporu. Zakadam e po
prostu zczytam wiersz, zmieni jedno czy wicej pl i przeka do tej metody tak by zaktualizowaa
wszystkie kolumny, niezalenie od tego czy faktycznie co si w nich zmienio czy nie.
Podobnie jak dziao si to przy dodawaniu nowego wiersza, tak i tutaj w liniach 51-54 podaj list
wartoci ktre maj trafi do poszczeglnych kolumn. S to wartoci ktre ulegaj zmianie te
ktre podaj przez parametry metody. Tak jak i wczeniej metoda put przyjmuje jako argumenty
nazw kolumny w ktrej aktualizujemy warto, oraz warto dla tej kolumny. Podobnie jak w
przypadku metody kasujKontakt, tak i tutaj w linii 55 wartoci ktre zostan podane jako
argumenty warunku where. W linii 56 to ju wywoanie metody update ktra przyjmje jako
parametry kolejno: nazw aktualizowanej tabeli,zaktualizowane wartoci kolumn, warunek where,
warto lub wartoci ktre maj trafi do warunku where w miejsce znakw zapytania.
147/227
Przerabiam teraz gwn aktywno tak, aby przed wywietleniem wywoa metod aktualizujc i
zmieni numer telefonu Dziadka Mroza:
Efekt:
148/227
Oczywicie programistyczni puryci podnios zarzut, e jakto tak z palca podawa wszystkie
wartoci wcznei z tymi nie zmienianymi, e te dane powinny by pobrane z bazy , zwrcone
przez jak metod w postaci obiektu, a nastpnie po zmianie wartoci wybranego pola przekazane
jako obiekt do metody aktualizujcej w bazie. I jak najbardziej bd mili racj :) Z tym, e aby to
osign potrzebujemy najpierw przerobi to na troszk bardziej obiektow form, oraz stworzy
metod zwracajc wybrany wiersz wg identyfikatora :). Zacznijmy wic od zdefiniowania klasy
ktra bdzie reprezentowa pojedynczy wiersz. Staraem si tak definiowa eby pola w klasie
odpowiaday nazwom kolumn w tabeli:
Jest taka dobra praktyka programistyczna, by pola w klasach typu POJO nie byy publiczne, a
prywatne, natomiast dostp do nich uzyskiwa poprzez tak zwane gettery i settery. Dziki temu
mamy wiksz kontrol nad zawartoci tych pl. W rodowisku Eclipse jest nawet specjalna
funkcja do automatycznego generowania tego typu metod. Wybieramy z menu dostpnego pod
prawym przyciskiem myszki:
149/227
Gdy pojawi si okno, zaznaczamy wszystkie opcje:
i klikamy dostpny na dole przycisk OK.
150/227
W tej chwili nasza klasa powinna wyglda mniej wicej tak:
Stworz teraz w naszym ZarzadcyBazy metod odpowiedzialn za pobieranie z bazy i oddawanie

wiersza w postaci obiektu nowo stworzonej klasy Kontakt. Dodaj do klasy ZarzadcaBazy metod
dajKontakt. W linii 67 tworz na razie pusty obiekt klasy kontakt, ktry po uzupenieniu zostanie z
metody zwrcony. W linii 68, tak jak i w kadym dotychczasowym przypadku podpinam zaczep do
bazy. W linii 69 definiuj kolumny ktre bd czyta. Widzimy e analogiczny fragment pojawia
si po raz kolejny, trzeba wic bdzie go odseparowa w przyszoci. Linia 70 to tak jak i wczeniej
podstawienie wartoci ktra trafi pod znak ? w warunku where. Linia 71 to zasadnicze wykonanie
zapytania. Argumenty odpowiedzialne za grupowanie, warunek having, sortowanie i limitowanie
iloci zwracanych wierszy (wg wymienionej kolejnoci) pozostawiam nullowe, poniewa adnej z
tych operacji nie bd wykonywa. Jeli w wyniku zapytania zostanie zwrcony przynajmniej jeden
wiersz (co sprawdzam w linii 72), przechodz do czytania danych z pl wiersza i uzupeniania
obiektu. W linii 73 przechodz do pierwszego (i w tym przypadku jedynego) wiersza.
151/227
Linie 74-77 to znane ju z wczeniejszych przypadkw czytanie danych, tym razem jednak nie
przypisuj ich do zmiennych, a przy uyciu setterw uzupeniam obiekt klasy kontakt. W linii 79
uzupeniony ju (miejmy nadziej moglimy przecie poszukiwa kontaktu po numerze ktry w
tabeli nie wystpuje) obiekt klasy kontakt zwracam z metody. Caa metoda:
Aby przetestowa now metod przerabiam ponownie gwn aktywno:
Efekt:
Przerobi teraz pozostae metody z klasy ZarzadcaBazy, tak by cao bya jako tako obiektowa :)
152/227
Zaczem od zmiany metody dodajKontakt. Zamiast przyjmowa wartoci pojedynczych pl jako

osobne argumenty metody, przekazuj po prostu jeden obiekt klasy Kontakt, ktry zostaje dodany
do bazy. Jeszcze jedna drobna rnica jest widaczna w liniach 36-39. Zamiast korzysta z osobnych
zmiennych reprezentujcych wartoci do poszczeglnych pl, po prostu wydobywam niezbdne
dane z obiektu, z uyciem zdefiniowanych w klasie Kontakt getterw.
W podobny sposb przerobiem metod aktualizujc wiersze:
Bardzo nie podoba mi si rwnie dotychczasowe rozwizanie pobierania wszystkich kontaktw:
Metoda zwraca obiekt klasy Cursor, ktrego przetwarzanie nie naley do najwygodniejszych. T
metod przerobi te tak, by zwracaa list (klasy LinkedList) obiektw.
153/227
Po paru poprawkach metoda dajWszystkie dziaa tak jak sobie tego yczylimy. Sposb pobierania
danych jest taki sam, jedynie dodaem w liniach 67-73 przetwarzanie kursora i adowanie danych
do przygotowanej wczeniej (w linii 63) listy kontaktw.
Przetwarzanie takiej listy jest pniej duo wygodniejsze. Poniej wykorzystanie nowej wersji
metody dajWszystkie w gwnej aktywnoci:
154/227
Przy okazji pojawia si nam tutaj nowa metoda: d klasy Log. Wywouje si j w taki sposb:
Log.d(tag,text); a efekt wyglda tak:
Sprawdza si to zwaszcza w zastpstwie System.out.println ktrego moe nieco brakowa

programistom Javy ;)
Taki jeszcze drobny, acz istotny element. W tych przykadach tego nie wykorzystamy, ale moe
nastpi konieczno pogrupowania, zastosowania klauzuli having, sortowania, czy limitowania
iloci wierszy w zapytaniu. Trzeba odpowiednio poda parametry w wywoaniu metody query.
Najlepiej bdzie pokaza na przykadzie. Gdybym zechcia np. odebra wynik takiego zapytania:
SELECT AVG(SALARY) , DEPARTMENT_ID FROM EMPLOYEES GROUP BY
DEPARTMENT_ID ORDER BY DEPARTMENT_ID DESC;
To wywoanie metody query musiaoby wyglda tak:
SQLiteDatabase db = getReadableDatabase();
String[] kolumny={"avg(salary) as srednia","department_id"};
Cursor kursor =
db.query("telefony",kolumny,null,null,department_id,null,
department_id desc);
Parametry wg kolejnoci :
1. Nazwa tabeli z ktrej czytamy
2. Kolumny ktre czytamy
3. Warunki where
4. Wartoci do warunkw where
5. Kolumna/kolumny po ktrych grupuj
6. Warunek do klauzuli having
7. Sposb sortowania
155/227
Tutaj ju kady moe uzna czy chce tak posta wykorzystywa czy nie. Moim zdaniem to rednio
wygodne i mao intuicyjne. Poza tym, co jeli chciabym stosowa zczenia midzy tabelami,
podzapytania etc? Zamiast takiej nieco abstrakcyjnej formy wywoywania zapyta z uyciem
metody query, moemy wykorzysta metod rawQuery. Do naszego zarzdcy bazy dopisaem
metod wycigajc kontakty o nazwisku ktre przekazuj jako parametr.
W przypadku metody rawQuery, nie uywamy adnych dodatkowych parametrw do okrelania

grupowania, czy sortowania. Wszyskie tego typu rzeczy okrelamy w samym zapytaniu SQL bez
adnych udziwnie. Jak wida w liniach 98-100 potrzebny parametr zwyczajnie doczyem na
zasadzie sklejania tekstu, warunek WHERE i sortowanie okrelone jest w samym SQL.
Zdecydowanie preferuj t form, jako bardziej przyjazn :) W liniach 101-105 wstawiem te
zakomentowan alternatywn posta tego samego wywoania. W tym przypadku zamiast skleja
zapytanie, posuyem si znakami zapytania i podstawiam wartoci ktre pod te znaki zapytania
maj trafi w trakcie wykonania z listy podanej jako drugi parametr metody rawQuery (tutaj lista
jest po prostu jednym elementem typu String). Samo pobieranie danych z takiego kursora przebiega
dokadnie tak jak wczeniej. Poniewa wartoci z kolejnych kolumn pobieram podajc jej numer
zaczynac liczy od 0 od lewej strony, nie musz nawet robi adnych aliasw dla kolumn ktre
wynikaj np. z dziaania funkcji.
156/227
Sprawdzanie zawartoci katalogu i wasnoci plikw

Rozpoczniemy od sprawdzania zawartoci katalogu. Wyniki wywietl na komponencie ListView.
W pierwszej kolejnoci dodaj wic taki komponent do mojej aktywnoci:
Do tego komponentu trzeba bdzie doda layout dla pojedynczych elementw listy (jest to
niezbdne na pniejszych etapach), na razie tworz pusty plik XML w katalogu layout.
157/227
Jego zawarto przedstawia si nastpujco:
Nic specjalnego. Plik opisuje po prostu w jaki sposb ma wyglda pojedynczy element listy. Tutaj
bdzie to po prostu napis, ale rwnie dobrze moemy tutaj zastosowa choby TableLayout i uoy
sobie bardziej skomplikowane struktury (np. obrazek i obok tekst).
Przysza pora na kod:
158/227
Najwaniejsze elementy znajduj si w liniach 23-28. W linii 23 do listy elementw typu String
przypisuj list plikw z wskazanego katalogu. Klasa File to zwyka javowa File, nie adna
Androidowa interpretacja. W Javie kady katalog te jest plikiem, std taki moe nieco dziwny
zapis. Katalog ktrego zawarto pobieram to . , czyli katalog root systemu. Rwnie dobrze moe
to by dowolny inny katalog, podajemy go jako parametr konstruktora klasy File. W liniii 24 tworz
obiekt klasy ArrayList. Bd musia do adaptera (czyli elementu dziki ktremu uzupeniam
zawarto komponentu klasy ListView) poda list wanie takiego typu. W linii 26 robi
konwersj z dotychczas uywanej listy stringw na obiekt klasy ArrayList. Linia 27 to
inicjalizacja wczeniej wspomnianego adaptera. Mamy trzy parametry, pierwszy to kontekst, drugi
do wskanik do zawartoci pliku XML charakteryzujcego wygld pojedynczego elementu listy,
trzeci to lista typu ArrayList zawierajca dane do wywietlenia.
Efekt:
159/227
Zmieniem katalog ktrego zawarto wywietlam na /sdcard , czyli zawarto karty SD. Wynik
wyglda tak:
Dodajemy teraz wywietlanie wasnoci plikw i katalogw.
160/227
Wprowadziem kilka zmian w kodzie. W linii 27 zmieniem troszk wywoanie konstruktora klasy
File, tak by korzysta ze zmiennej typu String o nazwie katalog, a nie podanej bezporednio cieki.
Zrobiem tak, poniewa nieco dalej znowu korzystam ze cieki do pliku i nie chc powiela tego
samego kodu. Od linii 29 do 37 iteruj po elementach listy stringw zawierajcych nazwy plikw i
katalogw. W zalenoci od wasnoci pliku/katalogu do jego nazwy doklejam rne informacje.
Dalsza cz kodu pozostaje bez zmian. Linia 31 to doklejenie do nazwy litery R, jeli plik/katalog
moemy odczytywa. Linia 32 to dodanie do nazwy litery W jeli mamy moliwo pisania do
pliku. Linie 33-35 su dodaniu daty do nazwy pliku/katalogu. Korzystam tutaj z obiektu klasy
java.util.Date, poniewa warto zwracana przez metod lastModified() wyraona jest jako int. W
linii 36 powikszam warto iteratora ktrego uywam do poruszania si po licie.
W pliku XML elementy_listy_glownej.xml opisujcym wygld pojedynczego elementu listy
rwnie dokonaem maej zmiany (czysta kosmetyka). Zmniejszyem wielko czcionki z 15 na 11,
poniewa wiksza ilo informacji powodowaaby zawijanie linii, a tak mamy wszystkie informacje
dotyczce pliku/katalogu w jednej linijcie :)
161/227
Efekt:
162/227
Sprawdzanie iloci wolnego miejsca na karcie SD

Jeli chcemy sprawdzi ilo wolnego miejsca na karcie SD lub w katalogu , moemy skorzysta z
klasy StatFs. Niestety nie dziaa to dla katalogu root.
W pierwszej kolejnoci przyklejam na ekranie element typu TextView. Bdzie na nim wywietlona
ilo miejsca na karcie.
163/227
Teraz trzeba doda nieco kodu ktry to obsuy:
Zasadniczo to co najwaniejsze mieci si w liniach 16 i 17. W 16 z uyciem konstruktora klasy

StatFs wskazuj katalog dla ktrego bdzie sprawdzana ilo wolnego miejsca. W linii 17
wykorzystuj metody getBlockSize i getBlockCount do sprawdzenia iloci miejsca na karcie
wyraonej w bajtach. Poniewa bardziej czytelne jest wywietlenie tego w megabajtach, dziel
dwukrotnie uzyskan warto przez 1024 i zaokrglam w linii 18. Efekt dziaania programu:
164/227
Lokalizacja i mapy
Wykorzystanie GPS
Jeli nasz telefon / urzdzenie z ktrego korzystamy posiada czujniki GPS, moemy wykorzysta je
do sprawdzania naszej pozycji programowo. Moemy rwnie skorzysta z darmowych map
projektu OpenStreetMap (http://openstreetmap.org) i np. stworzy wasn nawigacj.
Zaczniemy od utworzenia nowego projektu i wyedytowania pliku AndroidManifest.xml tego
projektu. Musimy doda prob o uprawnienia do korzystania z czujnikw GPS. Bez takiej
autoryzacji ze strony uytkownika, nasz program nie bdzie dziaa. Dodajemy linie:
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
Tu pod zamkniciem elementu <application>. Podgldzik:
Mamy ju moliwo korzystania z czujnikw GPS. Czas przej do waciwej wersji kodu.
Zaczniemy jak zawsze od wersji najprostszej tj. po uruchomieniu programu ma si na ekranie
wywietli nasze pooenie tzn. dugo i szeroko geograficzna.
165/227
Przechodzimy teraz do naszej gwnej aktywnoci. Przyklejam na ekranie trzy elementy klasy
TextView. Na dugo i szeroko geograficzn, oraz na nazw wybranego dostawcy (wyjani si to
nieco pniej).
Od razu w metodzie onCreate podpinam do nich uchwyty. Bd si przecie do tych elementw

odwoywa, wic bd te potrzebowa elementw reprezentujych te komponenty.
Do okrelania lokalizacji bdzie nam suy obiekt klasy LocationManager. Definiuj go podobnie
jak komponenty klasy TextView jako pole klasy a nie jako zmienna prywatna w metodzie
onCreate. Robi tak, bo by moe bd si do tego obiektu owoywa z innych metod na dalszych
etapach tworzenia programu.
166/227
Obiekt kr klasy Criteria (linia 29) suy do wyszukiwania najlepszego dostawcy informacji o
pooeniu GPS. Mog np. poprzez te kryteria okreli e interesuj mnie wycznie bezpatni
dostawcy ( metoda setCostAllowed klasy Criteria), czy poziom zapotrzebowania energetycznego
wymaganego dla danego sposobu okrelania lokalizacji (setPowerRequirement). Chcc zastosowa
ktry z wymienionych warunkw, po utworzeniu obiektu klasy Criteria, uruchamiamy dla tego
obiektu wybrane metody. Sam obiekt klasy Criteria jako element warunkujcy wybr dostawcy
stosujemy pniej przy pobieraniu nazwy najlepszego dostawcy. W linii 30 inicjalizuj obiekt przy
uzyciu usugi zwracanej przez metod getSystemService (metoda dziedziczona po klasie Activity).
Z uyciem tej metody moemy podpina si do najprzerniejszych usug systemowych : np.
korzysta z rnych czujnikw (temperatury, cinienia etc), korzysta z usug lokalizacyjnych,
pobiera dane z internetu, drukowa, korzysta z portu USB i wiele innych. Poniewa bdziemy
korzysta z usug lokalizacyjnych, jako parametr metody getSystemService podaj
LOCATION_SERVICE. Linia 31 to pobranie nazwy najlepszego dostawcy informacji o pooeniu
(moe to by np. GPS, pooenie okrelone wg triangulacji, lub sie WIFI). Zwrcony moe by
tylko dostawca dla ktrego wywoujca aktywno ma niezbdne pozwolenia (chodzi o wpisy w
AndroidManifest.xml). Jeli kilku dostawcw spenia zaoone kryteria, to zwrcona zostanie
nazwa tego ktry charakteryzuje si najwysz dokadnoci pooenia. Przykadowo, jeli moemy
okreli nasze pooenie na podstawie GPS, lub na podstawie triangulacji, przy czym GPS okreli
to z dokadnoci do 10 metrw a triangulacja z dokadnoci do 1 kilometra, to zostanie zwrcona
nazwa dostawcy gps. Pierwszy parametr metody getBestProvider to nasze kryteria, drugi okrela
czy zwracani maj by tylko aktywni dostawcy ( w tym przypadku oczywicie tylko tacy nas
interesuj).
167/227
Obiekt klasy Location bdzie reprezentowa nasz lokalizacj w przestrzeni, bdziemy z niego
pniej pobiera np. nasz dugo i szeroko geograficzn. Najpierw jednak musimy okreli
nasze pooenie :) Robimy to w linii 32 przy uyciu metody getLastKnownLocation obiektu klasy
LocationManager. Jako parametr podajemy nazw wybranego dostawcy informacji o pooeniu.
Linie 34-36 to po prostu wywietlenie uzyskanych danych. Warte uwagi mog tutaj by metody
getLongitude i getLatitude zwracajce dugo i szeroko geograficzn. Zwracaj liczby typu
double, z dosy du dokadnoci. Bdc na obrzeach Warszawy dostaem swoje pooenie z
dokadnoci do 7 miejsca po przecinku stopnia geograficznego. Do tego prostego programu warto
byoby ewentualnie dorobi obsug sytuacji w ktrej nie byoby w danym pooeniu adnego
dostawcy, lub nie mona byoby okreli pooenia. Nie bdziemy si tym tutaj jednak zajmowa
poniewa obsuga nulla zwracanego z metody (tutaj z metod getBestProvider i
getLastKnownLocation) to podstawy Javy. Chcc testowa rzeczy zwizane z GPS, najlepiej robi
to na realnym urzdzeniu a nie adnych emulatorach. Niby na emulatorach jest moliwo
ustawienia fikcyjnego pooenia GPS, ale te nie zawsze to dziaa. U mnie po uruchomieniu
programu na telefonie wywietlio si:
najlepszy dostawca: network
szeroko geograficzna: 52.2996591
dugo geograficzna: 20.9930961
Program dziaa, jednak jeli zmienimy pooenie, nasz program tego nie odnotuje. Warto byoby
wzbogaci program o funkcjonalno ktra by uwzgldniaa zmiany naszego pooenia. Zaczn od
dodania do ekranu elementu na ktrym bdzie pojawiaa si historia lokalizacji. Przykleiem
komponent klasy SmallText.
168/227
eby historia troszk si odrniaa, zmieniem tekstu w tym nowym komponencie poprzez edycj
pliku layoutu i dopisani linijki : android:textColor=#300FD
Kodowi rdowemu naszej aktywnoci bdziemy przyglda si poczynajc od gry. W definicji

dopisaem implements LocationListener, dziki czemu bd mia dostpn metod
onLocationChanged ktra jest wywoywana za kadym razem kiedy zostanie wykryta nowa
lokalizacja. Poniewa jest to interfejs, bd musia zaimplementowa cztery wymagane przez niego
metody. Tym si zajmiemy za chwil.
W linii 18 widzimy nowe pole t4. To jest obiekt reprezentujcy komponent do wywietlania
historii. W liniach 25-28 widzimy now metod odswiez. Poniewa bd musia odwiea swoje
pooenie przynajmniej dwukrotnie tj. przy uruchomieniu aplikacji i przy zmianie lokalizacji,
postanowiem kod odpowiedzialny za odwieanie oddelegowa do osobnej metody.
169/227
W linii 37 widzimy podpicie do obiektu t4 referencji do naszego nowego komponentu (tego napisu
ktry bdzie robi za histori). Nic nadzwyczajnego, ale musimy o tym pamita. W linii 41
zamiast wywoywa osobno szukanie najlepszego dostawcy i pobieranie pooenia mamy
wywoanie metody ktra wanie to robi i aktualizuje nasze obiekty. Linia 42 zawiera ustawienie
wasnoci odwieania. Konfigurujemy tutaj co jaki czas i przy jakiej zmianie pooenia system ma
odwiea lokalizacj (czyli jak czsto ma by automatycznie wywoywana metoda
onLocationChanged ktr bdziemy za chwil implementowa - w liniach 50-57). Pierwszy
parametr to nazwa dostawcy z ktrego korzystamy, drugi to czas w milisekundach co ile ma by
odwieana lokalizacja, trzeci to co jaki dystans (wyraony w metrach), a czwarty to obiekt
implementujcy interfejs LocationListener (tutaj akurat dotyczy to obiektu w ktrym si
znajdujemy). Linie 43-46 to ustawienie domylnych napisw, czyli tego co ma si pojawi zaraz po
uruchomieniu programu. Tutaj tak jak wczeniej wywietlamy dostawc i wsprzdne. W linii 46
ustawiam pierwsz i na razie jedyn lini historii.
170/227
Poniej mamy cztery metody ktre musiaem zaimplementowa z racji implementacji interfejsu
LocationListener. Trzy tymczasowo zostawiam w spokoju. Interesuje mnie teraz tylko metoda
onLocationChanged. Jest ona wywoywana co interwa czasowy lub dystans okrelone (linia 42) w
metodzie requestLocationUpdates. W ramach mojej implementacji metody onLocationChanged
odwieam pooenie wywoujc metod odswiez, a nastpnie w liniach 52-54 wywietlam na
komponentach aktualne pooenie. W linii 55 dodaj do historii kolejn lini.
171/227
Byem ciekaw na ile sprawnie t o dziaa, wic wgraem program na telefon i poszedem sprawdzi
czy nie ma mnie za rogiem. Oto wyniki:
172/227
Uywanie map OpenStreetMaps

Jedn z alternatyw dla stosowania w swoich aplikacjach map od Google jest wykorzystaniem map
zod OpenStreetMaps. S bezpatne i dziaaj cakiem sprawnie.
Zaczynamy od dodania do projektu niezbdnych blibliotek tj. osmdroid-android-4.0.jar i
slf4j-android-1.5.8.jar (lub ich nowszych wersji jeli takie si pojawi):
Musimy te doda te biblioteki do Build Path projektu. Robimy to wchodzc do waciwoci

projektu, nastpnie przechodzc do Java Build Path i wybierajc Add Jars:
173/227
Wybieramy te dwie nowo dodane biblioteki i zatwierdzamy. Czas wstawi obiekt mapy do naszego
layoutu. Dodajemy widoczny na poniszej ilustracji element org.osmdroid.views.MapView:
174/227
Poniewa aplikacja bdzie musiaa pobiera dane (mapy) z internetu, musimy zadba o
odpowiednie pozwolenia. Do pliku manifestu dodajemy wic ponisze linie:
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
tu za tagiem </application>
To s wystarczajce uprawnienia niezbdne do dziaania map OpenStreetMaps. My w naszym
przykadzie wykorzystamy nasz realn pozycj z GPS i wywietlimy fragment mapy z okolic
naszej pozycji. Z tego powodu trzeba bdzie doda jeszcze dodatkowe uprawnienia:
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
W przypadku gdybymy nie korzystali z pozycji GPS, tych ostatnich uprawnie nie dodajemy.
Oglnie w suemie cao powinna wyglda mniej wicej tak:
Przechodzimy teraz do aktywnoci ktr wykorzystamy do zaprezentowania mapy. Dodaj kilka

pl do klasy. Pola w liniach 17-20 s zwizane z wykorzystaniem GPS, wic jeli nie zamierzamy z
niego korzysta, nie definiujemy ich. Potrzebne nam bd tylko obiekty z linii 23,24:
175/227
Kod z linii 42-45 jest zwizany z pobraniem pozycji GPS, omawiaem w jednym z poprzednich
rozdziaw dokadnie sposb dziaania takiego kodu i nie bd si tutaj tym zajmowa. Nas
interesuj zasadniczo linie 35-40 i 46-50. Linia 35 to element nie zwizany z sam map jako tak,
suy do podpicia referencji do komponentu mapy. W linii 36 wskazujemy rdo z ktrego
pobieramy mapy. Linie 37 i 38 okrelaj zachowanie mapy. Metoda setBuildInZoomControls (linia
37) ustawia, czy ma by moliwo przybliania i oddalania na mapie (jeli podamy true, bd
dostpne przyciski + i na mapie). Metoda setMultiTouchControls (linia 38) ustawia moliwo
stosowania gestw dotykowych na ekranie jak np. zblianie i oddalanie widoku dwoma palcami.
W linii 40 okrelamy domylne przyblienie mapy. W linii 46 tworzymy obiekt klasy GeoPoint
reprezentujcy nasze pooenie. W linii 49 centrujemy map na punkcie wskazanym przez obiekt
klasy GeoPoint ustawiony w linii 46. Wywoanie metody invalidate w linii 50 to odwieenie
widoku.
176/227
177/227
Android te czuje czujniki

Sprawdzanie jakie czujniki mamy dostpne
Zanim zaczn korzysta z czujnikw jakiego urzdzenia, chciabym wiedzie jakie w ogle s
dostpne. W pierwszej kolejnoci przyklejam na ekranie komponent typu TextView na ktrym
wywietl wyniki:
W metodzie onCreate aktywnoci gwnej dodaj par linii kodu. Kod ktry ma realizowa zadanie
znajduje si wanie w tej metodzie, poniewa chc aby wyniki wywietliy si od razu po
uruchomieniu programu. Linie 21,22 to podpicie referencji do komponentu TextView i
wyczyszczenie jego zawartoci (napisu). Klasa SensorManager do ktrej obiektu odwouj si w
linii 25 (sama deklaracja obiektu jest w linii 14) daje nam dostp do czujnikw wbudowanych w
urzdzenie. Pobranie instancji tej klasy nastpuje poprzez wywoanie metody getSystemService z
parametrem SENSOR_SERVICE. Aby odczyta nazwy czujnikw ktre s dostpne w urzdzeniu,
wykorzystuj metod getSensorList klasy SensorManager ( linia 26 ). Metoda ta zwraca dostpne
(czyli znajdujce si na danym urzdzeniu) czujniki wskazanego typu. Tutaj podaj jako typ
Sensor.TYPE_ALL, dziki czemu w efekcie dostaj czujniki wszystkich typw. Mgbym w tym
miejscu wstawi np. Sensor.TYPE_GYROSCOPE i dostabym list wszystkich dostpnych w
urzdzeniu yroskopw. Linie 27-29 to ju iteracja po zwrconych obiektach i dodawanie
kolejnych linii z nazwami kolejnych czujnikw do kompontentu tekstowego.
178/227
Efekt na Samsung ACE3:
179/227
180/227
Czujnik orientacji (poziomica + kompas )

Android umoliwia korzystanie z wbudowanego w urzdzenie czujnika orientacji. Dziki temu
czujnikowi jestemy w stanie okreli pozycj telefonu tj. pochylenie gra-d i lewa-prawa.
Mona dziki temu zaprogramowa np. elektroniczn poziomic. Ten sam czujnik orientacji
pozwala te na okrelenie azymutu na ktry zwrcony jest telefon. W tym przykadzie
wykorzystamy wszystkie te moliwoci.
Zaczynamy od przyklejenia na ekranie czterech elementw klasy TextView:
Do przyklejonych elementw musimy podpi referencje aby z nich korzysta, tutaj niczego
zaskakujcego nie ma. Pojawia si za to implementacja interfejsu SensorEventListener. O co tu
chodzi? Nasz czujnik bdzie co chwila podawa nowe odczyty, aby wywietla te zmiany musimy
zaimplementowa ten interfejs. W zwizku z tym, bdziemy musieli przesoni metody
onSensorChanged i onAccuracyChanged. O tym za momencik.
181/227
Zanim zaczniemy korzysta z naszego czujnika, musimy zarejestrowa wybran klas (musi ona
implementowa interfejs SensorEventListener) jako odbiornik dla czujnika. Ja to zrobiem w
metodzie onCreate mojej aktywnoci, poniewa ta jest uruchamiana w momencie startu programu.
Jako odbiornik zarejestrowaem aktywno, poniewa to w niej chc reagowa na zmiany odczytw
(a zadbaem o to by ta aktywno implementowaa interfejs SensorEventListener).
W zwizku z implementacj interfejsu SensorEventListener musz zaimplementowa te metody

onAccuracyChanged i onSensorChanged. Pierwsza jest wywoywana kiedy dokadno czujnika
ulega zmianie (tutaj raczej nam si to nie przyda), druga jest wywoywana automatycznie kiedy
odczyty z czujnikw ulegn zmianie (ta ju nas interesuje). Do tej metody przekazywane s
odczyty z czujnika. Pod indeksem 0 (event.values[0]) znajdziemy azymut na jaki zwrcona jest
gra telefonu, pod indeksem 1 (event.values[1]) wychylenie w paszczynie gra-d, pod indeksem
2 (event.values[2]) wychylenie lewa-prawa. Wartoci wszystkich trzech wypisuj na pierwszym
komponencie.
Korzystajc z tych odczytw wywietlam na pozostaych komponentach stosowne komentarze.

Maj one sprawi, e odczyty bd bardziej czytelne. Nie jest to niezbdny element, czysta
estetyka. Ca metod onSensorChanged wida na poniszej ilustracji.
182/227
183/227
Efekt dziaania (Samsung ACE3):
Do programu warto byoby doda jeszcze obsug sytuacji gdyby urzdzenie nie posiadao
czujnika, nie kady telefon jest w niego wyposaony.
184/227
Wysyanie i odbieranie SMSw

Wysyanie pojedynczego SMSa
Wysyanie SMSw w Androidzie jest bardziej ni proste. Do pliku manifestu dodajemy
odpowiednie uprawnienie:
<uses-permission android:name="android.permission.SEND_SMS"/>
A nastpnie przechodzimy do kodu:
Obiekt klasy SmsManager to po prostu narzdzie suce do wysyania SMS. Znaczenia

pozostaych 2 zmiennych odbiorca i wiadomosc nie trudno jest si domyli. Przyjrzyjmy si
teraz liniom 22 i 23. Metoda getDefault oddaje nam instancj klasy SmsManager. Metoda
sendTextMessage suy do wysyania SMSw skadajcych si z nie wicej ni 160 znakw tj.
pojedynczy sms. Istnieje te metoda sendMultipartTextMessage ktra umoliwia wysanie tekstu
na ktry skada si wicej ni jeden SMS. Pierwszy parametr metody sendTextMessage to numer
telefonu odbiorcy,trzeci to tre wiadomoci. Musimy pamita, e urzdzenie z ktrego wysyamy
wiadomoci musi posiada kart SIM :)
185/227
Wysyanie wieloczciowego SMSa

Wysyanie wieloczciowego SMSa jest bardzo podobne do wysyania pojedynczego, z t rnic
e smsa trzeba po drodze podzieli na kilka fragmentw, ale nawet do tego mamy dedykowan
gotow metod. Zacznijmy od dodania niezbdnego uprawnienia:
<uses-permission android:name="android.permission.SEND_SMS"/>
Potem przechodzimy do kodu:
Obiekt klasy SmsManager jest elementem wysyajcym smsy. Zmienna odbiorca to numer telefonu
na ktry chcemy wysa wiadomo. Lista elementw fragmenty, zdefiniowana jako pusta to
pojemnik do ktrego wrzucona zostanie wiadomo SMS podzielona na fragmenty. Zmienna
wiadomosc suy do tymczasowego przechowania wiadomoci o dugoci wikszej ni 160 znakw.
W metodzie onCreate , w linii 28 odbieram instancj klasy SmsManager. W linii 29 wykorzystuj
metod divideMessage ktrej podaj dug wiadomo, a ta zwraca nam j ju podzielon na
fragmenty do pojemnika fragmenty. Samo wysanie wiadomoci to wywoanie metody
sendMultipartTextMessage, ktrej podaj numer telefonu odbiorcy i wiadomo podzielon na
fragmenty. Po drodze (w linii 30) wywietlam ilo elementw jakie wyjd z naszej wiadomoci.
186/227
Wyszy mi cztery, co wida na poniszym obrazku:
Wiadomo przychodzi jako cao. Pamitamy oczywicie o woeniu karty SIM do urzdzenia z
ktrego chcemy wysya smsy, poniewa wbrew pozorom nie jest to metoda na darmowe wysyanie
smsw ;)
187/227
Odbieranie SMSw
Jeli chcemy napisa aplikacj ktra bdzie reagowaa na nadejcie SMS, musimy j zarejestrowa
jako taki odbiornik i w ten sposb zdeklarowa e potrafi obsugiwa takie akcje. W tym
celu,gdzie pomidzy tagami <Application> w pliku manifestu musimy wstawi taki fragment:
<receiver android:name=".OdbiornikSMS" android:enabled="true">
<intent-filter>
<action android:name="android.provider.Telephony.SMS_RECEIVED"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</receiver>
Oczywicie w pierwszej linii podajemy nazw swojej klasy ktra ma sesemesy odbiera.
Wstawiajc taki kawaek kodu do naszego pliku manifestu, deklarujemy e nasz program potrafi
obsugiwa pewne operacje np. w tym przypadku android.provider.Telephony.SMS_RECEIVED,
ale rwnie dobrze moe to by odbieranie nadchodzcych pocze czy obsuga wywoa otwarcia
strony internetowej.
Skoro deklarujemy, e jestemy w stanie obsugiwa odbieranie sms, to musimy jeszcze mie do
tego uprawnienia ;) Pamitamy wic o dodaniu takiej linii do pliku manifestu:
<uses-permission android:name="android.permission.RECEIVE_SMS"/>
Jeszcze kodzik ktry to wszystko obsuy:
188/227
Musimy zaimplementowa interfejs BroadcastReceiver i posiada metod onReceive w ktrej

okrelimy co ma si zdarzy przy odbieraniu sms. Nie musisz si martwi e od teraz nasza
aplikacja zasoni domyln obsug odbierania smsw. Platforma Android w momencie odebrania
SMS wywoa wszystkie aplikacje zarejestrowane jako odbiorniki smsw :)
Tak funkcjonalno mona fajnie wykorzysta do stworzenia systemu zarzdzanego z dowolnego
miejsca na ziemi poprzez SMS :)
189/227
Multimedia
Odwarzanie dwiku
Zaczniemy od najprostszego przykadu. Program zaraz po uruchomieniu odtworzy plik MP3 ktry
bdzie znajdowa si w ramach samego programu.
Zaczynamy od stworzenia projektu, oraz utworzenia podkatalogu o nazwie raw w katalogu res
projektu. Nastpnie do podkatalogu raw wrzucamy utwr muzyczny w ktrym z formatw: wav,
aac, mp3, wma, amr, ogg, midi
Wszystko co wrzucimy do podkatalogu res, jest automagicznie rejestrowane jako zasb dostpny z
poziomu kodu.
190/227
Teraz ju tylko may szlif kodu gwnej aktywnoci:
Kluczowe s tutaj linie 19-21. artowaem :) Interesuj nas linie 16 i 17. W linii 16 tworzymy
obiekt klasy MediaPlayer ktra jako taka suy do odtwarzania multimediw. Podczas tworzenia
przekazujemy jako argumenty metody create : kontekts i zasb. Jak wida nie podajemy
rozszerzenia pliku.
Linia 17 to uruchomienie odtwarzania zasobu kty wskazalimy w linii 16.
W sytuacji gdyby plik muzyczny ktry chcemy odtwarza znajdowa si poza aplikacj, np. na
karcie SD nasz kod wyglda by musia tak:
MediaPlayer mp = new MediaPlayer();
mp.setDataSource(/sdcard/rammstein/raise_raise.mp3);
mp.prepare();
mp.start();
191/227
Wykorzystanie aparatu fotograficznego do robienia zdj

Podobnie jak w przypadku czujnikw, do kamery rwnie mamy gotowy interfejs. Zostay
stworzone odpowiednie klasy i metody, wystarczy tylko z nich skorzysta. Zaczniemy od
najprostszego programu robicego zdjcie i wywietlajce je na komponencie klasy ImageView.
Przyklejam na gwnej aktywnoci jeden przycisk i jeden imageView:
Po naciniciu tego przycisku zostanie uruchomiony wbudowany program do robienia zdj, a

nastpnie odbierzemy zrobione zdjcie i wywietlimy je na ImageView. Poniej wklejam kod
aktywnoci zwizanej z tym ekranem. W liniach 26-34 oprogramowuj zdarzenie nacinicia
przycisku. Cz ktra jest zwizana z samym robieniem zdj jako takim to linie 30 i 31. Tworz
now intencj ktrej zadaniem jest wywoanie wbudowanego w Androida programu do robienia
zdj (linia 30). W kolejnej linii uruchamiam t intencj. Wywoanie takiej intencji wyglda nieco
inaczej ni to do czego si przyzwyczailimy. Zazwyczaj wywoywalimy metod
startActivity(Intent i), a tutaj pojawia si startActivityForResult(Intent i, int x). Sama w sobie
metoda zakada e wywoywana intencja co nam odda. Przy zakoczeniu dziaania intencji i
zwrocie danych wywoywana jest metoda onActivityResult (o tym za chwil).Jako parametry
podajemy intencj ktra ma zosta uruchomiona, oraz identyfikator wywoania. Poprzez drugi
parametr podajemy warto (parametr typu int) ktra pniej zostanie zwrcona po zrobieniu
zdjcia. Przydatne gdybymy np. wywoali kilka rnych intencji oczekujc rnych zwracanych
wynikw. Kada z takich intencji wywoa metod onActivityResult (ktra par linii niej
implementujemy) w ktrej moemy pniej po takim identyfikatorze doj z ktrej to
intencji/wywoania intencji zostay zwrcone dane.
192/227
W liniach 38-44 implementuj metod onActivityResult ktra jest automagicznie wywoywana w

momencie kiedy nasza intencja wywoana przy uyciu metody startActivityForResult koczy swj
przebieg. W tej wanie metodzie odbieramy zrobione zdjcie. Przyjrzyjmy si warunkom w linii
39. Sprawdzam parametr requestCode. To jest wanie parametr ktry przekazaem przy
wywoywaniu intencji (linia 31). Sprawdzam czy requestCode jest rwne 1, by upewni si e to
jest wywoanie intencji zwizane z robieniem zdjcia (mogem przeciez wywoa wczeniej kilka
rnych intencji i oczekiwa na wynik). Drugi parametr resultCode jest zwracany przez
wywoywan aktywno tutaj wbudowany program do robienia zdj. RESULT_OK jest
zwracane w przypadku zatwierdzenia zdjcia. Moe te zosta zwrcone RESULT_CANCEL jeli
kto anuluje robienie zdjcia. W liniach 40 i 41 odbieram zrobione zdjcie. Aby odebra fotk
musz zawsze odwoa si w wizce do identyfikatora data. Linia 42 to ju po prostu ustawienie
odebranego zdjcia jako obrazek dla komponentu ImageView. Wykorzystanie kamery wymaga
odpowiednich pozwole, dlatego dodajemy je do pliku manifestu ( AndroidManifest.xml) aplikacji
w ten sposb:
</application>
<uses-permission android:name="android.permission.CAMERA" />
</manifest>
193/227
Po uruchomieniu i naciniciu przycisku pojawia nam si wbudowany programik do robienia

fotografii:
194/227
Zapomniaem dziubka zrobi, to bym sobie na fejsbuczka wstawi sit foci ;) . Po zrobieniu
zdjcia, dolny panel powinien nam si zamieni na taki:
Mog tutaj anulowa operacj, powtrzy robienie zdjcia, lub zatwierdzi. Zatwierdzamy, a po
powrocie z tej aktywnoci nasz ekran wyglda tak:
Za wyjtkiem moe zdjcia, na swoim zobaczysz pewnie co adniejszego :p Przy uyciu tej
metody moemy niestety robi tylko takie mae zdjcia. Za chwil zrobimy to troszk inaczej i
dostaniemy penowymiarowe zdjcie.
195/227
Stworzyem now aplikacj. Aby zrobi penowymiarowe zdjcie, Android bdzie musia zapisa je
w pliku. Podobnie jak wczeniej dodaj prob o uprawnienia do kamery pliku manifestu, teraz
jednak musz te uzyska pozwolenie na korzystanie z karty pamici, lub jakiego innego folderu.
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
Android udostpnia publicznie dostpny katalog (dostpny dla wszystkich aplikacji). Aby si do
niego dobra moemy zastosowa np. tak konstrukcj:
File katalog =
Environment.getExternalStoragePublicDirectory(Environment.DIRECTORY_PICTURES);
Jak zawsze rozpoczynam prac od przyklejenia komponentw:
Daem jeden guzik ktry uruchomi intencj, oraz jeden TextView na ktrym znajdzie si cieka do
zrobionej fotografii.
W aktywnoci, w metodzie onCreate podpinam referencj do komponentw i jako obsug
nacinicia przycisku wywouj metod obslugaGuzika().
196/227
Sama metoda obslugaGuzika jest przestawiona poniej:
Wyjaniam rzeczy ktrych nie omawiaem wczeniej. W linii 50 tworz plik ktry wykorzystam za
chwil do zapisania fotografii na dysku. Linie 51-54 su jedynie nazwaniu pliku tak, by nazwa
zawieraa dat i czas zrobienia zdjcia. Jeli chcesz, moesz je nazwa po prostu fotka. Linia 57
to pobranie referencji do kyatalogu przeznaczonego na obrazki. W linii 59 tworz plik w ktrym
znajdzie si zdjcie. W linii 63 do intencji podaj dodatkowy parametr tj. ciek do pliku w
ktrym ma si znale zdjcie. Po zakoczeniu cyklu intencji wywietlam na textView ciek do
utworzonego pliku.
197/227
Efekt:
Moe nam nie odpowiada to, e musimy dodatkowo klika na androidowej aktywnoci do robienia
zdj. Chcielibymy by przykadowo program sam robi zdjcie w reakcji na jakie zdarzenie np.
pobudzenie czujnika ruchu. Konieczno dodatkowego kliknicia przez czowieka w takim
wypadku nie wchodzi w gr. Jest moliwo automatyczniego robienia zdj, bez wywoywania
dodatkowej systemowej aktywnoci, ale wymaga to wicej pracy.
198/227
Stworzyem nowy projekt i przykleiem na ekranie button i imageView:
Zaoenie jest takie, e zaraz po klikniciu przycisku zostanie wykonana fotografia i wywietlona
na imageView. Musz te zadba o wymagane pozwolenie:
<uses-permission android:name="android.permission.CAMERA"/>
Przechodzimy teraz do kodu.
199/227
Aby automatycznie odbiera robione zdjcie, musimy w klasie ktra ma je odbiera

implementowa PictureCallback (linia 26). To sprawi, e w momencie zrobienia zdjcia zostanie
wywoana metoda onPictureTaken do ktrej zostanie przekazane zdjcie w postaci tablicy
elementw typu byte... Do tej metody przejdziemy za kilka chwil. Linie 37,38 to podpicie
referencji do komponentw, nic nadzwyczajnego. Kod z linii 41-51 ma na celu sprawdzenie czy
urzdzenie w ogle posiada kamer (linia 41) oraz znalezienie jej identyfikatora i uruchomienie. W
linii 45 do zmiennej liczbowej cameraId przypisuj identyfikator kamery zwracany jest przez
metod znajdzKamere. Zwraca ona warto wiksz ni -1 jeli zostanie znaleziona tylna kamera,
jeli nie zostanie znaleziona -metoda zwraca warto -1. To mam nadziej e wyjania warunek if z
linii 46. Kodem samej metody zajmiemy si za chwil. Linia 49 to uruchomienie kamery dla
identyfikatora zwrconego przez metod znajdzKamere. Przejdmy dalej:
200/227
Linie 53-61 to podpicie wywoania mojej metody onC pod kliknicie przycisku. W liniach 64-67
znajdziemy metod, ktra powoduje wykonanie zdjcia przez kamer. Istotnym z punktu widzenia
funkcjonalnoci jest tutaj wywoanie metody takePicture dla obiektu klasy Camera dla ktrego
wczeniej (linia 49) podpinalimy identyfikator fizycznego urzdzenia. Linie 70 81 to metoda
zwracajca identyfikator tylnej kamery. Wywoywalimy j wczeniej (linia 45) w celu odnalezienia
identyfikatora kamery. Zasada dziaania jest prosta. Jest ptla, ktrej zawarto jest wykonywana
tyle razy, ile jest kamer w systemie. Przy kadym obrocie sprawdzam czy wanie sprawdzana
kamera to ta odpowiadajca identyfikatorowi tylnej kamery
(CameraInfo.CAMERA_FACING_BACK w linii 75). Gdybymy zechcieli robi zdjcia z uyciem
kamery przedniej, moemy wykorzyta identyfikator CAMERA_FACING_FRONT. Przejdmy do
dalszej czci kodu:
Linie 85-90 to odblokowanie kamery w przypadku np. minimalizacji programu, tak by inne
programy rwnie mogy korzysta z tego urzdzenia. Przesaniam tutaj domyln metod onPause
klasy Activity. Linie 94-97 to implementacja metody onPictureTaken (konieczno wymaga z faktu
e implementujemy interfejs PictureCallBack. Ta metoda jest automatycznie wywoywana w
momencie zrobienia zdjcia. Przy uyciu metody decodeByteArray klasy BitmapFactory (linia 95)
konwertuj obraz w postaci tablicy elementw typu byte do bitmapy. Linia 96 to wywietlenie fotki
na komponencie klasy ImageView. Co z tego wszystkiego jest najwaniejsze? Najwaniejsze
elementy:
Implementujemy interfejs PictureCallback (linia 26)
Podpicie urzdzenia pod obiekt klasy camera (linia 45)
Wywoanie metody takePicture obiektu klasy Camera wtedy kiedy chcemy zrobi zdjcie
(linia 65)
Implementacja automatycznie wywoywanej metody onPictureTaken i przetworzenie

przekazanego nam przez argument zdjcia (linia 94).
Te elementy to nasz engine, reszta to poboczny osprzt.

201/227
Efekt po uruchomieniu i klikniciu przycisku:
202/227
Odtwarzanie Video
Odtwarza moemy formaty MP4 (MPEG-4), AVC, 3GP. Mamy gotowy komponent ktry
wystarczy przyklei gdzie na aktywnoci. Sam plik video moe znajdowa si ju w aplikacji, ale
moe si te znajdowa np. na karcie SD. W tym przykadzie uruchomi plik video znajdujcy si
w aplikacji. W katalogu res aplikacji dodaj podkatalog raw. Do niego wrzucam plik video.
Wklejony przeze mnie filmik to 2 i p minuty video z taczcymi i piewajcymi parabolami. Nie
wrzucaj zbyt duego pliku video, poniewa przy kadej aktualizacji kodu i ponownym
uruchamianiu programu , cao bdzie uploadowana na emulator lub telefon. Gdyby plik by duy,
trwaoby to niemiosiernie dugo.
203/227
W kolejnym kroku przyklejam na aktywnoci komponent VideoView:
Nastpnie wprowadzam kilka zmian w metodzie onCreate aktywnoci gwnej:
204/227
Linia 15 do podpicie referencji do komponentu VideoView. Musz to zrobi by w jakikolwiek

sposb mc si do tego elementu odnosi (np. wskaza mu plik video). Poniewa chc wskaza
plik video zawarty w samej aplikacji, musz stworzy do niego referencj w postaci obiektu klasy
Uri i przekaza go do metody setVideoURI komponentu klasy VideoView (linie 16 i 17). rednio
to wygodne moim zdaniem . Szkoda e nie ma moliwoci przekazania po prostu cieki jako
Stringa. ciek do pliku musz poda z przedrostkiem android:resource://, pakietem w ktrym
znajduje si dana aktywno, katalogiem raw i nazw pliku video bez rozszerzenia.
W linii 18 wida wykomentowany alternatywny sposb. Podaj tutaj ciek do pliku wideo
znajdujcego si poza aplikacj, z uyciem metody setVideoPath. Tutaj dla odmiany moemy poda
ciek jako zwykego Stringa.
Po uruchomieniu aplikacji wszystko dziaa w spodziewany sposb. Jedyna drobna uwaga filmik
nie dopasowuje si do ustawionej wielkoci komponentu VideoView, a wywietla si w swoich
oryginalnych proporcjach. W zwizku z powyszym w orientacji pionowej u mnie (Samsung ACE
3 ) przy propocji ekranu 480:800, wideo zajmuje jak 1/3 ekranu.
205/227
Nagrywanie video
Podczas nagrywania, potrzebny nam bdzie podgld na nagrywany obraz. W tym celu w pliku
layoutu aktywnoci wstawiam komponent SurfaceView. Bdzie robi za mini ekran kamery.
Wielko i szeroko tego podgldu ustawiem na na tyle mae aby zmiecio si na wikszoci
ekranw telefonw z Androidem (parametry layout_width i layout_height). Nie daj fill_parent,
poniewa chc obok jeszcze umieci guzik sucy do rozpoczynania i przerywania nagrywania.
android:orientation="vertical"
>
<LinearLayout
android:orientation="horizontal"
>
<SurfaceView
android:id="@+id/videoview"
android:layout_width="360px"
android:layout_height="240px"/>
<Button
android:id="@+id/mybutton"
android:text="Nagrywaj"
/>
</LinearLayout>
</LinearLayout>
Trzeba te zadba o niezbdne uprawnienia aplikacji. Moja kamera bdzie rejestrowaa nie tylko
obraz, ale i dwik std te uprawnienia do nagrywania audio. Sam plik z nagraniem zostanie
zapisany na zewntrznej karcie pamici std uprawnienie WRITE_EXTERNAL_STORAGE.
Jeli zamierzasz zapisywa nagrany film w pamici wbudowanej, tego uprawnienia nie
potrzebujesz.
<uses-permission android:name="android.permission.CAMERA"/>
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
Przejdmy teraz do kodu ktry bdzie cao obsugiwa. Aby nasza aktywno moga otrzymywa
informacje o tym e powierzchnia podgldu zostaa przygotowana (a bdzie trzeba j przygotowa
przed rozpoczciem nagrywania), nasza aktywno musi implementowa interfejs
SurfaceHolder.CallBack. W zwizku z implementacj tego interfejsu musimy te posiada
zaimplementowan metod onSurfaceChanged (ale nie bdziemy jej tutaj rozwija). W linii 20
definiuj obiekt ktrego uyj do obsugi przycisku (dalej podpinam pod niego referencj do
buttona zdefiniowanego w layoucie). W linii 21 tworz obiekt klasy MediaRecorder. To klasa
suca do rejestracji obrazu i dwiku. W linii 22 tworz obiekt klasy SurfaceHolder. Z uyciem
obiektu tej klasy moemy np. konfigurowa wielko i format nagrania, ale oglnie suy do
206/227
obserwacji tego co si dzieje z obiektem surfaceView czyli ekranem podgldu.
W linii 23 tworz obiekt ktry bdzie reprezentowa ekran podgldu nagrania. Na ekranie bd
mia te guzik, pocztkowo bdzie na nim napis Nagrywaj. Kiedy nacisn go pierwszy raz, ma
si rozpocz nagrywanie a napis na nim ma si zmieni na Koniec. Kiedy klikn po raz drugi,
ma zosta przerwane nagranie i zapisany plik. Potrzebuj wic zmiennej (linia 24), tutaj typu
boolean ktrej stan bdzie informowa o tym czy trwa nagranie czy nie. Zdefiniowana w linii 25
zmienna sciezkaPliku ma wskazywa nazw i ciek do pliku z nagraniem ktry ma zosta
utworzony. Linie 27-43 to metoda ktra ma obsugiwa naciscinia przycisku. Za pierwszym
klikniciem wykonywany jest kod z linii 39-41, rozpoczyna si nagrywanie a napis na przycisku
zmienia si na Koniec. Przy drugim klikniciu, wykonywany jest kod z linii 28-38. Przerywane
jest nagrywanie, a dodatkowo sprawdziam czy utworzy si plik z nagraniem. Jeli zostanie
faktycznie stworzony, dostan na konsoli LogCata informacj o tym.
207/227
Przechodzimy teraz do metody onCreate, a wic uruchamianej w momencie startu aktywnoci.
Podpinam tutaj referencje do komponentw ktrymi bdziemy si posugiwa, ustawiam

nagrywanie tylko w poziomie (linia 51), rejestruj obiekt aktywnoci jako odbiornik dla zdarze
zwizanych z nagrywaniem i przygotowywaniem ekranu podgldu (linie 54-56), a jako obsug
kliknicia przycisku ustawiam wywoanie wczeniej omawianej metody klikniecie() (linia 61). W
linii 52 wywouj te metod initMediaRecorder(), ktrej zawarto wyglda tak:
Suy ona ustawieniu rde dwiku i obrazu, jakoci obrazu, maksymalnego czasu nagrania i
maksymalnej wielkoci pliku.
208/227
Przy uruchomieniu aktywnoci, tworzony jest te podgld nagrania. Musimy go przy tej okazji
przygotowa. W metodzie surfaceCreated (wymaganej w zwizku z implementacj interfejsu
Callback) wywouj wic wasna metod prepareMediaRecorder, ktrej jedynym zadaniem jest
wykonanie wyej wspomnianej czynnoci.
209/227
Aplikacja po uruchomieniu na emulatorze:
210/227
Grafika 2D
Aby wykonywa jakiekolwiek rysunki, bdziemy potrzebowali ptna na ktrym bdziemy
rysowa. Takie ptno bdzie obiektem klasy Canvas. Tworz zwyczajny projekt, a z ekranu
gwnego usuwam domylnie pojawiajcy si tam kompontent textView1. Zasadniczo nasze ptno
przykryje cao ekranu wcznie z tym komponentem, wic kasowanie go nie jest konieczne.
Obiekt klasy Canvas pocztkowo bdzie pusty. Moemy rysowa obiekty korzystajc z
wyznaczania kolejnych linii wg wsprzdnych, ale moemy te skorzysta z gotowych w klasie
Canvas metod ktre narysuj dla nas wybrane figury geometryczne typu prostokt czy okrg. Aby
stworzy i wykorzystywa nasze ptno, nasza aktywno musi posiada wewntrzn klas
dziedziczc po klasie View dla ktrej przesaniamy metod onDraw przyjmujcej jako parametr
obiekt klasy canvas z ktrego bdziemy korzysta. Myl e posuymy si tutaj obrazem.
Pierwsze co robi, to do aktywnoci na ktrej chc rysowa dodaj klas wewntrzn CanvasView
(nazwa dowolna), dziedziczc po klasie View (android.view.View). Musimy doda do niej
konstruktor przyjmujcy jako parametr kontekst. W zasadzie z kontekstem nic szczeglnego tutaj
nie robimy, jedynie przekazujemy je do super klasy, niemniej taki konstruktor po prostu musi si
tutaj pojawi (wymogi implementacyjne klasy View). Nas bardziej interesuje metoda onDraw, bo
to w niej wanie opisujemy wszystko co ma zosta narysowane na dzie dobry na naszym
ptnie.
211/227
Jak na razie, nic szczeglnego si nie dzieje. Musimy sprawi, by zamiast domylnego layoutu
(tego okrelanego w pliku XML), na ekranie pojawio si nasze ptno.
212/227
Zmiany tej dokonaem podmieniajc parametr dla metody setContentView w metodzie onCreate
naszej aktywnoci. Widzimy to na powyszej ilustracji w linii 26. W linii 25 pozostawiem (dla
przykadu) wykomentowane domylne ustawienie.
Skoro ju wszystko mamy popodpinane, zajmiemy si teraz samym rysowaniem. Dodaem trzy
linie do metody onDraw. W linii 19 definiuj obiekt klasy Paint. Jest to pdzel ktrym bdziemy
rysowa rne ksztaty. Moemy dla niego ustawia rne parametry np. kolor ale o tym za
chwil. Linie 20 i 21 to wywoanie metody drawLine , sucej rysowaniu linii. Przyjmuje ona 5
parametrw. Wg. Kolejnoci: X pocztkowe, Y pocztkowe, X kocowe, Y kocowe, obiekt klasy
paint ktrym rysujemy (nasz pdzel). Narysowaem wic po prostu dwie linie zczone na kocach:
213/227
Efekt:
Pobawimy si teraz kolorami pdzla. Do zmiany jego koloru, suy metoda setARGB klasy Paint
(ktrej nasz pdzel jest obiektem). Przyjmuje ona cztery parametry. Pierwszy to stopie
przeroczystoci linii / figury. 0 to cakowita przeroczysto czyli w praktyce niewidoczno,
255 to cakowita nieprzezroczysto. Kolejne trzy parametry to RGB - stopie nasycenia trzech
kolorw wg kolejnoci : Red, Green,Blue. Przyjmowane wartoci to 0-255. Przed narysowaniem
pierwszej linii ustawiam kolor pdzla na czerwie (255 dla RED, reszta 0), nastpnie rysuj lini.
Ponownie zmieniam kolor pdzla, tym razem na zielony (255 dla GREEN, reszta 0) i znowu rysuj
lini:
Efekt:
214/227
Wzbogaciem kod o kolejne kilka linii. Zmieniem kolor pdzla na niebieski i dorysowaem kolejn
lini. Doszo nam wywoanie metody setStrokeWidth dla pdzla (linia 25). Ustawia ona grubo
linii pdzla:
Efekt:
Zajmiemy si teraz rysowaniem figur geometrycznych. Zaczniemy od prostoktw (i kwadratw,

wszak kwadrat te jest prostoktem tyle e o rwnych ramionach :) ).
215/227
Stworzyem nowy projekt, wszystko na identycznej zasadzie jak w poprzednim przykadzie. Rni
si tylko zawartoci metody onDraw:
Metoda setARGB jest ju znana z poprzednich przykadw, jednak tutaj pobawiem si troszk
przezroczystoci. Z nowych rzeczy mamy tutaj dwukrotne wywoanie metody drawRect klasy
Canvas. Metoda ta suy rysowaniu prostoktw. Pierwsze dwa argumenty to wsprzdne (x,y)
jednego z rogw, kolejne dwa to wsprzdne(x,y) rogu przeciwlegego. W tym przypadku wedug
kolejnoci lewy grny i prawy dolny. Ostatni argument to obiekt klasy Paint, czyli pdzel ktrym
bdziemy rysowa. Tutaj narysowaem dwa prostokty jeden nieprzezroczysty fioletowy ((?)
sorry, mczyni nie rozrniaj kolorw zbyt szczegowo) , drugi czciowo przezroczysty w
kolorze szybki przyciemnianych okularw (?). Drugi ma ustawion czciow przezroczysto. W
przypadku rysowania pierwszego prostokta przezroczysto dla pdzla ustawiem na 0, w drugim
na 100. Efekt wyglda tak:
216/227
Rysowanie kek nie sprawia rwnie wielu problemw. Stworzyem kolejny projekt, tym razem
metoda onDraw wyglda tak:
Generalnie do rysowania k suy metoda drawCircle ktra przyjmuje cztery parametry. Pierwsze
dwa to X i Y rodka koa, trzeci to promie, a czwarty to pdzel ktrego parametry ustawiamy na
identycznych zasadach co wczeniej. Zaprzgnem tutaj ptle do wyrysowania mi kilku k, ktre
czsciowo na siebie nachodz. W zasadzie cay kod to rysowane w ronych miejscach koa, ze
zmian waciwoci pdzla. Efekt wyglda tak :
Robacek :) Poniewa uznaem e przecitny robaczek yje na listku/trawce/gazce/czogu/czym

innym zielonym, musiaem zmieni kolor ta. Do tego celu uyem (linia 20) metody drawRGB
obiektu klasy Canvas. Ta metoda nie przyjmuje atrybutu przezroczystoci tak metoda drawARGB
dla obiektw klasy Paint. Ptno samo w sobie nie moe by przezroczyste :). Kolejno kolorw
jak sama nazwa wskazuje RGB - Red, Green, Blue.
217/227
Bluetooth czyli niebieskie pogaduszki

O korzyciach pyncych z moliwoci korzystania z Bluetooth nie trzeba chyba nikogo
przekonywa. Dzi zajmiemy si podczaniem urzdze z Bluetooth i komunikacj z nimi.
Tradycyjnie zaczynamy od dodania niezbdnych uprawnie do pliku manifestu:
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
Pierwsze uprawnienie daje nam moliwo korzystania z Bluetooth, drugie jego wczania i
wyczania (a musimy mie tak moliwo w razie gdyby w urzdzeniu BT byo wyczone).
Napiszemy aplikacj ktra bdzie w stanie :
Rozgosi fakt swojego istnienia, tak by inne urzdzenia skanujc w poszukiwaniu sprztu z
BlueTooth mogy nas zobaczy. Jeli urzdzenia nie s ze sob sparowane, urzdzenie nie
siejce informacji o swoim istnieniu nie bdzie widoczne.
Wywietli na konsoli list sparowanych urzdze
Wykry inne urzdzenia pozwalajce si wykry (czyli rozgaszajce fakt swojego

istnienia).
Utworzy serwer sieciowy oparty na BlueTooth, ktry bdzie oczekiwa na podczenie si

clienta, a gdy to nastpi przele mu komunikat.
Poczy si jako client do innego urzdzenia na ktrym bdzie uruchomiony serwer.
Nasza aplikacja bdzie moga dziaa zarwno jako client, jak i jako serwer. Zalee to bdzie od
tego, ktry przycisk naciniemy. Aby mc testowa aplikacj najlepiej bdzie by wyposay si w
dwa fizyczne urzdzenia wyposaone w BlueTooth. Przyklejam par guzikw, ktre bd
uruchamia wczeniej omwione funkcje. Na komponencie TextView na ktrym aktualne
wywietlam napis TextView w momencie uruchomienia aplikacji pokae si adres mac naszego
urzdzenia. Na TextView na ktrym pocztkowo wywietla si bdzie napis Poczenie nie
nawizane, wywietli si pniej tryb dziaania aplikacji jako serwer lub jako client. W polu
edycyjnym bdziemy wpisywa mac adres urzdzenia ktre bdzie pracowao jako serwer.
Wstawiem tutaj adres swojego telefonu, eby pniej nie musie kadorazowo go podawa.
218/227
Przejdmy teraz do kodu gwnej aktywnoci. Na pocztku w metodzie onCreate podpinam

komponenty wizualne do obiektw. Nic nowego ani nadzwyczajnego:
219/227
Dalej w metodzie onCreate podpinam wywoania metod realizujcych poszczeglne

funkcjonalnoci do przyciskw.
Wyjanienia mog wymaga jedynie linie 67-69 i 75-78. W zalenoci od tego czy aplikacja na
danym urzdzeniu bdzie pracowa jako serwer czy client, wywoywane s wtki realizujce
zadania danej strony. Oparem to na wtkach, poniewa np. oczekiwanie na poczenie , czy proces
czenia s operacjami ktre blokowayby wtek gwnej aktywnoci. W ten sposb wtki pracuj
sobie asynchronicznie, a aplikacja nie blokuje si. Obiekt ba z linii 76 reprezentuje fizyczny
adapter Bluetooth urzdzenia. Linia 77 to pobranie mac adresu wpisanego w pole edycyjne. Bdzie
nam ten adres potrzebny, po przekazujemy go przez parametr konstruktora do wtku clienta. Musi
on wiedzie jaki jest adres urzdzenia z ktrym ma si czy. W liniach 68 i 75 w zalenoci od
trybu dziaania aplikacji, wywietlam na stosownym polu na ekranie, jak rol spenia aplikacja
(czy jest serwerem czy clientem).
220/227
Przejdmy dalej. Linie 85,86 to wywietlenie mac adresu urzdzenia na ekranie oraz konsoli. W
dalszej czci metody onCreate aktywnoci (linie 87-91) obsuguj sytuacj gdyby okazao si, e
BlueTooth na urzdzeniu jest wyczony. Aktywno BT weryfikuj metod isEnabled() klasy
BluetoothAdapter (linia 87). Jeli okae si e jest wyczony, wywietlam komunikat z prob o
zgod na wczenie BT. Poniewa intencj z prob wywouj z uyciem startActivityForResult,
dodaem te metod onActivityResult ktra jest automatycznie wywoywana przez system kiedy
uytkownik udzieli zgody na wczenie BT (albo i nie udzieli :p). Jeli uytkownik udzieli zgody,
sam system uruchomi BT a nam pozostaje tylko zainicjalizowanie obiektu ktrego bdziemy
uywa do komunikowania si z fizycznym adapterem BT i ewentualnie wywietlenie informacji
na konsoli.
Przeszkoczymy na razie definicj obiektu klasy BroadcastReceiver (linie 102-117), wrcimy do niej
za chwil, a na razie przyjrzymy si metodom na kocu klasy.
Metoda dajSieWykryc() sprawia, e nasze urzdzenie jest widoczne dla innych urzdze ktre
skanuj w poszukiwaniu kolegw :). Jeli o to nie zadbamy a urzdzenia nie bd sparowane,
nasze nie bdzie widoczne dla innych. Linie 121 i 123 s odpowiedzialne za wywietlenie zapytania
o moliwo ujawnienia si i rozpoczcie rozgaszania swojego istnienia. Linia 122 to opcjonalna
konfiguracja czasu rozgaszania. Domylnie urzdzenie rozgaszaoby przez 2 minuty, natomiast
podaem mu warto 300 (sekund) , dziki czemu bdzie widoczny przez 5 minut.
221/227
Metoda wykryjInne() powoduje rozpoczcie poszukiwania innych urzdze. Trwa to ok 12 sekund.

Co istotne widoczne bd tylko te urzdzenia ktre bd rozgaszay swoje istnienie. Kiedy jakie
urzdzenie zostanie znalezione trzeba bdzie obsuy takie zdarzenie nie przerywajc
przeszukiwania. Z tego powodu rejestrujemy odbiorc komunikatu rozgoszeniowego
informujcego o znalezieniu urzdzenia (linia 130). Odbiorca to obiekt klasy BroadcastReceiver
ktrego metoda onReceive jest automatycznie wywoywana w przypadku znalezienia urzdzenia z
wczonym rozgaszaniem sygnau. W ramach tej metody wycigam obiekt reprezentujcy dane
urzdzenie fizyczne, sprawdzam czy to urzdzenie zostao wczeniej sparowane i wywietlam o
nim informacje.
cznie dziaanie tych dwch elementw przedstawia si w ten sposb, e metoda wykryjInne()
rozpoczyna poszukiwanie innych urzdze, a gdy jaki znajdzie to zostaje automatycznie wywoana
metoda onReceive obiektu klasy BroadcastReceiver zarejestrowanego jako odbiorca takiego
zdarzenia. W sumie, na konsoli zostan wywietlone informacje o dostpnych w okolicy
urzdzeniach. Po uruchomieniu na konsoli widz znalezione urzdzenie (jeli zostan wykryte,
pojawi si ich wicej ;)) :
222/227
W ramach tej klasy mamy jeszcze metod pokazSparowane():
Jej zadaniem jest sprawdzenie listy urzdze ktre wczeniej sparowalimy i wywietlenie
informacji o nich na ekranie. Ta metoda nie sprawdza czy urzdzenia te s dostpne , a jedynie
wywietla informacje o zarejestrowanych urzdzeniach ktre s przechowywane w systemie:
W przypadku mojego telefonu zostay wywietlone informacje o suchawce na Bluetooth ktrej

uywam (wic si rzeczy musi by sparowana), oraz tablecie ktry musia zosta sparowany by
odbywa po BT pogaduszki z moim telefonem na potrzeby niniejszego artykuu.
223/227
Przejdmy teraz do elementu komunikacji. Jeli programowae kiedy sieciowe poczenia

client-server w Javie, na pewno rozpoznasz wiele elementw. W zasadzie jest to zwyke poczenie
po socketach z t rnic, e nasza komunikacja nie bdzie si odbywaa po sieci, a po Bluetooth.
Najpierw wemiemy na tapet klas odpowiadajc za dziaanie aplikacji jako serwer.
W linii 15 definiuj socket przy uyciu ktrego bdzie odbywaa si komunikacja. Zagadkowe
mog si wyda linie 21 i 22. Usuga musi mie unikalny identyfikator, dziki ktremu bdzie
jednoznacznie rozpoznawana ( http://en.wikipedia.org/wiki/Universally_unique_identifier ). W tych
liniach nasz usug rejestruj pod nazw Usuga witajca pod identyfikatorem
550e8400-e29b-41d4-a716-446655440000
Ten akurat identyfikator jest cakiem przypadkowy, skopiowaem jaki przykad takiego
identyfikatora z internetu. Linie 27-54 to klasyczna implementacja procesu nasuchu, rnica
polega na tym, e nie sieciowego a na bluetooth. Wtek czeka na kontakt ze strony serwera, po
czym otwiera strumie i wysya tekst Witaj kolego!.
224/227
Strona kliencka:
Po tej stronie otwieram socket dla poczenia z serwerem (podobnie jak po stronie serwerowej nie
socket sieciowy a po bluetooth) i odczytuj co mi serwer przysa.
Uruchamiam teraz program na obu urzdzeniach, telefon robi za serwer, tablet za clienta.
225/227
Efekty dziaania serwera:
Po stronie clienta:
226/227
Gdyby zechcia rozwija ten program, lub na jego bazie napisa co swojego, pamitaj e mamy
do czynienia z nieco innym ni sieciowy protokoem i usuga BT z jednej strony moe si czy
tylko z jedn inn usug.
227/227

Ebook Android PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Ebook Android PDF

Uploaded by

Copyright:

Available Formats

Spis treci

Licencja na wykorzystanie materiaw.......................................................................................2

Licencja na wykorzystanie materiaw

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Dalej pobieramy Android SDK ze strony : http://developer.android.com/sdk/index.html

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Po pobraniu i rozpakowaniu, w rozpakowanym katalogu powinnimy zobaczy katalogi eclipse,

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Uruchamiamy rodowisko Eclipse z podkatalogu eclipse. Podczas uruchamiania program zapyta

Po pierwszym uruchomieniu powinnimy zobaczy taki ekran powitalny:

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Zamykamy go. Powinnimy teraz zobaczy mniej wicej taki widok:

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Nowe parametry bd obowizywa on nastpnego uruchomienia Eclipse, warto wic go

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Konfiguracja wirtualnych urzdze

Pojawi nam si lista dostpnych wirtualnych urzdze, tymczasowo pusta.

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Klikamy przycisk New i wprowadzamy konfiguracj urzdzenia. Moesz wzorowa si na tym

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Struktura katalogw w aplikacji

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Tworzenie podstawowej aplikacji

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Przechodzimy dalej. Na kolejnym ekranie mamy moliwo wyboru sposobu wywietlania

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Po zakoczeniu powinnimy zobaczy klas naszej aktywnoci:

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Kiedy klikniemy na zakadk z naszym plikiem layoutu ( na poprzedniej ilustracji u mnie to

Na ten moment zostawiamy tradycyjne Hello World i uruchomimy aplikacj na emulatorze i

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Zaznaczam swj telefon i wybieram Ok. Po odpaleniu:

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Korzystanie z komponentw wizualnych w kodzie

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Przejdmy teraz do kodu aktywnoci. Aby korzysta z przyklejonych komponentw, musimy

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Po uruchomieniu wyglda to tak:

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Obsuga i konfiguracja podstawowych komponentw graficznych.

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Zasoby tekstowe wykorzystanie pliku strings.xml

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Lepszym rozwizaniem bdzie odnalezienie pliku strings.xml znajdujcego si w katalogu values

Programowanie aplikacji na platform Android v 1.0. A.Klusiewicz www.jsystems.pl

Kiedy go wyedytujemy, powinnimy zobaczy tak zawarto: