跳转至

Unity Windows

Hive SDK Unity Windows 应用程序开发在开发后构建应用程序时需要以下设置。

构建预配置

在构建 Windows 项目之前，请在编辑器的 文件 > 构建设置... 中配置以下设置：

  1. 设置构建：
    • 目标操作系统：Windows
    • 架构：x86_64
    • 生成 Visual Studio 解决方案（构建方法取决于是否选择）
  2. 配置播放器：您可以通过按下构建设置窗口左下角的 播放器设置... 按钮或在检查器窗口的 播放器 类别中进行设置。
    • 脚本后端：IL2CPP
    • API 兼容性级别：.NET Standard 2.1
    • Windows 的自动图形 API：Direct3D11 或 OpenGLCore
  3. 配置HIVE_PLUGIN.dll 文件：请参考下图，并在 检查器 窗口中将HIVE_PLUGIN.dll 文件设置在Assets\Hive_SDK_v4\Plugins\Windows 文件夹中。

构建配置

根据在构建配置中是否选择了 生成 Visual Studio 解决方案，请按照下面的 选项 1. 或 选项 2. 进行操作。

选项 1. Visual Studio 解决方案生成: 假

  1. 在编辑器的项目中准备Assets\Plugins\Windows\res\hive_config.xml文件。
  2. Hive SDK附加文件（资源文件，如.dll, .pak,.bin）被复制到Unity Build生成的可执行文件夹中，使用Assets\Hive_SDK_v4\Editor\HivePostprocess.cs进行复制。如果未进行复制，请直接按如下方式复制：
  3. Assets\Hive_SDK_v4\Plugins\desktop\hive_string → [可执行文件夹]\resources\hive_string
  4. Assets\Hive_SDK_v4\Plugins\Windows\additional → [可执行文件夹]（.meta文件除外）
  5. Assets\Plugins\Windows\res\hive_config.xml → [可执行文件夹]>\resources\hive_config.xml
  6. 版本设置也是通过脚本Assets\Hive_SDK_v4\Editor\HivePostprocess.cs使用项目中设置的版本进行的。如果生成的可执行文件的版本没有变化，可以直接在CMD或Powershell中使用Assets\Hive_SDK_v4\Plugins\Windows\postBuildUtil\rcedit.exe进行更改。
    • 参考
    • 示例：rcedit.exe "D:\Hive\_SDK\_UnityPlugin\_Sample\b\Hive\_SDK\_v4\_Unity.exe" --set-product-version 1.0.3 --set-file-version 1.0.3
    • 结果：

选项 2. Visual Studio 解决方案生成：真

在所需文件夹中执行Windows目标Unity构建，环境配置请参见构建预配置。

构建后配置

本节描述了构建 Hive SDK Unity Windows 应用后所需的设置。在 Unity 构建完成后，将生成以下文件。

  • 构建
  • Il2CppOutputProject
  • [项目名称] 文件夹
  • UnityPlayerStub
  • [项目名称].sln
  • UnityCommon.props
  • locales
  • resources
  • swiftshader
  • .dll
  • cef.subprocess.exe
  • .pak
  • .bin
  • icudtl.dat

版本设置

您可以通过修改WindowsPlayerVersion.rc文件中的FILEVERSION和PRODUCTVERSION来设置版本，该文件位于[项目名称]文件夹内。修改后的版本在与Hive服务器通信时用作appversion信息。

