Lotuseed Android SDK 集成指南

二、接入流程

STEP 1、为应用申请 APP KEY

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

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

登录Lotuseed Web下载SDK，带apk更新等扩展功能SDK请注意勾选相应功能项后提交下载；
解压SDK，并将其中的libs目录和res目录（如存在）一并解压到Adnroid工程目录下；
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集成的正确。