雹APP使用教程

一、新手快速上手

下载安装

从下载页面选择渠道下载雹并安装。支持安卓 6.0及以上系统。

选择工作模式

打开雹，进入「设置」页面选择工作模式。推荐：安卓 11+或Root设备选Shizuku；无Root老设备可选设备所有者或Dhizuku。

勾选应用

进入「应用」界面，可看到所有可冻结的应用列表。点击需要冻结的应用，勾选后添加到首页冻结列表（支持多选）。

执行冻结

返回首页，点击右下角的「冻结」按钮，点击确定即完成冻结。

解冻恢复

需要恢复时，在首页点击「解冻」按钮即可恢复正常使用，应用数据完好保留。

提醒：被冻结的应用必须通过相同工作模式解冻，请牢记你使用的模式。

雹APP主界面，勾选应用后即可一键冻结

二、Shizuku模式设置（推荐）

Shizuku是最推荐的工作模式。使用前提：设备已Root，或安卓 11+支持无线调试。

步骤1：安装并启动Shizuku

安装Shizuku

从网盘或应用商店安装Shizuku应用。

启动服务（无线调试，安卓 11+）

手机开启「开发者选项」中的「无线调试」，在Shizuku中通过配对码完成配对并启动服务。

或通过Root启动

已Root设备直接在Shizuku中授予root权限，即可一键启动服务。

步骤2：在雹中选择Shizuku模式

进入设置

打开雹，进入「设置」页面，选择工作模式为Shizuku。

授权连接

按提示授权雹连接Shizuku服务，成功后即可开始冻结应用。

注意：Shizuku (adb) 模式无法隐藏应用（隐藏需要Root权限）。如需隐藏，请使用Root或Shizuku (root) / Sui模式。

Shizuku启动服务后，在雹中选择Shizuku工作模式

三、设备所有者（Device Owner）模式设置

无Root且不支持无线调试的设备，可选择设备所有者模式。需要电脑安装Android SDK Platform-Tools（包含adb工具）。

开启开发者选项与USB调试

在手机「设置」中连续点击版本号开启开发者选项，然后打开「USB调试」。

连接电脑

用数据线连接手机与电脑，允许USB调试授权。

执行adb命令

在电脑命令行中执行以下命令，将雹设置为设备所有者：

PowerShell / Terminal

adb shell dpm set-device-owner com.aistra.hail/.receiver.DeviceAdminReceiver

成功时输出：

成功输出

Success: Device owner set to package com.aistra.hail.
Active admin set to component {com.aistra.hail/com.aistra.hail.receiver.DeviceAdminReceiver}

回到雹选择模式

在雹「设置」中选择 设备所有者 工作模式，即可开始冻结应用。

重要：设置为设备所有者的应用，卸载前必须先移除设备所有者身份。移除方式：设置 > 移除设备所有者。

通过adb命令将雹设置为设备所有者，即可开始冻结

四、恢复 / 解冻被冻结的应用

方法一：使用雹解冻

打开雹，在首页点击「解冻」按钮，应用即刻恢复正常。

方法二：通过adb命令

将com.package.name替换为目标应用的包名：

启用应用（停用状态）

adb shell pm enable com.package.name

取消隐藏（需要Root）

adb shell su -c pm unhide com.package.name

取消暂停

adb shell pm unsuspend com.package.name

方法三：修改系统文件

访问 /data/system/users/0/package-restrictions.xml（存储应用限制信息），可修改、重命名或删除：

启用应用：将enabled值从2（DISABLED）或3（DISABLED_USER）改为1（ENABLED）
取消隐藏：将hidden从true改为false
取消暂停：将suspended从true改为false

提醒：请谨慎选择冻结的应用，以免陷入需要恢复模式清除数据才能解决的窘境。

五、特权系统应用模式（构建ROM场景）

该模式需配置privapp-permissions许可名单，并将雹作为特权系统应用安装，推荐在构建ROM时通过安卓.bp导入。需以下四项权限：

privapp-permissions.xml

<permissions>
    <privapp-permissions package="com.aistra.hail">
        <permission name="安卓.permission.PACKAGE_USAGE_STATS"/>
        <permission name="安卓.permission.FORCE_STOP_PACKAGES"/>
        <permission name="安卓.permission.CHANGE_COMPONENT_ENABLED_STATE"/>
        <permission name="安卓.permission.MANAGE_APP_OPS_MODES"/>
    </privapp-permissions>
</permissions>

六、自动化API

雹支持通过adb shell与URL Schema远程控制，可配合Tasker、MacroDroid等自动化工具打造场景化方案。

adb shell调用方式

通用格式

adb shell am start -a action -e key value

支持的Action列表

Action	功能	参数
`...action.LAUNCH` / `UNFREEZE`	解冻（并启动）应用	`package`
`...action.FREEZE`	冻结目标应用（需在首页）	`package`
`...action.FREEZE_TAG`	按标签冻结非白名单应用	`tag`
`...action.UNFREEZE_TAG`	按标签解冻应用	`tag`
`...action.FREEZE_ALL`	冻结首页全部应用	无
`...action.UNFREEZE_ALL`	解冻首页全部应用	无
`...action.FREEZE_NON_WHITELISTED`	冻结首页全部非白名单应用	无
`...action.FREEZE_AUTO`	自动冻结首页应用	无
`...action.LOCK`	锁定屏幕	无
`...action.LOCK_FREEZE`	冻结首页全部应用并锁屏	无

完整action前缀为com.aistra.hail.action.。v1.10.0起支持通过Uri执行API操作。

URL Schema形式

Schema	功能
`hail://launch?package=xxx`	解冻并启动
`hail://freeze?package=xxx`	冻结指定应用
`hail://unfreeze?package=xxx`	解冻指定应用
`hail://freeze_tag?tag=xxx`	按标签冻结
`hail://unfreeze_tag?tag=xxx`	按标签解冻
`hail://freeze_all`	冻结全部
`hail://unfreeze_all`	解冻全部
`hail://freeze_non_whitelisted`	冻结非白名单应用
`hail://freeze_auto`	自动冻结
`hail://lock`	锁屏
`hail://lock_freeze`	冻结并锁屏

示例：配合自动化工具时，可用hail://lock_freeze实现"离开即冻结并锁屏"，用hail://freeze_non_whitelisted保护白名单应用。