PageRouter 一款轻量级Android路由框架(支持Activity与Fragment跳转)
概述
??原项目是由后端分发url,用户端各Activity在Manifest中配置IntentFilter,通过匹配URL实现跳转和传参(隐式跳转);同时这些页面也支持Intent跳转,通过Bundle传参(显示跳转)。
??Fragment的统一跳转则需要将相关逻辑放入容器Activity中,导致公共的fragment容器注册一大堆IntentFilter,还要为每个Fragment去单独解析参数。
??随着项目迭代,支持跳转的页面越来越多,传参也越来越复杂,Manifest日渐臃肿,Activity中也需要通过判断intent来分别去解析url和bundle获取参数,给项目的迭代与维护添加很多成本。
??基于以上种种问题,我考察了主流的几个开源路由框架,发现都没法完全满足我的需求,有的不支持配置多路径(历史起因部分页面必需支持多路径);有的不支持参数自动解析(便利性大打折扣);普遍功能多,跳转逻辑复杂;基本都不支持Fragment的直接跳转,kolin支持度也参差不齐。
??经过参考了多款路由框架,我实现了一个轻量级Android路由框架:PageRouter,完美处理以上痛点问题,以下是PageRouter的相关特点及使用文档。
Github
liujingg/PageRouter
效果
pagerouter-demo.gif
特点
- 支持Activity的标准URL解析与跳转
- 支持Fragment直接跳转到指定的关联Activity
- 支持多路径
- 支持多板块工程
- 支持手动增加路由
- 支持kotlin
- 支持参数自动注入,kotlin下支持属性委托获取参数
- 支持增加阻拦器
- 支持全局降级与局部降级策略
增加依赖
android { defaultConfig { ... //multi module configuration javaCompileOptions { annotationProcessorOptions { arguments = [targetModuleName: 'Other']// replace with the other module project name } } } } dependencies { // Replace the last version implementation "com.liujing.pagerouter:router:last-version" annotationProcessor "com.liujing.pagerouter:router-compiler:last-version" ... }kotlin 项目请使用kapt替换annotationProcessor
apply plugin: 'kotlin-kapt // Replace the last version implementation "com.liujing.pagerouter:router:last-version" kapt "com.liujing.pagerouter:router-compiler:last-version"功能与使用
1. 初始化
强烈建议在Application中初始化。
Router.init("pagerouter"); //your application's specific scheme注册其余板块路由(如有)。
Router.register(new OtherRouterInitializer());手动增加路由条目(可选)。
Router.register(new RouterInitializer() { @Override public void initActivityTable(Map<String, Class<? extends Activity>> router) { router.put("second2", SecondActivity.class); } @Override public void initFragmentTable(Map<String, Pair<Class<? extends Activity>, Class<? extends Fragment>>> router) { } });2. 增加注解
Activity注解
@RouterActivity({"second", "third"}) public class SecondActivity extends AppCompatActivity { ... }Fragment注解
// The activityClazz here means the fragment currently associated with Activity @RouterFragment(value = "myfragment", activityClazz = FragmentContainerActivity.class) public class MyFragment extends Fragment { ... }3. 参数解析
@RouterActivity({"second"}) public class SecondActivity extends AppCompatActivity { @RouterField("id") // map parameters in the url by name private int id; ... @Override protected void onCreate(@Nullable Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_common); Router.inject(this);// PageRouter will automatically set value of fields ... } }4. 发起跳转
Router.startActivity(context,"scheme://second?id=17")5. 混淆
-keep class * extends com.liujing.pagerouter.RouterInitializer { *; }6. 跳转结果回调
Router.startActivity( this, "pagerouter://other?id=17", object : RouteCallback { override fun onSuccess(context: Context, uri: Uri) { Toast.makeText(context, "success", Toast.LENGTH_SHORT).show() } override fun onFailed(context: Context?, message: String?) { Toast.makeText(context, "failed : $message", Toast.LENGTH_SHORT).show() } })7. 外部URL跳转
AndroidManifest.xml中
<activity android:name=".RouterCenterActivity"> <intent-filter> <action android:name="android.intent.action.VIEW"/> <category android:name="android.intent.category.DEFAULT"/> <category android:name="android.intent.category.BROWSABLE"/> <data android:scheme="myscheme"/> </intent-filter> </activity>创立一个新的Activity用于监听scheme事件
public class RouterCenterActivity extends Activity { @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); Uri data = getIntent().getData(); if (data != null) { Router.startActivity(this, data.toString()); } this.finish(); } }8. 增加阻拦器
Router.setIntercept(new IIntercept() { @Override public void process(@NonNull Context context, @NonNull Uri uri, InterceptorCallback callback) { if (...) { //TODO do something callback.onInterrupt(result, message);//interrupt routing process } else { callback.onContinue(uri); } } });9. 全局策略
Router.setDefaultCallBack(new RouteCallback() { @Override public void onSuccess(Context context, Uri uri) { } @Override public void onFailed(Context context, String message) { //TODO do something } });1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » PageRouter 一款轻量级Android路由框架(支持Activity与Fragment跳转)