Kianuni/Erosion-CN

What It Does

Erosion-CN is a Simplified-Chinese fork of the upstream Erosion project, an iOS/iPadOS research toolbox that reads and writes the system's MobileGestalt cache to change hardware-gated behaviors: region and regulatory model, Apple Intelligence eligibility, eSIM/FaceTime availability, display and charging options, Apple Pencil/camera tweaks, and app container management. It also bundles app data backup, container cache cleanup, battery telemetry, crash log inspection, and Safari bookmark export.

The fork focuses on durability and safety around writes: in-place overwrite instead of truncate-then-write, F_FULLFSYNC flushes, a diff preview before applying, read-back verification with automatic rollback, and a SHA-256-checked factory backup mirrored to a system App Group container so it survives reinstalling the app. It parses the loaded libMobileGestalt.dylib at runtime to resolve cache slots per device rather than hard-coding offsets.

Getting Started

You need a signing method that grants an App Group entitlement. The project recommends a personal Apple ID sideloading tool such as SideStore, AltStore, Feather, Sideloadly, Impactor, or iLoader, or a developer certificate with App Group injection.

1. Download the latest Erosion_v0.8.6_zh-Hans.ipa from the Releases page.
2. Sign and install it with one of the tools above.
3. On first launch, check the home screen log to confirm an App Group container was detected.
4. Back up the device fully via a computer before making changes.

Detailed installation and factory-restore instructions are in the usage guide and the factory restoration guide. To build an unsigned IPA yourself, use Xcode 26/27 on macOS:

git clone https://github.com/Kianuni/Erosion-CN.git
cd Erosion-CN
chmod +x ipabuild.sh
./ipabuild.sh

Compatibility and Constraints

Full support covers iOS/iPadOS 27.0–27.2.1 and 27.3 beta 1, including MobileGestalt reads and safe writes. iOS/iPadOS 26.0–26.7.2 is partial: wallpaper, dialer theming, lock-screen signature text, and some container browsing work, but system MobileGestalt writes are blocked by the sandbox. The project warns that the underlying write technique is confirmed only through 27.3 beta 1; do not upgrade to 27.3 beta 2 or later if you rely on it. System-level changes should be made only on devices you own, with a full backup first.

Some features depend on physical hardware: satellite SOS, mmWave 5G, eSIM on older dual-nano-SIM models without an eUICC chip, and forcing 120Hz on a 60Hz panel cannot be unlocked. Region and eSIM changes may require a cold reboot rather than a respring, and certain combinations (for example, opening eSIM while two physical SIMs are inserted) require the specific steps described in the FAQ.

The project is licensed under GPLv3. It is presented as a research and learning tool; the authors disclaim responsibility for data loss or device issues.

HotRepo's take

Erosion-CN entered HotRepo's new-project ranking on 2026-11-10 with 1,012 stars gained in its first observed window, then added 508 on 2026-11-11 and 318 in the 2026-11-11 09:45 to 2026-11-12 09:45 window. The star curve from 148 on 2026-11-10 05:45 UTC to 1,653 on 2026-11-12 09:45 UTC is steep but short; no all-language daily rank has been recorded for it. For a niche, sideload-only iOS system tool, the interest is concentrated and fast-moving. The repository's own emphasis on in-place writes, read-back verification, rollback, and dual factory backups suggests the authors expect users to run it on real hardware, which is also where the risk sits: the delivered artifact is a prebuilt IPA that rewrites system cache files.