# bugestudioteam/buge-app-manager architecture

> Architecture diagram of the GitHub repository bugestudioteam/buge-app-manager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bugestudioteam/buge-app-manager
- Repository: https://github.com/bugestudioteam/buge-app-manager

## Overview

Buge App Manager is an Android utility for inspecting and managing installed apps, permissions, and launchable activities, with elevated operations through Shizuku or root. The principal workflow is to browse an app or permission view, inspect repository-provided device data, then use detail or batch controls for management. Separate branches cover activity discovery, backups/restores, and settings. The source index and excerpts establish several internal calls; other capability links are documented in the README, so unsampled implementation details are not expanded.

Main entry points: [`app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt`](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt) (Elevated command access), [`app/src/main/java/com/buge/appmanager/MainActivity.kt`](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/MainActivity.kt) (Main navigation), [`app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt`](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt) (Permission browser), [`app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt`](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt) (Settings screen)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App management"]
  node_main["Main navigation<br/>[MainActivity.kt]"]
  node_apps["App browser<br/>[AppsFragment.kt]"]
  node_appvm["App view model<br/>[AppsViewModel.kt]"]
  node_apprepo["App repository<br/>[AppRepository.kt]"]
  node_appmodel["App and permission data<br/>[AppInfo.kt]"]
  node_appdetail["App details and actions"]
end

subgraph group_permissions["Permission management"]
  node_permissions["Permission browser"]
  node_permvm["Permission view model"]
end

subgraph group_activities["Activity launcher"]
  node_activities["Activity browser"]
  node_activityrepo["Activity repository"]
  node_activitydetail["Activity details and launch"]
end

subgraph group_settings["Settings and backup"]
  node_settings["Settings screen"]
  node_backup["Backup and restore<br/>[BackupManager.kt]"]
  node_labels["Custom labels"]
  node_preferences[("Preferences store")]
  node_base["Activity presentation<br/>[BaseActivity.kt]"]
  node_locale["Locale handling<br/>[LocaleManager.kt]"]
end

subgraph group_platform["Platform services"]
  node_logs["Log capture and export<br/>[LogManager.kt]"]
  node_shizuku["Elevated command access<br/>[ShizukuManager.kt]"]
  node_root["Root command execution<br/>[RootManager.kt]"]
end

node_user(("Device user"))
node_android(("Android package system"))
node_shizuku_service(("Shizuku service"))

node_user -->|"opens app"| node_main
node_main -.->|"navigates to"| node_apps
node_main -.->|"navigates to"| node_permissions
node_main -.->|"navigates to"| node_activities
node_main -.->|"navigates to"| node_settings
node_apps -->|"uses"| node_appvm
node_apps -->|"opens details"| node_appdetail
node_apprepo -->|"creates data"| node_appmodel
node_apprepo -->|"runs commands"| node_shizuku
node_appdetail -->|"reads app data"| node_appmodel
node_appdetail -->|"runs commands"| node_shizuku
node_permissions -->|"loads app data"| node_apprepo
node_permissions -->|"uses"| node_permvm
node_permissions -->|"changes permissions"| node_shizuku
node_user -->|"filters and manages"| node_permissions
node_activities -->|"opens details"| node_activitydetail
node_activities -->|"loads activities"| node_activityrepo
node_user -->|"browses and launches"| node_activities
node_settings -->|"opens backup"| node_backup
node_settings -->|"opens labels"| node_labels
node_backup -->|"stores settings"| node_preferences
node_backup -->|"backs up labels"| node_labels
node_base -->|"applies locale"| node_locale
node_base -->|"reads preferences"| node_preferences
node_settings -->|"saves settings"| node_preferences
node_main -->|"requests authorization"| node_shizuku
node_shizuku -->|"delegates root mode"| node_root
node_shizuku -.->|"requests access"| node_shizuku_service
node_shizuku -.->|"executes device operations"| node_android
node_activityrepo -.->|"queries activities"| node_android

