通过注解方式来实现URL打开Activity功能，并支持在WebView和外部浏览器使用，支持多级Activity跳转，支持Bundle、Uri参数注入并转换参数类型。
特点
- 支持注解方式、手动方式注册Activity。
- 支持注入Bundle、Uri的参数并转换格式。
- 支持多级跳转。
- 支持外部浏览器打开。
- 支持HTTP协议。
- 支持目标Activity的URL构造器访问。
项目地址
[图片上传失败...(image-9abb02-1525053844418)]
https://github.com/joyrun/ActivityRouter
简单例子
@RouterActivity("second")
public class SecondActivity extends Activity {
@RouterField("uid")
private int uid;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);
Routers.inject(this);
Log.e("uid", String.valueOf(uid));
}
}
Routers.init("joyrun");//设置Scheme
// 方式一
RoutersHelper.getSecondActivityHelper().withUid(24).start(this);
// 方式二
Routers.startActivity(context, "joyrun://second?uid=233");
// 方式三
// 如果AndroidManifest.xml注册了RouterCenterActivity，也可以通过下面的方式打开，如果是APP内部使用，不建议使用。
// startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse("joyrun://second?uid=233")));
目标Activity的URL构造器访问
使用URL访问有一个缺点就是难以得以目标Activity所需要的参数，同时也需要手工生成URL，使用并不友好，填写的参数名称也容易出错。所以我们就做了一个用于生成目标Activity的URL构造器，减少我们写参数名的代码。会根据注解了RouterField的成员变量生成构造器。
// Routers.startActivity(context, "joyrun://second?uid=233&name=Wiki");
RoutersHelper.getSecondActivityHelper().withUid(233).withName("Wiki").start(this);
// Routers.startActivityForResult(context, "joyrun://second?uid=233&name=Wiki",1);
RoutersHelper.getSecondActivityHelper().withUid(233).withName("Wiki").startForResult(this,1);
多级跳转
@RouterActivity("third")
public class ThirdActivity extends BaseActivity {
@RouterField("uid")
private int uid;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_third);
Routers.inject(this);
Log.e("uid", String.valueOf(uid));
}
}
// 先打开SecondActivity，再打开ThirdActivity
Routers.startActivity(context, "joyrun://second/third?uid=233");
Bundle、Uri参数注入（支持单独使用）
Routers.inject(this)方法可以单独使用，可以实现注入Bundle、Uri的参数，由于Uri的参数是String类型，所以该框架还支持把String格式的类型转换为目标类型。目前该方法支持double、float、int、boolean、String数据类型。
// Bundle
Intent intent = new Intent(this, SecondActivity.class);
intent.putExtra("uid", "233");
startActivity(intent);
// Uri
Intent intent = new Intent(this, SecondActivity.class);
intent.setData(Uri.parse("joyrun://second?uid=233"));
startActivity(intent);
// Bundle、Uri
Intent intent = new Intent(this, SecondActivity.class);
intent.setData(Uri.parse("joyrun://second?uid=233"));
intent.putExtra("name", "Wiki");
startActivity(intent);
@RouterActivity("second")
public class SecondActivity extends Activity {
@RouterField("uid")
private int uid;
@RouterField("name")
private String name;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);
Routers.inject(this);
Log.e("uid", String.valueOf(uid));
Log.e("name", String.valueOf(name));
}
}
从外部浏览器、其它APP打开
只要在AndroidManifest.xml注册了RouterCenterActivity，即可变成经典的Uri打开，可以支持外部浏览器、其它APP打开内部的Activity。
<activity android:name="com.thejoyrun.router.RouterCenterActivity">
<intent-filter>
<category android:name="android.intent.category.BROWSABLE" />
<category android:name="android.intent.category.DEFAULT" />
<action android:name="android.intent.action.VIEW" />
<data android:scheme="joyrun" />
</intent-filter>
</activity>
// Java代码调用
startActivity(new Intent(Intent.ACTION_VIEW, Uri.parse("joyrun://second?uid=233&name=Wiki")));
// HTML方式，系统浏览器（不支持微信）
<a href="joyrun://second?uid=233&name=Wiki">打开JoyrunApp的SecondActivity</a>
支持HTTP协议
<activity android:name="com.thejoyrun.router.RouterCenterActivity">
<intent-filter>
<category android:name="android.intent.category.DEFAULT" />
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:host="www.thejoyrun.com" android:scheme="http" />
<data android:scheme="joyrun" />
</intent-filter>
</activity>
如果支持HTTP协议，那么URL的结构就要做些修改
// joyrun://second?uid=233
// =>
http://www.thejoyrun.com/second?uid=233
使用方式
配置根目录的build.gradle
allprojects {
repositories {
...
maven { url "https://jitpack.io" }
}
dependencies {
classpath 'com.android.tools.build:gradle:1.5.0'
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
配置app module的build.gradle
apply plugin: 'com.android.application'
apply plugin: 'com.neenbedankt.android-apt'
dependencies {
compile 'com.github.joyrun.ActivityRouter:router:0.3.1'
apt 'com.github.joyrun.ActivityRouter:router-compiler:0.3.1'
}
初始化
建议在Application进行初始化
// 必填，填写独特的scheme，避免和其它APP重复
Routers.init("joyrun");
// 可选，如果需要支持HTTP协议就需要填写
Routers.setHttpHost("www.thejoyrun.com");
// 可选，手工注册Activity
Routers.register(new ActivityRouteTableInitializer() {
@Override
public void initRouterTable(Map<String, Class<? extends Activity>> router) {
router.put("second2", SecondActivity.class);
router.put("other://www.thejoyrun.com/second", SecondActivity.class);
}
});
// 可选，针对自己的业务做调整
Routers.setFilter(new Filter() {
public String doFilter(String url) {
//return url.replace("joyrun://www.thejoyrun.com/","joyrun://");
return url;
}
});
配置AndroidManifest
如果需要从外部浏览器打开，就要注册
<activity android:name="com.thejoyrun.router.RouterCenterActivity">
<intent-filter>
<category android:name="android.intent.category.BROWSABLE" />
<category android:name="android.intent.category.DEFAULT" />
<action android:name="android.intent.action.VIEW" />
<data android:host="www.thejoyrun.com" android:scheme="http" />
<data android:scheme="joyrun" />
</intent-filter>
</activity>
其它说明
多对一映射
一个Activity支持配置多个路径，也支持完整的URL配置
@RouterActivity({"second", "second2", "other2://www.thejoyrun.com/second", "joyrun://www.thejoyrun.com/second"})
public class SecondActivity extends Activity {}
手工注册Activity
手工注册，也支持路径注册，也支持完整路径注册，支持多种scheme
Routers.register(new ActivityRouteTableInitializer() {
@Override
public void initRouterTable(Map<String, Class<? extends Activity>> router) {
router.put("second2", SecondActivity.class);
router.put("other://www.thejoyrun.com/second", SecondActivity.class);
}
});
URL过滤器
通过URL过滤器可以对URL进行过滤，可以通过过滤器对URL进行修改，也可以拦截URL，不让路由器打开。
Routers.setFilter(new Filter() {
public String doFilter(String url) {
//return url.replace("joyrun://www.thejoyrun.com/","joyrun://");
return url;
}
});
