本文详解如何在 android 6.0（marshmallow）及以上版本中正确调用 smsmessage.createfrompdu()，避免因缺失 format 参数导致的编译或运行时错误，并提供向后兼容的完整实现方案。
本文详解如何在 android 6.0（marshmallow）及以上版本中正确调用 smsmessage.createfrompdu()，避免因缺失 format 参数导致的编译或运行时错误，并提供向后兼容的完整实现方案。
在 Android 6.0（API 23）及更高版本中，SmsMessage.createFromPdu(byte[]) 已被标记为过时（@Deprecated），系统要求显式传入短信协议格式（format），以区分 3GPP（GSM/UMTS/LTE）与 3GPP2（CDMA/LTE）消息编码。若忽略该参数，不仅会触发编译警告，更可能在 Android 8.0+ 设备上引发 NoSuchMethodError 或运行时异常。
正确做法是：根据系统 API 级别动态选择重载方法，并从 Intent Bundle 中提取 "format" 字符串。该字段由系统在广播（如 SMS_RECEIVED_ACTION）中自动注入，不可省略或硬编码。
以下为生产环境推荐的兼容性实现：
public class SMSReceiver extends BroadcastReceiver {
@Override
public void onReceive(Context context, Intent intent) {
Bundle bundle = intent.getExtras();
if (bundle == null) return;
Object[] pdus = (Object[]) bundle.get("pdus");
if (pdus == null || pdus.length == 0) return;
SmsMessage[] messages = new SmsMessage[pdus.length];
StringBuilder sb = new StringBuilder();
for (int i = 0; i = Build.VERSION_CODES.M) {
// Android 6.0+：必须传入 format
messages[i] = SmsMessage.createFromPdu(pdu, format);
} else {
// Android 5.1 及以下：使用旧版单参数方法
messages[i] = SmsMessage.createFromPdu(pdu);
}
if (messages[i] != null) {
sb.append("From: ").append(messages[i].getOriginatingAddress())
.append("\nBody: ").append(messages[i].getMessageBody())
.append("\n\n");
}
}
Log.d("SMSReceiver", sb.toString());
Toast.makeText(context, sb.toString(), Toast.LENGTH_LONG).show();
}
}
⚠️ 关键注意事项：
- 无需额外依赖：SmsMessage 属于 Android SDK 内置类（android.telephony.SmsMessage），仅需确保 targetSdkVersion ≥ 23 时适配 format 参数；
-
权限声明：在 AndroidManifest.xml 中仍需声明
，且 Android 6.0+ 需动态申请； - format 值不可为空：bundle.getString("format") 在绝大多数设备上返回 "3gpp" 或 "3gpp2"；若为 null，可安全降级为 "3gpp"（但建议保留判空逻辑）；
- 避免在主线程执行耗时操作：示例中仅作日志与 Toast，实际项目中应将解析、存储等逻辑移至后台线程；
- Android 10+ 行为变更：自 API 29 起，普通应用无法静态注册 SMS_RECEIVED 广播（需使用 SmsRetrieverClient 或前台服务监听），此代码适用于 targetSdk
总结：该问题本质是 Android 平台演进带来的 API 兼容性升级，而非依赖缺失。通过 Build.VERSION.SDK_INT 分支判断 + 正确提取 format 字段，即可一劳永逸解决跨版本短信解析异常。
