Android 上出现“应用未安装”时,不要先改配置文件,也不要先怀疑 VPN 网关。应先确认 Clash Meta for Android 是否真的以声明的包名落在系统里,再按“安装包是否进来 → 系统能否解析该包 → VPN 列表能否引用该包”的顺序缩小范围。仓库给出的应用包名为 com.github.metacubex.clash.meta。Android 平台对第三方 VPN 的前提是应用已安装且完成 VpnService.prepare();按应用分流时,被加入允许或禁止列表的应用也必须已经安装,否则会得到 PackageManager.NameNotFoundException,注释即为应用未安装。这两类“未安装”含义不同,排查顺序不能颠倒。
适用条件
本顺序适用于:安装程序提示失败或完成后桌面找不到应用、按包名查询不到、系统 VPN 页没有该应用、或把某应用加入分流列表时被判定未安装。不适用于尚未选择正确 ABI 或系统低于 Android 5.0 就反复点击安装包的情况——那应先回到 Requirement:最低 Android 5.0,建议 7.0 及以上,架构为 armeabi-v7a、arm64-v8a、x86 或 x86_64。始终开启 VPN 从 Android 7.0 起由系统拉起服务,8.0 起后台服务受限,这些只影响“已安装之后能否稳定作为 VPN 服务”,不能解释“包根本不在”。
建议的排查顺序
第一步,确认安装包是否对应本项目,并以包名 com.github.metacubex.clash.meta 在系统包列表中查询。查不到则视为未装上,不要进入 VPN 授权。第二步,对照系统版本与 ABI:低于 5.0 或不在四种架构内,安装器可能直接拒绝,表现为未安装。第三步,若包已存在,打开系统 VPN 界面(Settings > Network & Internet > VPN)看是否出现已接受连接请求的应用;首次激活前系统会弹出连接请求对话框,未确认则应用虽已安装,仍不是当前 VPN。第四步,若错误出现在按应用分流:官方接口要求加入列表前该应用必须已安装,应先 getPackageInfo 一类查询,捕获未安装异常后跳过,而不是把异常当成 Clash Meta 自身没装。第五步,确认不是工作资料或多用户环境装错配置文件——每个用户或工作资料只能运行一个 VPN 应用,装在另一用户下时,当前用户仍会表现为找不到。
每一步的判断依据
包名能查到且版本可读,说明 APK 已注册,可排除“文件没装进去”。包名查不到且安装器报失败,优先怀疑 ABI 或最低系统,而不是权限文案。系统 VPN 页能看到该应用,说明用户已接受过连接请求;完全没有条目,说明还未 prepare 成功或权限被撤销,establish() 在未准备或权限收回时会返回空。分流列表里某第三方应用报未安装,判断依据是该包名在设备上不存在,与 Clash Meta 是否已装无关。清单中 VPN 服务需声明 BIND_VPN_SERVICE 以及 android.net.VpnService 过滤器,这是系统能否找到服务的条件,但只有应用已经安装后才有意义。
仍失败时的下一步
若始终查不到包名:停止授权流程,回到版本与架构核对,更换符合 Requirement 的安装包,而不是重复发送启动意图。若包在、VPN 页没有:再次走系统连接请求,而不是重装。若仅分流列表报未安装:先安装目标应用或从列表去掉该包名,不要把 Clash Meta 卸掉重来。若系统已选中另一个 VPN,新服务启动会自动停下旧服务;此时应先在 VPN 页断开或忘记旧项,再准备本应用。权限被收回后必须重新 prepare,不能假定上次授权仍有效。
https://github.com/MetaCubeX/ClashMetaForAndroid https://developer.android.com/develop/connectivity/vpn