# androidideofficial/androidide architecture

> Architecture diagram of the GitHub repository androidideofficial/androidide, 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/androidideofficial/androidide
- Repository: https://github.com/androidideofficial/androidide

## Overview

AndroidIDE is an on-device IDE for building Gradle-based Android applications. The principal workflow is to open a project, edit its sources, initialize or run Gradle tasks, and inspect build output; Java/XML language support and UI design add editing capabilities. The README also identifies a terminal, SDK/JDK and environment support, API information, real-time app logs, and Git. Sampled activity and build-service references support the project/build links; unsampled feature relationships are shown only as unverified where useful.

Main entry points: [`core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt`](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt) (Project activity), [`core/app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt`](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt) (Source editor), [`core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt`](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt) (Gradle service), [`core/projects/src/main/java/com/itsaky/androidide/projects/builder/BuildService.kt`](https://github.com/androidideofficial/androidide/blob/dev/core/projects/src/main/java/com/itsaky/androidide/projects/builder/BuildService.kt) (Build service API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_project["Project workflow"]
  node_projectui["Project activity"]
  node_projectmgr["Project manager"]
  node_buildapi["Build service API<br/>[BuildService.kt]"]
end

subgraph group_edit["Editing tools"]
  node_editor["Source editor"]
  node_java["Java language server"]
  node_xml["XML language server"]
  node_index["Platform index"]
  node_designer["UI designer"]
  node_inflater["Layout inflater"]
end

subgraph group_runtime["Build and runtime"]
  node_gradlesvc["Gradle service"]
  node_toolserver["Tooling server<br/>[Main.java]"]
  node_terminal["Terminal service<br/>[TermuxService.java]"]
  node_shellmgr["Shell manager"]
  node_session["Terminal session"]
end

subgraph group_support["IDE services"]
  node_logs["Log reader"]
  node_environment["Build environment<br/>[Environment.java]"]
  node_git["Git support"]
  node_sdk["SDK manager"]
end

node_developer(("Developer"))

node_developer -.->|"opens project"| node_projectui
node_projectui -->|"initializes project"| node_projectmgr
node_projectui -->|"requests builds"| node_buildapi
node_buildapi -.->|"implemented by"| node_gradlesvc
node_gradlesvc -.->|"dispatches tasks"| node_toolserver
node_gradlesvc -.->|"reads environment"| node_environment
node_developer -.->|"edits sources"| node_editor
node_projectui -->|"connects language client"| node_java
node_editor -.->|"uses language support"| node_xml
node_editor -.->|"queries symbols"| node_index
node_developer -.->|"designs layouts"| node_designer
node_designer -.->|"inflates layouts"| node_inflater
node_developer -.->|"runs commands"| node_terminal
node_terminal -->|"manages shells"| node_shellmgr
node_shellmgr -->|"tracks sessions"| node_session
node_developer -.->|"views app logs"| node_logs
node_developer -.->|"uses version control"| node_git
node_developer -.->|"manages SDK"| node_sdk

click node_projectui "https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt"
click node_projectmgr "https://github.com/androidideofficial/androidide/blob/dev/core/projects/src/main/java/com/itsaky/androidide/projects/internal/ProjectManagerImpl.kt"
click node_buildapi "https://github.com/androidideofficial/androidide/blob/dev/core/projects/src/main/java/com/itsaky/androidide/projects/builder/BuildService.kt"
click node_editor "https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt"
click node_java "https://github.com/androidideofficial/androidide/blob/dev/java/lsp/src/main/java/com/itsaky/androidide/lsp/java/compiler/JavaCompilerService.java"
click node_xml "https://github.com/androidideofficial/androidide/tree/dev/xml/lsp"
click node_index "https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/indexing/platform/PlatformIndexService.kt"
click node_designer "https://github.com/androidideofficial/androidide/tree/dev/utilities/uidesigner"
click node_inflater "https://github.com/androidideofficial/androidide/tree/dev/utilities/xml-inflater"
click node_gradlesvc "https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt"
click node_toolserver "https://github.com/androidideofficial/androidide/blob/dev/tooling/impl/src/main/java/com/itsaky/androidide/tooling/impl/Main.java"
click node_terminal "https://github.com/androidideofficial/androidide/blob/dev/termux/application/src/main/java/com/termux/app/TermuxService.java"
click node_shellmgr "https://github.com/androidideofficial/androidide/blob/dev/termux/shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java"
click node_session "https://github.com/androidideofficial/androidide/blob/dev/termux/emulator/src/main/java/com/termux/terminal/TerminalSession.java"
click node_logs "https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/services/log/LogReceiverService.kt"
click node_environment "https://github.com/androidideofficial/androidide/blob/dev/core/common/src/main/java/com/itsaky/androidide/utils/Environment.java"
click node_git "https://github.com/androidideofficial/androidide/tree/dev/core/app"
click node_sdk "https://github.com/androidideofficial/androidide/tree/dev/termux/application"

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_projectui,node_projectmgr,node_buildapi toneBlue
class node_editor,node_java,node_xml,node_index,node_designer,node_inflater toneAmber
class node_gradlesvc,node_toolserver,node_terminal,node_shellmgr,node_session toneMint
class node_logs,node_environment,node_git,node_sdk toneRose
class node_developer toneIndigo
```

## Components

### Project workflow

- [Project activity](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt): `core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt`
- [Project manager](https://github.com/androidideofficial/androidide/blob/dev/core/projects/src/main/java/com/itsaky/androidide/projects/internal/ProjectManagerImpl.kt): `core/projects/src/main/java/com/itsaky/androidide/projects/internal/ProjectManagerImpl.kt`
- [Build service API](https://github.com/androidideofficial/androidide/blob/dev/core/projects/src/main/java/com/itsaky/androidide/projects/builder/BuildService.kt): `core/projects/src/main/java/com/itsaky/androidide/projects/builder/BuildService.kt`

### Editing tools

- [Source editor](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt): `core/app/src/main/java/com/itsaky/androidide/activities/editor/EditorHandlerActivity.kt`
- [Java language server](https://github.com/androidideofficial/androidide/blob/dev/java/lsp/src/main/java/com/itsaky/androidide/lsp/java/compiler/JavaCompilerService.java): `java/lsp/src/main/java/com/itsaky/androidide/lsp/java/compiler/JavaCompilerService.java`
- [XML language server](https://github.com/androidideofficial/androidide/tree/dev/xml/lsp): `xml/lsp`
- [Platform index](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/indexing/platform/PlatformIndexService.kt): `core/app/src/main/java/com/itsaky/androidide/indexing/platform/PlatformIndexService.kt`
- [UI designer](https://github.com/androidideofficial/androidide/tree/dev/utilities/uidesigner): `utilities/uidesigner`
- [Layout inflater](https://github.com/androidideofficial/androidide/tree/dev/utilities/xml-inflater): `utilities/xml-inflater`

### Build and runtime

- [Gradle service](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt): `core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt`
- [Tooling server](https://github.com/androidideofficial/androidide/blob/dev/tooling/impl/src/main/java/com/itsaky/androidide/tooling/impl/Main.java): `tooling/impl/src/main/java/com/itsaky/androidide/tooling/impl/Main.java`
- [Terminal service](https://github.com/androidideofficial/androidide/blob/dev/termux/application/src/main/java/com/termux/app/TermuxService.java): `termux/application/src/main/java/com/termux/app/TermuxService.java`
- [Shell manager](https://github.com/androidideofficial/androidide/blob/dev/termux/shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java): `termux/shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java`
- [Terminal session](https://github.com/androidideofficial/androidide/blob/dev/termux/emulator/src/main/java/com/termux/terminal/TerminalSession.java): `termux/emulator/src/main/java/com/termux/terminal/TerminalSession.java`

### IDE services

- [Log reader](https://github.com/androidideofficial/androidide/blob/dev/core/app/src/main/java/com/itsaky/androidide/services/log/LogReceiverService.kt): `core/app/src/main/java/com/itsaky/androidide/services/log/LogReceiverService.kt`
- [Build environment](https://github.com/androidideofficial/androidide/blob/dev/core/common/src/main/java/com/itsaky/androidide/utils/Environment.java): `core/common/src/main/java/com/itsaky/androidide/utils/Environment.java`
- [Git support](https://github.com/androidideofficial/androidide/tree/dev/core/app): `core/app`
- [SDK manager](https://github.com/androidideofficial/androidide/tree/dev/termux/application): `termux/application`

### Other components

- **Developer**

## Connections

- Developer → Project activity: opens project (evidence: `README.md`)
- Project activity → Project manager: initializes project (evidence: `core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt`)
- Project activity → Build service API: requests builds (evidence: `core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt`)
- Build service API → Gradle service: implemented by (evidence: `core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt`)
- Gradle service → Tooling server: dispatches tasks
- Gradle service → Build environment: reads environment (evidence: `core/app/src/main/java/com/itsaky/androidide/services/builder/GradleBuildService.kt`)
- Developer → Source editor: edits sources (evidence: `README.md`)
- Project activity → Java language server: connects language client (evidence: `core/app/src/main/java/com/itsaky/androidide/activities/editor/ProjectHandlerActivity.kt`)
- Source editor → XML language server: uses language support
- Source editor → Platform index: queries symbols
- Developer → UI designer: designs layouts (evidence: `README.md`)
- UI designer → Layout inflater: inflates layouts
- Developer → Terminal service: runs commands (evidence: `README.md`)
- Terminal service → Shell manager: manages shells (evidence: `termux/application/src/main/java/com/termux/app/TermuxService.java`)
- Shell manager → Terminal session: tracks sessions (evidence: `termux/shared/src/main/java/com/termux/shared/termux/shell/TermuxShellManager.java`)
- Developer → Log reader: views app logs (evidence: `README.md`)
- Developer → Git support: uses version control (evidence: `README.md`)
- Developer → SDK manager: manages SDK (evidence: `README.md`)
