核心实施和生命周期

此信息可帮助您实施 Android 库并收集生命周期量度，例如启动次数、升级次数、会话数、参与用户数等。

下载 SDK

1. 请完成以下各节中的步骤，以设置开发报表包并下载配置文件的预填充版本：

   • 创建报表包
   • 下载 SDK

2. 下载并解压缩 [Your_App_Name_]AdobeMobileLibrary-4.*-Android.zip 文件，同时确认存在以下软件组件：

   • adobeMobileLibrary.jar，这是将用于 Android 设备和模拟器的库。

   • ADBMobileConfig.json，为您的应用程序自定义的 SDK 配置文件。

   重要

   如果您在 Adobe Mobile Services 用户界面之外下载 SDK，则必须手动配置 ADBMobileConfig.json 文件。如果您是初次使用 Analytics 和 Mobile SDK，而且想要设置一个开发报表包并下载预填充版本的配置文件，请参阅开始之前。

将 SDK 和配置文件添加到您的 IntelliJ IDEA 或 Eclipse 项目

IntelliJ IDEA 项目

要将 SDK 和配置文件添加到您的项目，请执行以下操作：

1. 将 ADBMobileConfig.json 文件添加到您项目的 assets 文件夹中。

2. 在项目导航面板中，右键单击您的项目。

3. 选择​打开模块设置。

4. 在​项目设置​下，选择​库。

5. 单击 + 图标以添加新库。

6. 选择 Java 并导航至 adobeMobileLibrary.jar 文件。

7. 选择您计划在其中使用移动设备库的模块。

8. 单击​应用，然后单击​确定​以关闭“模块设置”窗口。

Eclipse 项目

要将 SDK 和配置文件添加到您的项目，请执行以下操作：

1. 将 ADBMobileConfig.json 文件添加到您项目的 assets 文件夹中。
2. 在 Eclipse IDE 中，右键单击项目名称。
3. 单击​生成路径 > 添加外部存档。
4. 选择 adobeMobileLibrary.jar。
5. 单击​打开。
6. 再次右键单击项目，然后选择​生成路径 > 配置生成路径。
7. 在​顺序和导出​选项卡中，确保已选中 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());
   }

实施生命周期量度

启用生命周期后，每次启动您的应用程序时，系统都会发送一个点击来测量启动次数、升级次数、会话数、参与用户数等量度。有关更多信息，请参阅生命周期量度。

在应用程序的每个活动中完成以下步骤：

1. 导入库：

   import com.adobe.mobile.*;
   

2. 在 onResume 函数中，启动生命周期数据收集：

   @Override 
   public void onResume() { 
       Config.collectLifecycleData(this); 
       // -or- Config.collectLifecycleData(this, contextData); 
   }
   

3. 在 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 中的自定义变量：

其他生命周期量度将会自动收集。有关更多信息，请参阅生命周期量度。

后续操作

完成以下任务：

• 跟踪应用程序状态
• 跟踪应用程序操作