手把手教你接入华为分析的iOS SDK-华为开发者问答

Analytics Kit 5.0版本更新了，新增支持iOS SDK，实现对跨平台（Android, iOS）用户一站式的统一分析。满足以用户为中心的整体化的分析需求，以及用户在不同平台上行为的完整解读。今天我想来分享一下如何将Analytics Kit添加到你的iOS应用中。我接入的版本是5.0.0.300。

具体步骤包括：

配置AppGallery Connect
集成HMS Core SDK
接入Analytics

一、配置AppGallery Connect

请按照如下步骤为你的iOS应用配置AppGallery Connect。如果你的应用同时拥有Android和iOS版本，你可以将两个应用放在同一个项目内，后续你可以灵活切换以完成应用数据分析。

（一）准备

1. 为你的iOS应用准备好包名（向开发人员询问）。

2. 登录 AppGallery Connect 网站并创建一个新项目。

项目创建好后，你会进入一个页面，左侧导航栏展示了AGC的多种功能菜单。

3. 点击“添加应用“按钮，在项目下创建iOS应用。

这里提示你输入的软件包ID即开发人员为你提供的包名。

点击确定后，你会获得agconnect-services.plist配置文件。

（二）开通华为分析服务

点击“API管理“，看到Analystics Kit已默认开启。

回到左侧导航栏，转到“华为分析”，你将看到各种数据报告，包括用户分析、行为分析、受众分析等，点击任意菜单即可开通分析服务。

然后进入“项目接入设置”页面，设置数据存储位置、时区、货币、设置用户数据留存时间、设置自然周定义后，单击“完成”，即完成Analytics Kit服务开通。

二、集成HMS Core SDK（Cocoapods方式集成）

建议使用Cocoapods集成，如果不想使用Cocoapods，则可以手动集成。

1. 添加AppGallery Connect配置文件

a. 点击下载 agconnect-services.plist 以获取你的iOS 配置文件(agconnect-services.plist)。

b. 将配置文件移至 Xcode 项目的根目录中。

2. 编辑Podfile文件

a. 如果你没有Podfile，请创建一个：

$ cd your-project-directory

$ pod init

b. 将想要用在应用中的 pod 添加到 Podfile：增加pod依赖pod 'HiAnalytics'。

Podfile示例：

  # Uncomment the next line to define a global platform for your project  
  # platform :iOS, '9.0'  
  target 'HiAnalyticsSwiftDemo' do  
    # Comment the next line if you don't want to use dynamic frameworks  
    use_frameworks!  
    # Pods for HiAnalyticsSwiftDemo  
      pod 'HiAnalytics'  
    target 'HiAnalyticsSwiftDemoUITests' do 
      # Pods for testing  
   end  
 end

c. 安装 pod，然后打开 .xcworkspace 文件以便在 Xcode 中查看该项目：

$ pod install

$ open your-project.xcworkspace

三、接入Analytics

1.在你的应用中初始化Analytics SDK

最后一步是在你的应用中添加初始化代码。在AppDelegate中通过config接口完成初始化。

Objective C代码：在AppDelegate.m中进行初始化。

  #import "AppDelegate.h"  
  #import <HiAnalytics/HiAnalytics.h>  
  @interface AppDelegate ()  
  @end  
  @implementation AppDelegate  
  ...  
  - (BOOL)Application:(UIApplication *)Application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {  
      // Override point for customization after Application launch.  
      [HiAnalytics config];//初始化  
     return YES;  
 }  
   
 ...  
  
 @end

Swift代码示例：在AppDelegate.swift中进行初始化。

  import UIKit  
  import HiAnalytics  
  @UIApplicationMain  
  class AppDelegate: UIResponder, UIApplicationDelegate {  
  ...  
   func Application(_ Application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool  {  
          // Override point for customization after Application launch.  
          HiAnalytics.config();//初始化  
          return true  
  }  
 ...  
 }

2. 通过 onEvent 接口记录定义事件。
如果你不确定如何标记事件，请查看事件说明。

3. 参考“API说明”，调用接口实现各类功能。

另外，在开发过程中，推荐大家启用调试模式，借助华为分析的应用调试功能，实时查看事件的上报情况，观察具体结果并根据需要进行调整。

开启/停用调试模式

1.开启调试模式：

Xcode菜单选择“Product > Scheme > Edit Scheme”,然后选择第二个页签“Arguments”，单击“+”号增加一个参数“-HADebugEnabled”,添加完成后单击右下角的“Close”按钮进行保存。