Jelajahi Sumber

docs: revert to separate pages (hub + 3 guides)

TheWildJames 1 Minggu lalu
induk
melakukan
39aa13dff5
4 mengubah file dengan 159 tambahan dan 125 penghapusan
  1. 6 114
      docs/installation.md
  2. 24 4
      docs/kernelflasher.md
  3. 82 4
      docs/magiskboot.md
  4. 47 3
      docs/post-install.md

+ 6 - 114
docs/installation.md

@@ -5,12 +5,10 @@
 
 ## Choose your method
 
-| Method | When to use | Requires root |
-|--------|-------------|---------------|
-| **Kernel Flasher** | Upgrading with root already available, no PC needed | Yes |
-| **magiskboot** | Flash a pre-patched `boot.img` directly (no pre-rooted setup required) | No |
-
-Expand the section you need below — all are collapsed by default.
+| Method | When to use | Requires root | Guide |
+|--------|-------------|---------------|-------|
+| **Kernel Flasher** | Upgrading with root already available, no PC needed | Yes | [kernelflasher.md](kernelflasher.md) |
+| **magiskboot** | When you want to flash a pre-patched `boot.img` directly (no pre-rooted setup required) | No | [magiskboot.md](magiskboot.md) |
 
 ## Prerequisites
 
@@ -44,115 +42,9 @@ For Pre-GKI or GKI 1.0 kernels, contact [@TheWildJames](https://t.me/TheWildJame
 
 See **[Supported Devices](supported-devices.md)**.
 
----
-
-<details>
-<summary><b> Install with Kernel Flasher — no PC, requires root</b></summary>
-
-> [!NOTE]
-> More convenient when upgrading KernelSU and can be done without a computer.
-
-- Root access already granted to the flashing app (for first install from stock without root, use recovery/fastboot — see magiskboot section below)
-- AnyKernel3 ZIP matching your kernel version from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases)
-
-**Steps:**
-
-1. **Download the AnyKernel3 ZIP** from the latest [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases) page.
-2. **Open the Kernel Flasher app**, grant root permissions when prompted.
-3. **Select the AnyKernel3 ZIP** and flash. Do not interrupt.
-4. **Reboot** when prompted and verify the manager shows the expected version.
+## After flashing
 
-**Supported flashing apps:**
-
-| App | Notes |
-|-----|-------|
-| [Kernel Flasher](https://github.com/fatalcoder524/KernelFlasher) | Recommended, actively maintained |
-
-</details>
-
-<details>
-<summary><b> Patch boot.img Manually (magiskboot) — Android / Linux</b></summary>
-
-Use the [official magiskboot build](https://github.com/topjohnwu/Magisk/releases) — works on Android and Linux.
-
-**Preparation:**
-
-1. Get your device's stock `boot.img`.
-2. Download the AnyKernel3 ZIP for your kernel version from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases).
-3. Unpack the ZIP and get the `Image` file (the KernelSU kernel).
-
-**Android** — via adb + `libmagiskboot.so` (in `/data/local/tmp/`):
-
-```sh
-# Push files
-adb push Magisk-*/lib/arm64-v8a/libmagiskboot.so /data/local/tmp/magiskboot
-adb push boot.img /data/local/tmp/
-adb push Image /data/local/tmp/
-
-# On device
-adb shell
-cd /data/local/tmp/
-chmod +x magiskboot
-./magiskboot unpack boot.img
-mv -f Image kernel
-./magiskboot repack boot.img
-# Test then flash
-fastboot boot new-boot.img
-fastboot flash boot new-boot.img
-```
-
-**Linux** — official magiskboot:
-
-```sh
-chmod +x magiskboot
-./magiskboot unpack boot.img
-mv -f Image kernel
-./magiskboot repack boot.img
-fastboot boot new-boot.img
-fastboot flash boot new-boot.img
-```
-
-</details>
-
-<details>
-<summary><b> Post-Install — Verify &amp; Finish Setup</b></summary>
-
-Do these checks in order after flashing:
-
-**1. Download matching manager — KernelSU / KernelSU-Next / ReSukiSU**
-
-- [ ] Download the `manager-apk-*` from the same [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases) page you got the kernel from.
-- [ ] Install / update it over any existing manager.
-- [ ] Open the manager — it should show the kernel version you just flashed (e.g. `6.1.x-androidXX-Wild`) and report "Working".
-
-**2. SUSFS**
-
-- [ ] In the manager, install the [sidex15/susfs4ksu-module](https://github.com/sidex15/susfs4ksu-module).
-- [ ] Reboot.
-
-**3. Meta Module (if mounting modules)**
-
-- [ ] [NoMount](https://github.com/maxsteeel/nomount) (Recommended) — `NoMount-metamodule-*commit*.zip` from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases)
-- [ ] [Mountify](https://github.com/backslashxx/mountify) — latest compatible module
-
-> [!NOTE]
-> Only one is required. Compatibility with SUSFS shifts with updates.
-
-**4. DroidSpaces**
-
-- [ ] Download the app: [ravindu644/Droidspaces-OSS](https://github.com/ravindu644/Droidspaces-OSS)
-
-**5. Troubleshooting**
-
-- **General issues** — try restarting your device.
-- **Bootloop** — restore a stock boot.img via fastboot/recovery.
-- **Manager and kernel version do not match (e.g. 31000 != 32000)** — install the latest kernel and manager from the release and reboot.
-- **Root not working** — ensure the manager matches the flashed flavor (KernelSU / KernelSU-Next / ReSukiSU).
-
-> [!CAUTION]
-> **Nuclear option:** Uninstall all modules and reboot, then delete all files and folders in `/data/adb`. Reboot again. This wipes all KernelSU/Magisk module data — only use if nothing else works.
-
-</details>
+See [Post-Install — Verify & Finish Setup](post-install.md) for manager install, SUSFS module, and verification steps.
 
 ---
 

+ 24 - 4
docs/kernelflasher.md

@@ -1,8 +1,28 @@
-# Install with Kernel Flasher — Moved
+# Install with Kernel Flasher
 
 > [!NOTE]
-> This guide has moved into the single installation page.
+> This method is more convenient when upgrading KernelSU and can be done without a computer.
 
-See **[Installation — Install with Kernel Flasher](installation.md)** (expand the collapsed section).
+See [Installation](installation.md) for prerequisites, supported versions, and risks.
 
-> Old link? Use `Ctrl+F` for "Kernel Flasher" on that page.
+## Prerequisites
+
+- Root access already granted to the flashing app (for first install from stock without root, use recovery/fastboot — see [magiskboot](magiskboot.md))
+- AnyKernel3 ZIP matching your kernel version from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases)
+
+## Steps
+
+1. **Download the AnyKernel3 ZIP** from the latest [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases) page.
+2. **Open the Kernel Flasher app**, grant root permissions when prompted.
+3. **Select the AnyKernel3 ZIP** and flash. Do not interrupt.
+4. **Reboot** when prompted and verify the manager shows the expected version.
+
+## Supported flashing apps
+
+| App | Notes |
+|-----|-------|
+| [Kernel Flasher](https://github.com/fatalcoder524/KernelFlasher) | Recommended, actively maintained |
+
+## After flashing
+
+See [Post-Install — Verify & Finish Setup](post-install.md).

+ 82 - 4
docs/magiskboot.md

@@ -1,6 +1,84 @@
-# Patch boot.img Manually (magiskboot) — Moved
+# Patch boot.img Manually (magiskboot)
 
-> [!NOTE]
-> This guide has moved into the single installation page.
+> [!TIP]
+> Use the [official magiskboot build](https://github.com/topjohnwu/Magisk/releases) — works on Android and Linux.
 
-See **[Installation — Patch boot.img Manually](installation.md)** (expand the collapsed section).
+See [Installation](installation.md) for prerequisites, supported versions, and risks.
+
+**Platforms:** [Android](#-android) · [Linux](#-linux)
+
+## Preparation
+
+1. Get your device's stock `boot.img`.
+2. Download the AnyKernel3 ZIP for your kernel version from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases).
+3. Unpack the ZIP and get the `Image` file (the KernelSU kernel).
+
+---
+
+<details>
+<summary><b> Android</b> — via adb + <code>libmagiskboot.so</code></summary>
+
+Folder structure on device (`/data/local/tmp/`):
+
+```
+/data/local/tmp/
+├── magiskboot
+├── boot.img
+└── Image
+```
+
+1. Download latest Magisk from [GitHub Releases](https://github.com/topjohnwu/Magisk/releases).
+2. Rename `Magisk-*(version).apk` to `Magisk-*.zip` and unzip.
+3. Push `libmagiskboot.so` to device:
+  ```sh
+  adb push Magisk-*/lib/arm64-v8a/libmagiskboot.so /data/local/tmp/magiskboot
+  ```
+4. Push `boot.img` and `Image`:
+  ```sh
+  adb push boot.img /data/local/tmp/
+  adb push Image /data/local/tmp/
+  ```
+5. Make executable:
+  ```sh
+  adb shell
+  cd /data/local/tmp/
+  chmod +x magiskboot
+  ```
+6. Unpack:
+  ```sh
+  ./magiskboot unpack boot.img
+  ```
+7. Replace kernel:
+  ```sh
+  mv -f Image kernel
+  ```
+8. Repack:
+  ```sh
+  ./magiskboot repack boot.img
+  ```
+9. Test: `fastboot boot new-boot.img`
+10. Flash: `fastboot flash boot new-boot.img`
+
+</details>
+
+<details>
+<summary><b> Linux</b> — official magiskboot</summary>
+
+Folder structure on PC:
+
+```
+.
+├── magiskboot
+├── boot.img
+└── Image
+```
+
+1. Prepare `boot.img` and `Image` on PC.
+2. Make executable: `chmod +x magiskboot`
+3. Unpack: `./magiskboot unpack boot.img`
+4. Replace: `mv -f Image kernel`
+5. Repack: `./magiskboot repack boot.img`
+6. Test: `fastboot boot new-boot.img`
+7. Flash: `fastboot flash boot new-boot.img`
+
+</details>

+ 47 - 3
docs/post-install.md

@@ -1,6 +1,50 @@
-# Post-Install — Moved
+# Post-Install — Verify & Finish Setup
+
+After flashing a Wild Kernels GKI kernel, do these checks in order.
+
+## 1. Download matching manager — KernelSU / KernelSU-Next / ReSukiSU
+
+- [ ] Download the `manager-apk-*` from the same [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases) page you got the kernel from.
+- [ ] Install / update it over any existing manager.
+- [ ] Open the manager — it should show the kernel version you just flashed (e.g. `6.1.x-androidXX-Wild`) and report "Working".
+
+## 2. SUSFS
+
+- [ ] In the manager, install the [sidex15/susfs4ksu-module](https://github.com/sidex15/susfs4ksu-module).
+- [ ] Reboot.
+
+## 3. Meta Module (if mounting modules)
+
+If you need to mount modules, install one:
+
+- [ ] [NoMount](https://github.com/maxsteeel/nomount) (Recommended) — `NoMount-metamodule-*commit*.zip` from [Releases](https://github.com/WildKernels/GKI_KernelSU_SUSFS/releases)
+- [ ] [Mountify](https://github.com/backslashxx/mountify) — latest compatible module
 
 > [!NOTE]
-> This guide has moved into the single installation page.
+> Only one is required. Compatibility with SUSFS shifts with updates.
+
+## 4. DroidSpaces
+
+- [ ] Download the app: [ravindu644/Droidspaces-OSS](https://github.com/ravindu644/Droidspaces-OSS)
+
+## 5. Troubleshooting
+
+<details>
+<summary><b> Common issues</b></summary>
+
+- **General issues** — try restarting your device.
+- **Bootloop** — restore a stock boot.img via fastboot/recovery.
+- **Manager and kernel version do not match (e.g. 31000 != 32000)** — install the latest kernel and manager from the release and reboot.
+- **Root not working** — ensure the manager matches the flashed flavor (KernelSU / KernelSU-Next / ReSukiSU).
+
+</details>
+
+<details>
+<summary><b> Nuclear option</b></summary>
+
+Uninstall all modules and reboot, then delete all files and folders in `/data/adb`. Reboot again.
+
+> [!CAUTION]
+> This wipes all KernelSU/Magisk module data — only use if nothing else works.
 
-See **[Installation — Post-Install](installation.md)** (expand the collapsed section).
+</details>