首页
/ GKD项目中的ActivityId匹配失效问题分析与解决方案

GKD项目中的ActivityId匹配失效问题分析与解决方案

2025-05-07 23:52:04作者:凤尚柏Louis

问题背景

在GKD项目中,规则配置中的activityIds属性本应限制规则只在特定Activity中生效,但实际使用中发现存在失效情况。具体表现为:在Bilibili应用中,为MainActivityV2配置的开屏广告规则,在搜索页(SearchActivity)也被错误触发。

问题现象分析

开发者配置了如下规则:

{
  name: '开屏广告',
  key: 2,
  fastQuery: true,
  actionMaximum: 1,
  matchTime: 5000,
  resetMatch: 'app',
  activityIds: [
    'tv.danmaku.bili.MainActivityV2'
  ],
  rules: [
    {
      matches: [
        '[text*="跳"][visibleToUser=true]'
      ]
    }
  ]
}

理论上,该规则应仅在MainActivityV2中生效。但实际测试发现,当应用从后台返回前台时,即使当前Activity是搜索页(com.bilibili.search2.main.BiliMainSearchActivity),该规则也会被触发。

根本原因

经过日志分析,发现系统未能正确获取当前Activity的ID。日志显示:

com.sec.android.app.launcher.Launcher/8 -> tv.danmaku.bili/null/0

这表明系统返回的Activity ID为null,导致GKD无法进行Activity匹配。在这种情况下,GKD会忽略Activity限制,使规则在所有界面都可能被触发。

解决方案

方案一:安装Shizuku服务

通过安装Shizuku可以解决Activity ID获取失败的问题。Shizuku提供了更稳定的系统API访问能力,能确保正确获取当前Activity信息。

方案二:优化选择器表达式

修改规则中的选择器,增加更严格的限制条件:

'[text*="跳"][visibleToUser=true][vid!="tag_name"]'

这样可以减少误触发的概率,但需要注意:

  1. 如果首页有标题或UP主名称包含"跳"字,仍可能误触发
  2. 这只是一个缓解方案,不能从根本上解决Activity ID获取失败的问题

最佳实践建议

  1. 对于关键规则,建议同时采用两种方案
  2. 在规则设计时,应考虑Activity ID可能获取失败的情况
  3. 对于重要功能,建议增加更精确的选择器条件
  4. 定期检查规则的有效性,特别是在应用更新后

技术原理深入

Activity ID匹配失效的根本原因在于Android系统的权限限制。普通应用获取当前Activity信息需要特殊权限,而Shizuku通过系统级授权可以绕过这些限制。这也是为什么安装Shizuku能从根本上解决问题的原因。

对于无法使用Shizuku的环境,优化选择器表达式是次优方案。通过增加更多匹配条件,可以在一定程度上弥补Activity匹配的不足,但无法完全避免误触发。

登录后查看全文
热门项目推荐
相关项目推荐