Developing android c2_dm_applications(android c2dm開発に関して)

Android C2DM開発に関して
Developing Android C2DM applications.
Overview and implementation.

2011/10
Keishi Hosoba @hosopy
株式会社ガラパゴス

What is C2DM?
• Cloud to Device Messaging
• PUSH notification framework and
service for android applications
• It allows third-party application
servers to send lightweight messages
to their Android applications.

Galapagos Inc. http://www.glpgs.com/

PUSH

Android Application server


Target
GoogleAccount(device) × Application

PUSH(hoge, rearge)

hoge@gmail.com

PUSH(fuga, rearge)
Registration ID
fuga@gmail.com

Flow overview
1. New data

5. Request data

6. Receive data

4. Event 2. Send
(RegistrationID)

3. PUSH Notification

Galapagos Inc. http://www.glpgs.com/ C2DM Servers

Flow overview
1. New data

5. Request data

6. Receive data

4. Event 2. Send
(RegistrationID)

Don’t care! C2DM
Service

Without C2DM

• WebSocket
• Comet
• Polling
• Other(Google Channel API...)


Many things to care
• Designed for realtime web application
• WebSocket,Comet
• Infrastructure
• server and network
• Message queueing
• if target device is offline ...
• Security
• Connection management

Flow overview
1. New data

5. Request data

6. Receive data

4. Event 2. Send
(RegistrationID)

Don’t care!
Infrastructure / Queueing / SecurityC2DM
/
Connection Management Service

Other feature

• Designed for lightweight message
• No gurantee for message sequence


Lifecycle Flow

• Enabling C2DM
• Sending a message
• Receiving a message


1. Enabling C2DM

Application AndroidOS C2DM Server Server

Intent
com.google.android.c2dm.int
ent.REGISTER ？
data[Sender ID]

Registration ID

Broadcast Intent
REGISTRATION With permission
data[Registration ID] hoge :
RegistrationID

Registration ID


2,3. Sending & Receiving a message


Message
BroadcatReceiver Registration ID
AuthToken
Message
RegistrationID
Broadcast Intent Queueing hoge :
com.google.android.c2dm.int RegistrationID
ent.RECEIVE
data[Message]

With permission


Requirements

• Android Application
• OS 2.2
• Application Server
• SSL enabled


http://code.google.com/intl/ja/android/c2dm/signup.html


SDK & Permission


<permission
android:name="com.glpgs.android.study.c2dm.permission.C2D_MESSAGE"
android:protectionLevel="signature" />
<uses-permission android:name="com.glpgs.android.study.c2dm.permission.C2D_MESSAGE" />


<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.GET_ACCOUNTS" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.USE_CREDENTIALS" />

BroadcastReceiver
<application android:icon="@drawable/icon" android:label="@string/app_name">


<receiver
android:name=".C2DMReceiver"
android:permission="com.google.android.c2dm.permission.SEND">

<intent-filter>
<action android:name="com.google.android.c2dm.intent.RECEIVE" />
<category android:name="com.glpgs.android.study.c2dm" />
</intent-filter>

<intent-filter>
<action android:name="com.google.android.c2dm.intent.REGISTRATION" />
<category android:name="com.glpgs.android.study.c2dm" />
</intent-filter>
</receiver>

1. Enabling C2DM


Intent
com.google.android.c2d
m.intent.REGISTER ？
data[Sender ID]

Registration ID

Broadcast Intent
hoge :
REGISTRATION With permission RegistrationI
data[Registration ID]
D

Registration ID


Register, Unregister

OnClick

private void registerC2DM(){
Intent intent = new Intent("com.google.android.c2dm.intent.REGISTER");
intent.putExtra("app", PendingIntent.getBroadcast(this, 0, new Intent(), 0));
intent.putExtra("sender", "hoge@example.com");
startService(intent);
} Sender ID
private void unregisterC2DM(){
Intent intent = new Intent("com.google.android.c2dm.intent.UNREGISTER");
intent.putExtra("app", PendingIntent.getBroadcast(this, 0, new Intent(), 0));
startService(intent);
}


Receive Intent
public class C2DMReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(
"com.google.android.c2dm.intent.REGISTRATION")) {
// Registration IDの発行が完了した
handleRegistration(context, intent);
}
}


Retrieve
RegistrationID
private void handleRegistration(Context context, Intent intent) {
String registration = intent.getStringExtra("registration_id");
if (intent.getStringExtra("error") != null) {
// エラーだよ, リトライとか検討しましょう
} else if (intent.getStringExtra("unregistered") != null) {
// 登録解除が完了したよ
} else if (registration != null) {
// Registration IDの発行が完了したので、保存して自分のサーバに登録します
// ここからは各アプリの仕様に応じてお好きに
saveRegistrationId(registration);
postRegistrationId(registration);
}
}


Implement
Sending message
Flow

[API]POST:https://android.apis.google.com/c2dm/send

Field Content

registration_id Registration ID

An arbitrary string that is used to collapse a group of like messages
collapse_key when the device is offline, so that only the last message gets sent to
the client.

Message content (key-value pair)
data.<key>
1024 bytes limit

If included, indicates that the message should not be sent
delay_while_idle immediately if the device is idle.

Authorization: GoogleLogin Header with a ClientLogin Auth token. The cookie must be associated
auth=[AUTH_TOKEN] with the ac2dm service.


collapse_key

message
ckey=hoge

message
ckey=hoge

message
ckey=hoge

Only the last message is sent to the device when the
device is online.


AuthToken

• Authentication token required to use
Goolge API.
• http://code.google.com/intl/ja/apis/acc
ounts/docs/AuthForInstalledApps.html


Send message
@Server
def send_c2dm(message)
if auth_token = get_auth_token
uri = URI.parse("http://android.apis.google.com/c2dm/send")
body = URI.encode_www_form({
"registration_id" => message.registration_id,
"collapse_key" => rand(100000).to_s,
"data.content" => message.content})
header = {
'Content-Type' => "application/x-www-form-urlencoded;charset=UTF-8",
'Content-Length' => body.bytesize.to_s,
'Authorization' => "GoogleLogin auth=#{auth_token}"}
Net::HTTP.start(uri.host, uri.port) do |http|
http.post(uri.path, body, header)
end
end
end


Implement
Receiving message
Flow

Receive Intent
public class C2DMReceiver extends BroadcastReceiver {

@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(
"com.google.android.c2dm.intent.REGISTRATION")) {
Log.d("C2DMReceiver", "REGISTRATION");
// Registration IDの発行が完了した
handleRegistration(context, intent);
} else if (intent.getAction().equals("com.google.android.c2dm.intent.RECEIVE")) {
// Messageを受信した
Log.d("C2DMReceiver", "RECEIVE");
handleMessage(context, intent);
}
}


Other

• Spec
• http://code.google.com/intl/ja/android/c2dm/
• Memo about server-side
• http://d.hatena.ne.jp/hosopy/20111030


PR

Entrust Galapagos your C2DM enabled
Android applications development.

C2DMを使ったアプリの開発承ります！
http://www.glpgs.com

END


Developing android c2_dm_applications(android c2dm開発に関して)

Recomendados

Recomendados

Mais conteúdo relacionado

Último

Último (20)

Destaque

Destaque (20)

Developing android c2_dm_applications(android c2dm開発に関して)