使用HarmonyNext SDK必備操作，缺少任意步驟都可能造成集成失敗或者數據丟失

1. 快速集成

在QuickTracking后臺，為每一個應用生成了專屬的集成代碼，可以根據產品內的引導進行集成。

1.1. 進入產品后臺

QuickTracking【首頁】-【管理控制臺】

1.2. 找到應用歸屬組織

在【管理控制臺】進入【組織列表】功能，組織列表展示當前創建的組織，找到應用歸屬組織

1.3. 找到待集成應用

2. 集成代碼明細

如果因為特定原因，無法訪問上述頁面，可以通過查看本章節進行SDK集成

2.1. 參數準備

appKey：在應用列表中獲取

收數域名：在【管理控制臺】-【采集信息】模塊中獲取

2.2. 引入SDK

系統 API 要求，HarmonyNext API 12及以上，目前僅支持普通應用的Stage模型，暫不支持元服務

2.2.1. 離線安裝SDK

引入離線版本鴻蒙SDK

{
  "modelVersion": "5.0.0",
  "description": "Please describe the basic information.",
  "dependencies": {
    "@quicktracking/common": "file:./lib/common.har",
    "@quicktracking/analytics": "file:./lib/qt_tongji.har",
  },
  "devDependencies": {
    "@ohos/hypium": "1.0.18",
    "@ohos/hamock": "1.0.0"
  }
}

SDK文件位置

2.2.2. 引入配置（非必選）

在項目工程的AppScope/resources/rawfile目錄下新增一個配置文件qtconfig.json

{
  "appKey": "您應用自己的appKey", //可選
  "channel": "您應用的發布渠道", //可選
}

注意如果初始化的時候構建UMConfig時傳入上述信息，以初始化時的值為準

2.2.3. 權限配置

在需要使用SDK的模塊的module.json5文件中添加權限聲明

"requestPermissions": [
  {
    "name": "ohos.permission.INTERNET"
  },
  {
    "name": "ohos.permission.GET_NETWORK_INFO"
  },
  {
    "name": "ohos.permission.APP_TRACKING_CONSEN"  //可選，如您需要采集華為廣告標識符
  }
],

！！注意：根據華為官網文檔說明對于OAID的采集需要用戶主動在設備設置界面開啟，具體步驟請參考華為官方文檔

2.2.4. 使用標準化的OHMUrl格式

請設置useNormalizedOHMUrl為true，查看工程級build-profile.json5：

{
  "app": {
    "signingConfigs": [],
    "products": [
      {
        "name": "default",
        "signingConfig": "default",
        "compatibleSdkVersion": "5.0.0(12)",
        "runtimeOS": "HarmonyOS",
        "buildOption": {
          "strictMode": {
            "useNormalizedOHMUrl": true
          }
        }
      }
    ],
  
  }
}