Android | 移动网络改变时重新发送未成功的SMS和MMS

作者谢恩铭，公众号「程序员联盟」（微信号：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);
    }
}

上面的代码中有些内容，比如重新发送消息的代码，包含一些 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();
    }
}

我是谢恩铭，公众号「程序员联盟」（微信号：coderhub）运营者，慕课网精英讲师 Oscar 老师，终生学习者。
热爱生活，喜欢游泳，略懂烹饪。
人生格言：「向着标杆直跑」