# jakewharton/butterknife architecture

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

- Interactive diagram: https://gitdiagram.com/jakewharton/butterknife
- Repository: https://github.com/jakewharton/butterknife

## Overview

Butter Knife is a deprecated Android view-binding library. Developers annotate fields and methods, then annotation processing generates binding code used when an app calls `ButterKnife.bind`; bindings resolve views/resources and install listeners, with an unbinder for cleanup. The library also offers reflective binding, bulk view operations, and library-project R2 generation plus lint validation. Relationships below are limited to README statements and SOURCE INDEX references; some implementation details and runtime dispatch are unsampled, so uncertain links are omitted or marked unverified.

Main entry points: [`butterknife/src/main/java/butterknife/ButterKnife.java`](https://github.com/jakewharton/butterknife/blob/master/butterknife/src/main/java/butterknife/ButterKnife.java) (Bind entry point), [`butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt`](https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt) (R2 generation), [`butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java`](https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java) (Annotation processor), [`butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java`](https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java) (Generated bindings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_annotations["Binding annotations"]
  node_annotations["Field and listener annotations<br/>[BindView.java]"]
  node_listener_metadata["Listener metadata<br/>[ListenerClass.java]"]
end

subgraph group_generation["Code generation"]
  node_processor["Annotation processor"]
  node_binding_model["Binding code generation<br/>[BindingSet.java]"]
  node_generated["Generated bindings<br/>[BindingSet.java]"]
end

subgraph group_runtime["Binding runtime"]
  node_entry["Bind entry point<br/>[ButterKnife.java]"]
  node_unbinder["Unbind contract<br/>[Unbinder.java]"]
  node_bulk_views["Bulk view operations"]
  node_view_actions["View actions and setters<br/>[Action.java]"]
  node_reflection["Reflective binding<br/>[ButterKnife.java]"]
  node_listener_cleanup["Listener cleanup"]
end

subgraph group_integrations["Library integrations"]
  node_plugin["Gradle library plugin"]
  node_r2_generator["R2 generation<br/>[R2Generator.kt]"]
  node_symbol_reader["Resource symbol reader"]
  node_r2_builder["Final R2 builder"]
  node_lint["R2 usage lint"]
  node_lint_registry["Lint registration<br/>[LintRegistry.java]"]
end

node_developer(("Android developer"))
node_app["Android app"]
node_viewtree["Android view hierarchy"]

node_developer -->|"annotates fields"| node_annotations
node_annotations -->|"processed by"| node_processor
node_listener_metadata -->|"describes callbacks"| node_processor
node_processor -->|"builds bindings"| node_binding_model
node_binding_model -->|"emits code"| node_generated
node_app -->|"calls bind"| node_entry
node_entry -.->|"uses generated binding"| node_generated
node_generated -->|"implements cleanup"| node_unbinder
node_entry -.->|"binds view source"| node_viewtree
node_developer -->|"operates on view groups"| node_bulk_views
node_bulk_views -->|"invokes actions"| node_view_actions
node_developer -.->|"may bind reflectively"| node_reflection
node_reflection -->|"creates listener cleanup"| node_listener_cleanup
node_plugin -->|"runs generator"| node_r2_generator
node_r2_generator -->|"reads symbols"| node_symbol_reader
node_r2_generator -->|"builds R2"| node_r2_builder
node_lint_registry -->|"registers detector"| node_lint

click node_annotations "https://github.com/jakewharton/butterknife/blob/master/butterknife-annotations/src/main/java/butterknife/BindView.java"
click node_listener_metadata "https://github.com/jakewharton/butterknife/blob/master/butterknife-annotations/src/main/java/butterknife/internal/ListenerClass.java"
click node_processor "https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java"
click node_binding_model "https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java"
click node_generated "https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java"
click node_entry "https://github.com/jakewharton/butterknife/blob/master/butterknife/src/main/java/butterknife/ButterKnife.java"
click node_unbinder "https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/Unbinder.java"
click node_bulk_views "https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/ViewCollections.java"
click node_view_actions "https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/Action.java"
click node_reflection "https://github.com/jakewharton/butterknife/blob/master/butterknife-reflect/src/main/java/butterknife/ButterKnife.java"
click node_listener_cleanup "https://github.com/jakewharton/butterknife/blob/master/butterknife-reflect/src/main/java/butterknife/ListenerUnbinder.java"
click node_plugin "https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt"
click node_r2_generator "https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt"
click node_symbol_reader "https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/ResourceSymbolListReader.kt"
click node_r2_builder "https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/FinalRClassBuilder.kt"
click node_lint "https://github.com/jakewharton/butterknife/blob/master/butterknife-lint/src/main/java/butterknife/lint/InvalidR2UsageDetector.java"
click node_lint_registry "https://github.com/jakewharton/butterknife/blob/master/butterknife-lint/src/main/java/butterknife/lint/LintRegistry.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_annotations,node_listener_metadata,node_viewtree toneBlue
class node_processor,node_binding_model,node_generated toneAmber
class node_entry,node_unbinder,node_bulk_views,node_view_actions,node_reflection,node_listener_cleanup toneMint
class node_plugin,node_r2_generator,node_symbol_reader,node_r2_builder,node_lint,node_lint_registry toneRose
class node_developer,node_app toneIndigo
```

## Components

### Binding annotations

- [Field and listener annotations](https://github.com/jakewharton/butterknife/blob/master/butterknife-annotations/src/main/java/butterknife/BindView.java): `butterknife-annotations/src/main/java/butterknife/BindView.java`
- [Listener metadata](https://github.com/jakewharton/butterknife/blob/master/butterknife-annotations/src/main/java/butterknife/internal/ListenerClass.java): `butterknife-annotations/src/main/java/butterknife/internal/ListenerClass.java`

### Code generation

- [Annotation processor](https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java): `butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java`
- [Binding code generation](https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java): `butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java`
- [Generated bindings](https://github.com/jakewharton/butterknife/blob/master/butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java): `butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java`

### Binding runtime

- [Bind entry point](https://github.com/jakewharton/butterknife/blob/master/butterknife/src/main/java/butterknife/ButterKnife.java): `butterknife/src/main/java/butterknife/ButterKnife.java`
- [Unbind contract](https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/Unbinder.java): `butterknife-runtime/src/main/java/butterknife/Unbinder.java`
- [Bulk view operations](https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/ViewCollections.java): `butterknife-runtime/src/main/java/butterknife/ViewCollections.java`
- [View actions and setters](https://github.com/jakewharton/butterknife/blob/master/butterknife-runtime/src/main/java/butterknife/Action.java): `butterknife-runtime/src/main/java/butterknife/Action.java`
- [Reflective binding](https://github.com/jakewharton/butterknife/blob/master/butterknife-reflect/src/main/java/butterknife/ButterKnife.java): `butterknife-reflect/src/main/java/butterknife/ButterKnife.java`
- [Listener cleanup](https://github.com/jakewharton/butterknife/blob/master/butterknife-reflect/src/main/java/butterknife/ListenerUnbinder.java): `butterknife-reflect/src/main/java/butterknife/ListenerUnbinder.java`

### Library integrations

- [Gradle library plugin](https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt): `butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt`
- [R2 generation](https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt): `butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt`
- [Resource symbol reader](https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/ResourceSymbolListReader.kt): `butterknife-gradle-plugin/src/main/java/butterknife/plugin/ResourceSymbolListReader.kt`
- [Final R2 builder](https://github.com/jakewharton/butterknife/blob/master/butterknife-gradle-plugin/src/main/java/butterknife/plugin/FinalRClassBuilder.kt): `butterknife-gradle-plugin/src/main/java/butterknife/plugin/FinalRClassBuilder.kt`
- [R2 usage lint](https://github.com/jakewharton/butterknife/blob/master/butterknife-lint/src/main/java/butterknife/lint/InvalidR2UsageDetector.java): `butterknife-lint/src/main/java/butterknife/lint/InvalidR2UsageDetector.java`
- [Lint registration](https://github.com/jakewharton/butterknife/blob/master/butterknife-lint/src/main/java/butterknife/lint/LintRegistry.java): `butterknife-lint/src/main/java/butterknife/lint/LintRegistry.java`

### Other components

- **Android developer**
- **Android app**
- **Android view hierarchy**

## Connections

- Android developer → Field and listener annotations: annotates fields
- Field and listener annotations → Annotation processor: processed by (evidence: `butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java`)
- Listener metadata → Annotation processor: describes callbacks (evidence: `butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java`)
- Annotation processor → Binding code generation: builds bindings (evidence: `butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java`)
- Binding code generation → Generated bindings: emits code (evidence: `butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java`)
- Android app → Bind entry point: calls bind
- Bind entry point → Generated bindings: uses generated binding
- Generated bindings → Unbind contract: implements cleanup (evidence: `butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java`)
- Bind entry point → Android view hierarchy: binds view source
- Android developer → Bulk view operations: operates on view groups
- Bulk view operations → View actions and setters: invokes actions (evidence: `butterknife-runtime/src/main/java/butterknife/ViewCollections.java`)
- Android developer → Reflective binding: may bind reflectively
- Reflective binding → Listener cleanup: creates listener cleanup (evidence: `butterknife-reflect/src/main/java/butterknife/ButterKnife.java`)
- Gradle library plugin → R2 generation: runs generator (evidence: `butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt`)
- R2 generation → Resource symbol reader: reads symbols (evidence: `butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt`)
- R2 generation → Final R2 builder: builds R2 (evidence: `butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt`)
- Lint registration → R2 usage lint: registers detector (evidence: `butterknife-lint/src/main/java/butterknife/lint/LintRegistry.java`)
