Android中调试RxJava Android

是一个切入点，我们知道它是如何令人沮丧和痛苦的。此外，很多时候你为了写调试相关的代码（不属于业务逻辑的部分）而使得事情更复杂。特别是当涉及到异步代码执行。
Frodo就是为了避免编写用于调试RxJava对象的代码而出现的。它依赖Java注解和Gradle Plugin，程序Debug编译时会检测，它会将RxJava对象的相关信息输出到logcat。例如，即使是在生成release版的app时，在你的代码库中保留Frodo注解也是安全的。现在，让我们具体看看。
使用Frodo 使用Frodo第一步是在我们Android项目中将Gradle Plugin修改为如下这样：
build.gradle

 1 2 3 4 5 6 7 8 9 10 11 12 13 

 buildscript { repositories { jcenter 
( 
) } dependencies { classpath 'com.android.tools.build:gradle:1.3.1' classpath "com.fernandocejas.frodo:frodo-plugin:0.8.1" } } apply
plugin 
: 'com.android.application' apply
plugin 
: 'com.fernandocejas.frodo' 

正如你看到的，我们在classpath中添加了“com.fernandocejas.frodo:frodo-plugin:0.8.1”然后我们声明了‘com.fernandocejas.frodo’ plugin。这足够使用这个库提供的Java注解。
检验@RxLogObservable Frodo第一个核心功能是通过Java注解@RxLogObservable 记录RxJava Observables日志。比方说我们有一个会产出DummyClass列表的Observable。
ObservableSample.java

 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 

 public class ObservableSample { @ 
RxLogObservable public Observable 
< 
List 
< 
MyDummyClass 
>> list 
( 
) { return Observable 
. 
just 
( 
buildDummyList 
( 
) 
) 
;
 } public List 
< 
MyDummyClass 
> buildDummyList 
( 
) { return Arrays 
. 
asList 
( 
new MyDummyClass 
( 
"Batman" 
) 
, new MyDummyClass 
( 
"Superman" 
) 
) 
;
 } public static final class MyDummyClass { private final String name 
;
 MyDummyClass 
( 
String name 
) { this 
. 
name = name 
;
 } @ 
Override public String toString 
( 
) { return "Name: " + name 
;
 } } } 

然后我们订阅到我们的observable例子中：
MyClass.java

 1 2 3 4 5 6 7 8 9 10 11 

 final ObservableSample
observableSample = new ObservableSample 
( 
) 
;
 observableSample 
. 
list 
( 
) . 
subscribeOn 
( 
Schedulers 
. 
newThread 
( 
) 
) . 
observeOn 
( 
AndroidSchedulers 
. 
mainThread 
( 
) 
) . 
subscribe 
( 
new Action1 
< 
List 
< 
ObservableSample 
. 
MyDummyClass 
>> 
( 
) { @ 
Override public void call 
( 
List 
< 
ObservableSample 
. 
MyDummyClass 
> myDummyClasses 
) { toastMessage 
( 
"onNext() List--> " + myDummyClasses 
. 
toString 
( 
) 
) 
;
 } } 
) 
;
 

编译并运行应用后，这是我们在logcat中看到的信息：
LogcatShell

 1 2 3 4 5 6 7 

 ObservableSample D Frodo = 
