Android短信事件处理：SmsReceiver实战指南

原创 于 2025-08-19 11:51:28 发布 · 653 阅读 · 20 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

AI助手已提取文章相关产品：

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：在Android开发中， SmsReceiver 是一种专门用于监听短信事件的广播接收器。本项目 SmsReceiver-master 提供了一个实现示例或库，包含 SmsReceiver 类和相关文件，帮助开发者在应用中集成短信接收和处理功能。通过 SmsReceiver ，开发者可以实现对短信事件的监听，处理短信内容，并在Android 6.0及以上版本中妥善管理短信权限。同时，考虑到Android 8.0的限制，开发者需要使用JobScheduler或WorkManager等工具来优化后台任务。本项目通过清晰的文件结构和详尽的文档（如README.md），引导开发者理解短信处理的核心概念，并实现具体的功能扩展。
SmsReceiver

1. BroadcastReceiver核心概念

1.1 BroadcastReceiver简介

BroadcastReceiver（广播接收器）是Android中用于接收应用程序或系统发送的广播消息的一种组件。它是一种被动的通知机制，用于实现不同组件之间或应用程序与系统之间的通信。

1.2 广播机制的基本原理

当有事件发生时，如电量低、启动应用、系统启动等，系统或应用程序会发送一个广播。BroadcastReceiver则在监听到感兴趣的特定广播后，触发相关的处理逻辑。

1.3 使用场景和优势

BroadcastReceiver广泛应用于需要根据特定事件改变应用程序行为的场景，如网络连接变化、短信接收等。其优势在于实现了解耦和异步处理，允许应用响应系统级事件。

2. SmsReceiver作用与实现

2.1 SmsReceiver的基本功能和应用场景

2.1.1 SmsReceiver在移动应用中的作用

SmsReceiver是Android系统中用于接收和处理短信消息的组件。其核心功能是监听并响应来自系统的短信广播，从而使得开发者能够根据应用需求执行相关的逻辑处理。在移动应用中，SmsReceiver可以用于多种场景，例如：

  • 二次验证：许多应用通过发送短信验证码来完成用户的身份验证，SmsReceiver可用于捕获这些验证码信息，并自动填充验证字段。
  • 广告或通知：一些服务可能会发送包含通知的短信，SmsReceiver能够解析这些消息，并在应用内显示通知或广告。
  • 特定信息处理：SmsReceiver可以识别特定格式的短信，并根据短信内容触发应用内的预定义行为，例如自动回复、创建联系人条目等。

2.1.2 实现SmsReceiver的基本步骤和关键点

要实现一个基本的SmsReceiver，需要遵循以下步骤：

  1. 创建SmsReceiver类： 继承自 BroadcastReceiver 类，并重写 onReceive 方法。在此方法中，处理接收到的短信信息。
  2. 注册SmsReceiver： 在应用的 AndroidManifest.xml 文件中声明SmsReceiver，并通过 <intent-filter> 指定接收短信动作 android.provider.Telephony.SMS_RECEIVED 。
  3. 动态权限申请： 在Android 6.0（API级别23）以上，需要在运行时请求接收短信权限 android.permission.RECEIVE_SMS 。
  4. 短信处理逻辑： 在 onReceive 方法中实现短信的解析和处理逻辑。由于 onReceive 运行在主线程，需要确保处理逻辑不会阻塞主线程。

一个关键点是在实现时，要考虑到效率和用户隐私的保护，避免在 onReceive 方法中进行复杂的处理或不必要的网络请求，以减少对用户体验的影响。

2.2 SmsReceiver的代码结构和核心方法

2.2.1 SmsReceiver类的构造和生命周期方法

SmsReceiver 类的构造相对简单，关键在于 onReceive 方法，该方法是 BroadcastReceiver 生命周期中的唯一方法，当短信到达时被系统调用。以下是构造和生命周期方法的示例代码： 

public class SmsReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        // 此处编写接收短信时的处理逻辑
    }
}

2.2.2 onReceive()方法的详细解析

onReceive() 方法是 SmsReceiver 的核心，用于接收和处理短信内容。这个方法只会在接收到短信时被调用，并在后台线程中运行。因此，你需要在此方法中完成所有必要的逻辑，并确保快速返回，避免阻塞后台线程。

一个典型的 onReceive 实现如下： 

