How jakewharton/butterknife works
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.java Bind entry point · R2Generator.kt R2 generation · ButterKnifeProcessor.java Annotation processor · BindingSet.java Generated bindings
Components 20
Binding annotations
- Field and listener annotations
butterknife-annotations/src/main/java/butterknife/BindView.java - Listener metadata
butterknife-annotations/src/main/java/butterknife/internal/ListenerClass.java
Code generation
- Annotation processor
butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java - Binding code generation
butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java - Generated bindings
butterknife-compiler/src/main/java/butterknife/compiler/BindingSet.java
Binding runtime
- Bind entry point
butterknife/src/main/java/butterknife/ButterKnife.java - Unbind contract
butterknife-runtime/src/main/java/butterknife/Unbinder.java - Bulk view operations
butterknife-runtime/src/main/java/butterknife/ViewCollections.java - View actions and setters
butterknife-runtime/src/main/java/butterknife/Action.java - Reflective binding
butterknife-reflect/src/main/java/butterknife/ButterKnife.java - Listener cleanup
butterknife-reflect/src/main/java/butterknife/ListenerUnbinder.java
Library integrations
- Gradle library plugin
butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt - R2 generation
butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt - Resource symbol reader
butterknife-gradle-plugin/src/main/java/butterknife/plugin/ResourceSymbolListReader.kt - Final R2 builder
butterknife-gradle-plugin/src/main/java/butterknife/plugin/FinalRClassBuilder.kt - R2 usage lint
butterknife-lint/src/main/java/butterknife/lint/InvalidR2UsageDetector.java - Lint registration
butterknife-lint/src/main/java/butterknife/lint/LintRegistry.java
Other components
- Android developer
- Android app
- Android view hierarchy
Connections 17
- Android developer → Field and listener annotations: annotates fields
- Field and listener annotations → Annotation processor: processed by
butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java - Listener metadata → Annotation processor: describes callbacks
butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java - Annotation processor → Binding code generation: builds bindings
butterknife-compiler/src/main/java/butterknife/compiler/ButterKnifeProcessor.java - Binding code generation → Generated bindings: emits code
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
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
butterknife-runtime/src/main/java/butterknife/ViewCollections.java - Android developer → Reflective binding: may bind reflectively
- Reflective binding → Listener cleanup: creates listener cleanup
butterknife-reflect/src/main/java/butterknife/ButterKnife.java - Gradle library plugin → R2 generation: runs generator
butterknife-gradle-plugin/src/main/java/butterknife/plugin/ButterKnifePlugin.kt - R2 generation → Resource symbol reader: reads symbols
butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt - R2 generation → Final R2 builder: builds R2
butterknife-gradle-plugin/src/main/java/butterknife/plugin/R2Generator.kt - Lint registration → R2 usage lint: registers detector
butterknife-lint/src/main/java/butterknife/lint/LintRegistry.java