You are on page 1of 27

c 


     
 

Version 4.4

Copyright © 2009 - 2010 Lars Vogel

06.12.2010

  


Revision 0.1 04.07.2009 Lars Vogel
Created
Revision 0.2 - 4.4 07.07.2009 - 06.12.2010 Lars Vogel
bug fixing and enhancements

 
  c   


This tutorial describes how to create Android applications with Eclipse. It is based on
Eclipse 3.6, Java 1.6 and Android 2.3 (Gingerbread).

    

1. Android Development
1.1. Android Operation System
1.2. Important Android components
1.3. AndroidManifest.xml
1.4. R.java, Resources and Assets
1.5. Activities and Layouts
1.6. Activities and Lifecyle
1.7. Context
2. Installation
2.1. Android SDK
2.2. Eclipse
2.3. Configuration
2.4. Device
3. Error handling
4. Your first Android project
4.1. Create Project
4.2. Two faces of things
4.3. Create attributes
4.4. Add UI Elements
4.5. Maintain UI properties
4.6. Code your application
4.7. Start Project
4.8. Using the home menue
5. Lists
5.1. Overview
5.2. Simple ListActivities
5.3. ListActivities with own layout
5.4. ListActivities with flexible layout
6. Menu, Preferences and Intents
6.1. Project
6.2. Add a menu
6.3. Using preferences
6.4. Run
7. ContentProvider
7.1. Overview
7.2. Create contacts on your emulator
7.3. Example
8. ScrollView
9. Services and Broadcast Receiver
10. Important views
10.1. LogCat View
10.2. File explorer
11. Shell
11.1. Android Debugging Bridge - Shell
11.2. Uninstall an application via adb
11.3. Emulator Console via telnet
12. Deploy your application on a real device
13. Thank you
14. Questions and Discussion
15. Links and Literature
15.1. Source Code
15.2. Android Resources
15.3. vogella Resources

1.c  
 
1.1.c !
  "  

Android is an operating system based on Linux with a Java programming interface. It


provides tools, e.g. a compiler, debugger and a device emulator as well as its own Java
Virtual machine (Dalvik Virtual Machine - DVM). Android is created by the Open
Handset Alliance which is lead by Google.

Android uses a special Java virtual machine (Dalvik). Dalvik uses special bytecode.
Therefore you cannot run standard Java bytecode on Android. Android provides a tool
"dx" which allows to convert Java Class files into "dex" (Dalvik Executable) files.
Android applications are packed into an .apk (Android Package) file. To simplify
development Google provides the Android Development Tools (ADT) for Eclipse . The
ADT performs automatically the conversion from class to dex files and creates the apk
during deployment.

Android supports 2-D and 3-D graphics using the OpenGL libraries and supports data
storage in a SQLLite database.
Every Android applications runs in its own process and it isolated from other running
applications. Therefore on misbehaving application cannot harm other Android
applications.

1.2.#
  c 
  

An Android application consists out of the following parts:


Y Activity - Represents the presentation layer of an Android application, e.g. a
screen which the user sees. An Android application can have several activities
and it can be switched between them during runtime of the application. The User
interface of an Activities is build with widgets classes which inherent from
"android.view.View". The layout of the views is managed by ViewGroups.

Y Services - perform background activities without providing an UI. They can
notify the user via the notification framework in Android.

Y Content Provider - provides data to applications, via a content provider your
application can share data with other applications. Android contains a SQLLite
DB which can serve as data provider

Y Intents allow the application to request and / or provide functionality from other
services or activities. An application can call directly a service or activity
(explicit intent) or asked the Android system for registered services and
applications for an intent (implicit intents). For example the application could
ask via an intent for a contact application. Application register themself via an
IntentFilter. Intents are a powerful concept as they allow to create loosely
coupled applications.

Y Broadcast Receiver - receives system messages and implicit intents, can be used
to react to changed conditions in the system. An application can register as a
broadcast receiver for certain events and can be started if such an event occurs.

Other Android parts are Android widgets or Live Folders and Live Wallpapers . Live
Folders display any source of data on the homescreen without launching the
corresponding application.

1.3.c $  .x 

An Android application is described the file "AndroidManifest.xml". This files must


declare all activities, services, broadcast receivers and content provider of the
application. It must also contain the required permissions for the application. For
example if the application requires network access it must be specified here.
"AndroidManifest.xml" can be thought as the deployment descriptor for an Android
application.

Y Y Y Y Y
Y
 Y 
    Y
 Y  
  

 
 Y
YYYYYY 
 
 Y
YYYYYY 


  Y
YYYYYY 

!   Y
YYYY  
Y 
 
"#$ 
Y
 
$ " %   Y
YYYYYYYY   &Y 
  
 Y
YYYYYYYYYYYYYYYYYY  
$ " %   Y
YYYYYYYYYYYY   Y
YYYYYYYYYYYYYYYY 
Y 
   
  
'()! Y Y
YYYYYYYYYYYYYYYY 
&Y
 
   
  
