Android消息应用（Messaging）源码学习笔记

我想首先应该从AndroidManifest.xml 文件开始，该文件是Android应用（APK）的打包清单，其中提供了关于这个应用程序的基本信息，如名称(application/@label)，图标( application/@icon  )，等常量信息，但该文件最重要的功能仍然是：向Android系统声明应用程序所包含的组件，包括Activity、Service、Receiver和ContentProvider，另外还会请求 系统 授予相关权限。

 

<application>是重要的标记，一般咱们都是在此设置应用程序的名称和图标，而在Messaging这个应用中，它扩展了默认的android.app.Application类，在com.android.mms.MmsApp类中覆写了onCreate()方法进行系统初始化、覆写onTerminate() 方法作相关清理工做。最重要的是 <application>标记设置了(任务吸引力) taskAffinity =“android.task.mms”、allowTaskReparenting ="true" 这是两个与Task有关的属性，那么何为任务(Task)呢？

 

A pplication就是一个.apk文件，由若干个组件（可能会包括 Activity、Service、Receiver 或者 ContentProvider ）构成，它是一个物理上的独立存在。而Task则是指用户借助Application提供的功能完成某件事情，例如：发送一条信息给老朋友。一般一个Task操做所涉及的内容不会超过 A pplication边界 ，但在Android中却不是这样，Android容许一个Task操做 横跨多个Apllication。还以向老朋友发送信息为例，在该任务中，至少须要一个用来输入目标电话号码和消息内容的用户界面——即Android中的Activity组件（这是 Messaging应用中的内容），若是进一步要求目标号码是从联系人列表(或通话列表)中选择，而非手工输入，那么就涉及到跨 Apllication调用‘联系人应用’中的列表组件 了 （也是一个 Activity ） 。所以以上两个属性前者设置了 Activity的吸引力(Affinity)值，后者使得 Activity能够在不一样的Task中自有切换。

 

 

Messaging中的Receiver

R eceiver广播 接收器用于响应系统中的各类广播事件并执行相关业务代码的组件，经常使用于完成如：启动service、显示Activity等 任务 。在Messagin应用中一共有7个 R eceiver：

一、.transaction.SmsReceiver ： 短消息 广播 接收器，它负责处理与收到短消息相关的广播事件。触发该接收器运行的intent有两个：

A.android.intent.action.BOOT_COMPLETED--->Android系统启动完成时会发出该广播，即SmsReceiver会在系统启动完成时接收到调用；

B.com.android.mms.transaction.MESSAGE_SENT --->定义在 SmsReceiverService.java中的常量，被用在SmsMessageSender.sendMessage方法中——即短消息发送后 触发的广播事件；

彻底和预想的同样，在 SmsReceiver中会启动 SmsReceiverService，启动代码在beginStartingService方法里。值得注意的是它同时还作了“屏幕唤醒锁定 （WakeLock）” 操做，最终在service启动完成后，经过回调用finishStartingService方法，解除了屏幕唤醒锁定。

SmsReceiver.java中有编译错误，由于没法访问android.provider.Telephony.Sms.Intents。其实 Intents 所在位置是：myeclair\frameworks\base\core\java\android\provider\Telephony.java，它被标记为@hide。

 

二、 . transaction.PrivilegedSmsReceiver ：该接收器是SmsReceiver的子类，惟一的区别在于该Receiver被申明有permission为android.permission.BROADCAST_SMS。

 

 

三、.transaction.MmsSystemEventReceiver ：Mms系统事件接收器，它负责 在收到新消息时 向通知区域（即标题栏）显示小图标，和 从新发送在发件箱中的MM。触发该接收器运行的两个Intent是：

A. android.intent.action.BOOT_COMPLETED ---> ：与SmsReceiver中的状况相同；

B.android.intent.action.CONTENT_CHANGED ---> ：链接方式改变时系统会发出该广播，即在链接方式变化，例如从gprs-->wifi时该接收器将被调用 ；

