iOS

Hive SDK for iOS 提供促銷功能。本文件描述如何配置 iOS 應用以使用促銷功能。

添加框架¶

將框架添加到您項目目錄中的 Podfile。詳細說明請參見添加框架。

pod 'HivePromotion', $HIVE_SDK_VERSION # Framework for the Promotion feature

在保存添加了框架的 Podfile 之后，执行以下命令将框架安装到您的项目中。

pod install

設定深層連結¶

深度連結是一個連結，當應用程式啟動後，將使用者帶到應用程式中的特定位置。Hive SDK for iOS 支援處理深度連結方案在促進用戶參與。

在 Xcode 项目窗口中，在项目导航器中选择您的项目。
从 TARGETS 列表中选择您的应用程序。
点击信息选项卡。
在信息选项卡中点击 URL 类型 项。
点击 + 图标以创建 附加 URL 类型属性 项。
在 附加 URL 类型属性 项下的 标识符 和 URL 方案 字段中输入您的应用程序 ID。

使用以下代碼，您可以創建一個 HTML 頁面，以在安裝遊戲的應用程序中顯示，以測試 URL Scheme 的行為。請注意，鏈接地址必須與配置深層鏈接時設置的 URL 相同。

<a href="com.com2us.myapp://">TEST</a>

設定延遲深層連結（通用連結）¶

Universal Link 使得應用程式的安裝和啟動透過邀請頁面以及邀請者獎勵成為可能，這是第一次。 Hive SDK for iOS 支援基於 URI Scheme 和基於 Universal Link 的延遲深度鏈接。

通過基於 Universal Link 的邀請鏈接邀請用戶並獎勵邀請者需要 UIPasteboard 粘貼系統權限。當被邀請的用戶使用邀請鏈接首次安裝並啟動應用程序時，iOS 16.1 以下版本可能會出現一個提示彈出窗口，而 iOS 16.1 及以上版本可能會出現系統權限請求彈出窗口。要防止系統權限請求彈出窗口出現，請參閱開發者網站上的促銷操作指南並禁用延遲深度鏈接設置。

Note

有關生成基於通用鏈接的邀請者鏈接的額外控制台設置說明，請參閱開發者網站上的推廣操作指南。
開發者無法自定義系統權限請求彈出窗口的文本。

Xcode 專案設定¶

選擇您的 Xcode 專案的主要目標，並在簽名和功能標籤的關聯域部分按以下方式配置域。

applinks:sandbox-promotion.qpyou.cn: 在 Hive 沙盒服务器环境中运行的通用链接域名。
applinks:promotion.qpyou.cn: 在 Hive 商业服务器环境中运行的通用链接域名。

伺服器設定¶

將以下列出的值根據給定格式修改為您的環境，並將其保存為 apple-app-site-association。

團隊識別碼: 在 Apple 開發者控制台中找到的團隊識別碼
包識別碼: 將使用通用連結的應用程式的包識別碼
URL 路徑: 支持通用連結的 HTTP URL

上傳到網頁伺服器的根目錄或.well-known子目錄。雖然apple-app-site-association文件的格式是JSON，但它沒有擴展名。

{
   "applinks": {
       "apps": [],
       "details": [
           {
               "appID": "--TEAM ID.--Bundle Identifier",
               "paths": ["--URL Path"]
           }
       ]
   }
}

以下是來自蘋果的範例。

{
   "applinks": {
       "apps": [],
       "details": [
           {
               "appID": "9JA89QQLNQ.com.apple.wwdc",
               "paths": ["/wwdc/news/", "/videos/wwdc/2015/*"]
           }, {
               "appID": "ABCD1234.com.apple.wwdc",
               "paths": ["*"]
           }
       ]
   }
}

iOS 應用程式設置¶

在您的 Xcode 项目中遵循以下指示。

在 Xcode 项目窗口中，在项目导航器中选择您的项目。
从 TARGETS 列表中选择您的应用程序。
点击“签名与能力”选项卡。
點擊簽名和能力標籤左上角的 + 能力 按鈕。
從列表中選擇並添加關聯域。 applinks:[apple-app-site-association] 上傳的域名（例如：applinks:hive-ota.withhive.com)
在Apple Developer Console中啟用應用程式的功能中的關聯域。

hive_config.xml 設定¶

按照以下方式添加/修改hive_config.xml文件：

<universalLink>Universal link address (Domain/Path) </universalLink>