&*(+! ,-. Y Y
YYYYYYYYYYYY    Y
YYYYYYYY   & Y
Y
YYYY  
 Y
YYYY Y 
 /0
1 Y Y
Y
 Y Y
Y Y Y Y

The "package" attribute defines the base package for the following Java elements.
"activity" defines an activity in this example pointing to the class
"de.vogella.android.temperature.Convert". For this class an intent filter is registered
which defines that this activity is started ion the application starts (action
android:name="android.intent.action.MAIN"). The category definition (category
android:name="android.intent.category.LAUNCHER" ) defimes that this application is
added to the application directory on the Android device. The @ values refer to
resource files which contain the actual values. This makes it easy to provide different
resources, e.g. strings, colors, icons, for different devices and makes it easy to translate
applications.

1.4..j% c 

The directory "gen" in an Android project contains generated values. "R.java" is a


generated class which contains references to resources of the "res" folder in the project.
System resources are maintained in the "res" directory and can be values, menus,
layouts, icons or pictures or animations. These resources can for example be text or
icons. If you create a new resources the corresponding reference is automatically
created in R.java. The references are static int values, the Android system provides
methods to access the corresponding resource. For example to access a String with the
reference id "R.string.yourString" use the method getString(R.string.yourString));
Please do not try to modify "R.java" manually. While "res" contains structured values
which are known to the Android platform the directory "assets" can be used to store any
kind of data. In Java you can access this data via the AssetsManager and the method
getAssets().

1.5.c    

The user interface for Activities is defined via layouts. The layout defines the UI
elements, their properties and their arragement. A layout can be defined via XML and
via code at runtime. The XML way is usually preferred for a fixed layout while defining
the layout via code is more flexible. You can also mix both approaches.

1.6.c    

The operating system controls the life cycle of your application. At any time the
Android system may stop or destroy your application, e.g. because of an incoming call.
The Android system defines a life cycle for an activities via pre-defined methods. The
most important methods are:

Y onSaveInstanceState() - called if the activity is stopped. Used to save data so
that the activity can restore its states if re-started

Y onPause() - always called if the Activity ends, can be used to release ressource
or save data

Y onResume() - called if the Activity is re-started, can be used to initiaze fields

1.7.  x 

The class android.content.Context provides the connections to the Android system.


Contexts provides the method getSystemService which allows to receive a manager
object for the different hardware parts. As Activities and Services extend this class you
can directly access the context via "this".

2.#     
The following assume that you have already Eclipse installed. For details please see
Eclipse Tutorial .

2.1.c "&

Download the Android SDK from the Android homepage under Android SDK
download . The download contains a zip file which you can extract to any place in your
file system, e.g. I placed it under "c:\android-sdk-windows" .

2.2. 


Use the Eclipse update manager to install all available plugins for the Android
Development Tools (ADT) from the URL https://dl-ssl.google.com/android/eclipse/ .

2.3.    

In Eclipse open the Preferences dialog via Windows -> Preferences. Select Android and
maintain the installation path of the Android SDK.




If you maintain the location the Android plugin will remind you frequently (and for
every workspace). Join me in starring at Bug 3210 to get this improved.

Select now Window -> Android SDK and AVD Manager from the menu.

Select available packages and select the latest version of the SDK.
Press "Install selected" and confirm the license for all package. After the installation
restart Eclipse.

2.4.

You need to define a device which can be used for emulation. Press the device manager
button, press "New" and maintain the following.

Press "Create AVD".This will create the device. To test if you setup is correct, eelect
your device and press "Start".

After (a long time) your device should be started.

3.   
Things are not always working as they should be. Several users report that get the
following errors:

1.Y Project ... is missing required source folder: 'gen'


2.Y The project could not be built until build path errors are resolved.
3.Y Unable to open class file R.java.

To solve this error select from the menu Project -> Clean.

If you having problems with your own code you can use the LogCat viewer as described
in LogCat Viewer .

4.' c 
j 
4.1.  (j 



This app is also available on the Android Marketplace. Search for "vogella" for find this
example.

Select File -> New -> Other -> Android -> Android Project and create the Android
project "de.vogella.android.temperature". Maintain the following.




I think this wizard should have the option to add the project to an existing working set.
Please stare at Android New Project Wizard should have the option to add to Working
set to get this functionality.

Press "Finish". This should create the following directory structure.

While "res" contains structured values which are known to the Android platform the
directory "assets" can be used to store any kind of data. In Java you can access this data
via the AssetsManager and the method getAssets().

4.2.   

The Android SDK allows to maintain certain artifacts, e.g. strings and UI's, in two
ways, via a rich editor and directly via XML. The following description tries to use the
rich UI but for validation lists also the XML. You can switch between the two things the
the tab on the lower part of the screen. For example:

4.3.    

Android allows to create attributes for resources, e.g. for strings and / or colors. These
attributes can be used in your UI definition via XML or in your Java source code.

Select the file "res/values/string.xml" and press "Add". Select "Color" and maintain
"myColor" as the name and "#3399CC" as the value.

Add also the following "String" attributes. String attributes allow to translate the
application at a later point.

 1."  c  


>   
buttonHandler myClickHandler
celsius to Celsius
fahrenheit to Fahrenheit
calc Calculate

Switch to the XML representation and validate that you maintained the values correctly.

Y Y Y Y Y
Y
 Y 
    Y

 Y
Y  Y  
,
Y2
3Y
4   Y
Y  Y  %  5Y
   Y
Y 

Y  &

 67711 

 Y
Y  Y  $
,  &  ,    Y
Y  Y    
Y     Y
Y  Y      
Y8     Y
Y  Y       Y

 Y
Y Y Y Y

4.4.c)#   