在MmsSystemEventReceiver类中，程序一旦得到数据链接时就会启动TransactionService服务；当链接方式改变时还会调用PduCache.purge()方法清理缓存；还有当系统刚刚启动时 会同步通知区域的图标、未读消息个数等信息。

MmsSystemEventReceiver.java中有编译错误，由于它没法访问如下类：

一、com.google.android.mms.util.PduCache：位置-myeclair\frameworks\base\core\java\com\google\android\mms\util\PduCache.java，该类未包含在默认的android.jar文件中，须要从新编译；

二、android.provider.Telephony.Mms： 位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

三、com.android.internal.telephony.TelephonyIntents：位置-myeclair\frameworks\base\telephony\java\com\android\internal\telephony\TelephonyIntents.java，该类是一个常量类是未被开放的API。

四、com.android.internal.telephony.Phone： 位置- myeclair\frameworks\base\telephony\java\com\android\internal\telephony\Phone.java， 该类被标记为 @hide 。

 

四、.transaction.PushReceiver ： WAP_PUSH 事件的广播接收器，该事件发生时 表明手机收到了一条新的WAP PUSH message。该接收器被调用后，首先唤醒手机屏幕5秒钟，而后在一个后台线程中处理push-data，将消息数据插入到数据库中，必要时启动TransactionService服务以更新通知信息 。触发该接收器运行的 Intent是：

（intent.action=android.provider.Telephony.WAP_PUSH_RECEIVED, data=application/vnd.wap.mms-message），其中Action.Name定义在android.provider.Telephony类中。值得注意的是该Receiver有申明权限：android.permission.BROADCAST_WAP_PUSH，这意味着发出该广播时必须携带该受权，不然本 Receiver将不会被触发执行。

PushReceiver.java中有编译错误，由于它没法访问如下类：

一、android.provider.Telephony ： 位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

二、com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中。

 

五、. transaction.MessageStatusReceiver ：消息状态改变时的广播接收器，消息状态改变是指消息的投递状态（即：是否成功送达、是否被目标用户阅读等）的变化，触发该接收器的Intent是：com.android.mms.transaction.MessageStatusReceiver. MESSAGE_STATUS_RECEIVED，该值是申明在MessageStatusReceiver.java文件中的常量。该广播事件是在SmsMessageSender.sendMessage()方法中被发出的，收到广播事件后，Receiver的会作两件事情：a-取得pdu数据包 更新消息状态（在updateMessageStatus方法中）；b-更新通知区域的新消息指示信息 （在MessagingNotification.updateNewMessageIndicator()方法中）。

MessageStatusReceiver.java中有编译错误，由于它没法访问如下类：

一、android.provider.Telephony ： 位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

二、com.google.android.mms.util.SqliteWrapper： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\ util\SqliteWrapper.java，该类未包括在公开的API中。

 

六、.transaction.SimFullReceiver ：Sim卡短信存储空间满的事件通知，当系统发现Sim卡中存储短信的空间耗尽时会发出该广播事件。该接收器完成的工做是在通知区域显示相关信息，点击通知信息后，能够进入管理Sim卡中短消息的Activity界面 。

SimFullReceiver.java中有编译错误，由于它没法访问 android.provider.Telephony 类，所在位置-myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

七、.transaction.SmsRejectedReceiver ：短消息被拒绝时的事件接收器，当手机的存储空间不足时会拒绝接收新的短消息，当该事件发生时SmsRejectedReceiver被调用，它会检查确认是不是存储空间不足，而后在通知区域显示相关通知信息。

SmsRejectedReceiver.java中有编译错误，由于它没法访问 android.provider.Telephony 类，所在位置-myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

 

Messaging中的Activity

Activity是用来构建UI（用户界面 ）的组件，用户操做界面表明了应用程序提供的基本功能，是应用程序和用户之间的交互接口。在Messaging应用中有如下的Activity：

