How alibaba/arouter works
ARouter is an Android component-routing framework: applications annotate destinations and injectable fields, then build-time processors generate route and injection metadata used by the runtime. The principal flow is a caller building a URL/path request, runtime lookup and optional interception, then launching a destination or returning a service/provider. The README also documents dependency injection, dynamic registration, route documentation, IDE navigation, and fallback strategies. Runtime internals are only partly sampled; dashed edges mark documented capabilities whose implementation links were not shown.
Main entry points: _ARouter.java Navigation runtime · Route.java Route annotations · RouteSymbolProcessor.java KSP route processor · ARouter.java ARouter API
Components 20
Route authoring
- Route annotations
arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java - Injection annotations
arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Autowired.java - Route metadata
arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/model/RouteMeta.java
Metadata generation
- KSP route processor
arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java - KSP processor coordinator
arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/ARouterSymbolProcessor.java - APT route processor
arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/RouteProcessor.java - APT injection processor
arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/AutowiredProcessor.java
Runtime routing
- ARouter API
arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java - Navigation request
arouter-api/src/main/java/com/alibaba/android/arouter/facade/Postcard.java - Navigation runtime
arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java - Route lookup
arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java - Route registry
arouter-api/src/main/java/com/alibaba/android/arouter/core/Warehouse.java - Interceptor chain
arouter-api/src/main/java/com/alibaba/android/arouter/core/InterceptorServiceImpl.java
Services and injection
- Automatic injection
arouter-api/src/main/java/com/alibaba/android/arouter/core/AutowiredServiceImpl.java - Provider services
arouter-api/src/main/java/com/alibaba/android/arouter/facade/template/IProvider.java - Degrade and pretreatment
arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/DegradeService.java - Serialization service
arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/SerializationService.java
Developer tools
- IDE route navigation
arouter-idea-plugin/src/main/kotlin/com/alibaba/android/arouter/idea/extensions/NavigationLineMarker.kt
Other components
- App caller
- Android destination
Connections 20
- App caller → ARouter API: initializes and calls
README.md - ARouter API → Navigation runtime: delegates
arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java - App caller → Route annotations: annotates destinations
README.md - Route annotations → KSP route processor: processed by
arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java - Injection annotations → KSP route processor: collected with routes
arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java - KSP processor coordinator → KSP route processor: coordinates
arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/ARouterSymbolProcessor.java - KSP route processor → Route metadata: generates metadata
- Route annotations → APT route processor: processed by
README.md - Injection annotations → APT injection processor: processed by
README.md - ARouter API → Navigation request: builds request
arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java - Navigation request → Navigation runtime: starts navigation
README.md - Navigation runtime → Route lookup: resolves route
arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java - Route lookup → Route registry: reads route data
arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java - Navigation runtime → Interceptor chain: runs interceptors
README.md - Navigation runtime → Android destination: launches destination
README.md - Navigation runtime → Automatic injection: injects parameters
README.md - Navigation runtime → Provider services: resolves services
README.md - Navigation runtime → Degrade and pretreatment: supports fallback
README.md - Navigation request → Serialization service: supports object parameters
README.md - IDE route navigation → Route annotations: locates destinations
README.md