# domilopment/apk-extractor architecture

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

- Interactive diagram: https://gitdiagram.com/domilopment/apk-extractor
- Repository: https://github.com/domilopment/apk-extractor

## Overview

APK Extractor is an Android app for backing up installed applications, managing saved APK/APKS/XAPK archives, and restoring them. Users browse and filter installed apps, choose one or more to save or share, then browse saved archives to inspect, delete, share, or install them. Settings govern save location, naming, filtering, and automatic backups; an update-watching service is a separate capability. The graph combines README-documented product behavior with indexed references and sampled source; several domain-to-UI links are not shown in the excerpts and are therefore omitted.

Main entry points: [`app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt`](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt) (Auto-backup service), [`app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt`](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt) (File repository), [`app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt`](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt) (Archive operations), [`app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt`](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt) (Task execution)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App experience"]
  node_main["App entry<br/>[MainActivity.kt]"]
  node_navigation["Screen navigation"]
  node_appview["Installed app browser<br/>[AppList.kt]"]
  node_archiveview["Archive browser"]
  node_settings["Settings screens"]
end

subgraph group_domain["App and archive operations"]
  node_appmodel["Application model"]
  node_applications["Installed apps"]
  node_archive["Archive operations"]
  node_install["Install and restore"]
end

subgraph group_storage["Files and persistence"]
  node_fileops["File utilities<br/>[FileUtil.kt]"]
  node_fileservice["APK file service<br/>[FilesService.kt]"]
  node_filesrepo["File repository<br/>[FilesRepository.kt]"]
  node_database[("Archive database<br/>[ApkDao.kt]")]
  node_archiveentity["Archive records"]
  node_preferences[("Preferences")]
end

subgraph group_background["Tasks and automation"]
  node_taskengine["Task execution<br/>[TaskEngine.kt]"]
  node_taskstate["Task state<br/>[TaskState.kt]"]
  node_taskfailure["Task failures<br/>[TaskFailure.kt]"]
  node_autobackup["Auto-backup service"]
  node_autotile["Backup quick tile"]
end

subgraph group_platform["Android integrations"]
  node_installer["Install sessions"]
  node_packageevents["Package update receiver"]
  node_analytics["Analytics interface<br/>[AnalyticsHelper.kt]"]
end

node_user(("Device user"))

node_user -->|"opens"| node_main
node_main -->|"routes through"| node_navigation
node_user -->|"browses apps"| node_appview
node_user -->|"manages backups"| node_archiveview
node_user -->|"configures"| node_settings
node_user -->|"restores backup"| node_install
node_user -->|"toggles backup"| node_autotile
node_appview -.->|"browses"| node_applications
node_applications -->|"provides models"| node_appmodel
node_archive -->|"reads and writes"| node_database
node_archive -->|"uses records"| node_archiveentity
node_filesrepo -->|"delegates to"| node_fileservice
node_fileservice -->|"uses"| node_fileops
node_user -->|"saves or shares APKs"| node_filesrepo
node_install -->|"delegates installation"| node_installer
node_installer -.->|"reports install result"| node_user
node_settings -.->|"edits preferences"| node_preferences
node_autotile -->|"starts or stops"| node_autobackup
node_autobackup -->|"registers receiver"| node_packageevents
node_autobackup -.->|"backs up updated apps"| node_filesrepo
node_taskengine -->|"transitions"| node_taskstate
node_taskengine -->|"records failure"| node_taskfailure

