# routinemiku/apkstart architecture

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

- Interactive diagram: https://gitdiagram.com/routinemiku/apkstart
- Repository: https://github.com/routinemiku/apkstart

## Overview

ApkStart is a Windows Android-app runner: users install an APK, then launch its app from a Windows shortcut in a managed Android runtime and app window. The map includes the documented provisioning, diagnosis, updates, shared files, input mapping, and window behavior. Some subsystem paths are present in the tree and README but their source was not sampled; those branches are documented rather than inferred from unseen calls.

Main entry points: [`src/main.js`](https://github.com/routinemiku/apkstart/blob/main/src/main.js) (App coordinator), [`src/core/installer.js`](https://github.com/routinemiku/apkstart/blob/main/src/core/installer.js) (APK installer), [`src/core/engine.js`](https://github.com/routinemiku/apkstart/blob/main/src/core/engine.js) (Runtime lifecycle), [`src/core/emulator.js`](https://github.com/routinemiku/apkstart/blob/main/src/core/emulator.js) (Emulator control)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Install and launch"]
  node_main["App coordinator<br/>[main.js]"]
  node_ui["Settings UI<br/>[app.js]"]
  node_installer["APK installer<br/>[installer.js]"]
  node_apk["APK analyzer<br/>[apk.js]"]
  node_shortcuts["App shortcuts<br/>[shortcut.js]"]
  node_store[("App and settings store<br/>[store.js]")]
end

subgraph group_runtime["Android runtime"]
  node_provision["Runtime provisioning<br/>[provision.js]"]
  node_downloads["Downloads and sources<br/>[download.js]"]
  node_sources["Source selection<br/>[sources.js]"]
  node_engine["Runtime lifecycle<br/>[engine.js]"]
  node_emulator["Emulator control<br/>[emulator.js]"]
  node_adb["Android device client<br/>[adb.js]"]
  node_doctor["Compatibility diagnosis<br/>[doctor.js]"]
  node_drivers["Compatibility patches<br/>[drivers.js]"]
end

subgraph group_experience["Window and input"]
  node_appwin["App window manager<br/>[appwin.js]"]
  node_pointer["Mouse input<br/>[pointer.js]"]
  node_keymap["Keyboard mapping<br/>[keymap-engine.js]"]
  node_sharing["Shared files<br/>[sharer.js]"]
end

subgraph group_services["Management services"]
  node_preflight["Host preflight<br/>[preflight.js]"]
  node_updater["Software updater<br/>[updater.js]"]
end

node_user(("Windows user"))
node_android["Android runtime"]
node_release_sources["GitHub and Gitee"]

node_user -->|"launches"| node_main
node_user -->|"configures"| node_ui
node_main -->|"installs APK"| node_installer
node_installer -->|"analyzes"| node_apk
node_installer -->|"records app"| node_store
node_installer -->|"creates shortcuts"| node_shortcuts
node_main -->|"starts app"| node_engine
node_engine -->|"operates runtime"| node_android
node_provision -->|"downloads components"| node_downloads
node_provision -->|"selects sources"| node_sources
node_engine -->|"manages emulator"| node_emulator
node_engine -->|"checks device"| node_adb
node_emulator -->|"chooses profiles"| node_doctor
node_emulator -->|"applies patches"| node_drivers
node_main -->|"manages windows"| node_appwin
node_main -->|"sets up sharing"| node_sharing
node_main -->|"sets up key mapping"| node_keymap
node_keymap -->|"injects input"| node_adb
node_main -->|"refreshes pointer"| node_pointer
node_user -->|"checks host"| node_preflight
node_user -->|"requests update"| node_updater
node_updater -->|"checks releases"| node_release_sources

click node_main "https://github.com/routinemiku/apkstart/blob/main/src/main.js"
click node_ui "https://github.com/routinemiku/apkstart/blob/main/src/ui/app.js"
click node_installer "https://github.com/routinemiku/apkstart/blob/main/src/core/installer.js"
click node_apk "https://github.com/routinemiku/apkstart/blob/main/src/core/apk.js"
click node_shortcuts "https://github.com/routinemiku/apkstart/blob/main/src/core/shortcut.js"
click node_store "https://github.com/routinemiku/apkstart/blob/main/src/core/store.js"
click node_provision "https://github.com/routinemiku/apkstart/blob/main/src/core/provision.js"
click node_downloads "https://github.com/routinemiku/apkstart/blob/main/src/core/download.js"
click node_sources "https://github.com/routinemiku/apkstart/blob/main/src/core/sources.js"
click node_engine "https://github.com/routinemiku/apkstart/blob/main/src/core/engine.js"
click node_emulator "https://github.com/routinemiku/apkstart/blob/main/src/core/emulator.js"
click node_adb "https://github.com/routinemiku/apkstart/blob/main/src/core/adb.js"
click node_doctor "https://github.com/routinemiku/apkstart/blob/main/src/core/doctor.js"
click node_drivers "https://github.com/routinemiku/apkstart/blob/main/src/core/drivers.js"
click node_appwin "https://github.com/routinemiku/apkstart/blob/main/src/core/appwin.js"
click node_pointer "https://github.com/routinemiku/apkstart/blob/main/src/core/pointer.js"
click node_keymap "https://github.com/routinemiku/apkstart/blob/main/src/core/keymap-engine.js"
click node_sharing "https://github.com/routinemiku/apkstart/blob/main/src/core/sharer.js"
click node_preflight "https://github.com/routinemiku/apkstart/blob/main/src/core/preflight.js"
click node_updater "https://github.com/routinemiku/apkstart/blob/main/src/core/updater.js"

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_ui,node_installer,node_apk,node_shortcuts,node_store,node_user toneBlue
class node_provision,node_downloads,node_sources,node_engine,node_emulator,node_adb,node_doctor,node_drivers toneAmber
class node_appwin,node_pointer,node_keymap,node_sharing toneMint
class node_preflight,node_updater toneRose
class node_android,node_release_sources toneIndigo
```

## Components

### Install and launch

- [App coordinator](https://github.com/routinemiku/apkstart/blob/main/src/main.js): `src/main.js`
- [Settings UI](https://github.com/routinemiku/apkstart/blob/main/src/ui/app.js): `src/ui/app.js`
- [APK installer](https://github.com/routinemiku/apkstart/blob/main/src/core/installer.js): `src/core/installer.js`
- [APK analyzer](https://github.com/routinemiku/apkstart/blob/main/src/core/apk.js): `src/core/apk.js`
- [App shortcuts](https://github.com/routinemiku/apkstart/blob/main/src/core/shortcut.js): `src/core/shortcut.js`
- [App and settings store](https://github.com/routinemiku/apkstart/blob/main/src/core/store.js): `src/core/store.js`

### Android runtime

- [Runtime provisioning](https://github.com/routinemiku/apkstart/blob/main/src/core/provision.js): `src/core/provision.js`
- [Downloads and sources](https://github.com/routinemiku/apkstart/blob/main/src/core/download.js): `src/core/download.js`
- [Source selection](https://github.com/routinemiku/apkstart/blob/main/src/core/sources.js): `src/core/sources.js`
- [Runtime lifecycle](https://github.com/routinemiku/apkstart/blob/main/src/core/engine.js): `src/core/engine.js`
- [Emulator control](https://github.com/routinemiku/apkstart/blob/main/src/core/emulator.js): `src/core/emulator.js`
- [Android device client](https://github.com/routinemiku/apkstart/blob/main/src/core/adb.js): `src/core/adb.js`
- [Compatibility diagnosis](https://github.com/routinemiku/apkstart/blob/main/src/core/doctor.js): `src/core/doctor.js`
- [Compatibility patches](https://github.com/routinemiku/apkstart/blob/main/src/core/drivers.js): `src/core/drivers.js`

### Window and input

- [App window manager](https://github.com/routinemiku/apkstart/blob/main/src/core/appwin.js): `src/core/appwin.js`
- [Mouse input](https://github.com/routinemiku/apkstart/blob/main/src/core/pointer.js): `src/core/pointer.js`
- [Keyboard mapping](https://github.com/routinemiku/apkstart/blob/main/src/core/keymap-engine.js): `src/core/keymap-engine.js`
- [Shared files](https://github.com/routinemiku/apkstart/blob/main/src/core/sharer.js): `src/core/sharer.js`

### Management services

- [Host preflight](https://github.com/routinemiku/apkstart/blob/main/src/core/preflight.js): `src/core/preflight.js`
- [Software updater](https://github.com/routinemiku/apkstart/blob/main/src/core/updater.js): `src/core/updater.js`

### Other components

- **Windows user**
- **Android runtime**
- **GitHub and Gitee**

## Connections

- Windows user → App coordinator: launches
- Windows user → Settings UI: configures
- App coordinator → APK installer: installs APK (evidence: `src/main.js`)
- APK installer → APK analyzer: analyzes (evidence: `src/core/installer.js`)
- APK installer → App and settings store: records app (evidence: `src/core/installer.js`)
- APK installer → App shortcuts: creates shortcuts (evidence: `src/core/installer.js`)
- App coordinator → Runtime lifecycle: starts app (evidence: `src/main.js`)
- Runtime lifecycle → Android runtime: operates runtime
- Runtime provisioning → Downloads and sources: downloads components (evidence: `src/core/provision.js`)
- Runtime provisioning → Source selection: selects sources (evidence: `src/core/provision.js`)
- Runtime lifecycle → Emulator control: manages emulator (evidence: `src/core/engine.js`)
- Runtime lifecycle → Android device client: checks device (evidence: `src/core/engine.js`)
- Emulator control → Compatibility diagnosis: chooses profiles (evidence: `src/core/emulator.js`)
- Emulator control → Compatibility patches: applies patches (evidence: `src/core/emulator.js`)
- App coordinator → App window manager: manages windows (evidence: `src/main.js`)
- App coordinator → Shared files: sets up sharing (evidence: `src/main.js`)
- App coordinator → Keyboard mapping: sets up key mapping (evidence: `src/main.js`)
- Keyboard mapping → Android device client: injects input (evidence: `src/core/keymap-engine.js`)
- App coordinator → Mouse input: refreshes pointer (evidence: `src/main.js`)
- Windows user → Host preflight: checks host
- Windows user → Software updater: requests update
- Software updater → GitHub and Gitee: checks releases
