Witamy w kodach źródłowych stworzonych z myślą o książce Pro Android 3!!

Jest to plik instruktażowy, pomagający w jak największym przyswojeniu informacji z książki.
Za jego pomocą możliwe będzie właściwe skonfigurowanie wszystkich przykładów zawartych w książce.
Nie musimy pobierać i korzystać z każdego projektu zawartego na stronie www.androidbook.com;
możemy wybrać rozdziały, którymi jesteśmy szczególnie zainteresowani.
Każdy rozdział zawiera swój własny plik (w kilku przypadkach nawet kilka),
a nazwa pliku odpowiada danemu rozdziałowi. Istnieje również możliwość pobrania
jednego spakowanego pliku zip zawierającego wszystkie rozdziały. Poniższe instrukcje
znajdują zastosowanie w obydwu sytuacjach, a różnice zostały wyjaśnione
na etapie importowania projektów do środowiska Eclipse. 

Zanim przystąpimy do procesu importowania jakiegokolwiek projektu, musimy
upewnić się, że środowisko naszej stacji roboczej jest właściwie skonfigurowane
i gotowe do odczytywania projektów. W rozdziale 2. znajdziemy informacje dotyczące
instalacji środowisk Java, Eclipse oraz Android SDK. 

Kolejną czynnością, jaką należy wykonać przed wczytaniem przykładowych projektów
jest pobranie odpowiednich platform systemu Android, za pomocą zestawu Android SDK
oraz menedżera AVD (rysunek 2.2 w książce). Jednym ze sposobów przeprowadzenia tej czynności
jest znalezienie i użycie pliku android.bat zawartego w katalogu tools zestawu Android SDK.
Drugim rozwiązaniem jest wykorzystanie opcji Android SDK and AVD Manager środowiska Eclipse.
Tak czy inaczej, musimy posiadać następujące platformy: 

	Android 1.6 (4)
	Android 2.1 (7)
	Android 2.2 (8)
	Android 2.3.3 (10)
	Android 3.0 (11)

Jeżeli zamierzamy pracować z projektami wykorzystującymi funkcje map, musimy
pobrać również dodatkowe platformy Google API, na potrzebnym nam poziomie interfejsu,
na przykład 4, 7, 8, 10 i 11.

Pobrane projekty należy importować do przestrzeni roboczej środowiska Eclipse.
Wybierzmy jakąś przestrzeń roboczą lub stwórzmy zupełnie nową. Aby utworzyć
nową przestrzeń roboczą, możemy wpisać jej nazwę w momencie uruchomienia środowiska Eclipse
(w momencie, gdy prosi o wybór przestrzeni roboczej) lub, przebywając już w tym środowisku,
kliknąć File/Switch workspace/Other... W ten sposób otworzymy okno pojawiające się w momencie
uruchomienia środowiska i możemy tu podać nazwę nowej przestrzeni roboczej, która zostanie
utworzona.

Bez względu na to, czy stworzyliśmy nową przestrzeń roboczą lub
korzystamy z już istniejącej, powinniśmy wstawić ścieżkę do lokalizacji
zestawu Android SDK w oknie Android Preferences, co zostało zademonstrowane
na rysunku 2.4 w książce.

Aby wczytać przykładowe projekty w środowisku Eclipse, korzystamy z opcji
File/Import. Rodzaj kodu źródłowego definiujemy w węźle General/Existing Projects.
Klikamy Next. Jeżeli nie rozpakowaliśmy pobranego pliku, wybieramy opcję
Select atchive file, a następnie Browse... Wyszukujemy lokalizację importowanego
pliku, zaznaczamy go i klikamy przycisk Open. Powinniśmy teraz ujrzeć wszystkie
projekty w pliku zip, które powinny być w domyśle zaznaczone. Za pomocą przycisków
oraz/lub pól wyboru wybieramy interesujące nas obiekty, a następnie klikamy przycisk
Finish. Jest to skuteczne rozwiązanie w przypadku osobnych plików zip, mieszczących
osobne rozdziały, jeżeli jednach pobraliśmy jeden, zbiorczy plik, metoda ta
okaże się nieprzydatna. Zawsze jest wyświetlana lista projektów zawartych w pliku zip,
co w przypadku tego zbiorczego pliku oznacza wyświetlenie wszystkich projektów
zawartcyh w książce. w takim przypadku lepszych rozwiązaniem jest uprzednie
rozpakowanie zbiorczego pliku zip. Podczas korzystania z opcji File/Import... wybierzemy
teraz Select root directory... i wyszukamy katalog, w którym będą umieszczone
projekty danego rozdziału. Po jego otwarciu ujrzymy listę projektów utworzonych
wyłącznie na potrzeby tego rozdziału. Jest to o wiele wygodniejsze rozwiązanie.

Istnieje możliwość, że pojawią się błędy w importowanych projektach.
Może pojawić się następujący komunikat "Android requires compiler 
compliance level 5.0. Please fix project properties". Aby rozwiązać
ten problem, kliknijmy prawym przyciskiem dany projekt w środowisku
Eclipse i wybierzmy opcję Tools/Fix Project Properties. Aby od razu
uniknąć błędów tego typu, możemy przejść do zakładki Preferences, a
następnie Java/Compiler i ustanowić zgodność kompilatora z wersją
1.5 (co oznacza, że zestaw JDK 5 posiada zgodność na poziomie 5.0).
Oczywiście, może to oznaczać, że korzystamy ze starszej wersji pakietu
Java JDK. Możemy jednak najpierw ustawić wartość 1.5 podczas wczytywania
projektu, a następnie zmienić ją na jakąś wyższą wartość (np. 1.6), dzięki
czemu środowisko Eclipse ponownie skompiluje projekt do tej wersji.
Aby móc korzystać z wersji 1.6, musimy posiadać zainstalowany pakiet
JDK w wersji 6.

Inne błędy mogą być spowodowane zmianami wprowadzonymi w dodatku Android
dla środowiska Eclipse. Na każdy błąd znajduje się jakieś rozwiązanie.
Zawsze z chęcią służymy pomoca w razie potrzeby. 

Nienajgorszym pomysłem jest oczyszczenie projektów po ich wczytaniu. W ten
sposób zostaną ponownie utworzone pliki binarne, dzięki czemu zagwarantujemy
sobie optymalne działanie aplikacji w naszym środowisku. Aby oczyścić projekt,
klikamy zakładkę Project w środowisku Eclipse i wybieramy opcję Clean...
Zaznaczamy opcję Clean all projects i zatwierdzamy przyciskiem OK. Wyczyszczenie
wszystkich projektów może zająć chwilę. Założywszy, że posiadamy zaznaczoną 
opcję Build Automatically w menu Project, środowisko Eclipse ponownie utworzy
wszystkie aplikacje znajdujące się w przestrzeni roboczej po zakończeniu
procesu oczyszczania. Jeżeli opcja Build Automatically nie została zaznaczona,
będziemy musieli samodzielnie przeprowadzić proces budowania.

Po wczytaniu projektów niezawierających błędów, możemy je już zwyczajnie
uruchomić, albo w emulatorze, albo w prawdziwym urządzeniu. Jedynym wyjątkiem
są aplikacje wykorzystujące funkcje map. W tym przypadku musimy edytować
odpowiedni plik układu graficznego, do którego wstawimy własny klucz interfejsu
map. Informacje na tego klucza znajdziemy w rozdziale 17. 

Dave jest dostępny pod adresem davemac327@gmail.com
Satya jest dostępny pod adresem satya.komatineni@gmail.com
