# ibotpeaches/apktool architecture

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

- Interactive diagram: https://gitdiagram.com/ibotpeaches/apktool
- Repository: https://github.com/ibotpeaches/apktool

## Overview

Apktool is an Android APK reverse-engineering tool. Users invoke the CLI to decode an APK into an editable project, inspect or modify its resources and smali, then rebuild the project into an APK. The repository also includes framework and aapt support plus project metadata handling. Resource parsing, binary/XML serialization, and smali assembly are distinct internal stages. The sampled CLI and builder references support some links; several decoder and framework details are unsampled, so their connections are shown only where documented or left unverified.

Main entry points: [`brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java) (APK builder), [`brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java`](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java) (APK decoder), [`brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java`](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java) (Command line), [`brut.apktool/apktool-lib/src/main/java/brut/androlib/res/ResDecoder.java`](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/ResDecoder.java) (Resource decoding)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI and orchestration"]
  node_cli["Command line<br/>[Main.java]"]
end

subgraph group_apk["APK processing"]
  node_decoder["APK decoder<br/>[ApkDecoder.java]"]
  node_builder["APK builder<br/>[ApkBuilder.java]"]
  node_smali["Smali assembly<br/>[SmaliBuilder.java]"]
end

subgraph group_resources["Resource handling"]
  node_resdecode["Resource decoding<br/>[ResDecoder.java]"]
  node_binaryxml["Binary XML parser"]
  node_restable["Resource table<br/>[ResEntrySpec.java]"]
  node_xmlserial["XML serializer"]
  node_framework["Framework manager<br/>[Framework.java]"]
  node_aapt["aapt manager<br/>[AaptManager.java]"]
end

subgraph group_support["Project and tooling"]
  node_metadata["APK metadata<br/>[ApkInfo.java]"]
  node_sdkinfo["SDK metadata<br/>[SdkInfo.java]"]
  node_config["Run configuration<br/>[Config.java]"]
  node_zip["ZIP archive<br/>[ZipArchive.java]"]
end

node_user(("APK developer"))
node_aaptbin["aapt executable"]
node_project["Decoded project"]
node_apkfile["APK file"]

node_user -->|"invokes"| node_cli
node_cli -->|"dispatches decode"| node_decoder
node_cli -->|"dispatches build"| node_builder
node_cli -->|"configures"| node_config
node_decoder -->|"writes project"| node_project
node_apkfile -->|"supplies input"| node_decoder
node_builder -->|"produces APK"| node_apkfile
node_decoder -.->|"decodes resources"| node_resdecode
node_resdecode -.->|"parses binary XML"| node_binaryxml
node_binaryxml -->|"resolves resource entries"| node_restable
node_resdecode -.->|"serializes XML"| node_xmlserial
node_decoder -.->|"uses frameworks"| node_framework
node_builder -->|"builds smali"| node_smali
node_builder -->|"invokes packaging"| node_aapt
node_aapt -->|"executes"| node_aaptbin
node_builder -->|"reads metadata"| node_metadata
node_sdkinfo -->|"records SDK details"| node_metadata
node_decoder -.->|"reads archive"| node_zip
node_builder -->|"writes archive"| node_zip

click node_cli "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java"
click node_decoder "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java"
click node_builder "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java"
click node_smali "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/smali/SmaliBuilder.java"
click node_resdecode "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/ResDecoder.java"
click node_binaryxml "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/decoder/BinaryXmlResourceParser.java"
click node_restable "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/table/ResEntrySpec.java"
click node_xmlserial "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/xml/ResXmlSerializer.java"
click node_framework "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/Framework.java"
click node_aapt "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/AaptManager.java"
click node_metadata "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/ApkInfo.java"
click node_sdkinfo "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/SdkInfo.java"
click node_config "https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/Config.java"
click node_zip "https://github.com/ibotpeaches/apktool/blob/main/brut.j.zip/src/main/java/brut/zip/ZipArchive.java"

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_cli toneBlue
class node_decoder,node_builder,node_smali toneAmber
class node_resdecode,node_binaryxml,node_restable,node_xmlserial,node_framework,node_aapt toneMint
class node_metadata,node_sdkinfo,node_config,node_zip toneRose
class node_user,node_aaptbin,node_project,node_apkfile toneIndigo
```

## Components

### CLI and orchestration

- [Command line](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java): `brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java`

### APK processing

- [APK decoder](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java`
- [APK builder](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`
- [Smali assembly](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/smali/SmaliBuilder.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/smali/SmaliBuilder.java`

### Resource handling

- [Resource decoding](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/ResDecoder.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/ResDecoder.java`
- [Binary XML parser](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/decoder/BinaryXmlResourceParser.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/decoder/BinaryXmlResourceParser.java`
- [Resource table](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/table/ResEntrySpec.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/table/ResEntrySpec.java`
- [XML serializer](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/xml/ResXmlSerializer.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/xml/ResXmlSerializer.java`
- [Framework manager](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/Framework.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/Framework.java`
- [aapt manager](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/res/AaptManager.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/AaptManager.java`

### Project and tooling

- [APK metadata](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/ApkInfo.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/ApkInfo.java`
- [SDK metadata](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/SdkInfo.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/SdkInfo.java`
- [Run configuration](https://github.com/ibotpeaches/apktool/blob/main/brut.apktool/apktool-lib/src/main/java/brut/androlib/Config.java): `brut.apktool/apktool-lib/src/main/java/brut/androlib/Config.java`
- [ZIP archive](https://github.com/ibotpeaches/apktool/blob/main/brut.j.zip/src/main/java/brut/zip/ZipArchive.java): `brut.j.zip/src/main/java/brut/zip/ZipArchive.java`

### Other components

- **APK developer**
- **aapt executable**
- **Decoded project**
- **APK file**

## Connections

- APK developer → Command line: invokes (evidence: `README.md`)
- Command line → APK decoder: dispatches decode (evidence: `brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java`)
- Command line → APK builder: dispatches build (evidence: `brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java`)
- Command line → Run configuration: configures (evidence: `brut.apktool/apktool-cli/src/main/java/brut/apktool/Main.java`)
- APK decoder → Decoded project: writes project (evidence: `README.md`)
- APK file → APK decoder: supplies input (evidence: `README.md`)
- APK builder → APK file: produces APK (evidence: `README.md`)
- APK decoder → Resource decoding: decodes resources (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkDecoder.java`)
- Resource decoding → Binary XML parser: parses binary XML
- Binary XML parser → Resource table: resolves resource entries (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/decoder/BinaryXmlResourceParser.java`)
- Resource decoding → XML serializer: serializes XML
- APK decoder → Framework manager: uses frameworks
- APK builder → Smali assembly: builds smali (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`)
- APK builder → aapt manager: invokes packaging (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`)
- aapt manager → aapt executable: executes (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/res/AaptManager.java`)
- APK builder → APK metadata: reads metadata (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`)
- SDK metadata → APK metadata: records SDK details (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/meta/ApkInfo.java`)
- APK decoder → ZIP archive: reads archive
- APK builder → ZIP archive: writes archive (evidence: `brut.apktool/apktool-lib/src/main/java/brut/androlib/ApkBuilder.java`)
