扫描到手机查看
ActivityRouter 是一款轻量级 Android 结构化路由框架,专为解决大型 Android 项目的模块通信、页面跳转难题设计,秉持轻量、高效、解耦的核心理念。该框架体积小巧、接入成本低,无需引入冗余依赖,可快速集成到各类 Android 项目中,显著提升开发效率与代码可维护性。
1、在你的项目根目录的build.gradle文件中添加注解处理器依赖:
2、在需要路由的Activity上添加@Router注解:
3、在Application的onCreate方法中初始化路由:
多模块解耦:组件化 / 插件化架构下跨模块跳转,无依赖、无硬编码。
降级与容错:支持页面找不到、跳转失败统一处理,提升应用稳定性。
跳转结果回调:标准化处理 startActivityForResult,简化回调逻辑。
全链路可扩展:支持路由日志、拦截器排序、动态路由配置,便于二次开发。
页面路由映射:通过注解绑定页面路径,支持 Activity、Fragment 统一路由管理。
URL Scheme 跳转:支持外部链接、H5 跳转原生页面,自动解析参数与协议。
自动参数注入:自动解析并赋值跳转参数,省去手动 getIntent () 编码。
拦截器机制:支持登录校验、权限判断、跳转预处理等自定义拦截逻辑。
为满足复杂业务场景的扩展需求,框架提供可插拔式拦截器扩展机制,支持在路由跳转的前置、后置阶段自定义拦截逻辑,可灵活实现登录校验、权限控制、埋点统计、参数预处理、页面白名单校验等个性化需求,让路由跳转的管控更灵活、更贴合业务场景。
针对多模块开发场景,框架深度适配模块化解耦需求,通过路由中心统一管理各模块的页面入口,打破模块间的直接依赖,实现模块的独立编译、独立调试与独立发布。即使项目架构复杂、模块数量多,也能保证模块间通信的清晰性与稳定性,避免因模块耦合导致的代码混乱、维护困难等问题。
此外,框架还内置完善的降级策略与跳转结果回调机制:当目标页面不存在、跳转失败或权限不足时,可触发自定义降级逻辑(如跳转兜底页面、提示用户、返回上一级等),保障应用运行稳定性;跳转结果回调则支持在跳转完成后接收成功 / 失败状态及返回数据,轻松实现跨页面的数据交互与状态同步。
整体而言,该框架通过标准化路由规则、自动化参数处理、灵活的扩展能力与完善的容错机制,彻底摒弃繁琐的硬编码 Intent 方式,大幅降低 Android 项目中模块间的耦合度,简化页面跳转与通信逻辑,显著提升项目的开发效率、可维护性与稳定性,是大中型 Android 项目模块化开发的高效解决方案。
软件评论
网友评论