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 Hive Config Editor生成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 发出一个可以验证的令牌，以确定用户是否不当，并且这个 令牌可以被验证 以确定该令牌未被伪造。
付款¶
Billing 是一個功能，顯示應用程式中銷售的產品列表給應用程式用戶，並允許他們購買這些產品。如果您在應用程式中實現商店並銷售應用內產品，您將公開產品列表，並根據國家、貨幣類型和語言提供不同的銷售產品資訊。每個產品都有一個產品識別碼，用於區分每個產品的資訊。
當您在應用內商店銷售產品時，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 或第三方库用于提交的个人信息指南。