Select "res/layout/main.xml" and open the Android editor via double-click. This editor
allows to maintain the UI via drag and drop or directly via the XML source code. You
can switch between both representations via the tabs at the bottom of the editor. For
changing the postion and grouping elements you can use the outline view.

Delete the "Hello World, Hello!" via a right mouse click. From the "Views" bar, drag in
an "EditText". Add from the layout a "RadioGroup" and then two RadioButtons, add
one "Button". The result should look like the following and the corresponding XML is
listed below. Make sure that your code is the same as listed below.

Switch to "main.xml" and verify that your XML looks like the following.

Y Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y
Y  
&
%   %   Y
Y
- 5Y 
 "9 - 5 Y 
  "9 - 5 Y
 
&
%#  #%
  Y
 
&
%  #%
   - 5 Y
Y .
:
Y 
  "9 .
:
 Y
Y Y  
&
%#  #%
  Y
 
&
%  #%
   Y
Y Y .
;
Y 
 "9 .
;
 Y
 
  "9 .
;
 Y
Y Y Y  
&
%#  #%
  Y
 
&
%  #%
   .
;
 Y
Y Y .
;
Y 
 "9 .
;
< Y
 
  "9 .
;
< Y
Y Y Y  
&
%#  #%
  Y
 
&
%  #%
   .
;
 Y
Y .
:
 Y
Y ;
Y 
 "9 ;
 Y 
  "9 ;
 Y
Y Y  
&
%#  #%
  Y
 
&
%  #%
   ;
 Y
* *&
 Y
Y Y Y Y

4.5.$  )#

 

If you select a UI element you can change its properties via the properties view. Select
EditText and change the property "Layout Width" to "fill_parent".

Assign the "celsius" string attribute to your "text" property of the first radio button and
"fahrenheit" to the second. Set the property "Checked" to true for the first RadioButton.
Assign "calc" to the text property of your button and assign "buttonHandler" to the
"onClick" property. Delete the text property in the EditText (this means no text will be
initially shown) and set the "Input type" property to "numberSigned" and "number
decimal".

Select the complete widget and use the Properties view to set the property "background"
to the color attribute "@color/myColor".

Switch to the "main.xml" tab and verify that the XML is correctly maintained.

Y Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y 
&
%    %  Y
 
$
  "

&

  Y
Y
- 5Y 
  "9 - 5 Y
 
&
%  #%
  Y
 
&
%#   %  Y
 
 5& $/  = $>   - 5 Y
Y .
:
Y 
  "9 . 
:
 Y
Y Y  
&
%#  #%
  Y
 
&
%  #%
   Y
Y Y .
;
Y 
  "9 .
;
 Y
Y Y Y  
&
%#  #%
  Y
 
&
%  #%
  Y 
 "   Y
 
    .
;
 Y
Y Y .
;
Y 
  "9 .
;
< Y
Y Y Y  
&
%#  #%
  Y
 
&
%  #%
  Y
 
 "     .
;
 Y
Y .
:
 Y
Y ;
Y 
  "9 ;
 Y
Y Y  
&
%  #%
  Y
 

  " $
,  Y
 
&
%#  #%
  Y
 
 "   ;
 Y
* *&
 Y
Y Y Y Y

4.6. 

  

Change your code in "Convert.java" to the following. Note that the "myClickHandler"
will be called based on the "On Click" property of your button.

Y Y Y Y Y
Y
 
? Y
Y

Y 
(  &? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# - 5? Y

Y 
# .
;
? Y

Y 
# 5
? Y
Y
$ YY
Y Y(  &Y@ Y
Y  Y- 5Y? Y
Y
Y "A Y
Y $ Y
Y
B; Y)  /CY@ Y
Y Y 
B)  /C? Y
Y Y 
 0 #B.&
 C? Y
Y Y Y YB- 5CY 0 #;&)B. - 5C? Y
Y
Y DY
Y
Y Y5 Y
Y YYY$
Y Y$Y#Y  Y
Y Y
Y Y
Y Y A Y  Y
& Y
YY$
Y
Y $ Y
Y&  , B0 #Y #CY@ Y
Y Y # YB #)BCCY@ Y
Y Y Y. ;
 Y
Y Y Y .
;
Y ;
Y YB.
;
CY
 0 #;&)B. .
;
C? Y
Y Y Y .
;
Y  ;
Y YB.
;
CY
 0 #;&)B. .
;
<C? Y
Y Y Y YB5BC BCY YCY@ Y
Y Y Y Y 5
5B Y
Y Y Y Y Y Y  3Y
Y Y Y Y Y Y EY YY Y
$ 3Y5
*-!:5,%*A!:C
#BC? Y
Y Y Y Y  ?Y
Y Y Y DY
Y Y Y Y
Y Y Y 
Y 0Y Y
8
8
B5BC
/ BCC? Y
Y Y Y YB ;
  BCCY@ Y
Y Y Y Y 5B/  Y
Y Y Y Y Y
Y AB
8  5
 B 0C CC?Y
Y Y Y DYY@Y
Y Y Y Y 5B/  Y
Y Y Y Y Y
Y AB
  5
8  B 0CCC? Y
Y Y Y DY
Y Y Y Y/# Y
YY
Y$
Y
Y Y Y YB  ;
  BCCY@ Y
Y Y Y Y   ;
 BC? Y
Y Y Y Y  ;
 BC? Y
