- Pigeon实现了activity间通过URL跳转和参数依赖注入，同时劫持了onActivityResult，改成接口回调
- Pigeon提供了基于特定uri规则的dispatch机制，用于支持互不依赖的module之间接口调用以及统一js调用Android入口
- Pigeon利用注解实现了IOC依赖注入，方便了IOC管理
- Pigeon没有使用APT，也没有使用反射，支持增量编译
- Pigeon支持Deep Link，从浏览器跳转应用任意页面
buildscript {
dependencies {
classpath 'xyz.bboylin:pigeon:0.1.3'
}
}// 注意，此项应该加在Android配置项后面，不然可能报错。
apply plugin: 'xyz.bboylin.pigeon'
pigeonConfig {
// 是否允许增量编译，默认允许，可提升编译速度，如需关闭，改成false
// 开启了增量编译的情况下，如果pigeon插件自身遇到异常的话会暂时为下一次编译启用全量，以保证可用性。
enableIncremental true
}// 把 a b c替换成最新的release版本号
compile 'xyz.bboylin:pigeon-core:a.b.c'非组件化项目则是直接在app module的build.gradle添加
@RouteNode("pigeon://sample/SampleLibActivity")
public class SampleLibActivity extends BaseActivity {
.......
}Postcard postcard = PostcardBuilder.newInstance(context, "pigeon://sample/SampleLibActivity")
// 参数存储在bundle中，支持基本类型和parcelable类型
.addExtra("demo", "this is demo string from pigeon postcard")
.build();
Pigeon.setOff(postcard); // 在要跳转的activity中使用Bind注解标记注入的字段
@Bind("demo")
String demoStr;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
// 手动调用参数注入，在BaseActivity中调用可一劳永逸
Pigeon.inject(this);
}
......setOff(@NonNull Postcard postcard, @NonNull OnResultListener onResultListener)
.......
public interface OnResultListener {
void onResult(int resultCode, Intent data);
}// 规则
scheme://version/path?query
// 示例
pigeon://v99/broswer/loadUrl?from=MainActivity&showConfirm=1¶ms={"url":"http%3a%2f%2fbboylin.github.io%2f"}
其中version部分遵循正则：v\d+ 数字越大表示版本越高，path部分可自由组合，建议按照module/submodule/...../action这种细分。query部分的key和value在dispatch到对应的dispatcher的时候会进行url decode，同时以hashmap形式提供。
// 每个Dispatcher都有个对应的path，uri dispatch的时候会解析出path，根据path找到对应Dispatcher
@Dispatcher(path = "browser/loadUrl")
public class WebDispatcher extends AbstractSchemeDispatcher {
@Override
public boolean invoke(@NonNull Context context, @NonNull Query query, @Nullable PigeonDispatchCallback callback) {
// query 中带了scheme的所有参数 ， Context是调用dispatch分发时候传入的
.......
}
}
.......
// 可指定index，因为某些场景下对interceptor列表顺序有要求，大多数情况下只需要@Interceptor，不加index
@Interceptor(index = 0)
public class DemoInterceptor extends AbstractSchemeInterceptor {
@NonNull
@Override
public String getName() {
return "DemoInterceptor";
}
@Override
public boolean shouldInterceptSchemeDispatch(@NonNull Context context, @NonNull String scheme) {
Log.d(getName(), "shouldInterceptSchemeDispatch");
// interceptor直接处理整个scheme，参考demo中的HttpInterceptor
// 当返回false的时候会继续用其他interceptor尝试拦截，返回true不再进行dispatch
// 所有interceptor都不拦截的情况下会交给对应dispatcher处理
return false;
}
}// 初始化的时候可以绑定dispatcher和interceptor，以及校验scheme有效性等。
// 无特殊要求的话init时候可以传null
Pigeon.init(new SchemeConfig() {
@Nullable
@Override
public List<AbstractSchemeInterceptor> getInterceptors() {
return null;
}
@Nullable
@Override
public Map<String, AbstractSchemeDispatcher> getDispatchers() {
return null;
@Override
public boolean checkValidScheme(@NonNull SchemeEntity entity) {
return TextUtils.equals(entity.schemeHead, "pigeon") && entity.version <= CURRENT_VERSION;
}
});
// 可以选择是否开启pigeon的debug模式
Pigeon.openDebug();public static boolean dispatch(@NonNull Context context, @NonNull String uri);
public static boolean dispatch(@NonNull Context context, @NonNull String uri, @Nullable PigeonDispatchCallback callback);通过Autowired和Inject两个注解标记需要注入的类和方法，示例：
@Autowired
public class AppRuntimeProvider {
// 是否使用单例模式
@Inject(singleton = true)
public static IAppRuntime get() {
return null;
}
}然后通过Provider注解标记要注入的实例，
@Provider
public class AppRuntime implements IAppRuntime {
@Override
public Context getAppContext() {
return DemoApplication.getInstance();
}
@Override
public void showUniversalToast(Context context, String text) {
UniversalToast.makeText(context, text, UniversalToast.LENGTH_SHORT, UniversalToast.EMPHASIZE)
.showWarning();
}
}在最终生成的APK里，AppRuntimeProvider注入后的代码成了：
@Autowired
public class AppRuntimeProvider {
public AppRuntimeProvider() {
}
// singleton = true会生成工厂类提供AppRuntime这个类的单例，否则直接new创建实例
@Inject(
singleton = true
)
public static IAppRuntime get() {
return AppRuntime_Factory.get();
}
}其中AppRuntime_Factory是pigeon自动生成的提供AppRuntime单例的工厂类
一是因为gradle 4.7才开始部分支持apt的增量编译，二是因为apt一次只能对单个module生效，最后还得需要开发一个gradle插件合并所有module的路由表。
基于此，pigeon直接利用javassist在transform阶段生成路由表，一举两得。
组件化开发中，有时候会出现下层module需要调用上层module接口的现象，例如获取App Context；例如调用登陆，视频播放等功能，而这几个功能在上层module。
这时候就需要进行控制反转。通过依赖注入来实现控制反转能减少许多冗余的公式化代码，另外也能减少模块间的耦合。
好处一是方便调用不依赖的module的服务，方便组件之间解耦；二是可以统一js和Android通信的桥梁，只需要绑定一个方法，根据传入的不同scheme就能调用不同服务。这个分发过程已经由pigeon完成，
路由表是在transform阶段扫描RouteNode注解生成，activity内参数注入通过扫描Bind注解，针对每个activity生成对应的Injector类，最终生成一个InjectorDispatcher类根据要跳转的activity名找到对应Injector来执行参数注入。
具体用法可以参考demo代码。
Copyright 2019 bboylin
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.