Note
本项目是 GSWXXN/RestoreSplashScreen 的修改版，以 AGPL-3.0 继续分发。详见 出处与许可。
按模块设置页归类，改完多数选项会立刻热重载，不必重启。
|
|
|
|
MIUI / HyperOS 与 ColorOS 走专门分支，其余系统走 AOSP 通用路径。
| 项 | 说明 |
|---|---|
| 系统 | Android 14 及以上（minSdk 34） |
| 框架 | 实现 libxposed API 101 的框架即可；API 102 额外支持热重载 |
| 作用域 | 至少勾选 系统界面（com.android.systemui） |
| 适配 | 重点覆盖 MIUI / HyperOS、ColorOS；其余 ROM 走通用路径 |
Note
框架只有 API 101 时，Hook 与设置热更新仍然可用，但模块 APK 更新后需要重启系统界面（勾了系统框架则重启手机）。API 102 会自动热重载，一般不必重启。
flowchart TD
A[安装模块并在管理器中激活] --> B[勾选系统界面 com.android.systemui]
B --> C{要用强制显示、热启动<br>或彻底关闭？}
C -->|否| D[重启系统界面]
C -->|是| E[再勾选系统框架 android 并重启手机]
D --> F[打开「启动遮罩进化A」调整选项]
E --> F
F --> G[多数设置立即生效；API 102 还可热重载模块更新]
| 功能 | 系统界面 | 系统框架 | 生效方式 |
|---|---|---|---|
| 图标 / 背景 / 时长 / 作用域等常规项 | 需要 | — | 改设置即时生效；API 101 下更新模块后需重启系统界面 |
| 强制显示遮罩 | 需要 | 需要 | 重启手机 |
| 热启动遮罩 | 需要 | 需要 | 须同时开启「强制开启启动遮罩」，并重启手机 |
| 彻底关闭 Splash Screen | — | 需要 | 重启手机；开启后模块内其余选项不再起作用 |
Warning
「强制开启启动遮罩」只在模块已激活却完全不生效时再试。正常工作时不要打开，否则可能在不该出现的场景显示遮罩，或挡住应用自己设置的背景图。
Tip
「最小持续时长」会拖慢应用启动。没有明确需求就保持默认。
需要 JDK 21 与 Android SDK Platform 37。
git clone https://github.com/jichuo1/SplashScreenAdvanced.git
cd SplashScreenAdvanced
./gradlew :app:assembleDebug| 产物 | 命令 / 入口 |
|---|---|
| Debug APK | ./gradlew :app:assembleDebug |
| Alpha 预发布 | 向 main 推送，或手动运行 alpha-release |
| Stable 发布 | stable-release |
发布签名使用 GitHub Environment Secrets，密钥库不要放进仓库。步骤见 release-signing。
使用交流与问题讨论，欢迎加入 Telegram 交流群。提交 Bug 请按下方说明提供信息，方便跟进。
请先到 Releases 确认已是最新版本，再提交 Issue，并附上：
- Android 版本、ROM 及版本号
- Xposed 框架名称与版本（API 101 或 102）
- 复现步骤，以及是否勾选了系统框架
- 模块日志与框架日志：在设置中打开「启用日志」后复现（日志会在 24 小时后自动关闭）
日志里请去掉账号、路径等无关隐私后再上传。
本项目基于 GSWXXN/RestoreSplashScreen（作者 GSWXXN）修改而来。原作品与本仓库均以 GNU Affero General Public License v3.0 授权。
相对上游的主要变更包括：
- 模块包名与项目身份改为
com.SplashScreenAdvanced.xposedmodule - Hook 层的异常隔离、反射缓存、内存与线程安全修复
- 设置界面重组与图标加载优化
- 发布流水线改为 GitHub Actions + Environment Secrets 签名
- 新增对图标进行预先超分抗锯齿的相关实用功能
原作者的个人品牌素材、社区链接与捐赠信息已移除，它们指向的是原作者本人而非本项目。
| 项目 | 说明 |
|---|---|
| GSWXXN/RestoreSplashScreen | 上游项目 |
| libxposed | 模块 API 与服务 |
| KavaRef | 运行期反射 |
| DexKit | 宿主类查找 |
| BetterAndroid | Android 系统扩展 |
| miuix | 设置界面组件 |
| hyperx-compose | HyperOS 风格 Compose 壳 |
| Koin | 依赖注入 |
| Hide My Applist | 应用列表获取思路 |
| MiuiHome_R | 备份恢复逻辑参考 |
| MIUINativeNotifyIcon | 开源参考 |
| YukiHookAPI | 开源参考 |