Y Y Y DYY@Y
Y Y Y Y   ;
 BC? Y
Y Y Y Y  ;
 BC? Y
Y Y Y DY
Y Y Y $?Y
Y Y DY
Y DY
Y
Y Y
Y
Y  Y
Y  Y
Y
8  5
 B
Y  CY@ Y
Y Y  YBB  Y Y7<CYFYGYY1C? Y
Y DY
Y
Y Y
Y
Y    Y
Y  Y
Y
  5
8  B
Y CY@ Y
Y Y  YBB YFY1CYYGCY9Y7<? Y
Y DY
DY
Y Y Y Y

4.7."  (j 

To start the Android Application, select your project, right click on it, Run-As->
Android Application Be patient, the emulator starts up very slow. You should get the
following result.

Type in a number, select your conversion and press the button. The result should be
displayed and the other option should get selected.

4.8.)     

If you press the Home button you can also select your application.
5. 
5.1.!

List can be used to display a scrollable list of items. You can either use lists in your
layout or if the purpose of your Activity is to show primary a list you can extend
ListActivities which provides nice hocks for typical actions for lists.

5.2."
 c  

A ListActivity extends Activity and simplifies the approach to show several objects in a
list. It extends the standard Activity with a standard ListView Elements, callbacks for
list events, e..g for selecting a list element and helper methods to access the current list
position and the selected element(s).

To test this create a new Android project "de.vogella.android.listactivity" with the


activity "MyList". You do not need to change the default layout "main.xml". Create the
following activity.

Y Y Y Y Y
 
   &? Y
Y

