使用 Anubis 和 Shizuku 根据 VPN…

在 Android 10+ 设备上通过 Shizuku 使用 pm disable-user 按 VPN 连接状态自动完全禁用或启用应用组，实现应用无法在错误网络状态下运行。

适用场景

解决思路

1. 安装并启动 Shizuku：通过 ADB 或无线调试执行 `adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh`。
2. 安装 Anubis APK。
3. 在提示时授予 Shizuku 权限。
4. 在提示时授予 VPN 权限（用于 dummy VPN 断开）。
5. 进入 Apps 标签，将应用分配到组。
6. 在 Settings 中选择 VPN 客户端。
7. 在 Home 屏幕打开 stealth mode。
8. 构建项目：`git clone https://github.com/sogonov/anubis`，`cd anubis`；调试构建 `./gradlew assembleDebug`；发布构建 `./gradlew assembleRelease`（需要签名配置）。
9. 为发布构建在项目根目录创建 `signing.properties`，包含 `storeFile=release.keystore`、`storePassword=${KEYSTORE_PASSWORD}`、`keyAlias=${KEY_ALIAS}`、`keyPassword=${KEY_PASSWORD}`。
10. 使用 Kotlin + Jetpack Compose (Material 3)、Shizuku API 13.1.5 (AIDL UserService pattern)、Room 数据库带 TypeConverters、ConnectivityManager NetworkCallback、ShortcutManager 等技术栈。
11. 按项目结构组织代码：`data/` 下放 `AppGroup.kt`、`AppGroupDao.kt`、`AppDatabase.kt`；`service/` 下放 `ShizukuService.kt`、`VpnStateMonitor.kt`、`FreezeManager.kt`；`vpn/` 下放 `VpnClient.kt`、`VpnClientRegistry.kt`；`ui/` 下放 `HomeScreen.kt`、`AppsScreen.kt`、`SettingsScreen.kt`。
12. 定义 Room 实体 `AppGroup`：包含 `id`、`name`、`policy`、`packages`（通过 TypeConverter 存储）；定义 `GroupPolicy` 枚举：`LOCAL`（VPN 活跃时冻结）、`VPN_ONLY`（VPN 非活跃时冻结）、`LAUNCH_WITH_VPN`（从不冻结，启动时触发 VPN）。
13. 定义 `AppGroupDao` 接口：`getAllGroups(): Flow<List<AppGroup>>`、`insertGroup`、`deleteGroup`、`updateGroup`。
14. 定义 AIDL 接口 `IShizukuService`：`executeCommand(String command)` 和 `destroy()`。
15. 实现 `ShizukuUserService`：继承 `IShizukuService.Stub`，在 `executeCommand` 中通过 `Runtime.getRuntime().exec` 执行 `sh -c command`，`destroy` 中调用 `exitProcess(0)`。
16. 在 `FreezeManager` 中绑定 UserService：使用 `Shizuku.UserServiceArgs`，设置 `processNameSuffix` 为 `service`、`debuggable(false)`、`version(1)`；在 `ServiceConnection` 中通过 `IShizukuService.Stub.asInterface(binder)` 获取服务；检查 `Shizuku.checkSelfPermission() == PackageManager.PERMISSION_GRANTED` 后调用 `Shizuku.bindUserService`；解绑用 `Shizuku.unbindUserService`。
17. 实现冻结/解冻：`freezePackage` 执行 `pm disable-user --user 0 $packageName`；`unfreezePackage` 执行 `pm enable --user 0 $packageName`。
18. 实现 VPN 状态监控 `VpnStateMonitor`：获取 `ConnectivityManager`，使用 `MutableStateFlow<Boolean>` 暴露 `isVpnActive`；创建 `NetworkCallback`，在 `onAvailable` 中检查 `capabilities?.hasTransport(NetworkCapabilities.TRANSPORT_VPN) == true` 则置 true；在 `onLost` 中重新检查所有网络是否有 VPN transport，更新状态；用 `NetworkRequest.Builder().addTransportType(NetworkCapabilities.TRANSPORT_VPN).build()` 注册回调。
19. 定义 VPN 客户端控制枚举 `VpnControlMethod`：`SEPARATE`、`TOGGLE`、`MANUAL`。
20. 定义 `VpnClientConfig` 数据类：包含 `packageName`、`method`、`startAction`、`stopAction`、`toggleAction`、`receiverClass`。
21. 预置已知 VPN 客户端：`com.v2ray.ang`（TOGGLE，toggleAction=`com.v2ray.ang.action.widget.click`，receiverClass=`com.v2ray.ang.receiver.WidgetProvider`）、`moe.nb4a`（SEPARATE，startAction=`moe.nb4a.ui.QuickEnable`，stopAction=`moe.nb4a.ui.QuickDisable`）、`com.happproxy`（TOGGLE，toggleAction=`com.happproxy.action.widget.click`，receiverClass=`com.happproxy.receiver.WidgetProvider`）。
22. 实现 `startVpn`：对于 TOGGLE/SEPARATE，如果有 `receiverClass` 则执行 `am broadcast -a $action -n ${config.packageName}/${config.receiverClass}`，否则执行 `am start -n ${config.packageName}/$action`；对于 MANUAL，使用 `packageManager.getLaunchIntentForPackage` 打开应用。
23. 实现 `stopVpn`：对于 SEPARATE 且有 `stopAction`，先执行 `am start -n ${config.packageName}/${config.stopAction}` 并 `delay(1000)`；然后执行 `am force-stop ${config.packageName}` 作为回退。
24. 实现检测活跃 VPN 客户端：执行 `dumpsys connectivity`，找包含 `type: VPN[` 的行，用正则 `ownerUid=(\d+)` 提取 uid，再执行 `pm list packages --uid $uid`，解析 `package:` 后的包名。
25. 添加自定义 VPN 客户端：用 jadx 打开 APK；在 Resources 中找 `app_widget_name`；在 Manifest 中找带 `android.appwidget.provider` metadata 的 `<receiver>`；在 Receiver 代码中找 `setAction` 调用；验证 toggle 模式为 `isRunning ? stop : start`；对于 v2ray/xray 分支，使用模板：packageName 为 `com.example.vpnclient`，toggleAction 为 `$packageName.action.widget.click`，receiverClass 为 `$packageName.receiver.WidgetProvider`；用 `adb shell am broadcast -a $toggleAction -n $packageName/$receiverClass` 手动验证。
26. 在 Settings 中注册自定义客户端：在 `SettingsViewModel.setCustomVpnClient` 中创建 `VpnClientConfig(packageName, VpnControlMethod.MANUAL)`，保存到 preferences（后续可升级为 TOGGLE）。
27. 创建固定快捷方式：使用 `ShortcutManager`，检查 `isRequestPinShortcutSupported`，构建 `ShortcutInfo`（设置 shortLabel、icon、intent 指向 `LaunchActivity` 并携带 `package_name`），调用 `requestPinShortcut`。
28. 实现 Compose UI `AppGroupCard`：使用 Card 包含组名、策略选择器（FilterChip 遍历 `GroupPolicy.entries`）、应用列表（每行显示包名和移除按钮）、添加应用按钮。
29. 实现 `AppOrchestrator.onVpnStateChanged`：获取所有组，对每个组根据策略处理：`LOCAL` 在 VPN 活跃时冻结，非活跃时解冻；`VPN_ONLY` 在 VPN 非活跃时冻结，活跃时解冻；`LAUNCH_WITH_VPN` 从不自动冻结。
30. 实现 `freezeGroup`：遍历组内包，调用 `freezeManager.freezePackage(pkg)`。
31. 实现 `unfreezeGroup`：安全检查，仅当 `!vpnMonitor.isVpnActive.value || group.policy == GroupPolicy.LOCAL` 时遍历包调用 `freezeManager.unfreezePackage(pkg)`。
32. 处理 Shizuku 权限拒绝：检查 `Shizuku.checkSelfPermission()`，如果未授予，若 `Shizuku.shouldShowRequestPermissionRationale()` 则显示理由对话框，否则调用 `Shizuku.requestPermission(REQUEST_CODE_SHIZUKU)`。
33. 排查应用未冻结：手动执行 `adb shell pm disable-user --user 0 com.example.app` 验证；用 `adb shell pm list packages -d` 列出已禁用应用；用 `adb shell pm enable --user 0 com.example.app` 手动重新启用。
34. 排查 VPN 检测失败：执行 `adb shell dumpsys connectivity | grep -A5 type: VPN` 调试输出；用 `adb shell pm list packages --uid 1234` 检查 UID 解析。
35. 排查自定义 VPN 客户端切换不工作：手动执行 `adb shell am broadcast -a com.example.vpn.action.widget.click -n com.example.vpn/.receiver.WidgetProvider`，预期 result=0 (RESULT_OK) 或检查 logcat：`adb logcat | grep -i widgetprovider|broadcast`。
36. 处理 VPN 断开后应用仍冻结：Anubis 在 VPN 仍活跃时从不解冻；用 `adb shell dumpsys connectivity | grep VPN` 检查 VPN 完全断开；通过长按应用图标 → Unfreeze 手动解冻。
37. 添加 Gradle 依赖：Shizuku `dev.rikka.shizuku:api:13.1.5` 和 `dev.rikka.shizuku:provider:13.1.5`；Room `androidx.room:room-runtime:2.6.1`、`androidx.room:room-ktx:2.6.1`、`ksp(androidx.room:room-compiler:2.6.1)`；Compose BOM `androidx.compose:compose-bom:2024.02.00` 及 ui、material3；Coroutines + ViewModel `androidx.lifecycle:lifecycle-viewmodel-compose:2.7.0`、`org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3`。

适用边界 · 注意事项

• 需要 Android 10+ 且已安装并运行 Shizuku，否则无法使用。
• 需要至少一个 VPN 客户端，且自定义客户端需要手动分析 APK 并测试广播。
• 不适合需要应用保持后台运行或不能完全禁用的场景，因为 pm disable-user 会彻底禁用应用。