# zacharee/installwithoptions architecture

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

- Interactive diagram: https://gitdiagram.com/zacharee/installwithoptions
- Repository: https://github.com/zacharee/installwithoptions

## Overview

Install with Options is an Android app for configuring and performing advanced APK installs through Shizuku or root. The principal workflow is selecting APKs, choosing install options, authorizing elevated access, and submitting the install; the README also documents split-APK and batch installs plus options for test-only apps, downgrades, and Android 14 target-SDK restrictions. The excerpts show the activity, option state, permission handling, and shell installer boundary, but not the complete install dispatch. Consequently, that connection is marked unverified; other edges reflect shown calls or indexed references.

Main entry points: [`app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt) (Main activity), [`app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt`](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt) (Install coordinator), [`app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt`](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt) (Mutable options), [`app/src/main/java/dev/zwander/installwithoptions/data/DataModel.kt`](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/DataModel.kt) (App state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and interface"]
  node_activity["Main activity<br/>[MainActivity.kt]"]
  node_footer["Footer settings<br/>[Footer.kt]"]
end

subgraph group_options["Install options"]
  node_data["App state<br/>[DataModel.kt]"]
  node_installopts["Install options<br/>[InstallOption.kt]"]
  node_mutableopts["Mutable options<br/>[MutableOption.kt]"]
  node_settings[("Preferences<br/>[Settings.kt]")]
  node_selector["Option selector"]
end

subgraph group_permissions["Elevated access"]
  node_permission["Permission handler"]
  node_shizuku["Shizuku utilities<br/>[ShizukuUtils.kt]"]
  node_adapter["Root adapter"]
end

subgraph group_install["Installation runtime"]
  node_shell["Shell interface<br/>[ShellInterface.kt]"]
  node_internal["Internal installer"]
  node_installer["Install coordinator<br/>[Installer.kt]"]
end

node_user(("Device user"))
node_android["Android installer"]

node_user -->|"selects APKs"| node_activity
node_activity -->|"checks access"| node_permission
node_activity -->|"uses state"| node_data
node_activity -->|"uses options"| node_installopts
node_activity -->|"uses options"| node_mutableopts
node_activity -->|"renders"| node_footer
node_activity -.->|"starts install"| node_installer
node_footer -->|"reads preferences"| node_settings
node_footer -->|"renders"| node_selector
node_mutableopts -->|"persists values"| node_settings
node_mutableopts -->|"renders selector"| node_selector
node_permission -->|"updates access state"| node_data
node_permission -->|"checks Shizuku"| node_shizuku
node_adapter -->|"updates access state"| node_data
node_adapter -->|"implements interface"| node_shell
node_shell -->|"delegates install"| node_internal
node_installer -->|"updates status"| node_data
node_installer -->|"uses options"| node_mutableopts
node_installer -->|"receives install results"| node_android

click node_activity "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt"
click node_footer "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/components/Footer.kt"
click node_data "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/DataModel.kt"
click node_installopts "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/InstallOption.kt"
click node_mutableopts "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt"
click node_settings "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/Settings.kt"
click node_selector "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/ui/views/DropdownMenuSelector.kt"
click node_permission "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ElevatedPermissionHandler.kt"
click node_shizuku "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShizukuUtils.kt"
click node_adapter "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShizukuRootAdapter.kt"
click node_shell "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShellInterface.kt"
click node_internal "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/InternalInstaller.kt"
click node_installer "https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/Installer.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_activity,node_footer,node_user toneBlue
class node_data,node_installopts,node_mutableopts,node_settings,node_selector toneAmber
class node_permission,node_shizuku,node_adapter toneMint
class node_shell,node_internal,node_installer toneRose
class node_android toneIndigo
```

## Components

### App and interface

- [Main activity](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt): `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`
- [Footer settings](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/components/Footer.kt): `app/src/main/java/dev/zwander/installwithoptions/components/Footer.kt`

### Install options

- [App state](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/DataModel.kt): `app/src/main/java/dev/zwander/installwithoptions/data/DataModel.kt`
- [Install options](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/InstallOption.kt): `app/src/main/java/dev/zwander/installwithoptions/data/InstallOption.kt`
- [Mutable options](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt): `app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt`
- [Preferences](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/data/Settings.kt): `app/src/main/java/dev/zwander/installwithoptions/data/Settings.kt`
- [Option selector](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/ui/views/DropdownMenuSelector.kt): `app/src/main/java/dev/zwander/installwithoptions/ui/views/DropdownMenuSelector.kt`

### Elevated access

- [Permission handler](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ElevatedPermissionHandler.kt): `app/src/main/java/dev/zwander/installwithoptions/util/ElevatedPermissionHandler.kt`
- [Shizuku utilities](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShizukuUtils.kt): `app/src/main/java/dev/zwander/installwithoptions/util/ShizukuUtils.kt`
- [Root adapter](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShizukuRootAdapter.kt): `app/src/main/java/dev/zwander/installwithoptions/util/ShizukuRootAdapter.kt`

### Installation runtime

- [Shell interface](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/ShellInterface.kt): `app/src/main/java/dev/zwander/installwithoptions/util/ShellInterface.kt`
- [Internal installer](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/InternalInstaller.kt): `app/src/main/java/dev/zwander/installwithoptions/util/InternalInstaller.kt`
- [Install coordinator](https://github.com/zacharee/installwithoptions/blob/main/app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt): `app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt`

### Other components

- **Device user**
- **Android installer**

## Connections

- Device user → Main activity: selects APKs (evidence: `README.md`)
- Main activity → Permission handler: checks access (evidence: `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`)
- Main activity → App state: uses state (evidence: `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`)
- Main activity → Install options: uses options (evidence: `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`)
- Main activity → Mutable options: uses options (evidence: `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`)
- Main activity → Footer settings: renders (evidence: `app/src/main/java/dev/zwander/installwithoptions/MainActivity.kt`)
- Main activity → Install coordinator: starts install
- Footer settings → Preferences: reads preferences (evidence: `app/src/main/java/dev/zwander/installwithoptions/components/Footer.kt`)
- Footer settings → Option selector: renders (evidence: `app/src/main/java/dev/zwander/installwithoptions/components/Footer.kt`)
- Mutable options → Preferences: persists values (evidence: `app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt`)
- Mutable options → Option selector: renders selector (evidence: `app/src/main/java/dev/zwander/installwithoptions/data/MutableOption.kt`)
- Permission handler → App state: updates access state (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/ElevatedPermissionHandler.kt`)
- Permission handler → Shizuku utilities: checks Shizuku (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/ElevatedPermissionHandler.kt`)
- Root adapter → App state: updates access state (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/ShizukuRootAdapter.kt`)
- Root adapter → Shell interface: implements interface (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/ShizukuRootAdapter.kt`)
- Shell interface → Internal installer: delegates install (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/ShellInterface.kt`)
- Install coordinator → App state: updates status (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt`)
- Install coordinator → Mutable options: uses options (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt`)
- Install coordinator → Android installer: receives install results (evidence: `app/src/main/java/dev/zwander/installwithoptions/util/Installer.kt`)
