Lotuseed Android SDK 集成指南

二、接入流程

STEP 1、为应用申请 APP KEY

进入http://www.lotuseed.com 网站,使用您的注册账号登录后,请预先创建一款Android(应用)产品,您将获得一串编码后的APP KEY,用于唯一标识您的一款应用。

STEP 2、向工程中导入追踪SDK

  1. 登录Lotuseed Web下载SDK,带apk更新等扩展功能SDK请注意勾选相应功能项后提交下载;
  2. 解压SDK,并将其中的libs目录和res目录(如存在)一并解压到Adnroid工程目录下;
  3. Eclipse用户右键您的工程根目录,按F5刷新工程,然后再选择 Properties --> Java Build Path --> Libraries → 点击Add External JARs...找到本地目录下的Lotuseed SDK jar 文件,点击打开按钮即可成功导入。

STEP 3、配置AndroidManifest.xml

SDK需要获取适当的权限才可以正常工作,开发者需要在AndroidManifest.xml里边添加下表列举出来的权限申明。
另外,SDK会读取application的meta-data来获取当前应用的标识 LOTUSEED_APPKEY 和分包渠道标识 LOTUSEED_CHANNEL,对应的meta-data的名字也见下表。

注意:如果开发者不希望通过AndroidManifest.xml配置LOTUSEED_APPKEY和LOTUSEED_CHANNEL,也可以通过"STEP 4、添加SDK初始化代码(可选)"步骤描述的方法来通过API调用来传入这些信息。

所需权限 用途说明
android.permission.INTERNET 允许SDK联网和发送统计数据的权限。
android.permission.ACCESS_NETWORK_STATE 允许SDK检测网络连接状态,在网络异常状态时避免数据发送,节省电量。
android.permission.READ_PHONE_STATE(建议) 允许SDK获取IMEI和运营商信息。
android.permission.WRITE_EXTERNAL_STORAGE(可选) 使用应用更新辅助功能时,添加该权限可使apk保存到SD卡。
Meta-data 用途说明
LOTUSEED_APPKEY 该值为您在Lotuseed WEB上创建应用时获得的APPKEY,用于在LOTUSEED统计平台上唯一标识您的app。
LOTUSEED_CHANNEL 用于标注app的推广渠道,区分app的获取来源。
Receiver(可选) 用途说明
<receiver android:name="com.lotuseed.android.PackageReceiver">
     <intent-filter>
         <action android:name="android.intent.action.PACKAGE_REMOVED" />
         <action android:name="android.intent.action.PACKAGE_REPLACED" />
         <data android:scheme="package" />
     </intent-filter>
</receiver>
该Receiver用于获取app更新标志,此标志可区分出新激活设备与导入设备。
其他配置(可选) 用途说明
<activity android:label="@string/app_name" android:name="com.lotuseed.android.UpdateNotifyActivity" android:theme="@android:style/Theme.Translucent" /> 使用应用更新辅助功能时,添加的activity用于更新提醒。

最终的AndroidManifest.xml 示例如下:

    <?xml version="1.0" encoding="utf-8"?> 
    <manifest ......> 
        ......         
        <uses-permission android:name="android.permission.INTERNET"></uses-permission> 
        <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>         
        <uses-permission android:name="android.permission.READ_PHONE_STATE"> 
        </uses-permission> 
        <application ......> 
            <activity ....../> 
            <receiver android:name="com.lotuseed.android.PackageReceiver" > 
                <intent-filter> 
                    <action android:name="android.intent.action.PACKAGE_REMOVED" /> 
                    <action android:name="android.intent.action.PACKAGE_REPLACED" /> 
                    <data android:scheme="package" /> 
                </intent-filter> 
            </receiver> 
            <meta-data android:name="LOTUSEED_APPKEY" android:value="Your_APPKEY" /> 
            <meta-data android:name="LOTUSEED_CHANNEL" android:value="Your_CHANNEL" /> 
        </application> 
    </manifest>

STEP 4、添加SDK初始化代码(可选)

接口定义

//可选,为SDK设置Context,并立即产生激活设备的数据 
public static void init(final Context context); 
//可选,代码设置APPKEY &CHANNEL,同时在AndroidManifest.xml设置APPKEY &CHANNEL时,则已代码中设置的值为准 
public static void startWithAppKey(final String appKey, final String channel);

参数说明

参数 类型 描述
context Context 当前app的Context对象实例
appKey String Lotuseed Web上获取的APPKEY
channel String 自定义的分包渠道标识 。

实例代码

@Override
protect void onCreate () { 
    super.onCreate(); 
    Lotuseed.init(this); 
    Lotuseed.startWithAppKey(YOUR_APPKEY, YOUR_CHANNEL); 
}

注意:
1.初始化代码请添加在Application子类内;
2.如果未调用init接口,SDK有可能无法获取到Context对象,此时应注意Logcat错误日志提示。

STEP 5、添加调用方法

参见"添加方法"一节。

STEP 6、进行数据测试

集成完毕并打包后,请以真机测试并查验Lotuseed WEB输出报表,以确保SDK集成的正确。