CleanYourMobile v0.2.0 — Presets, Unrated List & CLI Tools

CleanYourMobile v0.2.0 — Presets, Unrated Visibility & CLI Tools

This release adds portable preset profiles across both the CLI and the Android app, surfaces unrated packages instead of hiding them, adds an offline package lookup tool, and fixes vendor ROM error reporting.

---

What's New in v0.2.0

• Two New CLI Tools:
  • tools/explain.py: Offline package lookup with keyword search, brand/safety/category filters, JSON output, and reversible commands — no phone needed.
  • tools/preset.py: Save, inspect, export, import, and apply portable cym-preset JSON profiles across phones. Every imported package is re-checked through the guard and strict package-name validation.
• Presets in the Android App: Export disabled packages as a portable JSON profile, or import a preset from a file or clipboard (Preset.kt). Imported presets re-verify every package against the database and guard and only tick checkboxes — nothing is applied automatically.
• Unrated Package List: Packages absent from the offline database are now displayed under Unrated instead of being silently omitted (shown for human inspection, never offered automatically).
• ColorOS / OxygenOS / realme UI Error Fix: Clearer explanation in scripts/debloat.sh and scripts/debloat.ps1 when a ROM blocks disabling with change component state instead of printing a raw Java exception.
• Proper Manifest Versioning: Bumped to versionCode 2 / versionName "0.2.0" (verified with aapt dump badging).

Note on testing: Preset export/import and the Unrated list in the Android app compile cleanly and share validation rules checked by tools/sync_guard.py, though neither has been exercised end-to-end on physical hardware yet.

---

Upgrading & Installation

• From v0.1.1 (Signed Release): Installs in place as a normal update (versionCode 1 -> 2, signed with the same release certificate). No uninstall needed.
• From v0.1.0 (Debug Build): You must uninstall v0.1.0 first, because v0.1.0 was signed with Android's debug key and cannot upgrade to a release-signed build.

Steps

1. Install Shizuku (GitHub release recommended for Android 11–16 support).
2. Start the Shizuku service via Wireless Debugging or ADB from a PC.
3. Download and install CleanYourMobile.apk below.
4. Open CleanYourMobile and tap Grant access when prompted.

---

Checksums & Verification

Verify the APK manifest and signing certificate with:

aapt dump badging CleanYourMobile.apk
apksigner verify --print-certs CleanYourMobile.apk

Expected output values:

Package:             com.cleanyourmobile
Version:             versionName='0.2.0' (versionCode='2')
Signer DN:           CN=0xgh0stri13y, OU=CleanYourMobile, O=CleanYourMobile
Certificate SHA-256: bf068b12ebc1c7f97ecaa33f312b19f69f0f97b8d1bfc6f0a164561712ca7782

File:                CleanYourMobile.apk
Format:              Android APK (Signed Release, 4,672,669 bytes)
File SHA-256:        e3a100eb595b1565affd6ca2694fc6018beb469b8bbec04b08142ffdd7440e76

CleanYourMobile v0.1.1 — Signed Release

CleanYourMobile v0.1.1 — Official Signed Release

This release promotes the CleanYourMobile Android Companion App to a signed production release build with certificate verification.

---

What's New in v0.1.1

• Official Signed Release: Built with official production signing keys held securely outside the repository (replaces the previous debug key build). Anyone upgrading from v0.1.0 (debug-signed) must uninstall v0.1.0 first before installing v0.1.1.
• Reduced Binary Footprint: APK size optimized down to 4.66 MB (from 5.7 MB).
• Database Updates: Updated documentation and safety guidance for com.google.ar.core and background runtimes.

---

Installation

1. If you have the v0.1.0 debug build installed, uninstall it first.
2. Install Shizuku (version 13.5+ recommended for Android 11–16).
3. Start the Shizuku service via Wireless Debugging or ADB from a PC.
4. Download and install CleanYourMobile.apk below.
5. Launch CleanYourMobile and tap Grant access when prompted.

---

Checksums & Verification

Verify authenticity with:

apksigner verify --print-certs CleanYourMobile.apk

Signer certificate & file digest:

Signer DN:           CN=0xgh0stri13y, OU=CleanYourMobile, O=CleanYourMobile
Certificate SHA-256: bf068b12ebc1c7f97ecaa33f312b19f69f0f97b8d1bfc6f0a164561712ca7782

File:                CleanYourMobile.apk
Format:              Android APK (Signed Release, 4,662,509 bytes)
File SHA-256:        46765fdba70fee6be9c64f8a8d3eea454135ad97bc3be2d83efb4c56df0e9d2f

CleanYourMobile v0.1.0 — Android Companion App

CleanYourMobile v0.1.0 — Initial Release

This release introduces the CleanYourMobile Android Companion App — a native on-device front end powered by Shizuku. Once Shizuku is running, you can safely inspect and debloat your Android device directly from the phone itself with no computer required.

---

Features

• Bundled Offline Database: Ships with the full curated database of 505 packages across 15 OEM brand families (Samsung, Xiaomi, OnePlus, OPPO, vivo, realme, Motorola, Pixel, etc.).
• Quadruple-Layer Safety Guard: Guard.kt implements the same strict checks as our CLI tooling — 202 critical system packages (dialer, SMS, emergency alerts, biometrics, Settings, camera, and active launcher/keyboard) are strictly immutable.
• Smart OEM Brand Detection: Identifies phone make, model, and OS overlay quirks with alias matching for sub-brands (e.g. Redmi, POCO, iQOO).
• Impact-First Categorization: Ranks ads and background telemetry first, so you target harmful bloat before cosmetic utilities.
• Safe, Reversible Disabling: Uses non-destructive user-profile disabling rather than permanent deletion:

pm disable-user --user 0 <package>

One-click Restore All reactivates disabled packages.

• Automatic Pre-Debloat Snapshot: Captures package states before any changes are made, with exportable rollback logs.
• OLED Dark & Light Themes: True pitch-black OLED theme (#000000) and clean light theme with high-contrast accessibility.

---

Installation

1. Install Shizuku (use the GitHub release for Android 11–16 support).
2. Start the Shizuku service via Wireless Debugging (in Developer Options) or via ADB from a PC.
3. Download and install CleanYourMobile.apk below.
4. Launch CleanYourMobile and tap Grant access when Shizuku prompts for permission.

---

Checksums & Verification

Format: Android APK (Debug Signed)

File:    CleanYourMobile.apk
SHA-256: 9cf2f4201a39c655ceedfcd1212cba591256694a92fa12dfc4499e769453322a

Note: This APK is built as a reference implementation signed with Android's standard debug key for easy sideloading. Full source code is available in android/.