手把手教你接入華為分析的iOS SDK

Analytics Kit 5.0版本更新了，新增支持iOS SDK，實(shí)現(xiàn)對跨平臺（Android, iOS）用戶一站式的統(tǒng)一分析。滿足以用戶為中心的整體化的分析需求，以及用戶在不同平臺上行為的完整解讀。今天我想來分享一下如何將Analytics Kit添加到你的iOS應(yīng)用中。我接入的版本是5.0.0.300。

具體步驟包括：

配置AppGallery Connect

集成HMS Core SDK

接入Analytics

一、配置AppGallery Connect

請按照如下步驟為你的iOS應(yīng)用配置AppGallery Connect。如果你的應(yīng)用同時(shí)擁有Android和iOS版本，你可以將兩個(gè)應(yīng)用放在同一個(gè)項(xiàng)目內(nèi)，后續(xù)你可以靈活切換以完成應(yīng)用數(shù)據(jù)分析。

（一）準(zhǔn)備

1. 為你的iOS應(yīng)用準(zhǔn)備好包名（向開發(fā)人員詢問）。

2. 登錄 AppGallery Connect 網(wǎng)站 并創(chuàng)建一個(gè)新項(xiàng)目。

項(xiàng)目創(chuàng)建好后，你會進(jìn)入一個(gè)頁面，左側(cè)導(dǎo)航欄展示了AGC的多種功能菜單。

3. 點(diǎn)擊“添加應(yīng)用“按鈕，在項(xiàng)目下創(chuàng)建iOS應(yīng)用。

這里提示你輸入的軟件包ID即開發(fā)人員為你提供的包名。

點(diǎn)擊確定后，你會獲得agconnect-services.plist配置文件。

（二）開通華為分析服務(wù)

點(diǎn)擊“API管理“，看到Analystics Kit已默認(rèn)開啟。

回到左側(cè)導(dǎo)航欄，轉(zhuǎn)到“華為分析”，你將看到各種數(shù)據(jù)報(bào)告，包括用戶分析、行為分析、受眾分析等，點(diǎn)擊任意菜單即可開通分析服務(wù)。

然后進(jìn)入“項(xiàng)目接入設(shè)置”頁面，設(shè)置數(shù)據(jù)存儲位置、時(shí)區(qū)、貨幣、設(shè)置用戶數(shù)據(jù)留存時(shí)間、設(shè)置自然周定義后，單擊“完成”，即完成Analytics Kit服務(wù)開通。

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

建議使用Cocoapods集成，如果不想使用Cocoapods，則可以手動集成。

1. 添加AppGallery Connect配置文件

a. 點(diǎn)擊下載 agconnect-services.plist 以獲取你的iOS 配置文件(agconnect-services.plist)。

b. 將配置文件移至 Xcode 項(xiàng)目的根目錄中。

2. 編輯Podfile文件

a. 如果你沒有Podfile，請創(chuàng)建一個(gè)：

$ cd your-project-directory

$ pod init

b. 將想要用在應(yīng)用中的 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 中查看該項(xiàng)目：

$ pod install

$ open your-project.xcworkspace

三、接入Analytics

1.在你的應(yīng)用中初始化Analytics SDK

最后一步是在你的應(yīng)用中添加初始化代碼。在AppDelegate中通過config接口完成初始化。

Objective C代碼：在AppDelegate.m中進(jìn)行初始化。

  #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中進(jìn)行初始化。

  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 接口記錄定義事件。

如果你不確定如何標(biāo)記事件，請查看事件說明。

3. 參考“API說明”，調(diào)用接口實(shí)現(xiàn)各類功能。

另外，在開發(fā)過程中，推薦大家啟用調(diào)試模式，借助華為分析的應(yīng)用調(diào)試功能，實(shí)時(shí)查看事件的上報(bào)情況，觀察具體結(jié)果并根據(jù)需要進(jìn)行調(diào)整。

開啟/停用調(diào)試模式

1.開啟調(diào)試模式：

Xcode菜單選擇“Product > Scheme > Edit Scheme”,然后選擇第二個(gè)頁簽“Arguments”，單擊“+”號增加一個(gè)參數(shù)“-HADebugEnabled”,添加完成后單擊右下角的“Close”按鈕進(jìn)行保存。

     -HADebugEnabled

2.停用調(diào)試模式：

     -HADebugDisabled

數(shù)據(jù)成功上報(bào)后，華為分析的應(yīng)用調(diào)試界面會展示出數(shù)據(jù)，如下圖：

補(bǔ)充：

Q: 集成華為分析服務(wù)iOS SDK后，運(yùn)行時(shí)不打日志？

A: 該問題是沒有設(shè)置日志運(yùn)行參數(shù)導(dǎo)致的。您可通過增加運(yùn)行參數(shù)來調(diào)整日志級別：有如下四個(gè)級別的可選項(xiàng)：-HALogLevelDebug、-HALogLevelInfo、-HALogLevelWarn、-HALogLevelError，以-HALogLevelDebug為例；

Xcode菜單選擇“Product >  Scheme >  Edit Scheme”,然后選擇第二個(gè)頁簽“Arguments”，點(diǎn)擊“+”號增加一個(gè)參數(shù)“-HALogLevelDebug”,添加完成后點(diǎn)擊右下角的“Close”按鈕進(jìn)行保存。