GRouter是基于Kotlin Annotation Processing Tools和ASM技术开发的一款适用于Android平台的模块化路由组件，具备以下特点：
- 支持代码自动注入，用户无需编写额外的初始化代码；
- 支持路由按分组进行按需加载；
- 支持配置局部路由拦截器
Interceptor和全局的路由拦截器GlobalInterceptor，且支持自定义优先级； - 支持配置路由匹配器
Matcher，且支持自定义优先级； - 支持响应式的
startActivityForResult操作； - 支持自定义匹配
Activity失败时的回调； - 支持
URL Scheme路由（DeepLink）； - 支持
MultiDex；
buildscript {
// ... Your codes
repositories {
// ... Your codes
maven { url 'https://jitpack.io' }
}
dependencies {
// ... Your codes
classpath "com.github.ITGungnir.GRouter:router_plugin:$router_version"
}
}dependencies {
// ... Your codes
api "com.github.ITGungnir.GRouter:router_api:$router_version"
// 如果要使用goForResult()功能，请导入RxJava 2.x的依赖
api "io.reactivex.rxjava2:rxjava:$rxjava_version"
}apply plugin: 'kotlin-kapt'
dependencies {
// ... Your codes
kapt "com.github.ITGungnir.GRouter:router_compiler:$router_version"
}apply plugin: 'grouter'在项目的顶层模块（如app模块）中创建一个Application类，重写onCreate()方法，并在AndroidManifest.xml文件中配置该类。
注意： 本步骤必须要做，否则无法注入代码！
GRouter在v1.2.0版本后增加了分组的概念，可以按需初始化，其具体特点如下：
- 在配置页面的路由时，
@Route注解中的path字符串必须以/开头，否则GRouter在扫描路由时不会对它做处理； @Route注解中的path字符串以/分级，如/main被视为一级；/app/app1被视为二级；以此类推；- 二级及以上的路由中被
/隔开的第一部分视为路由的分组，如/app/app1的分组就是app；/account/login/code的分组是account； - 一级路由是默认路由，在
GRouter初始化时会加载这些路由，而不会加载非一级路由； - 当用户要跳转到某个非一级路由时，
GRouter会先判断当前路由表中是否有该路由，如果没有则说明该分组的路由还没有被初始化，此时才会初始化这个分组下的所有路由并添加到路由表中。
在一个Activity类上添加@Route注解，表示当前Activity所代表的路由字符串。示例代码：
@Route("/main")
class MainActivity : AppCompatActivity()
@Route("/app/app1")
class AppActivity1 : AppCompatActivity()将如下代码写到MainActivity中某个按钮的点击事件中，点击按钮时即可从MainActivity跳转到AppActivity1中。
Router.instance.with(this)
.target("/app/app1")
.go()Router.instance.with(this)
.target("/app/app1")
.addParam("key1", "value1")
.addParam("key2", 222)
.go()注意： 如果要使用本功能，请确保项目中引入了RxJava 2.x的依赖，否则会报错！
Router.instance.with(this)
.target(AppAppActivity2)
.goForResult(1)?.subscribe {
if (it.code == ProxyResult.ResultCode.RESULT_OK) {
it.extras.getString("backKey")?.let { str -> toast(str) }
}
}go()、goForResult()方法中都可以多传入一个notMatchedCallback: (() -> Unit)?参数，如果GRouter没有找到匹配目标路由的Mathcer，就会调用这个方法，
用户可以在这个方法中做特殊处理，或者对页面请求进行降级。
Router.instance.with(this)
.target("/ghost_grout/ghost_page")
.go { toast("/ghost_grout/ghost_page页面不存在") }val intent = Router.instance.with(this)
.target("/main")
.addFlag(Intent.FLAG_ACTIVITY_CLEAR_TOP)
.addFlag(Intent.FLAG_ACTIVITY_SINGLE_TOP)
.getIntent()拦截器的使用场景：如果某些页面要求用户只有在登录之后才可以访问，则可以设置一个登录拦截器，可以简化场景判断。一个登录拦截器的代码示例如下：
class LoginInterceptor(errorCallback: () -> Unit) : BaseInterceptor(errorCallback) {
override fun intercept(chain: Interceptor.Chain): RouterResponse? {
val isUserLogin = // 判断用户是否已登录的业务逻辑
return if (isUserLogin) {
chain.proceed(chain.request())
} else {
RouterResponse.failed(errorCallback)
}
}
}在路由跳转时添加拦截器，示例代码：
Router.instance.with(this)
.target(SubAccountActivity4)
.addInterceptor(LoginInterceptor { toast("用户尚未登录，不能跳转到account4") })
.go()单体拦截器仅针对当前路由，随用随配置。先调用addInterceptor()的拦截器会先被执行。
如果想设置全局路由器，参考下面的@GlobalInterceptor注解用法。
GRouter中提供了对DeepLink路由跳转的支持，可以通过URL Scheme的方式跳转到当前应用之外的其他应用，例如用系统浏览器打开网页：
Router.instance.with(this)
.target("https://www.baidu.com/")
.go()也可以通过其他应用中自定义的Scheme协议进行跳转，如跳转到我自己创建的TestDeepLink应用：
Router.instance.with(this)
.target("deeplink://test.deeplink.com?param=hello,deepLink")
.go { toast("当前设备上没有安装TestDeepLink应用！") }用于指定某个类为路由匹配器，用于匹配不同类型的Uri，从而进行不同的跳转，该类必须继承自BaseMatcher抽象类。示例代码：
@Matcher
class TelMatcher : BaseMatcher(priority = 3) {
override fun matched(request: RouterRequest): Boolean =
request.target.toString().startsWith("tel:")
override fun proceed(request: RouterRequest): Intent =
Intent(Intent.ACTION_DIAL, request.target).apply {
flags = Intent.FLAG_ACTIVITY_NEW_TASK
}
}上述代码编写了一个用于跳转拨号界面的匹配器，指定优先级为3 （1~9，1最高） ，使用时的代码如下：
Router.instance.with(this)
.target("tel:88888888")
.go()GRouter中默认提供了一些默认的BaseMatcher，介绍如下：
RouteMapMather(priority = 4)：匹配路由表中的路由；DeepLinkMatcher(priority = 6)：匹配DeepLink路由，跳转到其他APP；
@GlobalInterceptor用于设置全局路由器，配置之后所有路由操作都会添加该拦截器拦截。配置的拦截器必须实现Interceptor接口，示例代码：
@GlobalInterceptor
class LogGlobalInterceptor : BaseGlobalInterceptor(priority = 1) {
override fun intercept(chain: Interceptor.Chain): RouterResponse? {
val request = chain.request()
println("------>>Router: ${request.safeContext()!!::class.java.name} -> ${request.target.toString()}")
return chain.proceed(request)
}
}从GRouter v1.2.0版本开始，全局路由拦截器需要配置priority属性标识其优先级，优先级为Int类型，值在[1, 9]之间，1最高。
配置该日志拦截器后，当发生路由跳转时会打印如下日志：
------>>Router: test.itgungnir.grouter.MainActivity -> app1
------>>Router: test.itgungnir.grouter.MainActivity -> https://www.baidu.com/
------>>Router: test.itgungnir.grouter.MainActivity -> tel:88888888
注意： 拦截器的拦截顺序为：局部拦截器列表 -> VerifyInterceptor -> 自定义的全局拦截器 -> IntentInterceptor。
GRouter中提供了一些默认的全局拦截器，介绍如下：
VerifyInterceptor：判断发起路由的是否是Context或Fragment；IntentInterceptor：调用Matcher列表匹配路由，判断是否能匹配到路由；
./gradlew clean build --no-daemon -Dorg.gradle.debug=true -Dkotlin.compiler.execution.strategy="in-process" -Dkotlin.daemon.jvm.options="-Xdebug,-Xrunjdwp:transport=dt_socket\,address=5005\,server=y\,suspend=n"
注意： Mac系统中需要使用./gradlew命令，如果提示command not found，需要先运行chmod +x gradlew。
apply plugin: 'java-library'
apply plugin: 'kotlin'
apply plugin: 'maven'
repositories {
jcenter()
}
dependencies {
implementation gradleApi()
implementation "com.android.tools.build:gradle:$gradle_version"
implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
}
uploadArchives {
repositories {
mavenDeployer {
repository(url: uri('../grouter'))
}
}
}
sourceCompatibility = jdk_version
targetCompatibility = jdk_version
group 'my.itgungnir.grouter.plugin'
version '1.0.0'buildscript {
// ... Your codes
dependencies {
// ... Your codes
classpath 'my.itgungnir.grouter.plugin:router_plugin:1.0.0'
}
}第一步：router_plugin -> Tasks -> build -> build
第二步：router_plugin -> Tasks -> upload -> uploadArchives
第三步：app -> Tasks -> build -> build，此时在Run面板中即可看到日志
可以先在Android Studio或IntelliJ IDEA中写好目标代码，然后通过Kotlin工具中的Show Kotlin Bytecode生成字节码，再对应调用响应的方法即可。
例如，我想要在Application子类的onCreate()方法中注入以下代码：
Router.instance.registerAdditionalRouteMap("TargetRouteMapFileName")此时我会先将这行代码写到Application的onCreate()方法的最后，然后在菜单栏上点击Tools -> Kotlin -> Show Kotlin Bytecode，就可以在Kotlin Bytecode面板中查看到字节码：
LINENUMBER 17 L4
GETSTATIC my/itgungnir/grouter/api/Router.Companion : Lmy/itgungnir/grouter/api/Router$Companion;
INVOKEVIRTUAL my/itgungnir/grouter/api/Router$Companion.getInstance ()Lmy/itgungnir/grouter/api/Router;
LDC "TargetRouteMapFileName"
INVOKEVIRTUAL my/itgungnir/grouter/api/Router.registerAdditionalRouteMap (Ljava/lang/String;)V
L5
LINENUMBER和L5两行可以忽略，只看它们中间的这几行，我们可以通过每行行首的操作符，去Google它们的用法。
- 移除
clearGo功能
- 增加路由分组的概念，不同分组的路由按需加载
- 全局路由拦截器支持设置优先级
- 支持为路由增加匹配失败的回调
- 支持
URL Scheme路由（DeepLink）
- 通过ASM技术将代码注入到Application的onCreate()方法中，避免用户自己配置
Copyright 2019 ITGungnir
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.