Skip to content

Commit

Permalink
feat: Update Version to 5.2.0
Browse files Browse the repository at this point in the history
  • Loading branch information
HChenX committed Feb 13, 2025
1 parent 47f8a8e commit bd0db3c
Show file tree
Hide file tree
Showing 3 changed files with 40 additions and 23 deletions.
53 changes: 34 additions & 19 deletions README-en.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,10 +17,11 @@

## ✨ Module Introduction

AppRetentionHook is an **LSP module** that implements **background retention** by hooking into the system’s kill logic.
📌 **Version 5.1 is a completely refactored new version!!** Give it a try!
AppRetentionHook is an **LSP module** that implements **background retention** by hooking into the
system’s kill logic.
📌 **Version 5.1+ is a completely refactored new version!!** Give it a try!

🔹 **Supported Systems** (for version 5.1):
🔹 **Supported Systems** (for version 5.1+):

-**HyperOS V1 / V2**
-**AOSP 10-15**
Expand All @@ -32,7 +33,8 @@ AppRetentionHook is an **LSP module** that implements **background retention** b
## 🛠 Usage Notice

> 📌 **Why might some applications still be killed?**
> **This module only intercepts kills triggered by system scheduling; it cannot address application crashes, self-termination, or other similar behaviors!**
> **This module only intercepts kills triggered by system scheduling; it cannot address application
crashes, self-termination, or other similar behaviors!**

📌 **Intercepted Kill Sources (system behaviors):**

Expand All @@ -49,7 +51,8 @@ AppRetentionHook is an **LSP module** that implements **background retention** b
- Application ANR (not responding), updates, self-termination, uninstallation, crashes, etc.

💡 **Module Objective:**
**Opened applications will not be killed due to system scheduling, thereby prolonging their background retention as much as possible!**
**Opened applications will not be killed due to system scheduling, thereby prolonging their
background retention as much as possible!**

---

Expand All @@ -60,16 +63,19 @@ AppRetentionHook is an **LSP module** that implements **background retention** b
1. **Installation**: Download and install this module.
2. **Activation**: Open LSP, select this module, and enable it.
3. **Select the applicable scopes** (depending on the system):
- **MIUI / HyperOS**: `System Framework (system)` and `Battery & Performance (powerkeeper)` [if available]
- **Color OS**: `Athena`, `Battery`, and `System Framework (system)` (Note: Version 5.1 is not fully adapted for Color OS, but it is usable)
- **MIUI / HyperOS**: `System Framework (system)` and
`Battery & Performance (powerkeeper)` [if available]
- **Color OS**: `Athena`, `Battery`, and `System Framework (system)` (Note: Version 5.1+ is not
fully adapted for Color OS, but it is usable)
- **OneUI**: `System Framework (system)`
4. **Restart your device!**

---

## 🌟 Module Effects

✅ Testing shows that the background retention time of apps has **significantly increased**, with no system-initiated app kills observed over extended periods.
✅ Testing shows that the background retention time of apps has **significantly increased**, with no
system-initiated app kills observed over extended periods.
**Even after an entire night, apps continue to run in the background.**
**Example Apps** (including but not limited to):

Expand All @@ -80,13 +86,17 @@ AppRetentionHook is an **LSP module** that implements **background retention** b

## ⚠ Potential Issues

**Due to modifications in the system’s operational logic, this module may have the following impacts:**
**Due to modifications in the system’s operational logic, this module may have the following
impacts:**

1. **Failure of system memory management**: When memory is low, automatic cleanup will not occur, which may result in system freezes.
2. **Increased standby power consumption**: Although the impact is minor, battery usage may be slightly higher.
1. **Failure of system memory management**: When memory is low, automatic cleanup will not occur,
which may result in system freezes.
2. **Increased standby power consumption**: Although the impact is minor, battery usage may be
slightly higher.
3. **Some devices may experience boot hang issues.**

🚨 **Strongly Recommended**: Please ensure you have a backup before using this module to avoid extreme issues such as failure to boot!
🚨 **Strongly Recommended**: Please ensure you have a backup before using this module to avoid
extreme issues such as failure to boot!

---

Expand All @@ -98,29 +108,34 @@ AppRetentionHook is an **LSP module** that implements **background retention** b
**Q: Does this module conflict with other retention modules?**
💡 A: Yes, **please do not use multiple modules with the same functionality simultaneously!**
Examples of conflicting modules include:

