Hive SDK 開發流程¶
從安裝 Hive SDK 到應用程式分發的整個流程摘要如下。
1. 安裝¶
要在您的應用中使用 Hive SDK 實現身份驗證和支付等功能，首先請註冊 Hive 控制台並創建一個 AppID。然後，安裝適合您開發環境的 Hive SDK。
安裝前的準備¶
大部分的 Hive SDK 功能需要在 Hive 控制台中输入数据。因此，要使用 SDK，您必须首先注册 Hive 控制台 并创建一个 AppID。
SDK 安裝¶
在控制台中创建 AppID 后，安装 SDK。Hive SDK 可能会根据开发引擎（Unity、Unreal Engine 等）和操作系统（Android、iOS）有不同的 安装 方法。例如，如果您使用 Unity 引擎开发应用程序，可以方便地使用 SDK 管理器 安装最新的 SDK 版本，但如果您在原生 Android 环境中开发应用程序，则需要使用 Gradle 安装 SDK。
安裝功能¶
完成 Hive SDK 的安裝後，您需要 安裝您將使用的 SDK 功能。該 SDK 提供各種功能，例如身份驗證、支付、推送通知、促銷和配對，建議將 身份驗證和支付功能設為必需，其餘功能設為可選。
Note
安裝身份驗證功能意味著選擇所需的身份提供者 (IdP)，例如 Google 登錄、Apple 登錄等。即使並非所有 IdP 都已安裝，默認情況下也支持訪客登錄。首次使用 Hive SDK 的開發人員可以僅通過訪客登錄快速體驗 Hive SDK。
2. 環境設置¶
如果SDK安裝完成，您將配置SDK環境。有必要的設置和可選的設置。
(必填) 基本設定: hive_config.xml¶
hive_config.xml 是一個包含 SDK 功能所需的基本配置值的文件，並包含在應用程序構建中。要使用 SDK，您需要在 Hive 控制台中輸入生成的 AppID 以及您將在此文件中使用的 IdP。SDK 在 初始化 時將 hive_config.xml 包含在應用程序構建中。
與SDK安裝一樣，hive_config.xml的配置方法可能會根據開發引擎（Unity、Unreal Engine等）和操作系統（Android、iOS）而有所不同。例如，在使用Unity引擎開發應用程序時，您可以使用Unity Inspector生成hive_config.xml，而無需直接在hive_config.xml中輸入配置值，而在本地環境中，您需要手動創建此文件並直接輸入值。
（可選）特定市場設定¶
如果您想在 PC 上使用特定的应用市场，例如 Google Play Games、Amazon、Steam（Windows），则需要额外的配置。需要额外设置。
(可選) 運行設定¶
一些 SDK 設定 應該在應用程式運行時而不是在 SDK 初始化（建構時）期間進行。 然而，在實時服務期間更改運行時設置並不建議。
3. 開發¶
完成日誌設置和開發準備後，實現所需的功能在應用程式中。您需要將整個應用程式源代碼中根據應用程式生命週期發生的事件傳遞給Hive SDK，並調用接收這些事件的SDK方法。以下是開發SDK時需要了解的關鍵項目。
SDK 初始化¶
SDK 初始化 是執行 SDK 功能的第一步準備。在 SDK 代碼流程中，首先執行初始化，並在初始化完成後，可以使用各種 SDK 功能，例如身份驗證、支付和促銷。
SDK在初始化过程中显示条款协议屏幕（例如，当应用用户运行应用时显示的设备识别信息收集和个人信息收集同意弹出窗口）。SDK的主要优点之一是它允许轻松便捷地实施符合合规要求的条款协议请求。
初始化完成後，您可以在 Hive 控制台中檢查設備識別信息和登錄時支持的 IdP 列表。
登入¶
當應用程式使用者使用先前設置的身份提供者（IdP）登錄時，SDK 會獲取用戶識別信息。您可以使用這些信息來識別用戶並提供服務。
在實現登錄時，必須實施異常處理。異常處理對於由SDK配置錯誤或已成功登錄的用戶引起的問題是必要的。需要作為異常處理的用戶示例包括被暫停用戶的登錄和解決帳戶衝突的過程。
如果應用程式使用者已成功登入，則必須驗證登入令牌。SDK 發出一個可以驗證的令牌，以確定使用者是否不當，並且這個 令牌可以被驗證 以確定該令牌是否未被偽造。
付款¶
計費 功能顯示應用程式中銷售的產品列表，並允許應用程式用戶購買這些產品。在應用程式中實現商店並銷售應用內產品時，產品列表會被公開，銷售產品資訊會根據國家、貨幣類型和語言提供不同的資訊。每個產品都有一個產品識別碼，用於區分每個產品的資訊。
當您在應用內商店中銷售產品時，SDK 會發出收據。您的應用必須接收此收據數據並調用收據驗證 API來驗證收據。如果收據有效，應用將向購買該產品的用戶提供該產品。一旦產品交付完成，SDK 將宣告支付交易結束。
當支付交易終止被宣告時，購買的收據不能用於產品恢復。如果應用程序用戶已從應用內商店購買了產品，但因任何原因未將產品交付給用戶，則可以使用發出的收據再次嘗試交付該產品。
除錯¶
啟用 logging 允許您檢查開發問題並執行調試。如果開發引擎是 Unity，則支持使用 RTT4U 進行實時調試。
4. 建立¶
在構建之前需要檢查的項目，取決於開發引擎、操作系統或構建管道。例如，在 Android 環境（原生 Android 和 Unity Android）中，權限會自動包含在 SDK 中，因此不需要額外的配置。相反，在原生 iOS 環境中，必須根據應用程序打算使用的功能在構建之前聲明權限。在 Unity iOS 環境中，只有必要的權限可以通過 HivePostProcess Editor 自動添加。
Note
Android OS 支援多語言資源的優化。您可以從應用程式中移除未使用的語言或將語言添加到應用程式中。
5. 部署¶
在將應用程式分發到應用市場（Google Play 商店、App Store 等）之前，您必須確保應用程式根據 Hive 平台的 政策 進行良好的實施，並且您必須向應用市場提交 應用程式收集的個人數據的類型和目的。請參考 Hive SDK 或第三方庫用於提交的個人信息指南。