Android SDK接入文档

最后修改时间2016-09-10

最新版本: 1.0.0

注意:

  • 本文中的代码示例可以复制/粘贴到你的源代码
  • 请注意,步骤3中的监听回调接口不是强制性的
  • 如果你有任何问题,联系我们 support@2bai.com.cn

开始集成

1.下载SDK,并添加到工程中

下载Android SDK,并解压缩

导入SDK有以下两种方法,选择其中一种即可

  • Eclipse ADT:将HotAppInApp-x.x.jar拷贝到工程目录的libs目录中
  • Android Studio:将HotAppInApp-x.x.jar拷贝到app目录下的libs目录中,通过File-> Project Structure->[在新开的窗口左侧选择你的项目]->Dependencies(右上方)-> +(左下方)->File Dependency选择指向jar的路径,点击OK,即导入成功。

2.配置AndroidManifest.xml

在 <manifest> 标签下添加权限

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/<
<uses-permission android:name="android.permission.READ_PHONE_STATE"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>

启动的Activity下的intent-filter中添加android:scheme,这样您的App就可以通过浏览器被唤起(可选)

<intent-filter>

    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="此处填写您在二百应用后台中显示的scheme" />

</intent-fier>

3.初始化SDK,并监听回调接口

在启动Activity的OnCreate方法中调用HotApp.init(this, "此处填写您在二百应用后台中显示的App ID", this); 并且实现HotAppListener接口(可选),获取到启动参数。

public class MainActivity extends AppCompatActivity implements HotAppListener {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        HotApp.init(this, "此处填写您在二百应用后台中显示的App ID", this);
        HotApp.setDebug(true); //设置调试模式,默认为false
    }

    @Override
    public void onParamReturnedSucceed(Map<String, String> paramMap) {
        // 获取到返回参数,包括你配置的渠道参数和短链后面带的参数没有配置参数则不需要进行处理
        if(paramMap.containsKey("key"))
        {
            // 获取相关的参数进行相关逻辑处理
        }
    }

    @Override
    public void onParamReturnedFailed(String info) {
        // 获取参数失败
    }
}

4.使用自定义事件

在您希望跟踪的事件代码部分,调用如下2种方法中的一种,事件名称可以自定义:

// 统计regist的发生次数
HotApp.onEvent("regist");

// 统计购买金币的数值
HotApp.onEvent("buy_coin", "1000");