Show Menu
主题×

核心实施和生命周期

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

下载 SDK

要下载 SDK,您必须使用 Android 2.2 或更高版本。
  1. 请完成以下部分中的步骤,以设置一个开发报表包并下载预填充版本的配置文件:
  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 中的自定义变量:
其他生命周期量度将会自动收集。有关更多信息,请参阅 生命周期量度

后续操作

完成以下任务: