Android chapter01-intro

Android Development
Introduction
Notes are based on:
Unlocking Android
by Frank Ableson, Charlie Collins, and Robi Sen.
ISBN 978-1-933988-67-2
Manning Publications, 2009.
&
Android Developers
http://developer.android.com/index.html

1

Chapter 1 - Goals
THE BIG PICTURE

1. What is Android?
2. Overview development environment

2

Chapter 1 - Resources
Android’s web page
http://www.android.com/

3

What is Android?
• Android is an open-source software platform
created by Google and the Open Handset
Alliance.
• It is primarily used to power mobile phones.
• It has the capability to make inroads in many
other (non-phone) embedded application
markets.

4

What is Android?
• Android™ consists of a complete set of
software components for mobile devices
including:
– an operating system,
– middleware, and
– embedded key mobile applications
– a large market.

5

Why Android?
Listen from the project creators/developers (2.19 min)
– Nick Sears. Co-founder of Android
– Steve Horowitz. Engineering Director
– Dam Morrill. Developer
– Peisun Wu. Engineering Project Manager
– Erick Tseng. Project Manager
– Iliyan Malchev. Engineer
– Mike Cleron. Software Manager
– Per Gustafsson. Graphics Designer.
– etc…

• http://www.youtube.com/watch?v=6rYozIZOgDk&eurl=http://www.android.com/about/&feature=player_embedd
ed

• You will hear statements such as
“…currently it is too difficult to make new products … open software brings more
innovation … choices … lower costs … more applications such as family planner, my
taxes, understand my wife better, … ”

6

What is Open Handset Alliance?
• Quoting from www.OpenHandsetAlliance.com
page

• “… Open Handset Alliance™, a group of 47 technology
and mobile companies have come together to accelerate
innovation in mobile and offer consumers a richer, less
expensive, and better mobile experience.

• Together we have developed Android™, the first
complete, open, and free mobile platform.

• We are committed to commercially deploy handsets and
services using the Android Platform. “

7

Open Handset Alliance Members
Operators Software Co. Commercializat. Semiconductor Handset Manf
China Mobile Ascender Corp. Aplix Audience ACER
China Unicom eBay Noser Engineering Broadcom Corp. ASUS
KDDI Corp. Esmertec Astonishing Tribe Intel Corp. HTC
NTT DoCoMo Google Wind River Systems Marvell Tech. LG
Sprint Nextel LivingImage Omron Software Group Motorola
T-Mobile NMS Comm. … Nvidia Corp. Samsung
Telecom Italia Nuance Comm. Teleca Qualcomm ASUSTek
Telefónica PacketVideo SiRF Tech. Holdings Garmin
Vodafone SkyPop Synaptics Huawei Tech
Softbank SONiVOX Texas Instr. LG
… … AKM Semicond. Samsung
Ericsson Borqs ARM …
Atheros Comm Sony Ericsson
... Toshiba
EMP

8

See Android Developers
http://www.youtube.com/watch?v=7Y4thikv-OM

Short video (4 min.)
Showing Dave Bort
and Dan Borstein,
two members of the
Android Open Source
Project talk about
the project.

9

The Android Platform
Again, what did they say about Android?

• Android is a software environment built for mobile
devices.
• It is not a hardware platform.
• Android includes:
• Linux kernel-based OS,
• a rich UI,
• telephone functionality,
• end-user applications,
• code libraries,
• application frameworks,
• multimedia support, ...
• User applications are built for Android in Java.

10

Android’s Context: Mobile Market Player$

Stakeholders:

Mobile network operators want
Operators to lock down their networks,
controlling and metering traffic.

Device manufacturers want to
differentiate themselves with
features, reliability, and price
Device Software points.
Manufacturers Vendors
Software vendors want complete
access to the hardware to deliver
cutting-edge applications.

11

The Maturing Mobile Experience
Electronic tools of a typical business warrior

Not so long ago … Today

1. Phone 1. Smartphone
2. Pager 2. Laptop (perhaps!)
3. PDA Organizer
4. Laptop
5. Portable music player
6. No Internet access /
limited access

Tomorrow ?
12

The Maturing Mobile Experience

I want my 2015 Smartphone to act as …
Trying to answer: Tomorrow ?
1. Phone
2. Pager
3. PDA Organizer
4. High Quality Camera (still & video)
5. Portable music player
6. Portable TV / Video Player / Radio
7. Laptop
8. Play Station
9. GPS
10. Golf Caddy (ball retriever too)
11. Book Reader (I don’t read, It reads to me)
12. Car / Home / Office Key
13. Remote Control (Garage, TV, …)
14. Credit Card / Driver’s License / Passport
15. Cash on Demand
16. Cook, house chores
17. Psychologist / Mentor / Adviser
18. ????
13

Android vs. Competitors

1.Apple Inc.
2.Microsoft
3.Nokia
4.Palm
5.Research In Motion
6.Symbian

14

The Size of
the Mobile
Market
http://gizmodo.com/5489036
/cellphone-overshare

[see appendix]

15

Android Components (Stack)

• The Android stack includes a large array of
features for mobile applications.
• It would be easy to confuse Android with a
general purpose computing environment.
• All of the major components of a computing
platform are included.

16

Android Components

• Application framework enabling reuse and replacement of components
• Dalvik virtual machine optimized for mobile devices
• Integrated browser based on the open source WebKit engine
• Optimized graphics powered by a custom 2D graphics library; 3D graphics
based on the OpenGL ES specification (hardware acceleration optional)
• SQLite for structured data storage
• Media support for common audio, video, and still image formats (MPEG4,
H.264, MP3, AAC, AMR, JPG, PNG, GIF)
• GSM Telephony (hardware dependent)
• Bluetooth, EDGE, 3G, 4G, and Wi-Fi (hardware dependent)
• Camera, GPS, compass, and accelerometer (hardware dependent)
• Rich development environment including a device emulator, tools for
debugging, memory and performance profiling, and a plugin for the
Eclipse IDE
17

Android Components

18

Android Components
Video 1/3: Android’s Architecture
Presented by Mike Cleron, Google Corp. (13 min)

19
Available at: http://www.youtube.com/watch?v=QBGfUs9mQYY

Android Components
Video 2/3: Application’s Life Cycle

20
Available at: http://www.youtube.com/watch?v=fL6gSd4ugSI&feature=channel

Android Components
Video 3/3: Android’s API

Available at: http://www.youtube.com/watch?v=MPukbH6D-lY&feature=channel 21

Android Application Framework
Video:
Inside the
Android Application Framework
(about 52 min)
Presented by Dan Morrill – Google
At Google Developer Conference
San Francisco - 2008
Available at:
http://sites.google.com/site/io/inside-the-android-application-framework
Android is designed to be fast, powerful, and easy to develop for. This session
will discuss the Android application framework in depth, showing you the
machinery behind the application framework.

explains the life-cycle of an android apk. very good!
22

Android Components
Video:
An Introduction to Android
(about 52 min)
Presented by Jason Chen – Google
At Google Developer Conference
San Francisco - 2008
Available at:
http://www.youtube.com/watch?v=x1ZZ-R3p_w8

23

Why use Linux for a phone?
• Linux kernel is a proven core platform.
• Reliability is more important than performance when it
comes to a mobile phone, because voice communication is
the primary use of a phone.
• Linux provides a hardware abstraction layer, letting the upper
levels remain unchanged despite changes in the underlying
hardware.
• As new accessories appear on the market, drivers can be
written at the Linux level to provide support, just as on other
Linux platforms.

24

Dalvik Virtual Machine
• User application, cũng như các ứng dụng core Android, được
viết bằng Java và được dịch thành byte code.
• Android byte code được thông dịch tại thời gian chạy bởi
máy ảo Dalvik (Dalvik virtual machine).
• Tại sao dùng một máy ảo khác?
– Các file bytecode Android tương đương về lô-gic với Java
bytecode, nhưng chúng cho phép Android
• Chạy các ứng dụng trong môi trường ảo của riêng nó, không bị
rằng buộc bởi các hạn chế trong giấy phép của Sun
• Là một nền tảng mở mà Google và có thể cả cộng đồng mã nguồn
mở có thể cải tiến khi cần thiết.

25

Dalvik Virtual Machine
Video (61 min)
Dalvik VM Internals
Presented by Dan Borstein
At Google Developer – 2008
San francisco
Available at:
http://www.youtube.com/watch?v=ptjedOZEXPM

26

Inside Android: Intents

• Chủ đề quan trọng hay gặp trong phát triển ứng
dụng Android là Intent.
• Một Intent trong Android mô tả cái ta muốn làm.
• Có thể là
– “Tôi muốn tra cứu một mục trong contact record,” hoặc
– “Hãy mở website này,” hoặc
– “Mở màn hình khẳng định đơn đặt hàng.”
• Tầm quan trọng của intent : chúng cho phép di
chuyển điều khiển trong ứng dụng và là khía cạnh
quan trọng nhất trong lập trình Android.
27

Intents & IntentFilters

• An Intent is a declaration of need.

• Một Intent bao gồm các mẩu thông tin sau:
– action hay service muốn thực hiện,
– data – dữ liệu vào cho action/service đó, và
– category – loại component nên xử lý intent cùng với các hướng
dẫn về cách gọi activity cần gọi.

• Một IntentFilter là một trigger, một khai báo về năng lực
cung cấp hỗ trợ cho những nơi cần.

• Một IntentFilter có thể khai báo tổng quát hoặc cụ thể
về các intent mà nó có thể phục vụ.
28


• Một intent là một mô tả trừu tượng về một thao tác cần thực hiện.

• Ứng dụng quan trọng nhất của nó là cho việc gọi activity (launching of
activities), có thể coi intent là keo dán giữa các activity.
• Các tham số chính của một intent:

Action Data
Action cần thực hiện, chẳng Dữ liệu cần xử lý, chẳng hạn
hạn: ACTION_VIEW, một địa chỉ trong sổ địa chỉ,
ACTION_EDIT, biển diễn dạng môt Uri.
ACTION_MAIN, v.v..

29


Ví dụ về các cặp action/data của intent:

ACTION_VIEW content://contacts/1 – Hiện thông tin về người có id là
"1".
ACTION_DIAL content://contacts/1 – Hiện ứng dụng gọi điện thoại cho
người có id là “1”.
ACTION_VIEW tel:123 -- Hiện ứng dụng gọi điện thoại với số điện thoại
điền sẵn là 123
ACTION_DIAL tel:123 – Thực hiện quay số cho số điện thoại 123.
ACTION_EDIT content://contacts/1 – Soạn thông tin về người có id là “1”.
ACTION_VIEW content://contacts/ -- Hiện danh sách contact, cho phép
duyệt danh sách.

30

Dissecting Intents

1. Component name Tên component cần xử lý intent ( ví dụ
"com.example.project.app.MyActivity1" ).

2. Action Một string là tên của action cần thực hiện — hoặc, đối với các broadcast intent,
action đã xảy ra và đang được báo cáo kết quả (ví dụ: ACTION_VIEW, ACTION_CALL,
ACTION_TIMEZONE_CHANGED, … ).

3. Data URI của dữ liệu cần xử lý và kiểu MIME của dữ liệu đó (ví dụ tel:/216 555-1234 ,
"http://maps.google.com”, ... ).

4. Category một string chứa các thông tin bổ sung về loại component cần xử lý intent (ví
dụ CATEGORY_BROWSABLE, CATEGORY_LAUNCHER, … ).

5. Extras các cặp key-value chứa các thông tin bổ sung cần gửi cho component sẽ xử lý
intent.

6. Flags các cờ thuộc nhiều loại.
31

Delivering Intents

• Một đối tượng Intent được truyền cho
Context.startActivity() hoặc Activity.startActivityForResult()
để gọi một activity (đồng bộ) hoặc yêu cầu một activity sẵn có
làm gì đó (không đồng bộ).
• Một đối tượng Intent được truyền cho Context.startService()
để bật một service hoặc gửi lệnh mới cho một service đang
chạy.
• Có thể truyền intent cho Context.bindService() để thiết lập
kết nối giữa component đang gọi và component bị gọi. Nó có
thể bật service nếu service đó chưa phải đang chạy.

32

Intent Resolution

Có hai loại Intent:
• Explicit intent chỉ định component đích bằng tên, thường
được dùng khi một activity bật một service con hoặc chạy một
activity khác.
• Implicit intent không gọi tên component đích (trường dành
cho tên component để trống), thường được dùng để kích
hoạt các component trong các ứng dụng khác. Late binding
được áp dụng ở đây.

Mỗi khi có thể, Android sẽ gửi explicit intent cho một thực thể
của lớp đích được chỉ định.

33

Example of Intent (1)

• Following fragments calls an Intent whose job is to
invoke a built-in task (ACTION_VIEW) and explore the
Contacts available in the phone.

Intent myIntent = new Intent(
Intent.ACTION_VIEW,
Uri.parse("content://contacts/people"));

startActivity(myIntent);

34


Intent uses
ACTION_VIEW
to see
Contacts.

35


• Complete code to see Contacts.
package matos.cis493;
import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;

public class AndDemo1 extends Activity {
/** show contact list */
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.main);
Intent myIntent = new Intent( Intent.ACTION_VIEW,Uri.parse( "content://contacts/people"));
}
}

36


• Following Intent uses built-in task (ACTION_VIEW) to
explore a web page
(see new Uri value)

Intent.ACTION_VIEW,
Uri.parse("http://www.google.com"));


37


• Following Intent uses built-in task (ACTION_VIEW) to
make a phone call
(see new Uri value)

Intent.ACTION_VIEW,
Uri.parse("tel:/216 555-1234"));


38

IntentFilters
• IntentFilter định nghĩa quan hệ giữa Intent và ứng
dụng.
• IntentFilter có thể quy định cụ thể đến phần data,
hoặc phần action của intent, hoặc cả hai.
• IntentFilter còn chứa một trường được gọi là một
category. Category giúp phân loại các action.
• Ví dụ, category có tên CATEGORY_LAUNCHER
chỉ dẫn Android rằng Activity chứa IntentFilter này
cần được nhìn thấy tại home screen.

39

IntentFilters
• Khi một Intent được phát đi, hệ thống sẽ đánh giá
các Activity, Service hiện có, và các
BroadcastReceiver đã được đăng kí, rồi gửi Intent đó
tới nơi nhận phù hợp nhất (Xem hình sau).

40

IntentFilters
• Để báo cho hệ thống biết mình có thể xử lý các implicit intent nào, các
activity, service, và broadcast receiver có thể có một hoặc nhiều intent
filter.

• Mỗi filter mô tả một năng lực mà component đó muốn nhận.

• Một explicit intent luôn được gửi đến đích của nó, bất kể nó chứa gì ở
trong; không cần hỏi đến các filter.

• Nhưng một implicit intent chỉ được gửi đến một component khi và chỉ
khi nó lọt qua một trong các filter của component.

42

IntentFilters
• IntentFilters are often defined in an application’s
AndroidManifest.xml with the <intent-filter> tag.

<intent-filter . . . >
<action android:name="code android.intent.action.MAIN" />
<category android:name="code android.intent.category.LAUNCHER" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:type="video/mpeg" android:scheme="http" . . . />
<data android:type="audio/mpeg" android:scheme="http" . . . />
...
</intent-filter>

43

Android Applications

• Mỗi ứng dụng Android chạy trong tiến trình Linux
của riêng nó.
• Mỗi ứng dụng bao gồm một tổ hợp các component
phần mềm, trong đó có:
– Activity
– Service
– BroadcastReceiver
– ContentProvider

44

Android Applications

Cấu trúc
một ứng
dụng
Android
điển hình

45

Android Services
• Service là một component chạy trong
background, không tương tác với người dùng,
chạy trong khoảng thời gian không xác định.
• Mỗi lớp service phải có một khai báo <service>
tương ứng trong AndroidManifest.xml.
• Service có thể được bật/tắt bằng
– Context.startService() và
– Context.bindService().
– stopService(…) and unbindService(…)

46

Android Services
• Service, cũng như các đối tượng ứng dụng
khác, chạy trong thread chính của tiến trình
chủ.
• Nghĩa là, nếu một service định làm thao tác gì
chiếm nhiều thời gian CPU (chẳng hạn MP3
playback) hoặc blocking (chẳng hạn
networking, RSS exchange), nó cần sinh
thread riêng để làm công việc đó

47

Android Services
Service1 Class
package matos.service;
import android.app.Service;
import android.os.IBinder;
import android.util.Log;

public class Service1 extends Service implements Runnable {
private int counter = 0;
@Override
public void onCreate() {
super.onCreate();
Thread aThread = new Thread(this);
aThread.start();
}

public void run() {
while (true) {
try {
Log.i("service1", "service1 firing : # " + counter++);
Thread.sleep(10000); //this is where the heavy-duty computing occurs
} catch (Exception ee) {
Log.e("service1", ee.getMessage());
}
}
}
@Override
public IBinder onBind(Intent intent) {
return null;
}
}
48

Android Services
// Service1Driver
package matos.service;
public class Service1Driver extends Activity {
@Override
// invoking the service
Intent service1Intent = new Intent( this, Service1.class );
startService( service1Intent );
// do some work here….
}
}// Service1Driver
49

Android Services
Service1Demo Manifest
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="matos.service"
android:versionCode="1"
android:versionName="1.0">
<application android:icon="@drawable/icon" android:label="@string/app_name">
<activity android:name=".Service1Driver"
android:label="@string/app_name">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<service android:name="Service1" android:enabled="true" >
</service>
</application>
<uses-sdk android:minSdkVersion="3" />
</manifest>

50

Android Services
Debugging - Log Cat
07-01 02:49:46.097: INFO/ActivityManager(583): Displayed activity matos.service /.Service1 Driver

07-01 02:49:51.277: DEBUG/dalvikvm(724): GC freed 1575 objects / 81280 bytes in 138ms

07-01 02:49:55.831: INFO/service1(767): service1 firing : # 1

51

Android Broadcast Receiver
What is a BROADCASTRECEIVER?

• Nếu một ứng dụng muốn nhận và đáp ứng một global event, chẳng hạn
điện thoại reo hoặc một tin nhắn đến, nó phải đăng kí làm một
BroadcastReceiver.
• Một ứng dụng đăng kí nhận Intent bằng việc khai báo các IntentFilter của nó
tại file AndroidManfest.xml.
• Nếu receiver được đăng kí tại file AndroidManifest.xml, nó sẽ được kích
hoạt khi cần chứ không nhất thiết phải đang trong trạng thái hoạt động
khi có Intent xảy ra.
• Khi xảy ra global event, ứng dụng sẽ được bật tự động khi có thông báo
về event. Hệ điều hành Android chịu trách nhiệm thực hiện việc này.
• Một ứng dụng có thể đăng kí trong khi đang chạy bằng phương thức
registerReceiver của lớp Context.
52

BROADCASTRECEIVER and UI.
• Cũng như Service, BroadcastReceiver không có giao diện
người dùng.

• Đối tượng BroadcastReceiver chỉ tồn tại khi phần mã trong
phương thức onReceive của nó chạy. Nó được coi như không
tồn tại một khi phương thức đó kết thúc.

• Nếu BroadcastReceiver cần thực thi mã nhiều hơn mức tầm
thường, phần mã đó nên yêu cầu một Service thực hiện công
việc đó (bằng Context.startService())

53

BROADCASTRECEIVER BroadcastReceiver

onReceive(…)
Some Activity

sendBroadcast(…)
BroadcastReceiver

onReceive(…)

BroadcastReceiver

onReceive(…)
54

Intents vs. Broadcasts
– Dùng một Intent để bật một Activity là một hoạt
động tại foreground, làm thay đổi phần mà user
đang tương tác.

– Broadcasting một Intent là một hoạt động tại
background mà user thường không nhận biết.

55

Type of Broadcasts
There are two major classes of broadcasts that can be received:

• Normal broadcasts (sent with sendBroadcast) are completely
asynchronous. All receivers of the broadcast are run in an undefined
order, often at the same time. This is more efficient, but means that
receivers cannot use the result or abort APIs included here.

• Ordered broadcasts (sent with sendOrderedBroadcast) are
delivered to one receiver at a time. As each receiver executes in
turn, it can propagate a result to the next receiver, or it can
completely abort the broadcast so that it won't be passed to other
receivers. The order receivers run in can be controlled with the
android:priority attribute of the matching intent-filter; receivers
with the same priority will be run in an arbitrary order.

56

Broadcast Receiver Life Cycle

• A process that is currently executing a BroadcastReceiver (that is,
currently running the code in its onReceive(Context, Intent) method) is
considered to be a foreground process and will be kept running by the
system except under cases of extreme memory pressure.