Visual Studio 构建和 Hive SDK 复制

  1. 使用 Visual Studio 打开sln，可执行文件将在构建过程中创建于build\bin\x64\Debug（或 Master）文件夹中。
  2. 在使用 Visual Studio 2019 运行 Unity 2018.4.17 的结果时，需要进行重新定位解决方案过程。
  3. 将 Unity 构建过程中创建的文件从文件夹复制到与可执行文件相同的文件夹中，排除[项目名称_Data].sln 和UnityCommon.props。
  4. 以相同的方式复制locales、resources 和 swiftshader 文件夹。
  5. 修改hive_config.xml的内容以匹配项目，并在可执行文件下的resources文件夹中指定位置。 （Appid、Google 相关、Facebook 相关）
  6. 如果游戏需要在hive_config.xml中输入市场值，请输入 HS，这是Hive 商店的市场代码。 （但是，在hive_config.xml中输入的市场值不会影响实际服务。）

  7. 将build\bin\项目名称_Data 文件夹复制到可执行文件所在的文件夹中。

  8. 在build\bin[项目名称_Data]\plugins中的文件（*.dll）是重复的，因此可以删除。

  9. 将额外的.dll和资源放置在build\bin[项目名称_Data]\plugins中，而不是可执行文件所在的文件夹是部分可行的，但有些功能无法正常工作，因此它被复制到可执行文件所在的文件夹中使用。
Note

Redistributable packages 在开发者的 PC 以外的环境中是必需的。
在调试模式下构建时，必须使用可再发行包的调试版本 DLL：vccorlib140d.dll, vcruntime140d.dll, cruntime140_1d.dll, ucrtbased.dll, msvcp140d.dll, concrt140d.dl

删除未使用的 XML 文件

如果您通过Unity包安装或更新了Hive SDK Unity，而不是通过Hive SDK管理器，则在构建应用程序之前，必须删除以下路径中所有HIVESDK_{library_name}Dependencies.xml文件。

  • 资产/Hive_SDK_v4/依赖
  • 资产/Hive_SDK_v4/编辑器

要删除的文件示例如下：

  • HIVESDK_DefaultDependencies.xml
  • HIVESDK_HerculesDependencies.xml
  • HIVESDK_HiveAnalyticsConsentModeDependencies.xml
  • HIVESDK_HiveDataStoreDependencies.xml
  • HIVESDK_HiveDeviceManagementDependencies.xml
  • HIVESDK_HiveGoogleInAppReviewDependencies.xml
  • HIVESDK_HiveGoogleInAppUpdateDependencies.xml
  • HIVESDK_HivePromotionDependencies.xml
  • HIVESDK_HiveRealNameVerificationDependencies.xml
  • HIVESDK_MarketAmazonDependencies.xml
  • HIVESDK_MarketAppleDependencies.xml
  • HIVESDK_MarketGoogleDependencies.xml
  • HIVESDK_MarketHiveStoreDependencies.xml
  • HIVESDK_MarketHuaweiDependencies.xml
  • HIVESDK_MarketLebiDependencies.xml
  • HIVESDK_MarketOneStoreDependencies.xml
  • HIVESDK_MarketSamsungDependencies.xml
  • HIVESDK_ProviderAdjustDependencies.xml
  • HIVESDK_ProviderAppleDependencies.xml
  • HIVESDK_ProviderAppleSignInDependencies.xml
  • HIVESDK_ProviderAppsFlyerDependencies.xml
  • HIVESDK_ProviderFacebookDependencies.xml
  • HIVESDK_ProviderFirebaseDependencies.xml
  • HIVESDK_ProviderGoogleDependencies.xml
  • HIVESDK_ProviderGooglePlayGamesDependencies.xml
  • HIVESDK_ProviderHiveMembershipDependencies.xml
  • HIVESDK_ProviderHuaweiDependencies.xml
  • HIVESDK_ProviderLineDependencies.xml
  • HIVESDK_ProviderQQDependencies.xml
  • HIVESDK_ProviderRecaptchaDependencies.xml
  • HIVESDK_ProviderSingularDependencies.xml
  • HIVESDK_ProviderVKDependencies.xml
  • HIVESDK_ProviderWechatDependencies.xml
  • HIVESDK_ProviderWeverseDependencies.xml
  • HIVESDK_PushAmazonAdmDependencies.xml
  • HIVESDK_PushGoogleFcmDependencies.xml