Android 友盟简单快速集成

1，打开友盟官网，进行注册，添加 app ，记住 key。

2，集成，一共两种方式，使用 jar 包和 自动集成，这里我们选择自动集成，如下：

​ 在项目的 gradle 中添加如下：

 repositories {
        ......
        maven { url 'https://dl.bintray.com/umsdk/release' }
    }

repositories {
        ......
        maven { url 'https://dl.bintray.com/umsdk/release' }
    }

​ 接着在 在工程App 对应build.gradle配置脚本dependencies段中添加基础组件库和统计SDK库依赖，如下：

//友盟基础组件库和统计SDK库依赖
api 'com.umeng.umsdk:analytics:8.0.0'
api 'com.umeng.umsdk:common:2.0.0'

​ 这样就集成完毕了

3，集成配置

​ 所需要的权限：

    <!--友盟统计所需权限-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"></uses-permission>
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.INTERNET"></uses-permission>
    <uses-permission android:name="android.permission.READ_PHONE_STATE"></uses-permission>

​ 在 AndroidManifest.xml 中配置 key

 <!--value的值填写你在友盟后台申请的应用Appkey-->
<meta-data
   android:name="UMENG_APPKEY"
   android:value="****************" />

4，配置渠道

​ 在 AndroidManifest.xml 中配置动态渠道

 <!--value的值填写渠道名称，例如yingyongbao。这里设置动态渠道名称变量-->
<meta-data
     android:name="UMENG_CHANNEL"
     android:value="${UMENG_CHANNEL_VALUE}" />

​ 在 app.gradle 中添加渠道

 /*配置渠道*/
    productFlavors {
        yingyongbao {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "yingyongbao"]
        }
        wandoujia {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "wandoujia"]
        }
        xiaomi {
            manifestPlaceholders = [UMENG_CHANNEL_VALUE: "xiaomi"]
        }
    }

​ 在同步过程中如果出现：ERROR: All flavors must now belong to a named flavor dimension. 的问题，就在 app/build.gradle 的 defaultConfig 中加入 flavorDimensions “versionCode” 即可

5，初始化

​ 在自定义的 Application 中进行初始化：

/**
 * 初始化common库
 * 参数1:上下文，必须的参数，不能为空
 * 参数2:友盟 app key，非必须参数，如果Manifest文件中已配置app key，该参数可以传空，则使用Manifest中配置的app key，否则该参数必须传入
 * 参数3:友盟 channel，非必须参数，如果Manifest文件中已配置channel，该参数可以传空，则使用Manifest中配置的channel，否则该参数必须传入，channel命名请详见channel渠道命名规范
 * 参数4:设备类型，必须参数，传参数为UMConfigure.DEVICE_TYPE_PHONE则表示手机；传参数为UMConfigure.DEVICE_TYPE_BOX则表示盒子；默认为手机
 * 参数5:Push推送业务的secret，需要集成Push功能时必须传入Push的secret，否则传空
 * 如果在 AndroidManifeset.xml 中没有配置 appkey 和 channel 则可以如下配置
 * UMConfigure.init(this, "*****************", "Umeng", UMConfigure.DEVICE_TYPE_PHONE,  * 我已经配置过，所以如下方式初始化
 */
UMConfigure.init(this, UMConfigure.DEVICE_TYPE_PHONE, "");
// log 
UMConfigure.setLogEnabled(true);

​ 其中 注释中的 channel 指的是渠道，我们在 AndroidManifest.xml 中已经动态配置过，所以这里就不用配置了

6，使用

​ 在每个 Activity 中需要如下调用：

 @Override
    protected void onResume() {
        super.onResume();
        //友盟统计
        MobclickAgent.onResume(this);
    }

    @Override
    protected void onPause() {
        super.onPause();
        //友盟统计
        MobclickAgent.onPause(this);
    }

​ 如果 Activity 中有继承关系，则不能重复调用，否则会造成启动数据异常增高

7，打包，进行测试

​ 如上所示：在打包的时候就可以选择渠道，这里可以进行多选

​ 打包成功后打开 app ，随便逛一下，然后打开友盟官网，查看统计数据

