Android收远程消息启动应用:SDK26以上版本失效需何种配置
高版本SDK下远程消息无法拉起应用的核心原因
从Android 8.0(API 26)开始,系统引入严格的后台活动启动限制(BAS):当应用处于后台状态(进程未在前台交互、无可见前台服务)时,直接调用startActivity()拉起页面的操作会被系统静默拦截,这就是原代码在API 26+失效的根本原因,而非通知渠道或基础权限的问题。
需要调整的配置与代码逻辑
1. 修正启动触发逻辑,移除后台直接启动的代码
原代码在onMessageReceived中直接调用startActivity(intent)的写法,在高版本系统下必然被拦截,需要把应用启动的触发动作完全托管给通知的PendingIntent:
- 通知作为系统级UI组件,用户交互(点击通知)触发的PendingIntent启动,会被系统授予临时后台启动权限,不受BAS规则限制
- 直接删除代码中
startActivity(intent)的调用,避免无意义的拦截异常
2. 修正PendingIntent的构建规则(适配全版本SDK)
原代码中PendingIntent的构建存在两个版本兼容问题,会导致高版本下通知构建失败、点击无响应:
- 提前设置Intent启动Flags:原代码在把Intent传入
PendingIntent.getActivity()之后,才给Intent设置FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_CLEAR_TASK,此时PendingIntent已经持有了无Flags的Intent副本,设置完全失效。需要在构建PendingIntent之前,就把Intent的启动Flags设置完成。 - 补充可变性标识适配Android 12+:从API 31开始,系统要求所有PendingIntent必须显式声明可变性,否则会直接抛出异常导致通知发送失败。根据业务需求选择对应的Flag:
- 若Intent内容不需要后续动态修改,使用
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE作为请求标志 - 若需要在PendingIntent创建后动态更新Intent携带的数据,使用
PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_MUTABLE,同时做好Intent输入校验,避免组件跳转漏洞
- 若Intent内容不需要后续动态修改,使用
正确的构建片段参考:
Intent launchIntent = new Intent(getApplicationContext(), MainActivity.class); // 先设置启动Flags launchIntent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK); // 根据SDK版本选择对应的PendingIntent Flag int pendingIntentFlag = PendingIntent.FLAG_UPDATE_CURRENT; if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) { pendingIntentFlag |= PendingIntent.FLAG_IMMUTABLE; } PendingIntent pendingIntent = PendingIntent.getActivity(this, 0, launchIntent, pendingIntentFlag);
3. 若需要实现“无交互自动拉起应用”的特殊效果的额外配置
原设计目标是“消息到达即启动应用”,不需要用户手动点击通知,这种场景下普通的通知触发逻辑无法绕过BAS限制,需要补充对应的权限和配置:
- 申请悬浮窗特殊权限:API 29+中,持有
SYSTEM_ALERT_WINDOW权限的应用可以豁免后台启动限制,需要引导用户在系统设置页为应用开启“显示在其他应用上层”的权限,普通运行时申请弹窗无法直接获取该权限。 - 适配国产ROM自启动规则:小米、华为、OPPO、vivo等定制系统会在原生BAS规则之上增加额外的自启动管控,需要引导用户将应用加入系统自启动白名单,否则就算满足原生权限要求,启动动作仍会被拦截。
- 注意:不推荐无交互自动拉起应用的交互逻辑,系统和用户都会对这类行为做强管控,实际落地的成功率非常低。
4. 通知相关的配置修正
- 震动权限补充:在Manifest文件中添加
<uses-permission android:name="android.permission.VIBRATE" />,否则高版本系统下带震动配置的通知会被判定为异常,无法正常展示。 - 通知渠道优化:通知渠道只需要在应用首次启动时创建一次即可,不需要每次收到消息重复创建;渠道的重要性等级一旦创建后无法通过代码修改,首次创建时需要直接设置为高优先级,避免后续通知被系统折叠静默。
- 修正通知音效Uri的拼接逻辑:原代码中
Uri.parse("someExample" + R.raw.win)的写法,会把资源ID的整数值拼到字符串后面,生成的Uri无法被系统识别,正确的raw资源Uri格式应为Uri.parse(ContentResolver.SCHEME_ANDROID_RESOURCE + "://" + getPackageName() + "/raw/win"),否则会出现通知音效加载失效的问题。
内容的提问来源于stack exchange,提问作者Kalin666
相关产品推荐
相关产品推荐

