# alibaba/arouter architecture

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

- Interactive diagram: https://gitdiagram.com/alibaba/arouter
- Repository: https://github.com/alibaba/arouter

## Overview

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-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java`](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java) (Navigation runtime), [`arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java`](https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java) (Route annotations), [`arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java`](https://github.com/alibaba/arouter/blob/develop/arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java) (KSP route processor), [`arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java`](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java) (ARouter API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Route authoring"]
  node_route_annotation["Route annotations<br/>[Route.java]"]
  node_autowired_annotation["Injection annotations<br/>[Autowired.java]"]
  node_route_metadata["Route metadata<br/>[RouteMeta.java]"]
end

subgraph group_generation["Metadata generation"]
  node_ksp_routes["KSP route processor"]
  node_ksp_coordinator["KSP processor coordinator"]
  node_apt_routes["APT route processor"]
  node_apt_injection["APT injection processor"]
end

subgraph group_routing["Runtime routing"]
  node_api["ARouter API<br/>[ARouter.java]"]
  node_postcard["Navigation request<br/>[Postcard.java]"]
  node_router_runtime["Navigation runtime<br/>[_ARouter.java]"]
  node_route_lookup["Route lookup"]
  node_route_registry[("Route registry<br/>[Warehouse.java]")]
  node_interceptors["Interceptor chain"]
end

subgraph group_services["Services and injection"]
  node_autowire_runtime["Automatic injection"]
  node_provider_services["Provider services<br/>[IProvider.java]"]
  node_degrade["Degrade and pretreatment"]
  node_serialization["Serialization service"]
end

subgraph group_tools["Developer tools"]
  node_ide_plugin["IDE route navigation"]
end

node_caller(("App caller"))
node_destination(("Android destination"))

node_caller -->|"initializes and calls"| node_api
node_api -->|"delegates"| node_router_runtime
node_caller -->|"annotates destinations"| node_route_annotation
node_route_annotation -->|"processed by"| node_ksp_routes
node_autowired_annotation -->|"collected with routes"| node_ksp_routes
node_ksp_coordinator -->|"coordinates"| node_ksp_routes
node_ksp_routes -.->|"generates metadata"| node_route_metadata
node_route_annotation -.->|"processed by"| node_apt_routes
node_autowired_annotation -.->|"processed by"| node_apt_injection
node_api -->|"builds request"| node_postcard
node_postcard -.->|"starts navigation"| node_router_runtime
node_router_runtime -->|"resolves route"| node_route_lookup
node_route_lookup -.->|"reads route data"| node_route_registry
node_router_runtime -.->|"runs interceptors"| node_interceptors
node_router_runtime -.->|"launches destination"| node_destination
node_router_runtime -.->|"injects parameters"| node_autowire_runtime
node_router_runtime -.->|"resolves services"| node_provider_services
node_router_runtime -.->|"supports fallback"| node_degrade
node_postcard -.->|"supports object parameters"| node_serialization
node_ide_plugin -.->|"locates destinations"| node_route_annotation

click node_route_annotation "https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java"
click node_autowired_annotation "https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Autowired.java"
click node_route_metadata "https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/model/RouteMeta.java"
click node_ksp_routes "https://github.com/alibaba/arouter/blob/develop/arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java"
click node_ksp_coordinator "https://github.com/alibaba/arouter/blob/develop/arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/ARouterSymbolProcessor.java"
click node_apt_routes "https://github.com/alibaba/arouter/blob/develop/arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/RouteProcessor.java"
click node_apt_injection "https://github.com/alibaba/arouter/blob/develop/arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/AutowiredProcessor.java"
click node_api "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java"
click node_postcard "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/Postcard.java"
click node_router_runtime "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java"
click node_route_lookup "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java"
click node_route_registry "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/Warehouse.java"
click node_interceptors "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/InterceptorServiceImpl.java"
click node_autowire_runtime "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/AutowiredServiceImpl.java"
click node_provider_services "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/template/IProvider.java"
click node_degrade "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/DegradeService.java"
click node_serialization "https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/SerializationService.java"
click node_ide_plugin "https://github.com/alibaba/arouter/blob/develop/arouter-idea-plugin/src/main/kotlin/com/alibaba/android/arouter/idea/extensions/NavigationLineMarker.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_route_annotation,node_autowired_annotation,node_route_metadata toneBlue
class node_ksp_routes,node_ksp_coordinator,node_apt_routes,node_apt_injection toneAmber
class node_api,node_postcard,node_router_runtime,node_route_lookup,node_route_registry,node_interceptors toneMint
class node_autowire_runtime,node_provider_services,node_degrade,node_serialization toneRose
class node_ide_plugin,node_caller,node_destination toneIndigo
```

