# kp7742/pluginloader architecture

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

- Interactive diagram: https://gitdiagram.com/kp7742/pluginloader
- Repository: https://github.com/kp7742/pluginloader

## Overview

PluginLoader is an Android stub that fetches a crafted plugin APK, stores its version and location, then loads the plugin into the running process. The main user-to-result path is stub launch → update/download when needed → local APK → class/resource loading → plugin launch. The app module is the plugin implementation surface; the README also documents plugin resource loading and Activity/Service support. Several plugin internals and stub helpers are unsampled, so links to those capabilities are documented rather than inferred from unseen code.

Main entry points: [`stub/src/main/java/com/kmods/stub/MainActivity.java`](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java) (Stub activity), [`app/src/main/java`](https://github.com/kp7742/pluginloader/tree/main/app/src/main/java) (Crafted plugin), [`stub/src/main/java/com/kmods/stub/Prefs.java`](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Prefs.java) (Install preferences), [`stub/src/main/java/com/kmods/stub/Const.java`](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Const.java) (Update settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_stub["Stub runtime"]
  node_stub_entry["Stub activity<br/>[MainActivity.java]"]
  node_prefs[("Install preferences<br/>[Prefs.java]")]
  node_constants["Update settings<br/>[Const.java]"]
  node_restart["App restart<br/>[Utils.java]"]
end

subgraph group_delivery["Plugin delivery"]
  node_update_api["Update API"]
  node_downloader["APK downloader<br/>[MainActivity.java]"]
  node_plugin_file["Stored plugin APK<br/>[MainActivity.java]"]
  node_cleanup["File cleanup<br/>[Utils.java]"]
end

subgraph group_loading["Runtime loading"]
  node_dex_loader["Dex class loader<br/>[MainActivity.java]"]
  node_reflection["Framework reflection<br/>[Reflector.java]"]
  node_resource_patch["Resource patcher"]
  node_app_replace["Application replacement<br/>[MainActivity.java]"]
end

subgraph group_plugin["Plugin app"]
  node_plugin_app["Crafted plugin"]
  node_plugin_activity["Plugin Activity"]
  node_plugin_service["Plugin Service"]
end

node_user(("User"))

node_user -->|"launches"| node_stub_entry
node_stub_entry -->|"reads and writes"| node_prefs
node_stub_entry -->|"uses settings"| node_constants
node_stub_entry -->|"requests metadata"| node_update_api
node_update_api -.->|"provides APK URL"| node_downloader
node_stub_entry -->|"starts download"| node_downloader
node_downloader -->|"writes APK"| node_plugin_file
node_stub_entry -->|"deletes old files"| node_cleanup
node_stub_entry -->|"checks local APK"| node_plugin_file
node_stub_entry -->|"installs class loader"| node_dex_loader
node_stub_entry -->|"patches resources"| node_resource_patch
node_stub_entry -->|"replaces application"| node_app_replace
node_app_replace -->|"uses reflection"| node_reflection
node_stub_entry -->|"starts plugin entry"| node_plugin_activity
node_plugin_app -.->|"provides entry"| node_plugin_activity
node_plugin_app -.->|"supports services"| node_plugin_service
node_stub_entry -->|"restarts after download"| node_restart

click node_stub_entry "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java"
click node_prefs "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Prefs.java"
click node_constants "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Const.java"
click node_downloader "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java"
click node_plugin_file "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java"
click node_cleanup "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Utils.java"
click node_dex_loader "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java"
click node_reflection "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Reflector.java"
click node_resource_patch "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/ResourcePatcher.java"
click node_app_replace "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java"
click node_plugin_app "https://github.com/kp7742/pluginloader/tree/main/app/src/main/java"
click node_plugin_activity "https://github.com/kp7742/pluginloader/tree/main/app/src/main/java"
click node_plugin_service "https://github.com/kp7742/pluginloader/tree/main/app/src/main/java"
click node_restart "https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Utils.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_stub_entry,node_prefs,node_constants,node_restart,node_user toneBlue
class node_update_api,node_downloader,node_plugin_file,node_cleanup toneAmber
class node_dex_loader,node_reflection,node_resource_patch,node_app_replace toneMint
class node_plugin_app,node_plugin_activity,node_plugin_service toneRose
```

## Components

### Stub runtime

- [Stub activity](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java): `stub/src/main/java/com/kmods/stub/MainActivity.java`
- [Install preferences](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Prefs.java): `stub/src/main/java/com/kmods/stub/Prefs.java`
- [Update settings](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Const.java): `stub/src/main/java/com/kmods/stub/Const.java`
- [App restart](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Utils.java): `stub/src/main/java/com/kmods/stub/Utils.java`

### Plugin delivery

- **Update API**
- [APK downloader](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java): `stub/src/main/java/com/kmods/stub/MainActivity.java`
- [Stored plugin APK](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java): `stub/src/main/java/com/kmods/stub/MainActivity.java`
- [File cleanup](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Utils.java): `stub/src/main/java/com/kmods/stub/Utils.java`

### Runtime loading

- [Dex class loader](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java): `stub/src/main/java/com/kmods/stub/MainActivity.java`
- [Framework reflection](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/Reflector.java): `stub/src/main/java/com/kmods/stub/Reflector.java`
- [Resource patcher](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/ResourcePatcher.java): `stub/src/main/java/com/kmods/stub/ResourcePatcher.java`
- [Application replacement](https://github.com/kp7742/pluginloader/blob/main/stub/src/main/java/com/kmods/stub/MainActivity.java): `stub/src/main/java/com/kmods/stub/MainActivity.java`

### Plugin app

- [Crafted plugin](https://github.com/kp7742/pluginloader/tree/main/app/src/main/java): `app/src/main/java`
- [Plugin Activity](https://github.com/kp7742/pluginloader/tree/main/app/src/main/java): `app/src/main/java`
- [Plugin Service](https://github.com/kp7742/pluginloader/tree/main/app/src/main/java): `app/src/main/java`

### Other components

- **User**

## Connections

- User → Stub activity: launches (evidence: `README.md`)
- Stub activity → Install preferences: reads and writes (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Update settings: uses settings (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Update API: requests metadata (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Update API → APK downloader: provides APK URL
- Stub activity → APK downloader: starts download (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- APK downloader → Stored plugin APK: writes APK (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → File cleanup: deletes old files (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Stored plugin APK: checks local APK (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Dex class loader: installs class loader (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Resource patcher: patches resources (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Application replacement: replaces application (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Application replacement → Framework reflection: uses reflection (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Stub activity → Plugin Activity: starts plugin entry (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
- Crafted plugin → Plugin Activity: provides entry (evidence: `README.md`)
- Crafted plugin → Plugin Service: supports services (evidence: `README.md`)
- Stub activity → App restart: restarts after download (evidence: `stub/src/main/java/com/kmods/stub/MainActivity.java`)