一、.ui.ConversationList ，对话列表界面，这是进入应用程序的主界面。它有两个配置属性值得咱们特别注意，a.android:configChanges="orientation|keyboardHidden"：在Android系统中，当程序所运行的环境(如：屏幕方向、键盘状态、字体等级，等等)发生变化后 会致使Activity被从新启动(以适应环境变化 )，然而 Activity也能够宣称本身来应付某些变化（而不是一股脑地全让系统重启本身）， configChanges 属性 正是用于 指定本身愿意 应付 的变化状况。此处该属性有两个值， orientation表明屏幕方向发生改变，keyboardHidden表示键盘可访问状态发生变化(即键盘弹出/收起 )，这意味着当屏幕方向和键盘可用状态 发生变化时， Activity不会被从新启动，而是调用其onConfigurationChanged方法，一般是在该方法中对本身作出调整，以适应变化；b.launchMode="singleTop"：该属性指示了Activity的加载模式，这与Activity在不一样Task之间的重用有关，该属性共有4个可用选项standard, singleTop,singleTask,singleInstance，它们将与Intent中的FLAG_ACTIVITY_* 标记 常量 协同产生相关做用。

ConversationList类中定义了程序中涉及到的选项菜单、会话(Conversation)项上的上下文菜单等UI元素。另外该类中的runOneTimeStorageLimitCheckForLegacyMessages方法用于检测存储空间限制。

SmsRejectedReceiver .java中有编译错误，由于它没法访问如下类：

1.android.provider.Telephony 类，所在位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

2. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中。

二、.ui.ComposeMessageActivity ，建立新消息的用户界面，经过选项菜单menu_compose_new会调用到该界面。这是个很庞大的类，内部实现也很复杂，等仔细看了再写补充吧。

ComposeMessageActivity .java中有编译错误，由于它没法访问如下类：

1.com.android.internal.widget.ContactHeaderWidget类，所在位置-myeclair\frameworks\base\core\java\com\android\internal\widget\ContactHeaderWidget.java，该类被标记为 @hide 。

2.com.android.internal.telephony.* 类，所在位置- myeclair\frameworks\ base\telephony\java\com\android\internal\telephony\*，这些类未包括在公开的API中 。

3. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中 。

 

三、 .ui.ForwardMessageActivity ，用于转发消息的Activity，这是ComposeMessageActivity的别名，用于把一条现有消息的内容带到建立消息的界面上；

 

四、.ui.DeliveryReportActivity ，投递报告 Activity， 用于报告消息的投递状态，它采用对话框风格的主题(android:theme="@android :style/Theme.Dialog")。

DeliveryReportActivity .java中有编译错误，由于它没法访问如下类：

1. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中 。

2. android.provider.Telephony 类，所在位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

 

五、.ui.WarnOfStorageLimitsActivity ，存储空间限制警告，用于告知用户 关于存储空间限制的设置信息。

WarnOfStorageLimitsActivity .java中有编译错误，由于它没法访问如下类：

1. com.android.internal.app.AlertActivity类， 位置- myeclair\frameworks\base\core\java\com\android\internal\app\AlertActivity.java，该类未包括在公开的API中 。

2. com.android.internal.app.AlertController类， 位置- myeclair\frameworks\base\core\java\com\android\internal\app\AlertController.java，该类未包括在公开的API中 。

 

6.ui.ConfirmRateLimitActivity ，发送多条彩信时向用户提示确认的界面，它包括了自动 应答操做——即用户 超过一段时间 未做出响应时自动取消发送。

 

七、.ui.ClassZeroActivity ，ClassZero是一种特殊的短消息类型，它会直接显示在用户屏幕上并等待用户操做。ClassZeroActivity正是用来显示此类型的短信消息 ，并运行用户将信息保存起来 。

ClassZeroActivity .java中有编译错误，由于它没法访问如下类：

1. android.provider.Telephony 类，所在位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

2. com.google.android.mms.util.SqliteWrapper： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\ util\SqliteWrapper.java，该类未包括在公开的API中。

 

