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。

Info

您可以从下载页面下载每个开发引擎的最新SDK版本和示例应用程序。
最新的SDK版本也通过Maven（Android）和Cocoapod（iOS）分发。

安装功能¶

在完成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将声明支付交易结束。

当支付交易终止被声明时，购买的收据无法用于产品恢复。如果应用用户从应用内商店购买了产品，但由于任何原因产品未交付给用户，则可以使用已发出的收据尝试再次交付该产品。

调试¶

启用日志记录可以让您检查开发问题并进行调试。如果开发引擎是Unity，则支持使用RTT4U进行实时调试。

4. 构建¶

在构建之前需要检查的项目，具体取决于开发引擎、操作系统或构建管道。例如，在Android环境（原生Android和Unity Android）中，权限会自动包含在SDK中，因此不需要额外的配置。相反，在原生iOS环境中，必须根据应用程序打算使用的功能在构建之前声明权限。在Unity iOS环境中，仅可以使用HivePostProcess Editor自动添加必要的权限。

Note

Android 操作系统支持多语言资源的优化。您可以从应用中删除未使用的语言或向应用中添加语言。

5. 部署¶

在将应用程序分发到应用市场（Google Play 商店、App Store 等）之前，您必须确保该应用程序根据 Hive 平台的政策得到良好的实施，并且您必须向应用市场提交应用程序收集的个人数据的类型和目的。请参考 Hive SDK 或第三方库用于提交的个人信息指南。