此信息可帮助您实施 Android 库并收集生命周期量度,例如启动次数、升级次数、会话数、参与用户数等。
要下载 SDK,您必须使用 Android 2.2 或更高版本。
请完成以下各节中的步骤,以设置开发报表包并下载配置文件的预填充版本:
下载并解压缩 [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip
文件,同时确认存在以下软件组件:
adobeMobileLibrary.jar
,这是将用于 Android 设备和模拟器的库。
ADBMobileConfig.json
,为您的应用程序自定义的 SDK 配置文件。
如果您在 Adobe Mobile Services 用户界面之外下载 SDK,则必须手动配置 ADBMobileConfig.json
文件。如果您是初次使用 Analytics 和 Mobile SDK,而且想要设置一个开发报表包并下载预填充版本的配置文件,请参阅开始之前。
IntelliJ IDEA 项目
要将 SDK 和配置文件添加到您的项目,请执行以下操作:
将 ADBMobileConfig.json
文件添加到您项目的 assets
文件夹中。
在项目导航面板中,右键单击您的项目。
选择打开模块设置。
在项目设置下,选择库。
单击 + 图标以添加新库。
选择 Java 并导航至 adobeMobileLibrary.jar
文件。
选择您计划在其中使用移动设备库的模块。
单击应用,然后单击确定以关闭“模块设置”窗口。
Eclipse 项目
要将 SDK 和配置文件添加到您的项目,请执行以下操作:
ADBMobileConfig.json
文件添加到您项目的 assets
文件夹中。adobeMobileLibrary.jar
。adobeMobileLibrary.jar
。AppMeasurement 库需要以下权限来发送数据和记录离线跟踪调用:
INTERNET
ACCESS_NETWORK_STATE
要添加这些权限,请将以下行添加到 AndroidManifest.xml
文件中,该文件位于应用程序项目目录内:
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
应在主活动的 onCreate
方法中添加以下代码:
@Override
public void onCreate(BundlesavedInstanceState){
super.onCreate(savedInstanceState)
setContentView(R.layout.main);
Config.setContext(this.getApplicationContext());
}
启用生命周期后,每次启动您的应用程序时,系统都会发送一个点击来测量启动次数、升级次数、会话数、参与用户数等量度。有关更多信息,请参阅生命周期量度。
在应用程序的每个活动中完成以下步骤:
导入库:
import com.adobe.mobile.*;
在 onResume
函数中,启动生命周期数据收集:
@Override
public void onResume() {
Config.collectLifecycleData(this);
// -or- Config.collectLifecycleData(this, contextData);
}
在 onPause
函数中,暂停生命周期数据收集:
@Override
public void onPause() {
Config.pauseCollectingLifecycleData();
}
您必须将这些调用添加到每个活动中,才能确保准确报告崩溃情况。有关更多信息,请参阅跟踪应用程序的崩溃情况。
要通过生命周期量度调用包含其他数据,请将一个额外的参数传递到包含上下文数据的 collectLifecycleData
:
@Override
public void onResume() {
HashMap<String, Object> contextData = new HashMap<String, Object>();
contextData.put("myapp.category", "Game");
Config.collectLifecycleData(this, contextData);
}
通过 collectLifecycleData
发送的其他上下文数据值必须映射到 Adobe Mobile Services 中的自定义变量:
其他生命周期量度将会自动收集。有关更多信息,请参阅生命周期量度。
完成以下任务: