1.4 添加引用

 在使用cobub sdk函数的Activity文件头中，添加引用 import com.wbtech.ums.UmsAgent;

1.5 初始化sdk

• 在Android应用的入口Activity的onCreate()方法中调用UmsAgent.init(Context context, String url,String AppKey)方法，注意这个方法应置于所有其他的方法之前。url为自行安装的Cobub Razor服务端地址，注意地址以index.php?/ums结束，如："http://demo.cobub.com/razor/index.php?/ums"。

  Code Block
  @Override public void onCreate(Bundle savedInstanceState) { ... UmsAgent.init(this,"http://demo.cobub.com/razor/index.php?/ums", "your appkey"); }

  注：如果同时使用了其他统计SDK，如果cobub先注册，其他错误统计后注册，会导致cobub的自动捕捉错误统计被覆盖而无数据。同理应用内如果有捕捉错误信息的代码（实现了UncaughtExceptionHandler类），建议注释掉！

  完成初始化配置之后，集成了Cobub SDK的应用可以运行，并搜集到最基本的统计数据，如活跃用户、新增用户、启动次数以及设备相关的统计等。如需更详细的统计，则需继续集成后续章节的代码。

• 参数配置

           通过本模块的集成操作，你可以进行一些关于SDK的参数配置，包含：

                  1.数据发送模式;

                  2.数据发送间隔时长;

                  3.是否发送位置信息;

                  4.session存活时长;

                  5.缓存文件大小;

                  6.是否只在wifi状态下更新。

            有两种方式配置sdk的相关参数。

       2.1  本地配置

        1）设置数据发送模式（默认情况下为实时发送）

              提供三种种数据发送模式 实时发送、下次启动发送和定时发送模式，通过如下方法可以设置数据的发送模式。

UmsAgent.setDefaultReportPolicy(Context context, SendPolicy.POST_ONSTART); //下次启动发送
UmsAgent.setDefaultReportPolicy(Context context, SendPolicy.POST_NOW);     //实时发送
UmsAgent.setDefaultReportPolicy(Context context,SendPolicy.POST_INTERVAL); //按时间间隔发送

   模式解释

• 启动时发送
  应用程序每次只会在启动时向服务器发送一次消息，在应用程序过程中产生的所有消息都会在下次启动时候发送。如果应用程序启动时处在不联网状态，那么消息将会缓存在本地，下次再尝试发送。
• 实时发送（推荐使用）
  应用程序每产生条消息时，就立即发送到服务器。这种方式使得计算更及时
• 间隔发送
  按时间间隔发送，默认的时间间隔为1min。如果需要修改该时间间隔，可以通过如下函数修改：
  UmsAgent.setPostIntervalMillis(Context context, long interval); 参数 interval的时间单位为：ms。

         2）设置数据发送间隔时长

               前提：数据发送格式设置为了按时间间隔发送。默认的时间间隔为1min发送一次。如果需要修改该时间间隔，可以通过如下方法修改:

UmsAgent.setPostIntervalMillis(Context context, long interval); //参数interval的时间单位为:毫秒。

         3）设置是否发送位置信息

               该方法用来设置客户端是否发送用户的位置信息。在程序中调用如下方法来设置是否发送位置信息:

UmsAgent.setAutoLocation(boolean isSendLocation); //true:发送;false:不发送。默认false,不发送。

         4）设置session存活时间

UmsAgent.setSessionContinueMillis(Context context,long interval); //参数interval的时间单位为:毫秒。默认30s。

          5）设置日志缓存文件大小

        2.2 在线配置

                启用在线配置参数方法如下（需要在web端开启在线配置功能，并进行相应参数配置）：

UmsAgent.updateOnlineConfig(Context context); //在后台进行相关配置后，即可获取并应用在线配置

