WeWaffles/OneLineage

选用指南

AI 根据 README 整理 · 2026/10/21 16:16:13

使用方式

通过Android应用和脚本切换，构建APK需JDK 17、Android SDK build-tools 34和android-34平台。

查看 README 依据

- Internet access for the GSI download (LineageOS 23.2 GSI, EXT4, VANILLA or GAPPS builds from SourceForge) ## What's in here | Path | What it is | | --- | --- | | `src/`, `res/`, `AndroidManifest.xml` | The Android app (`com.wewaffles.onelineage`) | | `assets/master_prepare.sh` | Stages the rootfs, binds the patched files, fixes labels/ownership | | `assets/master_inner.sh` | Runs inside the container, starts the guest zygote | | `assets/switch_to_lineage.sh` / `return_to_oneui.sh` | Switch in and back out | | `assets/zygote_exec` | Static aarch64 launcher for the guest zygote |

Edit the paths at the top of `build_apk.sh` (JDK 17, Android SDK build-tools 34, android-34 platform), provide your own signing keystore, then run `./build_apk.sh`. ## Credits LineageOS GSI builds by MisterZtr (SourceForge). LineageOS and Android are trademarks of their respective owners. Not affiliated with Samsung, Google or LineageOS.

部署要求

需要已root的三星手机（测试机型为One UI 8.5的S26 Ultra），/data分区有足够空间，且需联网下载GSI。

查看 README 依据

> It may not work on other Samsung models, other One UI versions, or other devices at all. It is experimental, it replaces core parts of a running system, and it can crash, hang or soft-brick your phone, fill `/data`, or break radio/SMS. **Back up everything first. Use at your own risk.** > Also, I did use AI a fair bit in this project, it would have taken a LOT longer without it. ## Requirements - A rooted Samsung phone (the tested one is an S26 Ultra on One UI 8.5) - Enough free space on `/data` for the extracted GSI

- Internet access for the GSI download (LineageOS 23.2 GSI, EXT4, VANILLA or GAPPS builds from SourceForge) ## What's in here | Path | What it is | | --- | --- | | `src/`, `res/`, `AndroidManifest.xml` | The Android app (`com.wewaffles.onelineage`) | | `assets/master_prepare.sh` | Stages the rootfs, binds the patched files, fixes labels/ownership | | `assets/master_inner.sh` | Runs inside the container, starts the guest zygote | | `assets/switch_to_lineage.sh` / `return_to_oneui.sh` | Switch in and back out | | `assets/zygote_exec` | Static aarch64 launcher for the guest zygote |

已知限制

仅在少数设备上测试，可能不适用于其他型号；实验性功能，可能导致崩溃、挂起或软砖；返回One UI可能需要手动重启；访客系统无IMS栈，语音通话不可用；开发者选项崩溃。

查看 README 依据

# OneLineage Hot-switch between stock **One UI** and a **LineageOS 23.2 (Android 16) GSI** on a rooted Samsung phone, with no reflashing and no second partition. OneLineage stages the GSI under `/data/local/tmp`, pivots into it as a container with its own zygote and system_server, and can hand the screen back to One UI. If something isn't working and you have a fix feel free to make a pr! > ## Disclaimer > **This has been tested on only a handful of devices, and it seems if you want to install it without making modifications, it has to be on Android 16**

> It may not work on other Samsung models, other One UI versions, or other devices at all. It is experimental, it replaces core parts of a running system, and it can crash, hang or soft-brick your phone, fill `/data`, or break radio/SMS. **Back up everything first. Use at your own risk.** > Also, I did use AI a fair bit in this project, it would have taken a LOT longer without it. ## Requirements - A rooted Samsung phone (the tested one is an S26 Ultra on One UI 8.5) - Enough free space on `/data` for the extracted GSI

12. **Boot diagnostics.** Each boot writes `/data/boot_failures.log`. ## Known issues - Returning to One UI may still need a manual reboot. - The guest binds the host's `media.codec`, whose AIDL hash differs from the GSI's, which can cause high CPU during codec enumeration. - No IMS stack in the guest, so **voice calls don't work** (data and SMS depend on One UI's `imsd`). - Developer options crash (the guest registers no `adb` service). - DTMF tones glitch, and deep-buffer audio hangs, so it stays disabled. - Never kill the host `netd` while Lineage is running. ## Building