click node_main "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/MainActivity.kt"
click node_navigation "https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/navigation"
click node_appview "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/ui/appList/AppList.kt"
click node_archiveview "https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/apkList"
click node_settings "https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/settings"
click node_appmodel "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/model/appList/ApplicationModel.kt"
click node_applications "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/applications/ApplicationRepository.kt"
click node_archive "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt"
click node_install "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/installation/InstallationRepository.kt"
click node_installer "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/di/installation/InstallationService.kt"
click node_fileops "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/utils/FileUtil.kt"
click node_fileservice "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/sources/FilesService.kt"
click node_filesrepo "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt"
click node_database "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/room/dao/ApkDao.kt"
click node_archiveentity "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/room/entities/PackageArchiveEntity.kt"
click node_preferences "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/preferences/PreferenceRepository.kt"
click node_taskengine "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt"
click node_taskstate "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskState.kt"
click node_taskfailure "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/model/tasks/TaskFailure.kt"
click node_autobackup "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt"
click node_autotile "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupTileService.kt"
click node_packageevents "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/PackageBroadcastReceiver.kt"
click node_analytics "https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/analytics/AnalyticsHelper.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_navigation,node_appview,node_archiveview,node_settings,node_user toneBlue
class node_appmodel,node_applications,node_archive,node_install toneAmber
class node_fileops,node_fileservice,node_filesrepo,node_database,node_archiveentity,node_preferences toneMint
class node_taskengine,node_taskstate,node_taskfailure,node_autobackup,node_autotile toneRose
class node_installer,node_packageevents,node_analytics toneIndigo
```

## Components

### App experience

- [App entry](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/MainActivity.kt): `app/src/main/java/domilopment/apkextractor/MainActivity.kt`
- [Screen navigation](https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/navigation): `app/src/main/java/domilopment/apkextractor/ui/navigation`
- [Installed app browser](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/ui/appList/AppList.kt): `app/src/main/java/domilopment/apkextractor/ui/appList/AppList.kt`
- [Archive browser](https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/apkList): `app/src/main/java/domilopment/apkextractor/ui/apkList`
- [Settings screens](https://github.com/domilopment/apk-extractor/tree/main/app/src/main/java/domilopment/apkextractor/ui/settings): `app/src/main/java/domilopment/apkextractor/ui/settings`

### App and archive operations

- [Application model](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/model/appList/ApplicationModel.kt): `app/src/main/java/domilopment/apkextractor/data/model/appList/ApplicationModel.kt`
- [Installed apps](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/applications/ApplicationRepository.kt): `app/src/main/java/domilopment/apkextractor/data/repository/applications/ApplicationRepository.kt`
- [Archive operations](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt): `app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt`
- [Install and restore](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/installation/InstallationRepository.kt): `app/src/main/java/domilopment/apkextractor/data/repository/installation/InstallationRepository.kt`

### Files and persistence

- [File utilities](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/utils/FileUtil.kt): `app/src/main/java/domilopment/apkextractor/utils/FileUtil.kt`
- [APK file service](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/sources/FilesService.kt): `app/src/main/java/domilopment/apkextractor/data/sources/FilesService.kt`
- [File repository](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt): `app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt`
- [Archive database](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/room/dao/ApkDao.kt): `app/src/main/java/domilopment/apkextractor/data/room/dao/ApkDao.kt`
- [Archive records](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/room/entities/PackageArchiveEntity.kt): `app/src/main/java/domilopment/apkextractor/data/room/entities/PackageArchiveEntity.kt`
- [Preferences](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/preferences/PreferenceRepository.kt): `app/src/main/java/domilopment/apkextractor/data/repository/preferences/PreferenceRepository.kt`

### Tasks and automation

- [Task execution](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt): `app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt`
- [Task state](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskState.kt): `app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskState.kt`
- [Task failures](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/model/tasks/TaskFailure.kt): `app/src/main/java/domilopment/apkextractor/data/model/tasks/TaskFailure.kt`
- [Auto-backup service](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt): `app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt`
- [Backup quick tile](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupTileService.kt): `app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupTileService.kt`

### Android integrations

- [Install sessions](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/di/installation/InstallationService.kt): `app/src/main/java/domilopment/apkextractor/di/installation/InstallationService.kt`
- [Package update receiver](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/autoBackup/PackageBroadcastReceiver.kt): `app/src/main/java/domilopment/apkextractor/autoBackup/PackageBroadcastReceiver.kt`
- [Analytics interface](https://github.com/domilopment/apk-extractor/blob/main/app/src/main/java/domilopment/apkextractor/data/repository/analytics/AnalyticsHelper.kt): `app/src/main/java/domilopment/apkextractor/data/repository/analytics/AnalyticsHelper.kt`

### Other components

- **Device user**

## Connections

- Device user → App entry: opens
- App entry → Screen navigation: routes through (evidence: `app/src/main/java/domilopment/apkextractor/MainActivity.kt`)
- Device user → Installed app browser: browses apps
- Device user → Archive browser: manages backups
- Device user → Settings screens: configures
- Device user → Install and restore: restores backup
- Device user → Backup quick tile: toggles backup (evidence: `app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupTileService.kt`)
- Installed app browser → Installed apps: browses
- Installed apps → Application model: provides models (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/applications/ApplicationRepository.kt`)
- Archive operations → Archive database: reads and writes (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt`)
- Archive operations → Archive records: uses records (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/packageArchive/PackageArchiveRepository.kt`)
- File repository → APK file service: delegates to (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/files/FilesRepository.kt`)
- APK file service → File utilities: uses (evidence: `app/src/main/java/domilopment/apkextractor/data/sources/FilesService.kt`)
- Device user → File repository: saves or shares APKs
- Install and restore → Install sessions: delegates installation (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/installation/InstallationRepository.kt`)
- Install sessions → Device user: reports install result
- Settings screens → Preferences: edits preferences
- Backup quick tile → Auto-backup service: starts or stops (evidence: `app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupTileService.kt`)
- Auto-backup service → Package update receiver: registers receiver (evidence: `app/src/main/java/domilopment/apkextractor/autoBackup/AutoBackupService.kt`)
- Auto-backup service → File repository: backs up updated apps
- Task execution → Task state: transitions (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt`)
- Task execution → Task failures: records failure (evidence: `app/src/main/java/domilopment/apkextractor/data/repository/tasks/TaskEngine.kt`)
