前提條件

• 已創建項目和應用。具體操作請參見創建項目和應用。

• 已下載iOS配置文件。具體操作請參見下載配置文件。

  iOS配置文件：AliyunEmasServices-Info.plist

使用限制

• 僅支持iOS 8.0及以上的App。

接入概述

通過iOS SDK接入性能分析服務的操作步驟如下：

1. 添加依賴：采用Pod方式集成SDK。

2. 接入服務：初始化SDK，接入服務。

3. 編譯：修改編譯設置。

添加依賴

1. 指定官方倉庫和阿里云倉庫。

   source "https://github.com/CocoaPods/Specs.git"
   source "https://github.com/aliyun/aliyun-specs.git"

2. 添加依賴。

   pod 'AlicloudAPM', '1.1.1'

   說明

   執行pod search AlicloudAPM命令，查詢AlicloudAPM最新版本。

3. 執行pod update命令，保存設置。

接入服務

1. 將iOS配置文件AliyunEmasServices-Info.plist拷貝至項目根目錄。

   說明

   iOS配置文件的獲取方式請參見前提條件。

2. 在AppDelegate.m文件的application:didFinishLaunchingWithOptions方法中初始化SDK。

   引入頭文件：

   #import <AlicloudAPM/AlicloudAPMProvider.h>
   #import <AlicloudHAUtil/AlicloudHAProvider.h>

   添加代碼段：

   NSString *appVersion = @"xxx";  
   NSString *channel = @"xxx";  
   NSString *nick = @"xxx"; 
   [[AlicloudAPMProvider alloc] autoInitWithAppVersion:appVersion channel:channel nick:nick];
   [AlicloudHAProvider start];

   配置說明：

   配置項	說明
   appVersion	用于指定App的版本，上報至服務端，進行版本區分。 【數據類型】字符串 【格式要求】自定義 【取值范圍】任意長度 說明 該參數值將在控制臺顯示為下拉列表選項，建議短小凝練。 【是否必選】是 【是否可為空】否 【默認值】無 【大小寫敏感】是。例如，vx.x和Vx.x不是一個版本。 【字符類型】英文大小寫、數字。 說明 該參數不支持中文字符、特殊字符。 【示例】NSString *appVersion = @"2.3";
   channel	用于指定渠道標識，上報至服務端，進行渠道區分。 【數據類型】字符串 【取值范圍】任意長度 【是否必選】是 【是否可為空】否 【默認值】無 【字符類型】英文大小寫、數字。 說明 該參數不支持中文字符、特殊字符。 【示例】NSString *channel = @"appstore";
   nick	用于指定用戶昵稱，上報至服務端，進行用戶區分。后續可能依據該參數，進行數據檢索。 【數據類型】字符串 【取值范圍】任意長度 【是否必選】是 【是否可為空】否 【默認值】無 【字符類型】英文大小寫、數字。 說明 該參數不支持中文字符、特殊字符。 【命名規范】自定義 【示例】NSString *nick = @"john";

編譯

1. 在項目的Build Setting中，將Allow Non-modular Includes In Framework Modules設置為YES。

   

2. 執行編譯。

樣例代碼

性能分析服務iOS SDK接入工程樣例請參見Demo工程。

功能驗證

iOS SDK接入操作完成后，可操作App，查看性能分析服務控制臺顯示數據，進行功能驗證。

1. 手機端：啟動App。（2分鐘后）控制臺：查看概覽頁簽的啟動速度是否顯示數據。

2. 手機端：在App中跳轉幾個頁面。（2分鐘后）控制臺：查看概覽頁簽的加載時間是否顯示數據。

如數據顯示正常，則iOS SDK接入成功；

否則，可能的原因是：SDK接入失敗、SDK未獲取數據、數據發送失敗、后端問題，請聯系技術支持解決。