> [ 
@ 
Observable :: @ 
InClass -> ObservableSample :: @ 
Method -> list 
( 
) 
] D Frodo = 
> [ 
@ 
Observable 
#list -> onSubscribe() :: @SubscribeOn -> RxNewThreadScheduler-3] D Frodo = 
> [ 
@ 
Observable 
#list -> onNext() -> [Name: Batman, Name: Superman]] D Frodo = 
> [ 
@ 
Observable 
#list -> onCompleted()] D Frodo = 
> [ 
@ 
Observable 
#list -> onTerminate() :: @Emitted -> 1 element :: @Time -> 0 ms] D Frodo = 
> [ 
@ 
Observable 
#list -> onUnsubscribe() :: @ObserveOn -> main] 

主要意思是在ObservableSample类中我们订阅了一个返回Observable的list()方法。然后通过带注释的Observable我们获得了关于被发送的元素、执行方法和事件被触发的信息。
检验@RxLogSubscriber 现在让我们看下@RxLogSubscriber能做什么。
下面例子，让我们创建一个用@RxLogSubscriber做注释的RxJava虚拟Subscriber。
MySubscriberBackpressure.java

 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 

 @ 
RxLogSubscriber public class MySubscriberBackpressure extends Subscriber 
< 
Integer 
> { @ 
Override public void onStart 
( 
) { request 
( 
16 
) 
;
 } @ 
Override public void onNext 
( 
Integer value 
) { //empty } @ 
Override public void onError 
( 
Throwable
throwable 
) { //empty } @ 
Override public void onCompleted 
( 
) { if ( 
! 
isUnsubscribed 
( 
) 
) { unsubscribe 
( 
) 
;
 } } } 

现在我们不提这个Subscriber的名字backpressure，因为这个话题得说一整篇文章。只要知道这个Subscriber仅请求16个元素和onNext()方法被调用时什么都不会做。可是，我仍然想看到当被调用时会发生什么。
ObservableSample.java

 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 

 public class ObservableSample { public Observable 
< 
Integer 
> numbersBackpressure 
( 
) { return Observable 
. 
create 
( 
new Observable 
. 
OnSubscribe 
< 
Integer 
> 
( 
) { @ 
Override public void call 
( 
Subscriber 
< 
? super Integer 
> subscriber 
) { try { if ( 
! 
subscriber 
. 
isUnsubscribed 
( 
) 
) { for ( 
int i = 1 
;
 i < 10000 
;
 i 
++ 
) { subscriber 
. 
onNext 
( 
i 
) 
;
 } subscriber 
. 
onCompleted 
( 
) 
;
 } } catch ( 
Exception e 
) { subscriber 
. 
onError 
( 
e 
) 
;
 } } } 
) 
;
 } } 

这里订阅到SampleObservable：
MyClass.java

 1 2 3 4 5 6 7 

 final ObservableSample
observableSample = new ObservableSample 
( 
) 
;
 observableSample 
. 
numbersBackpressure 
( 
) . 
onBackpressureDrop 
( 
) . 
subscribeOn 
( 
Schedulers 
. 
newThread 
( 
) 
) . 
observeOn 
( 
AndroidSchedulers 
. 
mainThread 
( 
) 
) . 
subscribe 
( 
new MySubscriberBackpressure 
( 
) 
) 
;
 

当我们再次编译并运行程序后，这是在logcat得输出信息：
LogcatShell

 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 

 SubscriberBackpressure D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onStart 
( 
) 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> @ 
Requested -> 40 elements 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 1 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 2 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 3 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 4 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 5 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 6 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 7 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 8 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 9 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 10 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 11 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 12 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 13 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 14 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 15 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onNext 
( 
) -> 16 :: @ 
ObserveOn -> main 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> onCompleted 
( 
) :: @ 
Received -> 16 elements :: @ 
Time -> 3 ms 
] D Frodo = 
> [ 
@ 
Subscriber :: MySubscriberBackpressure -> unSubscribe 
( 
) 
] 

这里得信息包括每一个被接收的item，元素的数量、调用函数，执行事件和触发事件。
正如你所看到了在backpressure中有用的信息，或看到哪个线程发出的item又或者当我们想是否Subscriber被成功订阅，从而避免了内存泄漏。
Frodo高级选项在这篇文章中，我没有说明这个库内部工作的细节，如果你感兴趣的话，可以看下我一年前写的一篇文章，它里面包括我同样使用Frodo的一个例子。
你也可以浏览我已经准备好的一个描述关于AOP和这个库的介绍，更深入的可以看源码。
免责说明：初期 Frodo刚刚诞生，未来还有很长的路。它仍然处在一个非常早期的阶段，所以你可能会发现问题或者可以提升的地方。
实际上，开源的一个主要原因是在社区中收到反馈或建议完善自己，让它更好用。我不得不非常激动的说，我已经在3个不同的项目中使用并没有发现很多问题（更多信息可以查看下边的已知问题）。
已知问题目前为止知道的一个已知问题：因为Frodo依赖Gradle Plugin（正如之前说的）检测Android Debug编译版本和植入代码，如果你做为Android Library项目使用，当你编译应用（即使是debug编译类型），官方的Android Gradle Plugin总是会编译Android Library项目的release版本，这样，这就阻止了Frodo在注释的方法／类上植入代码。当然这不会引起你的应用崩溃但在logcat中你看不到任何输出。既然你不希望在商用的release版本中到处都是暴露重要信息的log日志，这里有一个应对方案，你使用的时候要注意。
在你项目的Android Library module的build.gradle文件中添加下边标记：
(编者注：新版本的Androdi Studio的library module也可以设置为不混淆了。)
build.gradle

 1 2 3 4 

 android { defaultPublishConfig "debug" } 

Frodo应用例子这个repository包括一个应用例子，你可以看到不同情况下的使用实例，比如Observable的错误和其他log信息。我也在我的Android Clean Architecture repo使用了Frodo，你可以去看看。
总结这是我在这边文章中尽力提供的，希望你能找到Frodo的好处。
最新的版本你可以在这里找到：
https://github.com/android10/frodo
【Android中调试RxJava】 一如既往，欢迎任何反馈，也欢迎贡献，再会。