jiangtingfu / Tracker

Tracker 是Android 上的一个用户行为跟踪框架，根据预先订阅的事件链，以观察者模式监听用户的行为，当用户的行为与订阅的一样时，通知给订阅者。 基于此框架，你可以轻松实现android 上不侵入业务的逻辑埋点。特别是长路径的埋点更有优势。

Tracker

Tracker 是Android 上的一个用户行为跟踪框架，根据预先订阅的事件链，以观察者模式监听用户的行为，当用户的行为与订阅的一样时，通知给订阅者。

没有看明白？

没关系，直接说明traker的应用场景。“埋点”，当我们的app到一定阶段时，一定会有埋点需求，例如在某按钮点击后统计埋点，进行上报，给到产品，可以统计功能的使用度。还有页面跳转 等等……当然还有复杂的埋点，如页面的多级跳传，A->B->C 。或者多个入口进同一页面的分别埋点A->C， B->C。在埋点服务上，我们一般会选择第三方的服务，如友盟等……，但是埋点代码还是需要我们来写到指定的地方的。这种埋点称为代码埋点。开发人员需要把埋点代码写到业务代码中。在埋点多了后，在重构时，会容易不小心删除埋点，而且也不好管理。当然还有全埋点，也就是在所有的点击事件或页面跳转的地方插入埋点代码，然后一起上报，由专门分析人员从中分析数据。但是这样会造成上传数据量过大，有时候无法精准的统计到某个功能。基于此背景，我们希望能做到按需埋点，但是又能最大程度的不侵入业务代码。使埋点代码集中放到一起管理，而且还要能实现复杂的埋点。所以Tracker（追踪者） 就是这样产生的。

支持 全量埋点 的监听，示例参考 com.ttpai.sample.FullPointer.java

1. 监听 所有view 的点击
2. 监听 所有页面(activity+Fragment) 的 进入、退出、可见与不可见
3. 监听 所有 dialog/popupWindow 的show、dismiss

注？ Tracker 框架 只是一个监听的框架，如监听到view的点击，回调触发，具体的埋点逻辑需要自己实现，因为各家埋点逻辑不同，不可能统一实现

如何接入？

在project中的build.gradle 中

buildscript {
    dependencies {
        ...
        //gradle 4.0+
        classpath 'com.android.tools.build:gradle:4.0.1'

        classpath 'com.hujiang.aspectjx:gradle-android-plugin-aspectjx:2.0.10'
    }
    allprojects {
	repositories {
	    ...
	    maven { url 'https://jitpack.io' }
	}
    }
 }

在app的build.gradle 中

apply plugin: 'com.hujiang.android-aspectjx'

dependencies {
   implementation 'com.github.ttpai:Tracker:1.0.4'
}

在application 中注册

@Override
public void onCreate() {
   super.onCreate();
   Track.initTrack(getApplication());
}

如何使用？

监听AActivity 跳转到 某页面事件：

Track.from(AActivity.class).to(BActivity.class).subscribe(new OnSubscribe<Intent>() {
   @Override
   public void call(Intent intent) {
       Log.d(TAG, "A->B");
   }
});

监听AActivity 中的某view被点击：

 Track.from(AActivity.class).viewClick(R.id.button).subscribe(new OnSubscribe<View>() {
     @Override
     public void call(View view) {
         Log.d(TAG, "A.click(R.id.button)");
     }
});