discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens
mzule/ActivityRouter · source
Snapshot 0 · 2026-11-04T12:47:24Z · Java · Apache-2.0
Content fingerprint
513a47a9af39acd8c43132dd53eb997d52d302c7c445327b24be1c87394a33ccGitHub description at capture
Router activities and methods with url for android
README at capture
# ActivityRouter
### [English README.md here](https://github.com/mzule/ActivityRouter/blob/master/README-en.md)
## 功能
支持给`Activity`定义 URL，这样可以通过 URL 跳转到`Activity`，支持在浏览器以及 app 中跳入。
## 集成
### 1. 添加引用
请根据项目的历史情况选择合适的集成方式
#### 1.1 annotaitonProcessor 方式
``` groovy
dependencies {
compile 'com.github.mzule.activityrouter:activityrouter:1.2.2'
annotationProcessor 'com.github.mzule.activityrouter:compiler:1.1.7'
}
```
#### 1.2 apt 方式
根目录 build.gradle
``` groovy
buildscript {
dependencies {
classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
}
}
```
项目 app/build.gradle
``` groovy
apply plugin: 'android-apt'
dependencies {
compile 'com.github.mzule.activityrouter:activityrouter:1.2.2'
apt 'com.github.mzule.activityrouter:compiler:1.1.7'
}
```
### 2. 集成
在`AndroidManifest.xml`配置
``` xml
<activity
android:name="com.github.mzule.activityrouter.router.RouterActivity"
android:theme="@android:style/Theme.NoDisplay">
<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="mzule" /><!--改成自己的scheme-->
</intent-filter>
</activity>
```
在需要配置的`Activity`上添加注解
``` java
@Router("main")
public class MainActivity extends Activity {
...
}
```
这样就可以通过`mzule://main`来打开`MainActivity`了。
## 进阶
### 支持配置多个地址
``` java
@Router({"main", "root"})
```
`mzule://main`和`mzule://root`都可以访问到同一个`Activity`
### 支持获取 url 中`?`传递的参数
``` java
@Router("main")
```
上面的配置，可以通过`mzule://main?color=0xff878798&name=you+are+best`来传递参数，在`MainActivity#onCreate`中通过`getIntent().getStringExtra("name")`的方式来获取参数，所有的参数默认为`String`类型，但是可以通过配置指定参数类型，后面会介绍。
### 支持在 path 中定义参数
``` java
@Router("main/:color")
```
通过`:color`的方式定义参数，参数名为`color`，访问`mzule://main/0xff878798`，可以在`MainActivity#onCreate`通过`getIntent().getStringExtra("color")`获取到 color 的值`0xff878798`
### 支持多级 path 参数
``` java
@Router("user/:userId/:topicId/:commentId")
@Router("user/:userId/topic/:topicId/comment/:commentId")
```
上面两种方式都是被支持的，分别定义了三个参数，`userId`,`topicId`,`commentId`
### 支持指定参数类型
``` java
@Router(value = "main/:color", intParams = "color")
```
这样指定了参数`color`的类型为`int`，在`MainActivity#onCreate`获取 color 可以通过`getIntent().getIntExtra("color", 0)`来获取。支持的参数类型有`int`,`long`,`short`,`byte`,`char`,`float`,`double`,`boolean`，默认不指定则为`String`类型。
### 支持优先适配
``` java
@Router("user/:userId")
public class UserActivity extends Activity {
...
}
@Router("user/statistics")
public class UserStatisticsActivity extends Activity {
...
}
```
假设有上面两个配置，
不支持优先适配的情况下，`mzule://user/statistics`可能会适配到`@Router("user/:userId")`，并且`userId=statistics`
支持优先适配，意味着，`mzule://user/statistics`会直接适配到`@Router("user/statistics")`，不会适配前一个`@Router("user/:userId")`
### 支持 Callback
``` java
public class App extends Application implements RouterCallbackProvider {
@Override
public RouterCallback provideRouterCallback() {
return new SimpleRouterCallback() {
@Override
public boolean beforeOpen(Context context, Uri uri) {
context.startActivity(new Intent(context, LaunchActivity.class));
// 是否拦截，true 拦截，false 不拦截
return false;
}
@Override
public void afterOpen(Context context, Uri uri) {
}
@Override
public void notFound(Context context, Uri uri) {
context.startActivity(new Intent(context, NotFoundActivity.class));
}
@Override
public void error(Context context, Uri uri, Throwable e) {
context.startActivity(ErrorStackActivity.makeIntent(context, uri, e));
}
};
}
}
```
在`Application`中实现`RouterCallbackProvider`接口，通过`provideRouterCallback()`方法提供`RouterCallback`，具体 API 如上。
### 支持 Http(s) 协议
``` java
@Router({"http://mzule.com/main", "main"})
```
AndroidManifest.xml
``` xml
<activity
android:name="com.github.mzule.activityrouter.router.RouterActivity"
android:theme="@android:style/Theme.NoDisplay">
...
<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="http" android:host="mzule.com" />
</intent-filter>
</activity>
```
这样，`http://mzule.com/main`和`mzule://main`都可以映射到同一个 Activity，值得注意的是，在`@Router`中声明`http`协议地址时，需要写全称。
### 支持参数 transfer
``` java
@Router(value = "item", longParams = "id", transfer = "id=>itemId")
```
这里通过`transfer = "id=>itemId"`的方式，设定了 url 中名称为`id`的参数会被改名成`itemId`放到参数`Bundle`中，类型为`long`. 值得注意的是，这里，通过`longParams = "id"`或者`longParams = "itemId"`都可以设置参数类型为`long`.
### 支持应用内调用
``` java
Routers.open(context, "mzule://main/0xff878798")
Routers.open(context, Uri.parse("mzule://main/0xff878798"))
Routers.openForResult(activity, "mzule://main/0xff878798", REQUEST_CODE);
Routers.openForResult(activity, Uri.parse("mzule://main/0xff878798"), REQUEST_CODE);
// 获取 Intent
Intent intent = Routers.resolve(context, "mzule://main/0xff878798")
```
通过`Routers.open(Context, String)`或者`Routers.open(Context, Uri)`可以直接在应用内打开对应的 Activity，不去要经过 RouterActivity 跳转，效率更高。
### 支持获取原始 url 信息
``` java
getIntent().getStringExtra(Routers.KEY_RAW_URL);
```
### 支持通过 url 调用方法
``` java
@Router("logout")
public static void logout(Context context, Bundle bundle) {
}
```
在任意参数为 Context 和 Bundle 的静态公共方法上, 通过 @Router 标记即可定义方法的 url. @Router 使用方式与上述一致。
### 支持多模块
* 每个包含 activity 的 module 都要添加 apt 依赖
* 每个 module(包含主项目) 都要添加一个 @Module(name) 的注解在任意类上面，name 是项目的名称
* 主项目要添加一个 @Modules({name0, name1, name2}) 的注解，指定所有的 module 名称集合
## 混淆配置
``` groovy
-keep class com.github.mzule.activityrouter.router.** { *; }
```
## 许可
Apache License 2.0
## 联系我
任何相关问题都可以通过以下方式联系我。
1. 提 issue
1. 新浪微博 http://weibo.com/mzule
1. 个人博客 https://mzule.github.io/
1. 邮件 "mzule".concat("4j").concat("@").concat("gmail.com")