八、.ui.MessagingPreferenceActivity ，这是Messaging应用的系统配置界面，其中有针对SMS、MMS、存储限制等配置属性，以及管理存储在 SIM卡中 的短信消息。该Activity启动时会检查当前是否有SIM，以及是否支持MMS来动态调整配置项列表。

MessagingPreferenceActivity .java中有编译错误，由于它没法访问TelephonyManager.getDefault()方法，能够考虑使用Context.getSystemService(Context.TELEPHONY_SERVICE)方法来获得类实例。

 

九、.ui.ManageSimMessages ，用于管理Sim卡中短消息的界面，它以列表的形式显示了存储在SIM卡中的短消息，并容许用户将信息转存到手机内存中，或者删除消息。

ManageSimMessages .java中有编译错误，由于它没法访问如下类：

1. android.provider.Telephony 类，所在位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

2. com.google.android.mms.util.SqliteWrapper： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\ util\SqliteWrapper.java，该类未包括在公开的API中。

 

十、.ui.SearchActivity ，用于信息搜索的操做界面。Android经过系统服务Context. SEARCH_SERVICE（即SearchManager类）提供了强大的信息搜索功能。在该应用中经过对联系人(或者电话号码)、主题等信息的匹配来搜索信息，并将结果显示在一个列表中。

SearchActivity .java中有编译错误，由于它没法访问如下类：

1. android.provider.Telephony 类，所在位置- myeclair\frameworks\base\core\java\android\provider\Telephony.java，该类被标记为 @hide 。

 

十一、.ui.SlideshowEditActivity ， 所谓Slide是指MM中的一页内容 即一帧，一般被称为幻灯片。 SlideshowEditActivity是彩信中全部内容（即多个Slide）的列表，用户能够选定列表项进入Slide播放/修改界面。

SlideshowEditActivity .java中有编译错误，由于它没法访问如下类：

1. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中 。

 

 

十二、.ui.SlideshowActivity ， 用于播放Slide幻灯片的界面，它会在全屏状态下显示幻灯片的内容。

SlideshowActivity .java中有编译错误，由于它没法访问如下类：

1. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中 。

 

1三、.ui.SlideEditorActivity ，用于编辑Slide幻灯片内容的操做界面，它提供了：添加、移除 文本/图片/音乐，以及Slide等功能。

SlideEditorActivity .java中有编译错误，由于它没法访问如下类：

1. com.google.android.mms.*： 位置- myeclair\frameworks\base\core\java\com\google\android\mms\*，这些类未包括在公开的API中 。

 

1四、.ui.EditSlideDurationActivity ，用于修改Slide幻灯片持续显示时间 的操做界面 ，默认持续显示时间是5秒。

EditSlideDurationActivity .java编译无错误。

 

Messaging中的Service

应用中共有两个service：.transaction.TransactionService 和 .transaction.SmsReceiverService，前者负责处理与彩信(MMS)相关的网络业务，后者是短消息(SMS)的接收器，二者都会响应来自通信网络的通知并收取信息。它们只用于本应用内部(由于其未声明任何intent-filter)，上文介绍的广播接收器中有显式启动它们的代码。如下咱们将分别分析两个Service的基本实现。

 

一、.transaction.SmsReceiverService ，它被建立时首先 初始化了新的工做线程（HandlerThread对象）用来在后台完成相关动做，紧接着在onStartCommand方法里会将具体的任务经过消息(即调用service的Intent)发送给工做线程进行处理。根据Intent.Action的名称，工做线程会处理4中状况：

A.系统启动完成后BOOT_COMPLETED：把发件箱(outbox)中的消息移动到发送队列(QueuedBox)，而后开始发送队列中的消息，最后调用updateNewMessageIndicator方法更新状态栏消息指示图标；