@Override
public void onReceive(Context context, Intent intent) {
    if (intent.getAction().equals(Telephony.Sms.Intents.SMS_RECEIVED_ACTION)) {
        Bundle bundle = intent.getExtras();
        if (bundle != null) {
            // 获取 smsManager
            SmsManager smsManager = SmsManager.getDefault();
            // 解析短信
            Object[] pdus = (Object[]) bundle.get("pdus");
            if (pdus != null) {
                for (Object pdu : pdus) {
                    SmsMessage smsMessage = SmsMessage.createFromPdu((byte[]) pdu);
                    String sender = smsMessage.getDisplayOriginatingAddress();
                    String messageBody = smsMessage.getMessageBody();
                    // 此处可以根据短信内容执行进一步操作，例如验证、提醒等
                }
            }
        }
    }
}

在上述代码中，我们首先检查了传入的Intent动作是否为短信接收动作。之后，我们从Intent中提取出短信PDU（协议数据单元），使用 SmsMessage.createFromPdu 方法将PDU转换为 SmsMessage 对象，从而获取到发送者的电话号码和短信内容。

这个方法的逻辑重点在于如何高效地处理短信内容，并确保在不长的时间内返回，以免影响系统的性能。在 onReceive 中执行耗时任务时，应当使用异步任务（例如使用 AsyncTask 或 HandlerThread ）来避免阻塞主线程。

在实际应用中，你可能还需要对短信内容进行解析和处理，比如根据短信内容触发特定事件或者更新UI等操作。因此， onReceive 方法通常需要和应用的其它组件相结合，来实现更加丰富的功能。

3. IntentFilter用于筛选广播事件

3.1 IntentFilter的工作原理和使用场景

3.1.1 IntentFilter的基本概念

IntentFilter 是Android中用于筛选特定广播消息的一种机制。它允许组件（如BroadcastReceiver）通过指定的规则来接收系统或者应用程序发出的Intent。在广播接收器中， IntentFilter 通常用于确定哪些广播消息能够被接收器捕获。

一个 IntentFilter 可以指定一组动作（action）、一个或多个数据类型（data type）以及一组类别（category）。当一个广播被发送时，系统会将这个广播与所有的 IntentFilter 进行匹配，只有匹配成功的广播才会传递给对应的 BroadcastReceiver 。

3.1.2 IntentFilter在SmsReceiver中的应用

在 SmsReceiver 的实现中， IntentFilter 用于定义 SmsReceiver 感兴趣的短信消息。例如，如果你想要 SmsReceiver 只接收包含特定关键字的短信，你可以通过 IntentFilter 来指定接受动作为 android.provider.Telephony.SMS_RECEIVED 的广播，但仅当这些短信包含特定的关键字时。 

IntentFilter filter = new IntentFilter();
filter.addAction("android.provider.Telephony.SMS_RECEIVED");
registerReceiver(smsReceiver, filter);

在上面的代码段中，我们创建了一个 IntentFilter ，并添加了动作 android.provider.Telephony.SMS_RECEIVED ，这意味着我们只关心接收到的短信。然后，我们通过 registerReceiver 方法将这个过滤器与我们的 SmsReceiver 关联起来。

3.2 IntentFilter的高级特性及其实现

3.2.1 动态注册和静态注册的区别

IntentFilter 的注册可以通过两种方式进行：动态注册和静态注册。动态注册是在代码中进行，适用于在运行时根据不同的条件接收广播。静态注册则是在AndroidManifest.xml文件中声明，适用于应用程序中的 BroadcastReceiver 。

动态注册的 IntentFilter 会在应用运行时存在，当广播发送时，只有当前处于运行状态的应用才能接收到广播。而静态注册的 BroadcastReceiver 则无论应用是否在运行都可以接收到广播。

3.2.2 IntentFilter的匹配规则详解

IntentFilter 的匹配规则包括以下几点：

  • 动作（Action）匹配 ：广播的动作需要与 IntentFilter 中定义的动作完全匹配。一个 IntentFilter 可以匹配多个动作。

  • 数据类型（Data Type）匹配 ：通过 setData 和 setType 方法定义数据类型。数据类型匹配是基于MIME类型，以及数据的URI模式。

  • 类别（Category）匹配 ：广播的类别需要与 IntentFilter 中定义的至少一个类别匹配。与动作不同，类别可以是隐式的，即不需要在发送广播时明确指定。

  • 优先级（Priority） ：在多个 BroadcastReceiver 对同一广播感兴趣时，系统会根据优先级来决定哪个接收器应该先接收到广播。

下面是一个 IntentFilter 的示例代码，它展示了如何设置动作、数据类型和类别： 

IntentFilter filter = new IntentFilter();
filter.addAction(Intent.ACTION_AIRPLANE_MODE_CHANGED);
filter.addCategory(Intent.CATEGORY_DEFAULT);
filter.setDataAndType(Uri.parse("content://some_data"), "some_type");
registerReceiver(broadcastReceiver, filter, null, null);

