Knowledge Base updated: 2026-11-16
Knowledge Base Index
1. Orientation
This repository is the Android Shizuku project: a manager app plus privileged server/bootstrap components that let apps use Shizuku-mediated system APIs. The highest-level flow is: the manager app helps start the Shizuku server through root/ADB/shell bootstrap paths, then the server manages clients, permissions, and binder access.
Main parts:
manager/— Android app UI, settings, startup guidance, wireless ADB pairing, authorization, and app management.server/— privileged Shizuku daemon/service core, client tracking, config persistence, and user-service handling.starter/— bootstrap entrypoint used to start the privileged server process.shell/— shell-side loader for Shizuku shell integration.common/— shared Android utility library.- root Gradle/API wiring — includes local modules plus API subprojects under
apior a local API checkout.
Critical state lives primarily in Android-side preferences/config and server config files described in the owning docs: manager settings under the manager app, and server-side Shizuku config under the server daemon.
2. Architecture diagrams
flowchart TD
subgraph Build[Gradle project]
Root[settings.gradle / root build]
Api[api subprojects]
Common[common library]
end
subgraph App[manager app]
Home[home/settings UI]
Auth[authorization + app management]
Wadb[wireless ADB pairing]
Native[JNI starter helpers]
Utils[manager utilities/widgets]
end
subgraph Privileged[privileged runtime]
Starter[starter module]
Shell[shell loader]
Server[server daemon]
end
Root --> Common
Root --> Api
Root --> Home
Root --> Starter
Root --> Shell
Root --> Server
Home --> Auth
Home --> Wadb
Home --> Native
Home --> Starter
Home --> Shell
Starter --> Server
Shell --> Server
Server --> Api
Utils --> Home
Utils --> Auth
flowchart LR
User[User in manager] --> Home[HomeActivity/start cards]
Home --> Mode{Start mode}
Mode --> Root[Root start]
Mode --> Adb[ADB start]
Mode --> Wadb[Wireless ADB pairing]
Wadb --> Pairing[ADB pairing client/service]
Root --> Starter[starter/native helpers]
Adb --> Starter
Pairing --> Starter
Starter --> Server[Shizuku server]
Server --> Status[manager status UI]
sequenceDiagram
participant App as Requesting app
participant Manager as Manager authorization UI
participant Server as Shizuku server
participant Config as Shizuku config
App->>Server: request Shizuku access
Server->>Manager: permission request / state query
Manager->>User: grant or deny UI
User->>Manager: decision
Manager->>Server: authorization result
Server->>Config: persist client permission state
Server-->>App: allow or deny binder access
3. Glossary
- Shizuku — the project’s privileged service model that lets apps access selected system APIs through a brokered server.
- Manager — the Android app under
manager/used to start, monitor, configure, and authorize Shizuku. - Server daemon — the privileged runtime under
server/that manages clients, permissions, binders, and user services. - Starter — bootstrap code under
starter/and manager starter helpers used to launch the server from root/ADB/shell contexts. - Rish — shell integration packaged with the manager and covered by the shell/startup docs.
4. Codebase-wide invariants
- The repository is a multi-module Gradle Android project: settings.gradle includes
:server,:starter,:shell,:manager,:common, and API-related projects mapped underapior a local API directory. - Each in-repo Android module has a module build file and manifest under its module root, e.g. manager/build.gradle with manager/…/AndroidManifest.xml, and the same pattern for
server/,starter/,shell/, andcommon/. - Manager native code is isolated under
manager/src/main/jni/**; non-manager modules in this repo do not have siblingsrc/main/jnitrees in the listed tracked structure. - Manager UI resources are centralized under
manager/src/main/res/**, while Java/Kotlin app logic lives undermanager/src/main/java/moe/shizuku/manager/**.
5. Routing table
-
gradle.properties-> docs/root-build-project-structure.md -
gradle/**-> docs/root-build-project-structure.md -
gradlew-> docs/root-build-project-structure.md -
gradlew.bat-> docs/root-build-project-structure.md -
.gitattributes-> docs/root-build-project-structure.md -
.gitignore-> docs/root-build-project-structure.md -
.gitmodules-> docs/root-build-project-structure.md -
.github/**-> docs/root-build-project-structure.md -
any change to Gradle module inclusion or API project mapping -> docs/root-build-project-structure.md
-
common/**-> docs/common-android-utilities.md -
server/**-> docs/server-daemon-core.md -
any change to Shizuku server client management, config persistence, binder sending, APK/user-service observation, or server APIs -> docs/server-daemon-core.md
-
starter/**-> docs/starter-bootstrap-flow.md -
any change to privileged server bootstrap entrypoints outside the manager UI -> docs/starter-bootstrap-flow.md
-
shell/**-> docs/shell-loader.md -
any change to shell-side Shizuku loading or rish integration -> docs/shell-loader.md
-
manager/build.gradle -> docs/manager-app-shell-home-settings.md
-
manager/proguard-rules.pro-> docs/manager-app-shell-home-settings.md -
manager/aapt2-resources.cfg-> docs/manager-app-shell-home-settings.md -
manager/…/AndroidManifest.xml -> docs/manager-app-shell-home-settings.md
-
manager/src/main/assets/**-> docs/manager-app-shell-home-settings.md -
manager/…/AppConstants.java -> docs/manager-app-shell-home-settings.md
-
manager/…/Helps.java -> docs/manager-app-shell-home-settings.md
-
manager/…/MainActivity.java -> docs/manager-app-shell-home-settings.md
-
manager/…/Manifest.java -> docs/manager-app-shell-home-settings.md
-
manager/…/ShizukuApplication.kt -> docs/manager-app-shell-home-settings.md
-
manager/…/ShizukuManagerProvider.kt -> docs/manager-app-shell-home-settings.md
-
manager/…/ShizukuSettings.java -> docs/manager-app-shell-home-settings.md
-
manager/src/main/java/moe/shizuku/manager/app/**-> docs/manager-app-shell-home-settings.md -
manager/src/main/java/moe/shizuku/manager/home/**-> docs/manager-app-shell-home-settings.md -
manager/src/main/java/moe/shizuku/manager/model/**-> docs/manager-app-shell-home-settings.md -
manager/src/main/java/moe/shizuku/manager/receiver/**-> docs/manager-app-shell-home-settings.md -
manager/src/main/java/moe/shizuku/manager/settings/**-> docs/manager-app-shell-home-settings.md -
manager/src/main/res/**-> docs/manager-app-shell-home-settings.md -
any change to the manager home screen, settings, app lifecycle, app manifest, or backing UI resources -> docs/manager-app-shell-home-settings.md
-
manager/src/main/java/moe/shizuku/manager/adb/**-> docs/manager-adb-wireless-pairing.md -
manager/…/adb_pairing.cpp -> docs/manager-adb-wireless-pairing.md
-
manager/…/adb_pairing.h -> docs/manager-adb-wireless-pairing.md
-
any change to wireless debugging pairing, ADB protocol/client handling, or mDNS discovery -> docs/manager-adb-wireless-pairing.md
-
manager/…/CMakeLists.txt -> docs/manager-native-starter-helpers.md
-
manager/…/android.cpp -> docs/manager-native-starter-helpers.md
-
manager/…/android.h -> docs/manager-native-starter-helpers.md
-
manager/…/cgroup.cpp -> docs/manager-native-starter-helpers.md
-
manager/…/cgroup.h -> docs/manager-native-starter-helpers.md
-
manager/…/helper.cpp -> docs/manager-native-starter-helpers.md
-
manager/…/logging.h -> docs/manager-native-starter-helpers.md
-
manager/…/misc.cpp -> docs/manager-native-starter-helpers.md
-
manager/…/selinux.cpp -> docs/manager-native-starter-helpers.md
-
manager/…/selinux.h -> docs/manager-native-starter-helpers.md
-
manager/…/starter.cpp -> docs/manager-native-starter-helpers.md
-
any change to manager JNI starter, SELinux, cgroup, Android native helpers, or native build wiring -> docs/manager-native-starter-helpers.md
-
manager/src/main/java/moe/shizuku/manager/authorization/**-> docs/manager-authorization-and-app-management.md -
manager/src/main/java/moe/shizuku/manager/management/**-> docs/manager-authorization-and-app-management.md -
any change to permission request handling, grant/revoke UI, or managed app lists -> docs/manager-authorization-and-app-management.md
-
manager/src/main/java/moe/shizuku/manager/starter/**-> docs/manager-startup-and-legacy-flows.md -
manager/src/main/java/moe/shizuku/manager/shell/**-> docs/manager-startup-and-legacy-flows.md -
manager/src/main/java/moe/shizuku/manager/legacy/**-> docs/manager-startup-and-legacy-flows.md -
any change to manager-facing start flows, shell binder requests, terminal tutorial support, or legacy compatibility screens -> docs/manager-startup-and-legacy-flows.md
-
manager/src/main/java/moe/shizuku/manager/ktx/**-> docs/manager-utilities-and-widgets.md -
manager/src/main/java/moe/shizuku/manager/utils/**-> docs/manager-utilities-and-widgets.md -
manager/src/main/java/moe/shizuku/manager/widget/**-> docs/manager-utilities-and-widgets.md -
any change to manager shared extensions, logging, system API wrappers, icon/cache helpers, locale/preference helpers, or reusable widgets -> docs/manager-utilities-and-widgets.md