# oraveczandrew/kjarify architecture

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

- Interactive diagram: https://gitdiagram.com/oraveczandrew/kjarify
- Repository: https://github.com/oraveczandrew/kjarify

## Overview

KJarify translates Android DEX bytecode into JVM class files, with command-line and library entry points and parallel class processing. The principal flow is input DEX parsing, instruction decoding and type analysis, JVM instruction generation and optimization, then class-file output; the library also exposes translated classes through callbacks or a result map. The README documents APK input and processing APIs, while the source index establishes several internal dependencies. Some intermediate assembly and output wiring is unsampled, so those links are omitted rather than inferred.

Main entry points: [`src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt`](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt) (DEX processor), [`src/main/kotlin/hu/oandras/kJarify/jvm/JVMClassWriter.kt`](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JVMClassWriter.kt) (Class-file writer), [`src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt`](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt) (Dalvik instructions), [`src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt`](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt) (JVM translation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry points"]
  node_cli["CLI<br/>[Main.kt]"]
  node_library["Library API<br/>[KJarify.kt]"]
end

subgraph group_dex["DEX processing"]
  node_processor["DEX processor<br/>[DexProcessor.kt]"]
  node_reader["DEX reader<br/>[DexReader.kt]"]
  node_dexmodel["DEX model<br/>[DexFile.kt]"]
  node_decoder["Instruction decoding<br/>[Dalvik.kt]"]
  node_dalvikinsn["Dalvik instructions"]
  node_opcode["Dalvik opcodes<br/>[DalvikOpcode.kt]"]
end

subgraph group_translate["JVM translation"]
  node_inference["Type inference<br/>[TypeInference.kt]"]
  node_typeinfo["Type state<br/>[TypeInfo.kt]"]
  node_typevisitor["Type transfer rules"]
  node_jvmvisitor["JVM translation"]
  node_jvminsn["JVM instructions<br/>[JvmInstruction.kt]"]
  node_ops["JVM operations<br/>[JvmOps.kt]"]
  node_options["Optimization options"]
  node_optimization["Bytecode optimization<br/>[JvmOptimization.kt]"]
  node_treelist["Persistent type lists<br/>[IntTreeList.kt]"]
end

subgraph group_output["Class output"]
  node_assembler["Bytecode assembly"]
  node_pool["Constant pool<br/>[ConstantPool.kt]"]
  node_classwriter["Class-file writer<br/>[JVMClassWriter.kt]"]
  node_jarwriter["JAR writer<br/>[JarWriter.kt]"]
end

node_input(("APK / DEX input"))
node_results["Classes / callback"]
node_outputfile["Output file"]

node_input -->|"supplies input"| node_cli
node_cli -->|"starts processing"| node_processor
node_input -->|"supplies files"| node_library
node_library -->|"delegates processing"| node_processor
node_processor -->|"loads DEX model"| node_dexmodel
node_reader -->|"reads stream data"| node_dexmodel
node_dexmodel -->|"provides DEX data"| node_decoder
node_decoder -.->|"creates instructions"| node_dalvikinsn
node_dalvikinsn -->|"carries opcode"| node_opcode
node_inference -->|"dispatches transfer"| node_typevisitor
node_inference -->|"tracks state"| node_typeinfo
node_typeinfo -->|"uses persistent lists"| node_treelist
node_typevisitor -->|"analyzes instructions"| node_dalvikinsn
node_jvmvisitor -->|"translates instructions"| node_dalvikinsn
node_jvmvisitor -->|"uses type data"| node_typeinfo
node_jvmvisitor -->|"emits instructions"| node_jvminsn
node_jvminsn -->|"uses opcode definitions"| node_ops
node_processor -->|"translates classes"| node_classwriter
node_processor -->|"configures processing"| node_options
node_options -.->|"selects passes"| node_optimization
node_classwriter -.->|"builds constants"| node_pool
node_classwriter -->|"returns class bytes"| node_results
node_processor -->|"reports translated classes"| node_results
node_classwriter -.->|"assembles bytecode"| node_assembler
node_jarwriter -.->|"writes archive"| node_outputfile
node_cli -.->|"writes requested output"| node_outputfile

click node_cli "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/Main.kt"
click node_library "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/KJarify.kt"
click node_processor "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt"
click node_reader "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexReader.kt"
click node_dexmodel "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexFile.kt"
click node_decoder "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/Dalvik.kt"
click node_dalvikinsn "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt"
click node_opcode "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DalvikOpcode.kt"
click node_inference "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInference.kt"
click node_typeinfo "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInfo.kt"
click node_typevisitor "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/DalvikInstructionVisitor.kt"
click node_jvmvisitor "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt"
click node_jvminsn "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JvmInstruction.kt"
click node_ops "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JvmOps.kt"
click node_options "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/optimization/OptimizationOptions.kt"
click node_optimization "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/optimization/JvmOptimization.kt"
click node_assembler "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/BytecodeAssembler.kt"
click node_pool "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/ConstantPool.kt"
click node_classwriter "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JVMClassWriter.kt"
click node_jarwriter "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/streams/JarWriter.kt"
click node_treelist "https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/treeList/IntTreeList.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_cli,node_library toneBlue
class node_processor,node_reader,node_dexmodel,node_decoder,node_dalvikinsn,node_opcode toneAmber
class node_inference,node_typeinfo,node_typevisitor,node_jvmvisitor,node_jvminsn,node_ops,node_options,node_optimization,node_treelist toneMint
class node_assembler,node_pool,node_classwriter,node_jarwriter toneRose
class node_input,node_results,node_outputfile toneIndigo
```

## Components

### Entry points

- [CLI](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/Main.kt): `src/main/kotlin/hu/oandras/kJarify/Main.kt`
- [Library API](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/KJarify.kt): `src/main/kotlin/hu/oandras/kJarify/KJarify.kt`

### DEX processing

- [DEX processor](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt): `src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt`
- [DEX reader](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexReader.kt): `src/main/kotlin/hu/oandras/kJarify/dex/DexReader.kt`
- [DEX model](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DexFile.kt): `src/main/kotlin/hu/oandras/kJarify/dex/DexFile.kt`
- [Instruction decoding](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/Dalvik.kt): `src/main/kotlin/hu/oandras/kJarify/dex/Dalvik.kt`
- [Dalvik instructions](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt): `src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt`
- [Dalvik opcodes](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/dex/DalvikOpcode.kt): `src/main/kotlin/hu/oandras/kJarify/dex/DalvikOpcode.kt`

### JVM translation

- [Type inference](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInference.kt): `src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInference.kt`
- [Type state](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInfo.kt): `src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInfo.kt`
- [Type transfer rules](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/typeinference/DalvikInstructionVisitor.kt): `src/main/kotlin/hu/oandras/kJarify/typeinference/DalvikInstructionVisitor.kt`
- [JVM translation](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt`
- [JVM instructions](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JvmInstruction.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/JvmInstruction.kt`
- [JVM operations](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JvmOps.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/JvmOps.kt`
- [Optimization options](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/optimization/OptimizationOptions.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/optimization/OptimizationOptions.kt`
- [Bytecode optimization](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/optimization/JvmOptimization.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/optimization/JvmOptimization.kt`
- [Persistent type lists](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/treeList/IntTreeList.kt): `src/main/kotlin/hu/oandras/kJarify/treeList/IntTreeList.kt`

### Class output

- [Bytecode assembly](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/BytecodeAssembler.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/BytecodeAssembler.kt`
- [Constant pool](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/ConstantPool.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/ConstantPool.kt`
- [Class-file writer](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/jvm/JVMClassWriter.kt): `src/main/kotlin/hu/oandras/kJarify/jvm/JVMClassWriter.kt`
- [JAR writer](https://github.com/oraveczandrew/kjarify/blob/master/src/main/kotlin/hu/oandras/kJarify/streams/JarWriter.kt): `src/main/kotlin/hu/oandras/kJarify/streams/JarWriter.kt`

### Other components

- **APK / DEX input**
- **Classes / callback**
- **Output file**

## Connections

- APK / DEX input → CLI: supplies input
- CLI → DEX processor: starts processing (evidence: `src/main/kotlin/hu/oandras/kJarify/Main.kt`)
- APK / DEX input → Library API: supplies files
- Library API → DEX processor: delegates processing
- DEX processor → DEX model: loads DEX model (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt`)
- DEX reader → DEX model: reads stream data (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/DexFile.kt`)
- DEX model → Instruction decoding: provides DEX data (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/Dalvik.kt`)
- Instruction decoding → Dalvik instructions: creates instructions (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/Dalvik.kt`)
- Dalvik instructions → Dalvik opcodes: carries opcode (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/DalvikInstruction.kt`)
- Type inference → Type transfer rules: dispatches transfer (evidence: `src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInference.kt`)
- Type inference → Type state: tracks state (evidence: `src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInference.kt`)
- Type state → Persistent type lists: uses persistent lists (evidence: `src/main/kotlin/hu/oandras/kJarify/typeinference/TypeInfo.kt`)
- Type transfer rules → Dalvik instructions: analyzes instructions (evidence: `src/main/kotlin/hu/oandras/kJarify/typeinference/DalvikInstructionVisitor.kt`)
- JVM translation → Dalvik instructions: translates instructions (evidence: `src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt`)
- JVM translation → Type state: uses type data (evidence: `src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt`)
- JVM translation → JVM instructions: emits instructions (evidence: `src/main/kotlin/hu/oandras/kJarify/jvm/DalvikInstructionVisitor.kt`)
- JVM instructions → JVM operations: uses opcode definitions (evidence: `src/main/kotlin/hu/oandras/kJarify/jvm/JvmInstruction.kt`)
- DEX processor → Class-file writer: translates classes (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt`)
- DEX processor → Optimization options: configures processing (evidence: `src/main/kotlin/hu/oandras/kJarify/dex/DexProcessor.kt`)
- Optimization options → Bytecode optimization: selects passes (evidence: `src/main/kotlin/hu/oandras/kJarify/jvm/optimization/OptimizationOptions.kt`)
- Class-file writer → Constant pool: builds constants
- Class-file writer → Classes / callback: returns class bytes
- DEX processor → Classes / callback: reports translated classes
- Class-file writer → Bytecode assembly: assembles bytecode
- JAR writer → Output file: writes archive
- CLI → Output file: writes requested output
