Skip to content

Latest commit

 

History

History
209 lines (125 loc) · 7.08 KB

README_EN.md

File metadata and controls

209 lines (125 loc) · 7.08 KB
Raw

简体中文 | English

English is not my native language. Help us translate README

Hail 雹

Android CI status Translation status Downloads License

Hail is a free-as-in-freedom software to freeze Android apps. GitHub Releases

Get it on F-Droid

Freeze

Freeze is a word to describe the action of forbid apps when they are unnecessary to use device in a better way, cut down the usage of ram and save power. User can unfreeze them to revert.

In general, "freeze" means disable, but also Hail can "freeze" apps by hiding and suspending them.

Disable

Disabled apps will not be shown in the launcher and will be shown as "Disabled" in the installed apps list. Enable them to revert.

Hide

Hidden apps will not be shown in the launcher and installed apps list. Unhide them to revert.

While in this state, which is almost like an uninstalled state, making the package unavailable, but it doesn't remove the data or the actual package file.

Suspend (Android 7.0+)

Suspended apps will be shown as grayscale icons in the launcher. Unsuspend them to revert.

While in this state, the application's notifications will be hidden, any of its started activities will be stopped and it will not be able to show toasts or dialogs or play audio. When the user tries to launch a suspended app, the system will, instead, show a dialog to the user informing them that they cannot use this app while it is suspended.

Working mode

Hail can work with Device Owner, Dhizuku, Superuser (Root) and Shizuku (including Sui).

Frozen app need to be unfrozen by the same working mode.

  1. For devices support wifi adb or rooted, Shizuku is recommend.

  2. For rooted devices, Superuser is alternative. It is slower.

  3. Select Device Owner or Dhizuku otherwise. These are a pain to set up.

Device Owner - Hide / Suspend

This mode invoke:

  • DevicePolicyManager.setApplicationHidden to hide apps.

  • DevicePolicyManager.setPackagesSuspended to suspend apps.

You must remove device owner before uninstall

Set device owner by adb

Android Debug Bridge (adb) Guide

Download Android SDK Platform-Tools

Issue adb command:

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

A message will shown if it has been successfully set:

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

Search the message by search engine otherwise.

Remove device owner

Settings > Remove Device Owner

Dhizuku - Hide / Suspend

This mode invoke:

  • DevicePolicyManager.setApplicationHidden to hide apps.

  • DevicePolicyManager.setPackagesSuspended to suspend apps.

Superuser - Disable / Hide / Suspend

This mode execute:

  • pm disable to disable apps.

  • pm hide to hide apps.

  • pm suspend to suspend apps.

Shizuku - Disable / Hide / Suspend

This mode invoke non-SDK interface:

  • IPackageManager.setApplicationEnabledSetting to disable apps.

  • IPackageManager.setApplicationHiddenSettingAsUser to hide apps. (root required)

  • IPackageManager.setPackagesSuspendedAsUser to suspend apps.

Revert

By adb

Replace com.package.name to the package name of target app.

# Enable app
adb shell pm enable com.package.name
# Unhide app (root required)
adb shell su -c pm unhide com.package.name
# Unsuspend app
adb shell pm unsuspend com.package.name

Modify file

Access /data/system/users/0/package-restrictions.xml, this file stores the restrictions about apps. You can modify, rename or just delete it.

  • Enable app: Modify the value of enabled from 2 (DISABLED) or 3 (DISABLED_USER) to 1 (ENABLED)

  • Unhide app: Modify the value of hidden from true to false

  • Unsuspend app: Modify the value of suspended from true to false

Wipe data by recovery

None of my business :(

API

adb shell am start -a action -e name value

action can be one of the following constants:

  • com.aistra.hail.action.LAUNCH: Unfreeze and launch target app. If it is unfrozen, it will launch directly. name="package" value="com.package.name"

  • com.aistra.hail.action.FREEZE: Freeze target app. It must be checked at Home. name="package" value="com.package.name"

  • com.aistra.hail.action.UNFREEZE: Unfreeze target app. name="package" value="com.package.name"

  • com.aistra.hail.action.FREEZE_TAG: Freeze all non-whitelisted apps in the target tag. name="tag" value="Tag name"

  • com.aistra.hail.action.UNFREEZE_TAG: Unfreeze all apps in the target tag. name="tag" value="Tag name"

  • com.aistra.hail.action.FREEZE_ALL: Freeze all apps at Home. extra is not necessary.

  • com.aistra.hail.action.UNFREEZE_ALL: Unfreeze all apps at Home. extra is not necessary.

  • com.aistra.hail.action.FREEZE_NON_WHITELISTED: Freeze all non-whitelisted apps at Home. extra is not necessary.

  • com.aistra.hail.action.LOCK: Lock screen. extra is not necessary.

  • com.aistra.hail.action.LOCK_FREEZE: Freeze all apps at Home and lock screen. extra is not necessary.

Help Translate

To translate Hail into your language, or to improve an existing translation, use Weblate.

Translation status

License

Hail - Freeze Android apps
Copyright (C) 2021-2023 Aistra

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.