B.处理Sms接收handleSmsReceived：从Intent中取得消息对象，直接显示给用户(Class0类型）或者保持到数据库中。

C.处理Sms发送handleSmsSent：从待发送消息队列中取得消息，并按次序逐个发送；

D.处理通信网络状态改变handleServiceStateChanged：用户从无信号状态进入有信息号状态后，继续执行发送任务的状况；

 

二、.transaction.TransactionService ， 是处理与彩信相关业务的服务组件，根据代码中的注释能够了解到： 收发彩信时能够是移动数据网络(mobile data network)或Wi-Fi网络。当没有可用的移动数据网络链接时，会尝试经过Wi-Fi网络发送/接收MMS信息(若是有 Wi-Fi 网络的话)。

它 一样在onCreate方法里首先建立了后台工做线程，经过NetworkConnectivityListener类( 一个被@hide的类 ，位置在：frameworks\ex\common\java\com\android\common路径下 )监听通信网络连接状态的变化，并根据不一样的连接状态做出相应的反应。

紧接着就是onStartCommand方法了，它首先会检测当前的网络链接状态，而后分别完成如下几件事情：

A.针对收发彩信的业务，它将intent.getExtras()包装成一个DTO—— TransactionBundle，再经过launchTransaction()方法将具体工做交给后台工做线程去处理。

B.若是 intent.getExtras()为Null时，它会尝试从数据库中扫描是否有(上次系统结束时)未完成的操做，若是有则遍历全部操做项，逐个调用launchTransaction()方法，以完成操做；

 

 

重点仍是在后台工做线程的处理逻辑上，在代码中表现为handleMessage方法，它共处理如下几种不一样类型的业务消息：

 

Ⅰ.EVENT_CONTINUE_MMS_CONNECTIVITY ，与彩信系统创建网络链接，它首 先会检查当前是否有待处理的业务，而后经过调用beginMmsConnectivity方法来建立于彩信系统的网络链接，若是网络链接被正确创建，那么它会经过一个30秒间隔的计时器来维持链接的持续存在；

 

Ⅱ.EVENT_DATA_STATE_CHANGED ，网络链接状态发生改变分支，这一分支是经过对NetworkConnectivityListener对象的监听而得到回调。在该分支中首先确认了网络链接的有效性，(代码在此处仅容许ConnectivityManager.TYPE_MOBILE_MMS类型那么wi-fi链接属于该类型?)，而后建立 TransactionSettings对象，并调用processPendingTransaction方法处理具体的彩信业务；

 

Ⅲ.EVENT_TRANSACTION_REQUEST ，这是对具体彩信业务的处理分支，它首 先建立了承载业务参数的TransactionSettings对象，该对象包含有彩信中心服务地址(mmscUrl)、代理服务器地址和端口等用于创建 网络链接的参数，而后根据不一样的业务类型，分别进行处理。当前仅明确处理了如下4中业务：

一、NOTIFICATION_TRANSACTION，经过一条Push数据，通知手机端收到有新信息；

二、RETRIEVE_TRANSACTION，收取彩信；

三、SEND_TRANSACTION，发送彩信；

四、READREC_TRANSACTION，彩信阅读报告；

用于处理具体业务的关键代码在processTransaction方法中，它首先检查业务是否已存在于处理队列中(mProcessing & mPending)，而后调用beginMmsConnectivity()方法确认网络链接有效性，并点亮终端屏幕，而后将业务对象条件处处理队列中并向业务附加观察者，最后调用业务自身process()方法完成网络通讯。注意：业务的process方法被调用又会触发观察者(即当前service) 的update方法被调用，这使得刚才被处理掉的业务从队列中被移除，而且开始处理下一条业务；

Ⅴ.EVENT_HANDLE_NEXT_PENDING_TRANSACTION ，这是一个多条彩信业务可以 被 连续 处理的关键分支，首先在当前service中有mProcessing数组列表用于缓存连续的彩信业务，每条彩信业务是一个可被观察的对象(注：观察者模式 )， 当前service是惟一观察者，其会感知到一条业务已处理结束，并触发下一条业务处理的开始；

 

全部彩信业务处理完成后， 会调用 service中的endMmsConnectivity()方法，结束与彩信中心的网络链接，并撤销屏幕点亮。