click node_main "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/MainActivity.kt"
click node_apps "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/AppsFragment.kt"
click node_appvm "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/viewmodel/AppsViewModel.kt"
click node_apprepo "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/data/AppRepository.kt"
click node_appmodel "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/model/AppInfo.kt"
click node_appdetail "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/AppDetailActivity.kt"
click node_permissions "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt"
click node_permvm "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/viewmodel/PermissionsViewModel.kt"
click node_activities "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/ActivitiesFragment.kt"
click node_activityrepo "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/data/ActivityRepository.kt"
click node_activitydetail "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ActivityDetailActivity.kt"
click node_settings "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt"
click node_backup "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/BackupManager.kt"
click node_labels "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/CustomLabelManager.kt"
click node_preferences "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/PreferencesManager.kt"
click node_base "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/BaseActivity.kt"
click node_locale "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/LocaleManager.kt"
click node_logs "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/LogManager.kt"
click node_shizuku "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt"
click node_root "https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/root/RootManager.kt"

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_main,node_apps,node_appvm,node_apprepo,node_appmodel,node_appdetail,node_user toneBlue
class node_permissions,node_permvm toneAmber
class node_activities,node_activityrepo,node_activitydetail toneMint
class node_settings,node_backup,node_labels,node_preferences,node_base,node_locale toneRose
class node_logs,node_shizuku,node_root,node_android,node_shizuku_service toneIndigo
```

## Components

### App management

- [Main navigation](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/MainActivity.kt): `app/src/main/java/com/buge/appmanager/MainActivity.kt`
- [App browser](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/AppsFragment.kt): `app/src/main/java/com/buge/appmanager/ui/AppsFragment.kt`
- [App view model](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/viewmodel/AppsViewModel.kt): `app/src/main/java/com/buge/appmanager/viewmodel/AppsViewModel.kt`
- [App repository](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/data/AppRepository.kt): `app/src/main/java/com/buge/appmanager/data/AppRepository.kt`
- [App and permission data](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/model/AppInfo.kt): `app/src/main/java/com/buge/appmanager/model/AppInfo.kt`
- [App details and actions](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/AppDetailActivity.kt): `app/src/main/java/com/buge/appmanager/AppDetailActivity.kt`

### Permission management

- [Permission browser](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt): `app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt`
- [Permission view model](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/viewmodel/PermissionsViewModel.kt): `app/src/main/java/com/buge/appmanager/viewmodel/PermissionsViewModel.kt`

### Activity launcher

- [Activity browser](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/ActivitiesFragment.kt): `app/src/main/java/com/buge/appmanager/ui/ActivitiesFragment.kt`
- [Activity repository](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/data/ActivityRepository.kt): `app/src/main/java/com/buge/appmanager/data/ActivityRepository.kt`
- [Activity details and launch](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ActivityDetailActivity.kt): `app/src/main/java/com/buge/appmanager/ActivityDetailActivity.kt`

### Settings and backup

- [Settings screen](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt): `app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt`
- [Backup and restore](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/BackupManager.kt): `app/src/main/java/com/buge/appmanager/util/BackupManager.kt`
- [Custom labels](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/CustomLabelManager.kt): `app/src/main/java/com/buge/appmanager/util/CustomLabelManager.kt`
- [Preferences store](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/PreferencesManager.kt): `app/src/main/java/com/buge/appmanager/util/PreferencesManager.kt`
- [Activity presentation](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/BaseActivity.kt): `app/src/main/java/com/buge/appmanager/BaseActivity.kt`
- [Locale handling](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/LocaleManager.kt): `app/src/main/java/com/buge/appmanager/util/LocaleManager.kt`

### Platform services

- [Log capture and export](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/util/LogManager.kt): `app/src/main/java/com/buge/appmanager/util/LogManager.kt`
- [Elevated command access](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt): `app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt`
- [Root command execution](https://github.com/bugestudioteam/buge-app-manager/blob/main/app/src/main/java/com/buge/appmanager/root/RootManager.kt): `app/src/main/java/com/buge/appmanager/root/RootManager.kt`

### Other components

- **Device user**
- **Android package system**
- **Shizuku service**

## Connections

- Device user → Main navigation: opens app
- Main navigation → App browser: navigates to (evidence: `app/src/main/java/com/buge/appmanager/MainActivity.kt`)
- Main navigation → Permission browser: navigates to (evidence: `app/src/main/java/com/buge/appmanager/MainActivity.kt`)
- Main navigation → Activity browser: navigates to (evidence: `app/src/main/java/com/buge/appmanager/MainActivity.kt`)
- Main navigation → Settings screen: navigates to (evidence: `app/src/main/java/com/buge/appmanager/MainActivity.kt`)
- App browser → App view model: uses (evidence: `app/src/main/java/com/buge/appmanager/ui/AppsFragment.kt`)
- App browser → App details and actions: opens details (evidence: `app/src/main/java/com/buge/appmanager/ui/AppsFragment.kt`)
- App repository → App and permission data: creates data (evidence: `app/src/main/java/com/buge/appmanager/data/AppRepository.kt`)
- App repository → Elevated command access: runs commands (evidence: `app/src/main/java/com/buge/appmanager/data/AppRepository.kt`)
- App details and actions → App and permission data: reads app data (evidence: `app/src/main/java/com/buge/appmanager/AppDetailActivity.kt`)
- App details and actions → Elevated command access: runs commands (evidence: `app/src/main/java/com/buge/appmanager/AppDetailActivity.kt`)
- Permission browser → App repository: loads app data (evidence: `app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt`)
- Permission browser → Permission view model: uses (evidence: `app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt`)
- Permission browser → Elevated command access: changes permissions (evidence: `app/src/main/java/com/buge/appmanager/ui/PermissionsFragment.kt`)
- Device user → Permission browser: filters and manages
- Activity browser → Activity details and launch: opens details (evidence: `app/src/main/java/com/buge/appmanager/ui/ActivitiesFragment.kt`)
- Activity browser → Activity repository: loads activities (evidence: `app/src/main/java/com/buge/appmanager/ui/ActivitiesFragment.kt`)
- Device user → Activity browser: browses and launches
- Settings screen → Backup and restore: opens backup (evidence: `app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt`)
- Settings screen → Custom labels: opens labels (evidence: `app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt`)
- Backup and restore → Preferences store: stores settings (evidence: `app/src/main/java/com/buge/appmanager/util/BackupManager.kt`)
- Backup and restore → Custom labels: backs up labels (evidence: `app/src/main/java/com/buge/appmanager/util/BackupManager.kt`)
- Activity presentation → Locale handling: applies locale (evidence: `app/src/main/java/com/buge/appmanager/BaseActivity.kt`)
- Activity presentation → Preferences store: reads preferences (evidence: `app/src/main/java/com/buge/appmanager/BaseActivity.kt`)
- Settings screen → Preferences store: saves settings (evidence: `app/src/main/java/com/buge/appmanager/ui/SettingsFragment.kt`)
- Main navigation → Elevated command access: requests authorization (evidence: `app/src/main/java/com/buge/appmanager/MainActivity.kt`)
- Elevated command access → Root command execution: delegates root mode (evidence: `app/src/main/java/com/buge/appmanager/shizuku/ShizukuManager.kt`)
- Elevated command access → Shizuku service: requests access
- Elevated command access → Android package system: executes device operations
- Activity repository → Android package system: queries activities