- **Don-t-Kill**
- **Cemiuiler** (overlapping functionalities)
- **A1 Memory Management LSP Module**

**Q: Why is my system freezing?**
💡 A: Please check your device's **memory usage**. This module does not perform automatic memory cleanup.
💡 A: Please check your device's **memory usage**. This module does not perform automatic memory
cleanup.

**Q: Why has my standby power consumption increased?**
💡 A: With apps staying alive in the background for longer, **increased power consumption is a normal phenomenon**, though the impact is minimal.
💡 A: With apps staying alive in the background for longer, **increased power consumption is a normal
phenomenon**, though the impact is minimal.

**Q: Why does my device hang during boot?**
💡 A: Some devices may be incompatible. If you encounter this issue, please uninstall the module and provide feedback.
💡 A: Some devices may be incompatible. If you encounter this issue, please uninstall the module and
provide feedback.

---

## 🙏 Acknowledgments

💡 Some parts of this module's code reference the following projects. Special thanks to:

| Project Name | Project Link |
|----------------|-----------------------------------------------------------------------------------|
| Cemiuiler | [Cemiuiler GitHub](https://github.com/Team-Cemiuiler/Cemiuiler/tree/main) |
| Don't Kill | [Don-t-Kill](https://github.com/HChenX/Don-t-Kill) |
| Project Name | Project Link |
|--------------|---------------------------------------------------------------------------|
| Cemiuiler | [Cemiuiler GitHub](https://github.com/Team-Cemiuiler/Cemiuiler/tree/main) |
| Don't Kill | [Don-t-Kill](https://github.com/HChenX/Don-t-Kill) |
| HookTool | [HookTool](https://github.com/HChenX/HookTool) |

📌 **Translation Provided By:**

Expand Down
8 changes: 5 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,9 @@
## ✨ 模块介绍

AppRetentionHook 是一款 **Lsp 模块**,通过 **Hook 系统 kill 逻辑** 来实现 **后台保活**
📌 **5.1 版本是重构后的全新版本!!** 快来体验吧!
📌 **5.1+ 版本是重构后的全新版本!!** 快来体验吧!

🔹 **适配系统**(5.1 版本支持范围):
🔹 **适配系统**(5.1+ 版本支持范围):

-**HyperOS V1 / V2**
-**AOSP 10-15**
Expand Down Expand Up @@ -61,7 +61,7 @@ AppRetentionHook 是一款 **Lsp 模块**,通过 **Hook 系统 kill 逻辑**
2. **激活**:进入 Lsp 选择本模块并启用
3. **勾选作用域**(不同系统):
- **MIUI / HyperOS**`系统框架(system)``电量与性能(powerkeeper) [如果有]`
- **Color OS**`雅典娜(Athena)``电池``系统框架(system)`(5.1 版本未适配,仅可用)
- **Color OS**`雅典娜(Athena)``电池``系统框架(system)`(5.1+ 版本未适配,仅可用)
- **OneUi**`系统框架(system)`
4. **重启设备即可!**

Expand Down Expand Up @@ -122,6 +122,7 @@ AppRetentionHook 是一款 **Lsp 模块**,通过 **Hook 系统 kill 逻辑**
|------------|---------------------------------------------------------------------------|
| Cemiuiler | [Cemiuiler GitHub](https://github.com/Team-Cemiuiler/Cemiuiler/tree/main) |
| Don't Kill | [Don-t-Kill](https://github.com/HChenX/Don-t-Kill) |
| HookTool | [HookTool](https://github.com/HChenX/HookTool) |

📌 **翻译提供**

Expand All @@ -137,4 +138,5 @@ AppRetentionHook 是一款 **Lsp 模块**,通过 **Hook 系统 kill 逻辑**
**抄袭将导致项目闭源!请注明作者!**

## 🎉结尾

💖 **感谢你的支持,Enjoy your day!** 🚀
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ public void onChange(boolean selfChange) {
}
}
);
XposedLog.logI(TAG, "system boot completed!!");
XposedLog.logI(TAG, "System boot completed!!");
}
case SaveLog.ACTION_LOG_SERVICE_CONTENT -> {
SaveLog.LogContentData logContentData;
Expand Down

0 comments on commit bd0db3c

Please sign in to comment.