Y 
* (  &? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# (&(? Y

Y 
# * 0 #? Y

Y 
# 5
? Y
Y
$ YY'&* Y  Y* (  &Y@ Y
Y
Y FFY Y# YY  &Y Y YYF Y
Y $ Y
Y
B; Y  CY@ Y
Y Y 
B  C? Y
Y Y Y Y Y&Y
Y/ 3YY# Y$YY
Y
Y
* (  & Y
Y Y / HIY Y Y #Y/ HIY@Y *  3Y 2 
#J 3Y
-  3Y / 3Y +$  3Y /
  3Y ( 
 3Y E
 D? Y
Y Y Y Y Y(&(3YY# Y&YYY
/ Y$
 Y
Y Y YY YY* 0 # Y
Y Y  * (B #Y(&( / B 3 Y
Y Y Y
Y  
.&
 % % %3Y CC? Y
Y DY
Y
Y "A Y
Y 
Y
Y
* )  B* 0 #Y3Y0 #Y3Y Y

 
3Y
Y CY@ Y
Y Y 
* )  B3Y3Y
 
3Y C? Y
Y Y Y:YY YY#Y  Y
Y Y A$KY
Y Y * (BC)B
 
C? Y
Y Y / Y&#
Y Y

/ BC? Y
Y Y 5
5B 3Y L
YY Y9Y&#
3Y
5
*-!:5,%*A!:C Y
Y Y Y Y 
#BC?Y
Y DY
DY
Y Y Y Y

5.3. c      

The example above is boring, as only text is shown. You can also define your own
layout for the rows and assign this layout to your row adapter. We will add a graphic to
each list entry.

Create the following layout file "rowlayout.xml" in the res/layout folder of your project
"de.vogella.android.listactivity".

Y Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  
&
%#  #%
  Y
 
&
%  #%
   Y
Y )0 #Y 
  "9  
Y
 
&
%  #%
  Y 
 "#$ 
Y
 
&
%#  << Y 
&
% 5
 M Y
 
&
% .  M Y 
&
% * M  Y
Y Y )0 # Y
Y 50 #Y  
 "9 50 # Y
 
&
%#  #%
  Y
 
&
%  #%
  Y 
  "9 $ Y
 
/ N 7  50 # Y
* *&
 Y
Y
Y Y Y Y

Change your activity "MyList" to the following. This is almost the same coding as in
the previous example, the only difference is that we are using our own layout in the
ArrayAdapter and telling the adapter which UI element should contains the text.

Y Y Y Y Y
Y
 
   &<? Y
Y

Y 
(  &? Y

Y 
* (  &? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# (&(? Y

Y 
# * 0 #? Y

Y 
# 5
? Y
Y
$ YY'&*&
* Y Y* (  &Y@ Y
Y
Y FFY Y# YY   &Y Y YYF Y
Y $ Y
Y
B; Y  CY@ Y
Y Y 
B  C? Y
Y Y Y Y Y&Y
Y/ 3YY# Y$YY
Y
Y
* (  & Y
Y Y / HIY Y Y #Y/ HIY@Y *  3Y 2 
#J 3Y
-  3Y / 3 Y
Y Y Y Y +$  3Y /
   3Y ( 
 3Y E
 Y
D?Y
Y Y Y+Y&
Y
# Y&
Y Y
YYY
YY+)Y
 Y# Y
 YY$ Y
Y Y  * (B #Y(&( / B 3Y
.&

#&
3 Y
Y Y Y Y . $3Y CC? Y
Y DY
Y
Y "A Y
Y 
Y
Y
* )   B* 0 #Y3Y0 #Y3Y Y

 
3Y
Y CY@ Y
Y Y 
* )  B3Y3Y
 
3Y C? Y
Y Y Y:YY YY#Y  Y
Y Y A$KY
Y Y * (BC)B
 
C? Y
Y Y / Y&#
Y Y

/ BC? Y
Y Y 5
5B 3Y L
Y Y Y9Y&#
3Y
5
*-!:5,%*A!:C Y
Y Y Y Y 
#BC?Y
Y
Y DY
DY
Y Y Y Y

5.4. c    x   

The above example uses one layout for all rows. If you want to influence the display of
the different rows you can also define your own adapter and implement your own
getView() method. This method is responsible for creating the listview. In this method
we will read the pre-defined layout via LayoutInflator and return one individual view
per row.

Create the following class "MyArrayAdapter.java".

Y Y Y Y Y
Y
 
   &? Y
Y

Y 
(  &? Y

Y 
 #*&
) ? Y

Y 
 #0 #? Y

Y 
 #0 #:
? Y

Y 
# (&(? Y

Y 
# )0 #? Y

Y 
# 50 #? Y
Y
$ YY'&(&(Y Y(&( / Y@ Y
Y  Y Y(  &Y
? Y
Y  Y Y/ HIY ? Y
Y
Y $ Y'&(&(B(  &Y
3Y/ HIY CY@ Y
Y Y B
3Y.&

#&
3Y C? Y
Y Y  
Y Y
? Y
Y Y   Y Y ? Y
Y DY
Y
Y "A Y
Y $ Y0 #Y0 #B Y
 
3Y0 #Y
0 #3Y0 #: 
Y
 CY@ Y
Y Y *&
) Y Y Y
*&
) BC? Y
Y Y 0 #Y
#0 #Y Y  B.&

#&
3Y
3YC? Y
Y Y Y
Y Y 50 #Y$Y YB50 #CY

#0 # 0 #;&)B. $C? Y
Y Y $5B H
 
IC? Y
Y Y /&
  B H
 
IC? Y
Y Y Y  YY 
Y
Y2 
#Y Y E
 Y
Y Y YB H
 
I2 B 2 
#J CY==YY
H
 
I2 B E
 CYCY@ Y
Y Y Y )0 #Y 0 #Y YB)0 #CY

#0 # 0 #;&)B.  
C? Y
Y Y
Y 0 #).
B.#$%# 
#%OC? Y
Y Y DYY
Y Y Y
Y Y  Y
#0 #? Y
Y DY
Y
DY
Y
Y Y Y Y
Y Y Y Y Y
Y
 
   &? Y
Y

Y 
* (  &? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# * 0 #? Y

Y 
# 5
? Y
Y
$ YY'&* Y Y* (  &Y@ Y
Y
Y FFY Y# YY  &Y Y YYF Y
Y $ Y
Y
B; Y  CY@ Y
Y Y 
B  C? Y
Y Y Y Y Y&Y
Y/ 3YY# Y$YY
Y
Y
* (  & Y
Y Y / HIY Y Y #Y/ HIY@Y *  3Y 2 
#J 3Y
-  3Y / 3Y +$  3Y /
  3Y ( 
 3Y E
 D? Y
Y Y  * (B #Y'&(&(B 3Y CC? Y
Y DY
Y
Y "A Y
Y 
Y
Y
* )  B* 0 #Y3Y0 #Y3Y  Y

 
3Y
Y CY@ Y
Y Y 
* )  B3Y3Y
 
3Y C? Y
Y Y Y:YY YY#Y  Y
Y Y A$KY
Y Y * (BC)B
 
C? Y
Y Y / Y&#
Y Y

/ BC? Y
Y Y 5
5B 3Y L
YY Y9Y&#
3Y
5
*-!:5,%*A! :CY
Y Y Y Y 
#BC?Y
Y DY
DY
Y Y Y Y
6.$ %(  #  
6.1.(j 

This chapter will demonstrate how to create and evaluate a menu, how to define
preferences and how to navigate between activities via an intent . Create a project
"de.vogella.android.preferences" with the activity "HelloPreferences". Change the UI in
the file "/res/layout/main.xml" to the following:

Y Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y
Y  
&
%   %   Y
Y ;
Y 
  "9 ;
 Y
 
&
%#  #%
  Y
Y Y  
&
%  #%
  Y 
 /
#Y
E   ;
 Y
* *&
 Y
Y
Y Y Y Y

6.2.c  

Menus can be defined via XML files. Select your project, right click on it and select
New -> Other -> Android -> "Android XML File".

Press Add and select "Item". Maintain the following value. This defines the entries in
your menu. We will have only one entry.

Change your class "HelloPreferences" to the following. The OnCreateOptionsMenu


method is used to create the menu. Please note that at the moment nothing happens if
you select this menu. The behavior will be later implemented in the method
"onOptionsItemSelected".

Y Y Y Y Y
Y
 
 ? Y
Y

Y 
(  &? Y

Y 

; ? Y

Y 
 #' ? Y

Y 
 #' ) ? Y
Y
$ YY,
E Y Y(  &Y@ Y
YYYYFFY Y# YY  &Y Y YYF Y
YYYY"A  Y
YYYY$ Y
Y
B; Y)  /CY@ Y
YYYYYYYY
B)  /C? Y
YYYYYYYY
 0 #B.&
 C? Y
YYYYDY
YYYY"A  Y
YYYY$ Y$

 Y
A
' B' Y CY@ Y
YYYYY ' ) Y Y Y' ) BC? Y
YYYYY  B.  3Y C? Y
YYYYY  Y? Y
YYYYDY
DY
Y Y Y Y

Run your application and press "Menu" on the emulator. Your menu should be
displayed.

6.3.) 
 

Preference values can also be stored as a XML resource. Create another Android XML
File "preferences.xml" this time of type preferences.

Press Add, add a category and add two preferences "EditTextPreferences" to this
category : "User" and "Password".

Create the class "Preferences" which will load the "preference.xml".

Y Y Y Y Y
Y
 
 ? Y
Y

Y 

; ? Y

Y 
 E (  &? Y
Y
$ YYE Y YE (  &Y@ Y
Y
Y FFY Y# YY  &Y Y YYF Y
Y "A Y
Y $ Y
Y
B; Y )  /CY@ Y
Y YYYY
B)  /C? Y
Y YYYYE 8
.
B. C? Y
Y DY
Y Y
Y Y
Y
DY
Y
Y Y Y Y

Select "AndroidManifest.xml" and the tab "Application". Add the activity


"Preferences".

To use the preferences add a button to your main.xml with the id "@+id/Button01" and
change the coding of HelloPreferences to the following.

Y Y Y Y Y
Y
 
 ? Y
Y

Y 
(  &? Y

Y 

 )  ? Y

Y 

 /E ? Y

Y 

; ? Y

Y 
 E ' ? Y

Y 
 #' ? Y

Y 
 #' ) ? Y

Y 
 #' )? Y

Y 
 #0 #? Y

Y 
 #0 #A  *  ? Y

Y 
# ;
? Y

Y 
# 5
? Y
Y
$ YY,
E Y Y(  &Y@ Y
Y /E Y ? Y
Y
Y FFY Y# YY  &Y Y YYF Y
Y "A Y
Y $ Y
Y
B; Y)  /CY@ Y
Y Y 
B)  /C? Y
Y Y 
 0 #B.&
 C? Y
Y Y ;
Y$
Y YB;
CY 0 #;&)B. ;
C? Y
Y Y Y)   N Y  Y
Y Y  Y Y
E ' >/E B C? Y
Y Y Y
Y Y $
A  *  B #YA  *  BCY@ Y
Y
Y Y Y "A Y
Y Y Y $ Y
Y
 B0 #YCY@ Y
Y Y Y Y / Y Y Y
 / B   3Y  C? Y
Y Y Y Y / Y#
Y Y
 / B #
 3Y  C? Y
Y Y Y Y 5
5B,
E  3 Y
Y Y Y Y Y Y L
Y  YY Y9Y
 Y9Y Y Y#
Y Y9Y#
3 Y
Y Y Y Y Y
Y 5
*-!:5,%*A!:C
#BC? Y
Y
Y Y Y DY
Y Y DC?Y
Y DY
Y
Y "A Y
Y $ Y$

 Y
A
' B' Y CY@ Y
Y Y ' ) Y Y Y' ) BC? Y
Y Y  B.  3Y C? Y
Y Y  Y? Y
Y DY
Y
Y Y5 Y
Y YY
YY Y Y Y
Y "A Y
Y $ Y$

 Y
A
)/B' )Y CY@ Y
Y Y # YB ))BCCY@ Y
Y Y Y2YY
&Y
Y Y

Y
Y Y Y.   Y
Y Y Y Y* YE Y  & Y
Y Y Y )  Y Y Y #Y)  B,
E  3Y
E C? Y
Y Y Y (  &B C? Y
Y Y Y Y(Y
Y YY #Y
 YYP Y  Y
Y
YY Y
Y Y Y 5
5B,
E  3 Y
Y Y Y Y Y ,Y&
Y Y  Y&
YY
   3 Y
Y Y Y Y Y 5
*-!:5,%*A!:C
#BC? Y
Y Y Y $?Y
Y
Y Y DY
Y Y  Y? Y
Y DY
DY
Y Y Y Y

6.4. 

Run your application. Press the "menu" hardware button and then select your menu item
"Preferences". You should be able to enter your user settings then press the back
hardware button to return to your main activity and press the button. The saved values
should be displayed in a small message windows (Toast).

7.   (
7.1.!

ContentProvider are used to provide data from an application to another.


ContentProvider do not store the data but provide the interface for other applications to
access the data.

The following example will use an existing context provider from "Contacts".

7.2.        

Select the home menu and then the menu entry "Contacts" to create contacts.
Press Menu and select "New Contact".

As a result you should have a few new contacts.

7.3.x


Create a new Android project "de.vogella.android.contentprovider" with the activity


"ContactsView".

Rename the id of the the existing TextView from the example wizard to "contactview".
Delete the default text. Also change the layout_height to "fill_parent".

The resulting main.xml should look like the following.

Y Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y
Y  
&
%   %   Y
Y 50 #Y 
&
%#   %  Y
Y Y  
&
%   %  Y
 
  "9 
 # Y Y
* *&
 Y
Y
Y Y Y Y

In AndroidManifest.xml add the User Permission that the application can use
"android.permission.READ_CONTACTS".

Change the coding of the activity.

Y Y Y Y Y
Y
 

 
 ? Y
Y

Y 
(  &? Y

Y 
$ 
? Y

Y 
 + ? Y

Y 

; ? Y

Y 

 

? Y

Y 
# 50 #? Y
Y
$ YY
0 #Y Y(  &Y@ Y
Y FFY Y# YY  &Y Y YYF Y
Y "A Y
Y $ Y
Y
B; Y)  /CY@ Y
Y Y 
B)   /C?Y
Y Y 
 0 #B.&
 C? Y
Y Y 50 #Y
0 #Y YB50 #CY
 0 #;&)B. 
 #C? Y
Y
Y Y 
Y
Y Y
BC? Y
Y
Y Y # YB

5
!BCCY@ Y
Y
Y Y Y / Y &!Y Y
/ B
 Y
Y Y Y Y
Y 
 ) B

>>)/E*(L%!('-CC? Y
Y Y Y 
0 # B !Y C? Y
Y Y Y 
0 # B &!C? Y
Y Y Y 
0 # B Q C?Y
Y Y DY
Y DY
Y
Y  Y 
Y
BCY@ Y
Y Y Y. YP& Y
Y Y + Y Y Y


 A!5-!5%+.)? Y
Y Y / HIY
K
Y Y #Y/ HIY@Y



%)>3 Y
Y Y Y Y