• Once you return from onReceive(), the BroadcastReceiver is no longer
active, and its hosting process is only as important as any other application
components that are running in it.

• This means that for longer-running operations you will often use a Service
in conjunction with a BroadcastReceiver to keep the containing process
active for the entire time of your operation.

57

Broadcast Receiver Example (1/5). Intercept arriving SMS
package matos.broadcastreceiver;

import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.IntentFilter;

import android.util.Log;


public class MySMSMailBox extends Activity {
// intercepts reception of new text-messages

58

@Override
// define instance of local broadcast receiver
MySMSMailBoxReceiver mySmsReceiver = new MySMSMailBoxReceiver();

// receiver's filter will accept event: ...SMS_RECEIVED
IntentFilter filter = new IntentFilter(
"android.provider.Telephony.SMS_RECEIVED");

// tell Android OS this receiver is ready to go
registerReceiver(mySmsReceiver, filter);
}

59

// this is the custom made broadcast receiver. Its onReceive method
// is fired when the filter matches the SMS_RECEIVED event
public class MySMSMailBoxReceiver extends BroadcastReceiver {
public static final String tag = "<<< MySMSMailBox >>>";

@Override
public void onReceive(Context context, Intent intent) {
Log.i(tag, "onReceive");
// checking global event signaling arrival of text-message
if (intent.getAction().equals(
"android.provider.Telephony.SMS_RECEIVED")) {
Log.i(tag, "Found our SMS Event!");
// you have intercepted the SMS
// do something interesting with it. Bye!
}
}// onReceive

} // BroadcastReceiver
}

60


61

package="matos.broadcastreceiver"
<activity android:name=".MySMSMailBox"
<intent-filter>
</intent-filter>
</activity>
</application>
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<receiver android:name="MySMSMailBoxReceiver" >
<intent-filter>
<action
android:name = "android.provider.Telephony.SMS_RECEIVED"/>
</intent-filter>
</receiver>
</manifest>
62

Android Content Provider
• Content provider ghi (store) và đọc (retrieve) dữ liệu và cho
phép tất cả các ứng dụng truy nhập dữ liệu.

• Đó là cách duy nhất để các ứng dụng Android dùng chung dữ
liệu. Không có nơi lưu trữ dữ liệu chung mà tất cả các
package có thể truy nhập.

• Android có sẵn các content provider cho các kiểu dữ liệu
thông dụng (audio, video, images, personal contact
information, v.v..).

63

• ContentProvider là tầng dữ liệu cung cấp trừu tượng dữ liệu
cho các client và tập trung các thủ tục lưu trữ và đọc dữ liệu
tại một chỗ.

• Một ContentProvider có thể cung cấp dữ liệu cho một
Activity hay Service trong cùng không gian ứng dụng, cũng
như các Activity hay Service nằm trong các ứng dụng khác.

• Một ContentProvider có thể dùng cơ chế lưu trữ dữ liệu bất
kì mà Android platform hỗ trợ, trong đó có file, cơ sở dữ liệu
SQLite, hay kể cả một bảng băm nằm trong bộ nhớ nếu
không đòi hỏi dữ liệu phải được duy trì.

64


65

The data model
• Content providers expose their data as a simple table on a
database model, where each row is a record and each column
is data of a particular type and meaning.
• For example, information about people and their phone
numbers might be exposed as follows:

66

URIs
• Each content provider exposes a public URI that uniquely identifies its data set.
• A content provider that controls multiple data sets (multiple tables) exposes a
separate URI for each one.
• All URIs for providers begin with the string "content://".
• Android defines CONTENT_URI constants for all the providers that come with the
platform. For example
– android.provider.Contacts.Phones.CONTENT_URI
android.provider.Contacts.Photos.CONTENT_URI
– android.provider.CallLog.Calls.CONTENT_URI
android.provider.Calendar.CONTENT_URI

• The ContentResolver method takes an URI as its first argument. It's what identifies
which provider the ContentResolver should talk to and which table of the provider
is being targeted.

67