通过上述示例， broadcastReceiver 将只接收动作类型为 Intent.ACTION_AIRPLANE_MODE_CHANGED ，数据类型为 some_type 且类别为默认的广播。

4. Android短信权限管理

4.1 权限申请与系统授权机制

4.1.1 Android权限模型概述

在Android系统中，权限模型是保障用户隐私和数据安全的核心机制。应用在需要访问系统资源或执行某些敏感操作时，必须获得用户的明确授权。Android权限模型定义了两种类型的权限：普通权限和危险权限。

普通权限一般涉及用户隐私较少，系统通常会自动授予应用请求的普通权限。而危险权限则涉及用户的隐私信息，如联系人、短信、位置等，用户必须明确同意应用的权限请求。对于这些权限，Android系统通过运行时权限模型来管理，允许用户在应用运行时决定是否授予特定权限。

4.1.2 短信权限的申请流程和注意事项

短信权限是一个典型的危险权限，应用需要此权限才能接收和发送短信。以下是申请短信权限的基本步骤：

  1. 在应用的 AndroidManifest.xml 文件中声明需要的权限： 
<uses-permission android:name="android.permission.SEND_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
  1. 在运行时请求权限，如果应用目标SDK版本是23（Android 6.0）或更高，需要动态请求权限。以下是请求权限的代码示例： 
if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.RECEIVE_SMS)
        != PackageManager.PERMISSION_GRANTED) {
    ActivityCompat.requestPermissions(thisActivity,
        new String[]{Manifest.permission.RECEIVE_SMS},
        MY_PERMISSIONS_REQUEST_RECEIVE_SMS);
}
  1. 处理用户的权限请求结果： 
@Override
public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_RECEIVE_SMS: {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 权限被用户同意，可以执行相关操作
            } else {
                // 权限被用户拒绝，需要向用户解释为何需要此权限
                // 可以提示用户打开应用的权限设置页面，手动开启权限
            }
            return;
        }
    }
}

在申请短信权限时需要特别注意以下几点：

  • 从Android 6.0（API 级别 23）开始，权限请求必须在运行时进行，即用户可以在应用运行时授权或拒绝。
  • 需要合理处理权限被拒绝的情况，可以引导用户去设置中开启权限。
  • 严格遵守Google Play的政策，不要滥用权限，只请求应用实际需要的权限。
  • 在应用的隐私政策中明确说明为什么需要该权限以及如何使用这些权限。

4.2 权限管理在SmsReceiver中的实践

4.2.1 配置AndroidManifest.xml中的权限声明

在 AndroidManifest.xml 文件中声明短信权限是使用 SmsReceiver 接收短信的第一步。具体操作已经在4.1.2节中提到，这里不再赘述。配置完权限声明后，应用就可以在代码中请求权限，并在用户授权后利用 SmsReceiver 接收短信。

4.2.2 动态权限检查和请求的最佳实践

动态权限检查是在应用运行时对用户授权状态进行检查的必要步骤。以下是检查并请求权限的最佳实践： 

// 检查接收短信权限是否已被授予
if (ContextCompat.checkSelfPermission(thisActivity, Manifest.permission.RECEIVE_SMS)
        != PackageManager.PERMISSION_GRANTED) {
    // 如果权限未被授予，则向用户请求权限
    ActivityCompat.requestPermissions(thisActivity,
        new String[]{Manifest.permission.RECEIVE_SMS},
        MY_PERMISSIONS_REQUEST_RECEIVE_SMS);
} else {
    // 如果权限已被授予，则可以正常使用SmsReceiver接收短信
    // 在这里注册SmsReceiver
}

请求权限后的结果处理同样重要： 

@Override
public void onRequestPermissionsResult(int requestCode, String permissions[], int[] grantResults) {
    switch (requestCode) {
        case MY_PERMISSIONS_REQUEST_RECEIVE_SMS: {
            if (grantResults.length > 0 && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
                // 权限被用户同意，可以注册SmsReceiver接收短信
                registerSmsReceiver();
            } else {
                // 权限被用户拒绝，需要适当处理
                handlePermissionDenied();
            }
            return;
        }
    }
}

在实践中， registerSmsReceiver() 方法会注册 SmsReceiver ，而 handlePermissionDenied() 方法则会处理权限拒绝的情况，可能是提示用户、引导至应用设置页面或给出合理的解释。

通过以上步骤，应用能够在尊重用户隐私的同时，安全有效地使用 SmsReceiver 接收短信。这不仅提升了应用的用户体验，也避免了因权限问题导致的崩溃和异常，确保了应用的稳定性和可靠性。

5. Android 8.0后台限制与解决方案