​ 查看渠道数据：

​ 这里需要注意一点：

​ 每台设备仅记录首次安装激活的渠道，在其他渠道再次安装不会重复计量。 所以在测试不同的渠道的时候，请使用不同的设备来分别测试不要改变 ’UMENG_CHANNEL’。意思就是在某个设备上安装渠道应用后，这个设备安装其他渠道应用将不会计量。

​ 当应用在后台运行超过30秒（默认）再回到前端，将被认为是两个独立的session(启动)，例如用户回到home，或进入其他程序，经过一段时间后再返回之前的应用。可通过接口：setSessionContinueMillis(long interval) 来自定义这个间隔（参数单位为毫秒）。

​ 如果开发者调用kill或者exit之类的方法杀死进程，请务必在此之前调用onKillProcess(Context context)方法，用来保存统计数据。

8，采集方式：

​ 在上面我们说的是在 Activity 中的数据统计，如果是 fragment 呢，这种情况下我们就要用到 采集方式了，一般我们使用 AUTO 的方式来进行采集。

​ 首先在 Application 中进行添加如下：

 // 选用AUTO页面采集模式
MobclickAgent.setPageCollectionMode(MobclickAgent.PageMode.AUTO);

​ 接着我们要在 fragment 的 onResume 和 onPause 中进行数据采集。但是由于 fragment 是 嵌套在 activity 中的，例如 使用 hide 隐藏 fragment，这个时候 fragment 并没有执行 onPause ，使用 ViewPager 加载 fragment 等，这些都会造成 fragment 统计的数据不准确，这个时候就需要调整了。

​ 找了一个帖子，发现讲的挺好。挺好的解决方式：当友盟遇到 fragment 的坑

​ 这样就可以解决 fragment 中采集数据的问题了

9，混淆

​ 如果您的应用使用了代码混淆，请添加如下配置，以避免【友盟+】SDK被错误混淆导致SDK不可用

-keep class com.umeng.** {*;}

-keepclassmembers class * {
   public <init> (org.json.JSONObject);
}

-keepclassmembers enum * {
    public static **[] values();
    public static ** valueOf(java.lang.String);
}

以上就是基础的使用方式了

---

高级用法：

1，自定义事件统计

​ 在友盟中找到事件管理，点击设置，手动添加事件即可，如下图：

在初始化的地方添加如下：

// 支持在子进程中统计自定义事件
UMConfigure.setProcessEvent(true)；

​ 然后在项目中点击商品的地方进行设置如下：

 @Override
    public void onItemClick(BaseQuickAdapter adapter, View view, int position) {
        GetGoodsListBean.DataBean bean = this.adapter.getData().get(position).getField(MultipleFields.OBJECT);
        ToastUtils.show(bean.getGoodsName());
        //第二个参数为点击 id
        MobclickAgent.onEvent(getContext(), "shop");
    }

​ 接着运行 app 进行操作，就可以在友盟上看到统计效果了。

2，错误统计

​ 组件化统计SDK内建JVM层错误统计。SDK通过Thread.UncaughtExceptionHandler 捕获程序崩溃日志，并在程序下次启动时发送到服务器。

如不需要错误统计功能，可通过此方法关闭：

// isEnable: false-关闭错误统计功能；true-打开错误统计功能（默认打开）
public static void setCatchUncaughtExceptions(boolean isEnable)

如果是捕获的异常，可以通过以下方式上传：

public static void reportError(Context context, String error);   
//或  
public static void reportError(Context context, Throwable e);

例如：

MobclickAgent.reportError(mContext, "Parameter Error");

try {
    // 抛出异常的代码
} catch (Exception e) {
    MobclickAgent.reportError(mContext, e);
}

ic static void reportError(Context context, Throwable e);

例如： 

MobclickAgent.reportError(mContext, “Parameter Error”);

try {
// 抛出异常的代码
} catch (Exception e) {
MobclickAgent.reportError(mContext, e);
}

还有许多功能，如账号统计等。[可以上官网查看](https://developer.umeng.com/docs/119267/detail/118637#h1-u9519u8BEFu5206u67904)