2a00ef96c2
This pull request introduces custom screen transition animations to
enhance the overall user experience during navigation.
The key change is the implementation of a custom slide/fade effect for
navigating from main screens (i.e., screens hosted in the bottom
navigation bar) to detail screens. Transitions between the bottom
navigation bar tabs themselves retain a simple, clean cross-fade effect
to ensure a fast and smooth user interaction.
This PR also addresses the root cause of an issue where custom
animations were being overridden by the navigation library's defaults.
During implementation, it was discovered that custom transition
animations defined in the `defaultTransitions` parameter of the
`DestinationsNavHost` in `MainActivity` were not being applied. Instead,
a default fade-in/fade-out animation was always present.
The root cause was traced to the `compose-destinations` KSP (Kotlin
Symbol Processing) code generator. By default, the generator creates a
`NavGraphSpec` (e.g., `RootNavGraph.kt`) that includes its own
`defaultTransitions` property. This property, defined at compile-time
within the generated graph object, has a higher precedence than the
`defaultTransitions` parameter supplied to the `DestinationsNavHost`
composable at runtime.
As a result, our intended custom animations were being ignored and
overridden by the generated default.
To resolve this precedence issue permanently, this PR adopts the
official configuration method recommended by the `compose-destinations`
library.
- The following KSP argument has been added to the
`app/build.gradle.kts` file:
```kotlin
ksp {
arg("compose-destinations.defaultTransitions", "none")
}
```
- This argument instructs the code generator to omit the
`defaultTransitions` property from the generated `NavGraphSpec`.
- By removing the higher-priority, generated default, the
`defaultTransitions` parameter on `DestinationsNavHost` now functions as
the effective default, allowing our custom animation logic to execute as
intended.
The new animation logic is conditional and defined within
`MainActivity`. It distinguishes between two primary navigation types:
- Main Screen → Detail Screen:
- Enter: The new detail screen slides in from the right.
- Exit: The old main screen slides out to the left while fading out.
- Detail Screen → Main Screen (on Pop):
- Pop Enter: The main screen slides back in from the left while fading
in.
- Pop Exit: The detail screen slides out to the right.
- Between Bottom Navigation Tabs:
- A simple cross-fade (`fadeIn`/`fadeOut`) is maintained for these
transitions to provide a quick and non-disruptive experience when
switching between primary sections of the app.
SukiSU Ultra
基于 KernelSU 的安卓设备 root 解决方案
实验性! 使用风险自负!
这是非官方分支，@tiann 有权保留所有权利
但是，我们将会在未来成为一个单独维护的 KSU 分支
如何添加
在内核源码的根目录下执行以下命令：
使用 main 分支 (不支持非 GKI 设备构建) (需要手动集成 susfs)
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s main
使用支持非 GKI 设备的分支 (需要手动集成 susfs)
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s nongki
如何集成 susfs
- 直接使用 susfs-main 或者其他 susfs-* 分支，不需要再集成 susfs (支持非 GKI 设备构建)
Note
- 因 SuSFS 版本的变化和不可测问题
- 本 susfs-main 分支只在完整更新后再合并最新新版本
- 请随时留意 susfs 分支的变化情况以免导致构建失败以及各种版本导致的不兼容问题
curl -LSs "https://raw.githubusercontent.com/SukiSU-Ultra/SukiSU-Ultra/main/kernel/setup.sh" | bash -s susfs-main
钩子方法
- 此部分引用自 rsuntk 的钩子方法
-
KPROBES 钩子：
- 用于可加载内核模块 (LKM)
- GKI 2.0 内核的默认钩子方法
- 需要
CONFIG_KPROBES=y
-
手动钩子：
-
标准的 KernelSU 钩子：https://kernelsu.org/guide/how-to-integrate-for-non-gki.html#manually-modify-the-kernel-source
-
backslashxx 的 syscall 手动钩子：https://github.com/backslashxx/KernelSU/issues/5 (v1.5 版本暂不可用，如要使用请使用 v1.4 版本，或者标准 KernelSU 钩子)
-
非 GKI 内核的默认挂钩方法
-
需要
CONFIG_KSU_MANUAL_HOOK=y
-
KPM 支持
- 我们基于 KernelPatch 去掉了和 KSU 重复的功能，仅保留了 KPM 支持
- 我们将会引入更多的兼容 APatch 的函数来确保 KPM 功能的完整性
开源地址: https://github.com/ShirkNeko/SukiSU_KernelPatch_patch
KPM 模板地址: https://github.com/udochina/KPM-Build-Anywhere
Note
- 需要
CONFIG_KPM=y- 非 GKI 设备还需要
CONFIG_KALLSYMS=y和CONFIG_KALLSYMS_ALL=y- 部分内核
4.19以下源码还需要从4.19向后移植头文件set_memory.h
如何进行系统更新保留 ROOT
- OTA 后先不要重启，进入管理器刷写/修补内核界面，找到
GKI/non_GKI安装选择需要刷写的 Anykernel3 内核压缩文件，选择与现在系统运行槽位相反的槽位进行刷写并重启即可保留 GKI 模式更新（暂不支持所有非 GKI 设备使用这种方法，请自行尝试。非 GKI 设备使用 TWRP 刷写是最稳妥的） - 或者使用 LKM 模式的安装到未使用的槽位（OTA 后）
兼容状态
-
KernelSU（v1.0.0 之前版本）正式支持 Android GKI 2.0 设备（内核 5.10+）
-
旧内核（4.4+）也兼容，但必须手动构建内核
-
通过更多的反向移植，KernelSU 可以支持 3.x 内核（3.4-3.18）
-
目前支持
arm64-v8a，armeabi-v7a (bare)和部分X86_64
更多链接
如果你需要为管理器提交翻译请前往 https://crowdin.com/project/SukiSU-Ultra
基于 SukiSU 和 susfs 编译的项目
使用方法
普适的 GKI
请全部参考 https://kernelsu.org/zh_CN/guide/installation.html
Note
- 适用于如小米、红米、三星等的 GKI 2.0 的设备 (不包含魔改内核的厂商如魅族、一加、真我和 oppo)
- 找到更多链接里的 GKI 构建的项目。找到设备内核版本。然后下载下来，用 TWRP 或者内核刷写工具刷入带 AnyKernel3 后缀的压缩包即可。Pixel 请使用不是增强的 GKI。
- 一般不带后缀的 .zip 压缩包是未压缩的，gz 后缀的为天玑机型所使用的压缩方式
一加
1.找到更多链接里的一加项目进行自行填写，然后云编译构建，最后刷入带 AnyKernel3 后缀的压缩包即可
Note
- 内核版本只需要填写前两位即可，如 5.10，5.15，6.1，6.6
- 处理器代号请自行搜索，一般为全英文不带数字的代号
- 分支和配置文件请自行到一加内核开源地址进行填写
特点
- 基于内核的
su和 root 访问管理 - 基于 5ec1cff 的 Magic Mount 的模块系统
- App Profile：将 root 权限锁在笼子里
- 恢复对非 GKI 2.0 内核的支持
- 更多自定义功能
- 对 KPM 内核模块的支持
- 引入 SuSFS 配置的管理器以及进阶功能
疑难解答
- 卸载 KernelSU 管理器设备卡死。→ 卸载包名为 com.sony.playmemories.mobile 的应用。
许可证
kernel目录下的文件是 GPL-2.0-only。- 有动漫人物图片表情包的这些文件
ic_launcher(?!.*alt.*).*的图像版权为怡子曰曰所有，图像中的知识产权由明风 OuO所有，矢量化由 @MiRinChan 完成，在使用这些文件之前，除了必须遵守 Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International 以外，还需要遵守向前两者索要使用这些艺术内容的授权。 - 除了以上所述的文件或目录外，所有其他部分均为 GPL-3.0 或更高版本。
爱发电链接
赞助名单
- Ktouls 非常感谢你给我带来的支持
- zaoqi123 请我喝奶茶也不错
- wswzgdg 非常感谢对此项目的支持
- yspbwx2010 非常感谢
- DARKWWEE 感谢老哥的 100 USDT
- Saksham Singla 网站的提供以及维护
- OukaroMF 网站域名捐赠
贡献
- KernelSU：原始项目
- MKSU：使用的项目
- RKSU：使用该项目的 kernel 对非 GKI 设备重新进行支持
- susfs4ksu：使用的 susfs 文件系统
- kernel-assisted-superuser：KernelSU 的构想
- Magisk：强大的 root 工具
- genuine：APK v2 签名验证
- Diamorphine：一些 rootkit 技能
- KernelPatch: KernelPatch 是 APatch 实现内核模块的关键部分