Querying a Content Provider
• You need three pieces of information to query a content
provider:
– The URI that identifies the provider
– The names of the data fields you want to receive
– The data types for those fields
• If you're querying a particular record, you also need the ID for
that record.
• A query returns a Cursor object that can move from record to
record and column to column to read the contents of each
field. It has specialized methods for reading each type of data.

68

Example: Posting a query to the Contact list (1/2)
package matos.cis493;
import android.net.Uri;
import android.widget.EditText;
import android.widget.Toast;
import android.provider.Contacts.People;
import android.content.ContentUris;
import android.database.Cursor;

public class AndDemo1 extends Activity {
/** queries contact list */
@Override

// Use the ContentUris method to produce the base URI for the contact with _ID == 23.
Uri myPerson1 = ContentUris.withAppendedId(People.CONTENT_URI, 23);

// use the "people" content provider to explore all your contacts
Uri myPerson2 = Uri.parse("content://contacts/people");

// Then query for this specific record using method: managedQuery
// args: (Uri uri, String[] projection, String selection,
// String[] selectionArgs, String sortOrder)

Cursor cur = managedQuery(myPerson2, null, null, null, null);

// do something with the cursor here

}
}

69

Example: Posting a query to the Contact list (2/2)

package="matos.cis493"
<activity android:name=".AndDemo1"
<intent-filter>
</intent-filter>
</activity>
</application>
<uses-permission android:name="android.permission.READ_CONTACTS">
</uses-permission>

</manifest>

70

Android Manifest xml File
• Every application must have an
AndroidManifest.xml file
(with precisely that name) in its root
directory.

• The manifest presents essential
information about the application to
the Android system, information the
system must have before it can run any
of the application's code.

71

These are the only legal elements; you cannot add your own elements or attributes.

<action> <permission>
<activity> <permission-group>
<activity-alias> <permission-tree>
<application> <provider>
<category> <receiver>
<data> <service>
<grant-uri-permission> <uses-configuration>
<instrumentation> <uses-library>
<intent-filter> <uses-permission>
<manifest> <uses-sdk>
<meta-data>
72

Các tác dụng quan trọng của manifest:
– Đặt tên cho Java package của ứng dụng. Tên package đóng vai trò định danh cho ứng dụng.
– Mô tả các component của ứng dụng – các activity, service, broadcast receiver, và content
provider của ứng dụng.
– Gọi tên các class cài đặt các component và khai báo năng lực của chúng (capability) (ví dụ,
chúng có thể xử lý các Intent nào). Các khai báo này cho phép hệ thống Android biết có
những component nào và có thể chạy chúng trong những điều kiện nào.
– Quyết định các tiến trình nào sẽ chứa các component nào của ứng dụng.
– Khai báo các permission mà ứng dụng phải được cấp để có thể truy nhập các phần được bảo
vệ của API và tương tác với các ứng dụng khác.
– Khai báo các permission mà các ứng dụng khác phải có để có thể tương tác với các
component của ứng dụng hiện hành.
– Liệt kê các lớp Instrumentation cung cấp các thông tin khác khi ứng dụng đang chạy. Các khai
báo này chỉ có ở manifest trong khi ứng đụng đang được phát triển và test; chúng sẽ bị xóa đi
trước khi ứng dụng được phát hành.
– Khai báo minimum level của Android API mà ứng dụng yêu cầu.
– Liệt kê các library mà ứng dụng cần được link với.

73

package="matos.earthquake"
android:versionName="1.0.0">
<application android:icon="@drawable/yellow_circle" android:label="@string/app_name">

<activity android:name=".AndQuake"
<intent-filter>
Android
Manifest
</intent-filter>
</activity>

<activity android:name=".SatelliteMapping"> </activity>

<service android:name="AndQuakeService" android:enabled="true" >
</service>
File
<receiver android:name="AndQuakeAlarmReceiver" >
<intent-filter>
<action
android:name = "ALARM_TO_REFRESH_QUAKE_LIST"/>
</intent-filter>
</receiver>
</application>

<uses-library android:name="com.google.android.maps" />
<uses-permission android:name="android.permission.INTERNET" />

</manifest> 74

Example. Currency converter
Implementing a simple currency converter:
USD – Euro – Colon (CR)

Note. Naive implementation using the rates
1 Costa Rican Colon = 0.001736 U.S. dollars
1 Euro = 1.39900 U.S. dollars