>)/E*(L%!('-Y
D?Y
Y Y / Y
Y Y



)!%0)/);*-%:.A+EY9Y Y YR Y
Y Y Y Y 9YB  CY9Y R ? Y
Y Y / HIY
(Y Y ? Y
Y Y / Y
AY Y



>)/E*(L%!('- Y
Y Y Y Y 9Y Y A**(5-Y*A (*)S->Y(/ ? Y
Y
Y Y  Y T&B 3Y
K
3Y
3Y

(3 Y
Y Y Y Y 
AC? Y
Y DY
Y
DY
Y Y Y Y

8." 
ScrollViews can be used to contain one child that might be to big to fit on one screen. If
the child is to big the ScrollView will display a scroll bar to scroll the context. Of
course the child can be a layout which can then contain other elements.

Create an android project "de.vogella.android.scrollview" with the activity


"ScrollView". Create the following layout and class.

Y Y Y Y
Y
 Y 
    Y
/
0 #Y  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y
Y  
&
%   %  Y
 
 0 #
   Y
Y
* *&
Y 
  "9 * *&
 Y
 

  
  Y 
&
%#   %  Y
 
&
%  #%
   Y
Y 50 #Y 
  "9 50 # Y
 
&
%#  #%
  Y
 
&
%  #%
  Y 
 5 Y YY Y
 
(   
( * Y
 
 *   Y 
  .    Y
 
 5
    50 # Y
Y 50 #Y 
 "9 50 #< Y
 
  "9 50 #< Y 
&
%#  #%
  Y
 
&
%   %  Y
 
&
%#    50 # Y
Y Y
Y * *&
 Y 
  "9 * *&
< Y
 
&
%#  #%
  Y
 
&
%  #%
   Y
Y Y ;
Y 
  "9 ;
 Y
 
&
%#  #%
  Y
 
&
%  #%
  Y 
 /$  Y
 
&
% #    ;
 Y
Y Y ;
Y 
  "9 ;
< Y
 
&
%#  #%
  Y
 
&
%  #%
  Y 
   Y
 
&
%#    ;
 Y
Y * *&
 Y
* *&
 Y
/
0 # Y
Y
Y Y Y
Y Y Y Y
Y
 

 #? Y
Y

Y 
(  &? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# 50 #? Y
Y
$ YY/
0 #Y Y(  &Y@ Y
YYYYFFY Y# YY  &Y Y YYF Y
YYYY"A  Y
YYYY$ Y
Y
B; Y)  /CY@ Y
YYYYYYYY
B)  /C? Y
YYYYYYYY
 0 #B.&
 C? Y
YYYYYYYY50 #Y #Y Y B50 #CY
 0 #;&)B. 50 #<C? Y
YYYYYYYY/ Y ? Y
YYYYYYYY
YB Y ?Y Y Y?Y 99CY@ Y
YYYYYYYYY Y9 Y 
Y ? Y
YYYYYYYYDY
YYYYYYYY #5BC? Y
YYYYDY
DY
Y Y Y

The attribute "android:fillViewport="true"" ensures that the the scrollview is set to the
full screen even if the elements are smaller then one screen and the "layout_weight" tell
the android system that these elements should be extended.
ë." * 
The Android platform provides a lot of pre-defined services, usually exposed via a
Manager class. In this chapter we will use the AlertManager and VibratorManager. The
alarm manager will in our example our own broadcast receiver.

Create a new project "de.vogella.android.alarm" with the activity "AlarmActivity".


Create the following layout.

Y Y Y Y
Y
 Y 
    Y
* *&
Y
  
  

 
 Y
Y  

  
  Y
 
&
%#   %  Y
Y  
&
%   %   Y
Y Y
Y
- 5Y 
&
%#  #%
  Y
 
&
%  #%
  Y 
  "9   Y
 
  !$Y
Y
 Y
 
 5& $>   - 5 ;
Y
 
&
%#  #%
  Y
 
&
%  #%
  Y 
  "9 
 Y
 

  ( Y 
 /Y
   ;
 Y
Y
* *&
 Y
Y
Y Y Y

Create the following broadcast receiver class. This class will get the Vibrator service.

Y Y Y Y
Y
 
? Y
Y

Y 

 ;
. ? Y

Y 

 
? Y

Y 

 )  ? Y

Y 

0 $
? Y

Y 
# 5
? Y
Y
$ YY'&;
. Y Y ;
. Y@ Y
Y "A Y
Y $ Y
Y
. B
Y
3Y)  Y  CY@ Y
Y Y 5
5B
3Y >
RY Y$Y&
Y Y Y
4444 3 Y
Y Y Y Y 5
*-!:5,%*A!:C
#BC? Y
Y Y Y0 $YY
$ Y
 Y
Y Y 0 $
Y $
Y YB0 $
CY

/&/ B
0);.(5A.%/-.0) -C? Y
Y Y  $
 $B<C? Y
Y DY
Y
DY
Y
Y Y Y

Maintain this class as broadcast receiver in "AndroidManifest.mf" and allow the vibrate
authorization.

Y Y Y Y
Y
 Y 
    Y
 Y   
  

 
 Y
Y  
 
 Y 


  Y
Y  

!   Y
Y  
Y 
 
"#$ 
Y
 
$ " %   Y
Y Y   &Y 
  ( (  & Y
 
$ " %   Y
Y Y Y   Y
Y Y Y Y 
Y
 
   
  
'()! Y Y
Y Y Y Y 
&Y
 
   
  
&*(+! ,-. Y Y
Y Y Y    Y
Y Y   & Y
Y Y  Y 
  '&;
 .  Y
 
 $   Y
Y Y   Y
Y  
 Y
Y Y 
 /0
 Y Y
Y
Y
 
Y 
   
 
0);.(5-   
 
 Y
 Y Y
Y
Y
Y Y Y

Now define your main Activitiy. This activity will create an Intent for the Broadcast
receiver and get the AlarmManager service.

Y Y Y Y Y
Y
 
? Y
Y

Y 
(  &? Y

Y 
(' ? Y

Y 
E  )  ? Y

Y 

 )  ? Y

Y 

; ? Y

Y 
 #0 #? Y

Y 
# - 5? Y

Y 
# 5
? Y
Y
$ YY((  &Y Y(  &Y@ Y
Y FFY Y# YY  &Y Y YYF Y
Y "A Y
Y $ Y
Y
B; Y)   /CY@Y
Y Y 
B)  /C? Y
Y Y 
 0 #B.&
 C? Y
Y DY
Y
Y $ Y
Y(B0 #Y #CY@ Y
Y Y - 5YY YB- 5CY 0 #;&)B.  C? Y
Y Y Y Y Y) ) B5BC
/ BCC? Y
Y Y )  Y  Y Y #Y)   B 3Y
'&;
. C? Y
Y Y E  )  Y  )  Y Y
E  )  ;
B Y
Y Y Y Y  ( 

BC3Y<7M7<M<M73Y
 3YC? Y
Y Y (' Y' Y YB(' CY
/&/ B(*(.'%/-.0) -C? Y
Y Y ' B(' .5 %2(U-+E3Y
/& 5 '  BC Y
Y Y Y Y 9YB YFYC3Y  )  C? Y
Y Y 5
5B 3Y (YY Y Y9Y Y9Y Y
 3 Y
Y Y Y Y 5
*-!:5,%*A!:C
#BC? Y
Y DY
Y
DY
Y Y Y Y

10.#
  
10.1.  

You can see the log (including System.out.print() statements) via the LogCat view.

10.2. x


The file explorer allows to see the files on the android simulator.

11." 
11.1.c  *" 

You can access your Android emulator also via the console. Open a shell, switch to
your "android-sdk" installation directory into the folder "tools". Start the shell via the
following command "adb shell".

Y Y Y Y $Y Y
Y
Y Y Y Y

This will connect you to your device and give you Linux command line access to the
underlying file system, e.g. ls, rm, mkdir, etc. The application data is stored in the
directory "/data/data/package_of_your_app".

If you have several devices running you can issue commands to one individuel device.
Y Y Y Y Y
6Y* YY  Y
$Y Y
6.Y
* Y
Y Y Y

GGGMY Y

GGGGY Y
6Y)YY
 Y
YY  Y  Y
$YY
 GGGMY Y
Y
Y Y Y Y

11.2.)     

  

You can uninstall an android application via the shell. Switch the the data/app directory
(cd /data/app) and simply delete your android application.

11.3.         

Alternatively to adb you can also use telnet to connect to the device. This allows you to
simulate certain things, e.g. incoming call, change the network "stability", set your
current geocodes, etc. Use "telnet localhost 5554" to conntect to your simulated device.
To exit the console session, use the command "quit" or "exit".

For example to change the power settings of your phone, to receive an sms and to get an
incoming call make the following.

Y Y Y Y Y
6Y
Y
Y  Y
 Y

YGGGM Y
6YYY
#Y Y

#YY Y

#YY  Y
6YYYY
YY  Y
YY<M<17<7 Y
6Y YYY
YY  Y
Y Y<7MGY2 Y$Y
Y

Y
6YYY
Y

Y
Y
Y Y Y Y

For more information on the emulator console please see Emulator Console manual

12.


    


Turn on "USB Debugging" on your device in the settings. Select in the settings
Applications > Development, then enable USB debugging. You also need to install the
driver for your mobile phone. For details please see Developing on a Device . Please
note that the Android version you are developing for must be the installed version on
your phone.

To select your phone, select the "Run Configurations", select "Manual" selection and
select your device.
13.  +
Y