进入http://www.lotuseed.com 网站,使用您的注册账号登录后,请预先创建一款Android(应用)产品,您将获得一串编码后的APP KEY,用于唯一标识您的一款应用。
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>
接口定义
//可选,为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错误日志提示。
参见"添加方法"一节。
集成完毕并打包后,请以真机测试并查验Lotuseed WEB输出报表,以确保SDK集成的正确。