-- 做者 谢恩铭 转载请注明出处「程序员联盟」ProgrammerLeague
原文 : www.jianshu.com/p/e85884989…android
这篇文章算是一个小小的 Android 开发经验总结,也是抛砖引玉。若有错谬,欢迎指正。git
最近在 Github 上一个开源的 Android Messages app 中,修正了一个需求的实现。程序员
这个开源的 Android app 是 QKSMS 。还不错的一个遵循 Material Design 的开源免费的 Android 消息应用,不过貌似做者不怎么维护了,比较惋惜。github
以前我也为这个开源项目贡献过一些补丁,我还写了一篇文章专门讲如何为 Github 的开源项目提交补丁:
Github | 如何贡献Android开源项目和提交补丁bash
需求以下:微信
在退出 Airplane mode(飞行模式)以后自动发送以前失败的全部 SMS(Short Message Service,就是「短信」)和 MMS(Multimedia Message Service,就是「彩信」,例如 图片,视频,音频,VCard 等等)。网络
以前做者其实已经写了这一块代码,可是没有知足需求。app
他是这么处理的:ide
既然要在退出飞行模式时从新发送,那么就用一个 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))。若是在检测到关闭飞行模式时当即发送未成功的消息,系统尚未链接完毕,不免会失败。
既然上面的实现不可行,那么应该如何来实现呢?
首先咱们要知道:
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。
咱们须要监听 "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
// 从新发送的实现 ...
}
}
}复制代码
咱们须要监听 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>复制代码
微信公众号「程序员联盟」ProgrammerLeague
我是谢恩铭,在巴黎奋斗的软件工程师。
关于我热爱生活,喜欢游泳,略懂烹饪。人生格言:「向着标杆直跑」