75


76

package matos.currencyconvereter;

import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.Toast;

public class Currency1 extends Activity {
// naive currency converter from USD to Euros & Colones
final double EURO2USD = 1.399;
final double COLON2USD = 0.001736;

// GUI widgets
Button btnConvert;
Button btnClear;
EditText txtUSDollars;
EditText txtEuros;
EditText txtColones;

77

@Override
// bind local controls to GUI widgets
txtUSDollars = (EditText)findViewById(R.id.txtUSDollars);
txtUSDollars.setHint("Enter US dollars");
txtEuros = (EditText)findViewById(R.id.txtEuros);
txtColones = (EditText)findViewById(R.id.txtColones);

// attach click behavior to buttons
btnClear = (Button)findViewById(R.id.btnClear);
btnClear.setOnClickListener(new OnClickListener() {
// clear the text boxes
@Override
public void onClick(View v) {
txtColones.setText("");
txtEuros.setText("");
txtUSDollars.setText("");
}
});
78

// do the conversion from USD to Euros and Colones
btnConvert = (Button) findViewById(R.id.btnConvert);
btnConvert.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
try {
String usdStr = txtUSDollars.getText().toString();
double usd = Double.parseDouble( usdStr );
String euros = String.valueOf( usd / EURO2USD );
String colones = String.valueOf( usd / COLON2USD );
txtEuros.setText(euros);
txtColones.setText(colones);
} catch (Exception e) {
Toast.makeText(v.getContext(), "Invalid data - try again" ,
Toast.LENGTH_SHORT).show();
}
}
});// setOnClick...
}// onCreate

}// class

79


80

Resource: res/ layout/main.xml (1/2)
<?xml version="1.0" encoding="utf-8"?> <AbsoluteLayout
<LinearLayout android:id="@+id/absLayout"
android:id="@+id/widget47" android:layout_width="316px"
android:layout_width="fill_parent" android:layout_height="308px"
android:layout_height="fill_parent" android:background="#ff003399"
android:orientation="vertical" >
xmlns:android="http://schemas.android.com/apk/res/an
droid"
<TextView
>
android:id="@+id/usdCaption"
android:layout_width="wrap_content"
<TextView
android:layout_height="wrap_content"
android:id="@+id/caption1"
android:text="US Dollars"
android:layout_width="fill_parent"
android:layout_x="40px"
android:layout_y="15px"
android:text="Currency Converter v0.01"
>
android:textSize="18sp"
</TextView>
android:textStyle="bold"
>
<EditText
</TextView>
android:id="@+id/txtUSDollars"
android:layout_width="150px"
<TextView
android:id="@+id/greenFiller1"
android:layout_width="fill_parent"
android:layout_x="130px"
android:background="#ff006666"
>
>
</TextView>
</TextView>

81

Resource: res/ layout/main.xml (2/2)
<EditText <Button
android:id="@+id/txtEuros" android:id="@+id/btnConvert"
android:layout_width="150px" android:layout_width="wrap_content"
android:layout_height="wrap_content“ android:layout_height="wrap_content"
android:layout_x="130px" android:text=" Convert "
android:layout_y="70px" android:layout_x="10px"
> android:layout_y="190px"
</EditText> >
</Button>
<TextView
android:id="@+id/colonCaption" <Button
android:layout_width="wrap_content" android:id="@+id/btnClear"
android:layout_height="wrap_content" android:layout_width="wrap_content"
android:text="Colones(CR)" android:layout_height="wrap_content"
android:layout_x="40px" android:text=" Clear "
android:layout_y="135px" android:layout_x="90px"
> android:layout_y="190px"
</TextView> >
<EditText </Button>
android:id="@+id/txtColones"
android:layout_width="150px" </AbsoluteLayout>
android:layout_height="wrap_content“
android:layout_x="130px" </LinearLayout>
>
</EditText>

82

package="matos.currencyconvereter"
<application android:icon="@drawable/icon"
<activity android:name=".Currency1"
<intent-filter>
<category
android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>
</manifest>

83

Additional Resources
Google Developer Conference
San Francisco – 2009
Web page: http://code.google.com/events/io/

84

Android chapter01-intro

More Related Content

Similar to Android chapter01-intro (20)

Android chapter01-intro