5.1 Android 8.0后台服务限制概述

5.1.1 后台限制对SmsReceiver的影响

随着Android系统的更新，系统后台限制变得更加严格，尤其是在Android 8.0（Oreo）中引入的后台执行限制对SmsReceiver产生了显著的影响。以往，SmsReceiver可以自动触发并执行后台服务，但新版本系统对后台应用的执行进行了更精细的管理。后台服务的限制包括减少应用程序在后台运行的频率和时间，这直接影响了SmsReceiver在接收和处理短信时的行为。

5.1.2 8.0及以上版本中SmsReceiver的新要求

在Android 8.0及以上版本中，为了满足系统对后台执行的限制，SmsReceiver需要进行一些调整。新的要求包括：
- 转移后台任务到前台执行，或者使用JobScheduler、WorkManager等系统提供的API来处理任务。
- 遵守电池优化机制，使得在电池优化白名单中的应用可以避免执行限制。
- 提升应用的执行效率，避免在后台执行高资源消耗的任务。

5.2 针对8.0版本的解决方案及优化策略

5.2.1 使用WorkManager处理后台任务

WorkManager是Android Jetpack的一部分，提供了一个简单但强大的API，用于异步任务的调度，尤其适用于需要确保任务完成的场景。它可以帮助开发者处理Android不同版本的后台执行差异，并提供了电量优化机制的支持。

要使用WorkManager处理后台任务，可以按照以下步骤进行：

  1. 在项目的 build.gradle 文件中添加WorkManager的依赖： 
dependencies {
    implementation "androidx.work:work-runtime-ktx:2.4.0"
}
  1. 创建一个Worker继承自 Worker 类，并重写 doWork() 方法： 
class MyWorker(context: Context, params: WorkerParameters) : Worker(context, params) {
    override fun doWork(): Result {
        // 在这里处理后台任务
        return Result.success()
    }
}
  1. 使用 WorkManager 的 enqueueUniqueWork() 方法来调度任务： 
val workRequest = OneTimeWorkRequestBuilder<MyWorker>().build()
WorkManager.getInstance(myContext).enqueueUniqueWork("uniqueWorkName", ExistingWorkPolicy.REPLACE, workRequest)

5.2.2 优化SmsReceiver以适应新限制

为了使SmsReceiver适应Android 8.0及以上的后台限制，可以进行以下优化：

  • 将短信处理逻辑移到前台服务 ：当收到短信时，启动一个前台服务来处理短信内容，避免在后台进行大量的数据处理。
  • 使用JobScheduler或WorkManager ：对于需要延迟处理或定期执行的任务，使用JobScheduler（对于Android 5.0及以上版本）或者WorkManager。
  • 优化任务执行策略 ：将长时间运行的操作分解为更小的任务单元，并适当地使用延时或者间隔执行。 
// 示例：创建一个WorkRequest进行周期性任务
val work = PeriodicWorkRequestBuilder<MyWorker>(12, TimeUnit.HOURS)
    .setConstraints(
        Constraints.Builder()
            .setRequiresBatteryNotLow(true)
            .setRequiresDeviceIdle(false)
            .build()
    )
    .build()
WorkManager.getInstance(myContext).enqueueUniquePeriodicWork(
    "uniquePeriodicWorkName",
    ExistingPeriodicWorkPolicy.KEEP,
    work
)

以上代码展示了如何创建一个周期性任务，并使用WorkManager来调度。在Android 8.0及更高版本中，这样的后台任务管理方式是推荐的做法。对于在8.0以下的版本，WorkManager会透明地回退到 AlarmManager 。

注意，使用WorkManager时，要确保合理设置任务的约束条件，比如在电池电量低时避免执行，以提升用户体验并延长设备电池寿命。

本文还有配套的精品资源，点击获取 menu-r.4af5f7ec.gif

简介：在Android开发中， SmsReceiver 是一种专门用于监听短信事件的广播接收器。本项目 SmsReceiver-master 提供了一个实现示例或库，包含 SmsReceiver 类和相关文件，帮助开发者在应用中集成短信接收和处理功能。通过 SmsReceiver ，开发者可以实现对短信事件的监听，处理短信内容，并在Android 6.0及以上版本中妥善管理短信权限。同时，考虑到Android 8.0的限制，开发者需要使用JobScheduler或WorkManager等工具来优化后台任务。本项目通过清晰的文件结构和详尽的文档（如README.md），引导开发者理解短信处理的核心概念，并实现具体的功能扩展。


本文还有配套的精品资源，点击获取
menu-r.4af5f7ec.gif

您可能感兴趣的与本文相关内容

评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符  | 博主筛选后可见
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值