Repository navigation
Setting up Shizuku
Shizuku allows ordinary apps like ApkUp to use system-level Android application management APIs directlyβwithout Root and without having to tap "Install" and "Update" for every single package manually.
This guide provides a quick setup walkthrough. For advanced architecture details, refer to the full Shizuku & Background Installation Guide.
- 1. Why Use Shizuku with ApkUp?
- 2. Method A: Wireless Debugging (Android 11+, No PC Required)
- 3. Method B: Setup via PC / Mac (USB ADB)
- 4. Method C: Rooted Devices
- 5. Granting Shizuku Permission to ApkUp
- 6. Device-Specific Quirks (Xiaomi / HyperOS, Samsung, OnePlus)
Without Shizuku, Android requires user interaction for every APK installation: a system dialog pops up, requiring you to confirm each update one-by-one.
With Shizuku enabled:
- β Batch Updates: Update 20 apps in one go with a single tap.
- β Silent Background Installations: When scheduled background checks find updates, ApkUp can download and install them silently while your screen is off.
- β
Split APKs (
.apkm/ App Bundles): Multi-part split packages are merged and installed seamlessly via Android's PackageInstaller session API. - β
Play Store Attribution: Updates are tagged with Play Store installer metadata (
com.android.vending) so Play Protect and in-app billing remain intact.
If your device runs Android 11 or newer and is connected to Wi-Fi:
- Install Shizuku from Google Play, F-Droid, or GitHub Releases.
- Enable Android Developer Options:
- Open Android Settings β About Phone.
- Tap Build Number 7 times until you see "You are now a developer!".
- Go to Settings β System β Developer Options (or search for Developer Options).
- Enable Wireless Debugging (toggle switch).
- Open the Shizuku app:
- Under Start via Wireless Debugging, tap Pairing.
- Tap Developer Options in the prompt.
- Under Wireless Debugging, tap Pair device with pairing code.
- Enter the 6-digit pairing code in the Shizuku notification prompt.
- Return to Shizuku and tap Start. Shizuku will start running in the background!
Tip: You only need to pair once. After pairing, you simply tap Start whenever your device restarts (or automate it via Shizuku's auto-start setting).
For Android 10 or older, or if Wireless Debugging is unavailable:
- Enable USB Debugging under Developer Options.
- Connect your device to your computer via USB.
- Open a terminal / command prompt and run the following command provided in the Shizuku app:
adb shell sh /sdcard/Android/data/moe.shizuku.privileged.api/start.sh
- Shizuku will activate immediately.
If your device is rooted with Magisk, KernelSU, or APatch:
- Open Shizuku.
- Tap Start (for rooted devices).
- Grant Superuser permission in your root manager.
Once Shizuku shows "Shizuku is running":
- Open ApkUp.
- Go to Settings β Installation Method.
- Select Shizuku (Silent Background Updates).
- When prompted by Shizuku, select Allow all the time.
- Test it: Go to the Updates tab, tap Update All, and watch ApkUp update your applications smoothly in the background!
Tip: In ApkUp Settings β Advanced β System & Permissions, tap Battery Optimization to open Android's background usage menu directly and switch ApkUp to Unrestricted to prevent OEM battery savers from interrupting background updates. (When all three system permissions are already granted, the System & Permissions section collapses automatically with an "All granted" badge β tap it anytime to inspect or adjust individual permissions.)
-
Crucial Setting: In Developer Options, you must enable both:
- USB Debugging
- USB Debugging (Security Settings) (requires SIM card insertion on MIUI). Without this toggle enabled, MIUI blocks apps from executing install commands via ADB!
- Samsung aggressively puts background processes into deep sleep.
- Go to Settings β Apps β Shizuku β Battery and set it to Unrestricted.
- Under Apps β ApkUp β Battery, also set battery usage to Unrestricted to ensure background update checks run on schedule.
- Disable "Auto-freeze" or "Background execution limit" for both Shizuku and ApkUp in system battery settings.