## Components

### Route authoring

- [Route annotations](https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java): `arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Route.java`
- [Injection annotations](https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Autowired.java): `arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/annotation/Autowired.java`
- [Route metadata](https://github.com/alibaba/arouter/blob/develop/arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/model/RouteMeta.java): `arouter-annotation/src/main/java/com/alibaba/android/arouter/facade/model/RouteMeta.java`

### Metadata generation

- [KSP route processor](https://github.com/alibaba/arouter/blob/develop/arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java): `arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java`
- [KSP processor coordinator](https://github.com/alibaba/arouter/blob/develop/arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/ARouterSymbolProcessor.java): `arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/ARouterSymbolProcessor.java`
- [APT route processor](https://github.com/alibaba/arouter/blob/develop/arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/RouteProcessor.java): `arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/RouteProcessor.java`
- [APT injection processor](https://github.com/alibaba/arouter/blob/develop/arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/AutowiredProcessor.java): `arouter-compiler/src/main/java/com/alibaba/android/arouter/compiler/processor/AutowiredProcessor.java`

### Runtime routing

- [ARouter API](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java): `arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java`
- [Navigation request](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/Postcard.java): `arouter-api/src/main/java/com/alibaba/android/arouter/facade/Postcard.java`
- [Navigation runtime](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java): `arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java`
- [Route lookup](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java): `arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java`
- [Route registry](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/Warehouse.java): `arouter-api/src/main/java/com/alibaba/android/arouter/core/Warehouse.java`
- [Interceptor chain](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/InterceptorServiceImpl.java): `arouter-api/src/main/java/com/alibaba/android/arouter/core/InterceptorServiceImpl.java`

### Services and injection

- [Automatic injection](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/core/AutowiredServiceImpl.java): `arouter-api/src/main/java/com/alibaba/android/arouter/core/AutowiredServiceImpl.java`
- [Provider services](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/template/IProvider.java): `arouter-api/src/main/java/com/alibaba/android/arouter/facade/template/IProvider.java`
- [Degrade and pretreatment](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/DegradeService.java): `arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/DegradeService.java`
- [Serialization service](https://github.com/alibaba/arouter/blob/develop/arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/SerializationService.java): `arouter-api/src/main/java/com/alibaba/android/arouter/facade/service/SerializationService.java`

### Developer tools

- [IDE route navigation](https://github.com/alibaba/arouter/blob/develop/arouter-idea-plugin/src/main/kotlin/com/alibaba/android/arouter/idea/extensions/NavigationLineMarker.kt): `arouter-idea-plugin/src/main/kotlin/com/alibaba/android/arouter/idea/extensions/NavigationLineMarker.kt`

### Other components

- **App caller**
- **Android destination**

## Connections

- App caller → ARouter API: initializes and calls (evidence: `README.md`)
- ARouter API → Navigation runtime: delegates (evidence: `arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java`)
- App caller → Route annotations: annotates destinations (evidence: `README.md`)
- Route annotations → KSP route processor: processed by (evidence: `arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java`)
- Injection annotations → KSP route processor: collected with routes (evidence: `arouter-compiler-ksp/src/main/java/com/alibaba/android/arouter/compiler/ksp/RouteSymbolProcessor.java`)
- KSP processor coordinator → KSP route processor: coordinates (evidence: `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 (evidence: `README.md`)
- Injection annotations → APT injection processor: processed by (evidence: `README.md`)
- ARouter API → Navigation request: builds request (evidence: `arouter-api/src/main/java/com/alibaba/android/arouter/launcher/ARouter.java`)
- Navigation request → Navigation runtime: starts navigation (evidence: `README.md`)
- Navigation runtime → Route lookup: resolves route (evidence: `arouter-api/src/main/java/com/alibaba/android/arouter/launcher/_ARouter.java`)
- Route lookup → Route registry: reads route data (evidence: `arouter-api/src/main/java/com/alibaba/android/arouter/core/LogisticsCenter.java`)
- Navigation runtime → Interceptor chain: runs interceptors (evidence: `README.md`)
- Navigation runtime → Android destination: launches destination (evidence: `README.md`)
- Navigation runtime → Automatic injection: injects parameters (evidence: `README.md`)
- Navigation runtime → Provider services: resolves services (evidence: `README.md`)
- Navigation runtime → Degrade and pretreatment: supports fallback (evidence: `README.md`)
- Navigation request → Serialization service: supports object parameters (evidence: `README.md`)
- IDE route navigation → Route annotations: locates destinations (evidence: `README.md`)
