作者 谢恩铭,公众号「程序员联盟」(微信号:coderhub)。
转载请注明出处。
原文:http://www.jianshu.com/p/e85884989f12
内容简介
- 前言
- 不可行的实现
- 可行的实现
1. 前言
这篇文章算是一个小小的 Android 开发经验总结,也是抛砖引玉。如有错谬,欢迎指正。
最近在 Github 上一个开源的 Android Messages app 中,修正了一个需求的实现。
这个开源的 Android app 是 QKSMS 。还不错的一个遵循 Material Design 的开源免费的 Android 消息应用,不过貌似作者不怎么维护了,比较可惜。
之前我也为这个开源项目贡献过一些补丁,我还写了一篇文章专门讲如何为 Github 的开源项目提交补丁:
Github | 如何贡献Android开源项目和提交补丁
需求如下:
在退出 Airplane mode(飞行模式)之后自动发送之前失败的所有 SMS(Short Message Service,就是「短信」)和 MMS(Multimedia Message Service,就是「彩信」,例如 图片,视频,音频,VCard 等等)。
2. 不可行的实现
之前作者其实已经写了这一块代码,但是没有满足需求。
他是这么处理的:
既然要在退出飞行模式时重新发送,那么就用一个 BroadcastReceiver 来接收系统的飞行模式状态改变的广播,一旦接收到广播,即重新发送所有失败的 SMS和 MMS。
关键代码如下:
// 类定义
public class AirplaneModeReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (!intent.getAction().equals(Intent.ACTION_AIRPLANE_MODE_CHANGED)) {
return;
}
// 如果是进入飞行模式,那么什么也不做
if (intent.getBooleanExtra("state", true)) {
return;
}
// 找出所有包含未成功的消息的对话(conversation),返回 Cursor
Cursor conversationCursor = context.getContentResolver().query(
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER,
Conversation.ALL_THREADS_PROJECTION,
Conversation.FAILED_SELECTION, null,
SmsHelper.sortDateDesc
);
// 遍历每个这样的对话
while (conversationCursor.moveToNext()) {
Uri uri = ContentUris.withAppendedId(SmsHelper.MMS_SMS_CONTENT_PROVIDER, conversationCursor.getLong(Conversation.ID));
// 找出对话中所有未成功的消息,返回 Cursor
Cursor cursor = context.getContentResolver().query(uri, MessageColumns.PROJECTION,
SmsHelper.FAILED_SELECTION, null, SmsHelper.sortDateAsc);
// 把 Cursor 映射到一个 MessageItem 对象,然后重新发送它
MessageColumns.ColumnsMap columnsMap = new MessageColumns.ColumnsMap(cursor);
while (cursor.moveToNext()) {
try {
MessageItem message = new MessageItem(context, cursor.getString(columnsMap.mColumnMsgType),
cursor, columnsMap, null, true);
sendMessage(context, message);
} catch (MmsException e) {
e.printStackTrace();
}
}
cursor.close();
}
conversationCursor.close();
}
// 发送消息
private void sendMessage(Context context, MessageItem messageItem) {
Transaction sendTransaction = new Transaction(context, SmsHelper.getSendSettings(context));
Message message = new Message(messageItem.mBody, messageItem.mAddress);
message.setType(Message.TYPE_SMSMMS);
context.getContentResolver().delete(messageItem.mMessageUri, null, null);
sendTransaction.sendNewMessage(message, 0);
}
}
<!-- 在 AndroidManifest.xml 中注册这个 BroadcastReceiver -->
<receiver android:name=".AirplaneModeReceiver">
<intent-filter>
<action android:name="android.intent.action.AIRPLANE_MODE" />
</intent-filter>
</receiver>
上面的代码中有些内容,比如重新发送消息的代码,包含一些 QKSMS 中的定义,不过不少代码都是用的 Android 源码中的定义。
例如:
public static final Uri CONVERSATIONS_CONTENT_PROVIDER = Uri.parse("content://mms-sms/conversations?simple=true");
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER 这个 Uri 是表示所有的对话。
而 Conversation.ALL_THREADS_PROJECTION 的定义如下:
public static final String[] ALL_THREADS_PROJECTION = {
Threads._ID, Threads.DATE, Threads.MESSAGE_COUNT, Threads.RECIPIENT_IDS,
Threads.SNIPPET, Threads.SNIPPET_CHARSET, Threads.READ, Threads.ERROR,
Threads.HAS_ATTACHMENT
};
SmsHelper.MMS_SMS_CONTENT_PROVIDER 也是标准的 Android 的 Uri:
public static final Uri MMS_SMS_CONTENT_PROVIDER = Uri.parse("content://mms-sms/conversations/");
而 MessageItem 这样的类基本使用了 Android 的 AOSP(Android Open Source Project)中的代码。
QKSMS 这个开源项目大量使用了 AOSP 中的代码,这也是它必须开源的原因。
其他的一些定义则是 QKSMS 中自定义的类或变量,大家可以自行去看 Github 上的 源码,或者 git clone 下来用 Android Studio 查看。上面的重新发送 SMS 和 MMS 的代码是一个可以借鉴的实现。
上面的代码看似可以实现需求。实际测试时发现,一旦退出飞行模式,确实会重新发送失败的 SMS 和 MMS,但是还是会失败。
这是为什么呢?
原因很简单:
刚退出飞行模式时,系统还需要一些时间去重新连接 Cellular network(蜂窝网络,又称 移动网络(mobile network))。如果在检测到关闭飞行模式时立即发送未成功的消息,系统还没有连接完毕,难免会失败。
3. 可行的实现
既然上面的实现不可行,那么应该如何来实现呢?
首先我们要知道:
MMS 需要移动数据,SMS 不需要移动数据。
就是说:MMS 的发送和接收需要 Mobile data,而 SMS 则并不需要。当然了,SMS 和 MMS 都需要有运营商(Network Operator)的网络,也就是需要有 SIM 卡。
开启和关闭 Mobile data 的操作一般可以在 Android 手机里的「仪表盘」上这样实现:
如上图所示,左边的 Mobile data 是用于开启或关闭 Mobile data(移动数据)。右边的 Airplane mode 是用于开启或关闭飞行模式。
因此,有两种情况:
开启飞行模式前,并没有开启 Mobile data。这样的话,在关闭飞行模式后,MMS 也不能发送,只有 SMS 能被发送,因为只有 Cellular network 会重新连接。
开启飞行模式前,已经开启 Mobile data。这样的话,在关闭飞行模式后,MMS 和 SMS 都可以被发送。因为 Cellular network 和 Mobile data 都会重新连接。
我们的代码也就需要分两部分来监听:
负责重新发送 SMS 的:只需要监听 Cellular network(移动网络)的状态改变。如果状态为已连接,则尝试重新发送未成功的 SMS。
负责重新发送 MMS 的:因为 Cellular network 连接还不够,还需要 Mobile data 连接。因此需要监听 Mobile data(移动数据)状态改变。如果状态为已连接,则尝试重新发送未成功的 MMS。
监听 Cellular network(移动网络)的状态改变
我们需要监听 "android.intent.action.SERVICE_STATE" 这个 actioin 对应的广播:
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals("android.intent.action.SERVICE_STATE")) {
if (isCellularNetworkOn(context)) {
// 当 Cellular network 连接上之后,主要用于重新发送未成功的 SMS
// 重新发送的实现 ...
}
}
}
监听 Mobile datata(移动数据)状态改变
我们需要监听 ConnectivityManager.CONNECTIVITY_ACTION (也就是 "android.net.conn.CONNECTIVITY_CHANGE" )这个 actioin 对应的广播:
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals(ConnectivityManager.CONNECTIVITY_ACTION)) {
NetworkInfo mNetworkInfo = intent.getParcelableExtra(ConnectivityManager.EXTRA_NETWORK_INFO);
if ((mNetworkInfo == null) || (mNetworkInfo.getType() != ConnectivityManager.TYPE_MOBILE)) {
return;
}
if (mNetworkInfo.isConnected()) {
// 当 Mobile data 连接上时,主要用于重新发送未成功的 MMS
// 重新发送的实现 ...
}
}
}
合并实现
我们可以把两个监听的部分合并在一个 BroadcastReceiver 中实现,合并后的代码如下 :
/**
* 监听移动网络状态改变,以便能够重新发送未成功的消息(SMS 和 MMS)
* MMS 需要 Mobile data,而 SMS不需要
*/
public class MobileNetworkReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
if (intent.getAction().equals("android.intent.action.SERVICE_STATE")) {
if (isCellularNetworkOn(context)) {
// 当 Cellular network 连接上时,主要用于重新发送未成功的 SMS
resendFailedMessages(context);
}
} else if (intent.getAction().equals(ConnectivityManager.CONNECTIVITY_ACTION)) {
NetworkInfo mNetworkInfo = intent.getParcelableExtra(ConnectivityManager.EXTRA_NETWORK_INFO);
if ((mNetworkInfo == null) || (mNetworkInfo.getType() != ConnectivityManager.TYPE_MOBILE)) {
return;
}
if (mNetworkInfo.isConnected()) {
// 当 Mobile data 连接上时,主要用于重新发送未成功的 MMS
resendFailedMessages(context);
}
}
}
// 重新发送失败的消息(SMS 或 MMS)
private void resendFailedMessages(Context context) {
// 找出所有包含未成功的消息的对话(conversation),返回 Cursor
Cursor conversationCursor = context.getContentResolver().query(
SmsHelper.CONVERSATIONS_CONTENT_PROVIDER,
Conversation.ALL_THREADS_PROJECTION,
Conversation.FAILED_SELECTION, null,
SmsHelper.sortDateDesc
);
// 遍历每个这样的对话
while (conversationCursor.moveToNext()) {
Uri uri = ContentUris.withAppendedId(SmsHelper.MMS_SMS_CONTENT_PROVIDER, conversationCursor.getLong(Conversation.ID));
// 找出对话中所有未成功的消息,返回 Cursor
Cursor cursor = context.getContentResolver().query(uri, MessageColumns.PROJECTION,
SmsHelper.FAILED_SELECTION, null, SmsHelper.sortDateAsc);
// 把 Cursor 映射到一个 MessageItem 对象,然后重新发送它
MessageColumns.ColumnsMap columnsMap = new MessageColumns.ColumnsMap(cursor);
while (cursor.moveToNext()) {
try {
MessageItem message = new MessageItem(context, cursor.getString(columnsMap.mColumnMsgType),
cursor, columnsMap, null, true);
sendMessage(context, message);
} catch (MmsException e) {
e.printStackTrace();
}
}
cursor.close();
}
conversationCursor.close();
}
// 发送消息
private void sendMessage(Context context, MessageItem messageItem) {
Transaction sendTransaction = new Transaction(context, SmsHelper.getSendSettings(context));
Message message = new Message(messageItem.mBody, messageItem.mAddress);
message.setType(Message.TYPE_SMSMMS);
sendTransaction.sendNewMessage(message, 0);
context.getContentResolver().delete(messageItem.mMessageUri, null, null);
}
// 判断 Cellular network 是否已连接
public static boolean isCellularNetworkOn(Context context) {
TelephonyManager telephonyManager = (TelephonyManager) context.getSystemService(Context.TELEPHONY_SERVICE);
return telephonyManager.getNetworkOperator() != null && !telephonyManager.getNetworkOperator().isEmpty();
}
}
<!-- 在 AndroidManifest.xml 中添加权限 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 在 AndroidManifest.xml 中注册这个 BroadcastReceiver -->
<receiver android:name=".MobileNetworkReceiver">
<intent-filter>
<action android:name="android.intent.action.SERVICE_STATE" />
<action android:name="android.net.conn.CONNECTIVITY_CHANGE" />
</intent-filter>
</receiver>
我是 谢恩铭,公众号「程序员联盟」(微信号:coderhub)运营者,慕课网精英讲师 Oscar 老师,终生学习者。
热爱生活,喜欢游泳,略懂烹饪。
人生格言:「向着标杆直跑」