• 页面统计

          通过本模块的集成操作，即可统计到页面访问路径，页面访问时长等信息。如需更详细的统计，则需继续集成后续章节的代码。

       3.1 Activity页面统计

               在Android应用的每个Activity页面文件的onResume()和onPause()函数中添加代码如下，以便追踪并统计页面的相关信息：

@Override
protected void onResume(){
super.onResume();
UmsAgent.onResume(this);
}
@Override
protected void onPause(){
super.onPause();
UmsAgent.onPause(this);
}

         3.2 Web页面访问统计

                  Cobub Razor的Android SDK同时提供了针对Web页面的统计，在加载WebView控件（或继承了WebView控件的第三方控件）控件的Activity界面中，重写                                           onPageFinished() 方法，添加代码：

WebView webview = (WebView)findViewById(R.id.webView1);
webview.setWebViewClient(new WebViewClient(){
@Override
public void onPageFinished(WebView view, String url)
{ super.onPageFinished(view, url);
//在此需截取url中的有效页面名称，防止因参数不同而将同一页面重复统计
UmsAgent.postWebPage(url);
}
});

         3.3 fragment 页面统计

                 由于现在的应用很多都是有少数的Activity加大量的Fragment组成，因此我们在统计中增加了对Fragment页面的统计。
                 app页面的常见使用场景如下：

    上图为三种典型的页面统计场景

1. 纯粹基于 Activity 的页面
2. Activity中包含 Fragment 的页面（也有可能是Fragment包含Fragment）
3. Activity 中包含多个并列 Fragment 的页面

    在上述场景中， 我们可以统计到的页面为：
      1.A activity -> B activity ->C activity;
      2.A activity -> B activity ->Fragment 2;
      3.A activity -> B activity ->Fragment 3;
      4.A activity -> Fragment 1 ->C activity;
      5.A activity -> Fragment 1 ->Fragment 2;
      6.A activity -> Fragment 1 ->Fragment 3;
   如下的顺序目前是无法统计到的：
      A activity > B activity ->C activity>Fragment 2;
      A activity > B activity ->C activity>Fragment 3;
   如果页面是使用FragmentActivity + Fragment实现的，需要在 FragmentActivity 中统计时长：

1）针对无ViewPager：

public class Fragment2 extends Fragment {
@Override
 public void onCreate(Bundle savedInstanceState) {
    // TODO Auto-generated method stub
    super.onCreate(savedInstanceState);
 }

 @Override
 public View onCreateView(LayoutInflater inflater, ViewGroup container,
 Bundle savedInstanceState) {
    // TODO Auto-generated method stub
    return inflater.inflate(R.layout.fragment2, container, false);
 }
 @Override
 public void onPause() {
    // TODO Auto-generated method stub
     super.onPause();
     UmsAgent.onPause(activity);
 }
@Override
 public void onResume() {
    // TODO Auto-generated method stub
    super.onResume();
    UmsAgent.onFragmentResume(activity, "Fragment 2");
 }
 Activity activity;
 @Override
 public void onAttach(Activity activity) {
        super.onAttach(activity);
    this.activity = activity;
 }
}

2）针对有ViewPager：（注意：不用在onPause方法中调用）

          首先在onResume方法中调用如下方法：

@Overridepublic void onResume() {
// TODO Auto-generated method stub
super.onResume();
UmsAgent.onFragmentResume(getActivity(), "Fragment—名字");
}

          然后在onHiddenChanged 方法中调用如下方法：

@Override public void onHiddenChanged(boolean hidden) {
// TODO Auto-generated method stub
super.onHiddenChanged(hidden);
if(hidden){
UmsAgent.onPause(getActivity());
}else{
UmsAgent.onFragmentResume(getActivity(), "fragment—名字");
}
}

• App自动更新

         机制说明：

UmsAgent.update(this); //启用app新版本自动更新功能

updateCustomsParameters();      //获取在线配置参数 保存到本地
getConfigParameter(String key); //获取本地保存的在线配置参数