# kangrio/microg-patcher architecture

> Architecture diagram of the GitHub repository kangrio/microg-patcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kangrio/microg-patcher
- Repository: https://github.com/kangrio/microg-patcher

## Overview

MicroG Patcher is an Android app that takes a user-selected APK or downloads one by package name, modifies it to support signature spoofing, signs the result, then offers installation or saving. The app activity owns the user workflow; download support is separate from APK mutation and signing. The extension module supplies the provider embedded into patched APKs, where it intercepts package information and substitutes signatures. The map follows explicit calls and the README workflow; extension behavior beyond the shown provider excerpt is not inferred.

Main entry points: [`app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt) (APK patcher), [`app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt) (Main activity), [`app/src/main/java/com/kangrio/microgpatcher/Utils.kt`](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/Utils.kt) (APK download), [`app/src/main/java/com/kangrio/microgpatcher/App.kt`](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/App.kt) (App context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["App workflow"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_catalog["Package catalog<br/>[Package.kt]"]
  node_download["APK download<br/>[Utils.kt]"]
  node_appcontext["App context<br/>[App.kt]"]
  node_install["APK installer<br/>[ApkPatcher.kt]"]
  node_save["Save-to-storage flow<br/>[MainActivity.kt]"]
end

subgraph group_patching["APK transformation"]
  node_patcher["APK patcher<br/>[ApkPatcher.kt]"]
  node_manifest["Manifest patch<br/>[ApkPatcher.kt]"]
  node_providerinsert["Provider injection<br/>[ApkPatcher.kt]"]
  node_dexinsert["DEX injection<br/>[ApkPatcher.kt]"]
  node_apkoutput["Patched APK<br/>[ApkPatcher.kt]"]
  node_signer["APK signer<br/>[APKSigner.java]"]
  node_signed["Signed APK<br/>[ApkPatcher.kt]"]
end

subgraph group_spoofing["Signature spoofing"]
  node_extension["Signature provider"]
end

node_user(("APK user"))
node_downloadservice["APK download service"]
node_apk["Input APK"]
node_packageinfo["Package information"]

node_user -->|"selects APK"| node_activity
node_user -->|"requests download"| node_activity
node_activity -->|"lists packages"| node_catalog
node_activity -->|"requests download"| node_download
node_download -->|"gets context"| node_appcontext
node_appcontext -->|"provides context"| node_download
node_download -->|"enqueues APK"| node_downloadservice
node_downloadservice -->|"completion callback"| node_activity
node_user -->|"chooses file"| node_apk
node_apk -->|"opens selected file"| node_activity
node_activity -->|"starts patch"| node_patcher
node_patcher -->|"patches manifest"| node_manifest
node_patcher -->|"sets provider order"| node_providerinsert
node_patcher -->|"adds DEX"| node_dexinsert
node_manifest -->|"registers provider"| node_extension
node_patcher -->|"writes APK"| node_apkoutput
node_patcher -->|"signs output"| node_signer
node_signer -->|"produces signed APK"| node_signed
node_patcher -->|"offers install"| node_install
node_patcher -->|"offers save"| node_save
node_install -->|"installs APK"| node_signed
node_save -->|"reads patched APK"| node_signed
node_extension -->|"spoofs signatures"| node_packageinfo

click node_activity "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt"
click node_catalog "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/Package.kt"
click node_download "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/Utils.kt"
click node_appcontext "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/App.kt"
click node_patcher "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_manifest "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_providerinsert "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_dexinsert "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_apkoutput "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_signer "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/APKSigner.java"
click node_signed "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_install "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt"
click node_save "https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt"
click node_extension "https://github.com/kangrio/microg-patcher/blob/master/extension/src/main/java/com/kangrio/extension/provider/SignatureProvider.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_activity,node_catalog,node_download,node_appcontext,node_install,node_save,node_user toneBlue
class node_patcher,node_manifest,node_providerinsert,node_dexinsert,node_apkoutput,node_signer,node_signed toneAmber
class node_extension toneMint
class node_downloadservice,node_apk,node_packageinfo toneIndigo
```

## Components

### App workflow

- [Main activity](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt): `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`
- [Package catalog](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/Package.kt): `app/src/main/java/com/kangrio/microgpatcher/Package.kt`
- [APK download](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/Utils.kt): `app/src/main/java/com/kangrio/microgpatcher/Utils.kt`
- [App context](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/App.kt): `app/src/main/java/com/kangrio/microgpatcher/App.kt`
- [APK installer](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [Save-to-storage flow](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt): `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`

### APK transformation

- [APK patcher](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [Manifest patch](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [Provider injection](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [DEX injection](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [Patched APK](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`
- [APK signer](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/APKSigner.java): `app/src/main/java/com/kangrio/microgpatcher/patcher/APKSigner.java`
- [Signed APK](https://github.com/kangrio/microg-patcher/blob/master/app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt): `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`

### Signature spoofing

- [Signature provider](https://github.com/kangrio/microg-patcher/blob/master/extension/src/main/java/com/kangrio/extension/provider/SignatureProvider.java): `extension/src/main/java/com/kangrio/extension/provider/SignatureProvider.java`

### Other components

- **APK user**
- **APK download service**
- **Input APK**
- **Package information**

## Connections

- APK user → Main activity: selects APK (evidence: `README.md`)
- APK user → Main activity: requests download (evidence: `README.md`)
- Main activity → Package catalog: lists packages (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- Main activity → APK download: requests download (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- APK download → App context: gets context (evidence: `app/src/main/java/com/kangrio/microgpatcher/Utils.kt`)
- App context → APK download: provides context (evidence: `app/src/main/java/com/kangrio/microgpatcher/App.kt`)
- APK download → APK download service: enqueues APK (evidence: `app/src/main/java/com/kangrio/microgpatcher/Utils.kt`)
- APK download service → Main activity: completion callback (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- APK user → Input APK: chooses file (evidence: `README.md`)
- Input APK → Main activity: opens selected file (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- Main activity → APK patcher: starts patch (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- APK patcher → Manifest patch: patches manifest (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK patcher → Provider injection: sets provider order (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK patcher → DEX injection: adds DEX (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- Manifest patch → Signature provider: registers provider (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK patcher → Patched APK: writes APK (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK patcher → APK signer: signs output (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK signer → Signed APK: produces signed APK (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/APKSigner.java`)
- APK patcher → APK installer: offers install (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK patcher → Save-to-storage flow: offers save (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- APK installer → Signed APK: installs APK (evidence: `app/src/main/java/com/kangrio/microgpatcher/patcher/ApkPatcher.kt`)
- Save-to-storage flow → Signed APK: reads patched APK (evidence: `app/src/main/java/com/kangrio/microgpatcher/MainActivity.kt`)
- Signature provider → Package information: spoofs signatures (evidence: `extension/src/main/java/com/kangrio/extension/provider/SignatureProvider.java`)
