跳轉至

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)將由Assets\Hive_SDK_v4\Editor\HivePostprocess.cs複製到Unity Build生成的可執行文件所在的文件夾。如果它們沒有被複製,請手動按以下方式複製:
    • Assets\Hive_SDK_v4\Plugins\desktop\hive_string → [可執行文件夾]\resources\hive_string
    • Assets\Hive_SDK_v4\Plugins\Windows\additional → [可執行文件夾](不包括.meta文件)
    • Assets\Plugins\Windows\res\hive_config.xml → [可執行文件夾]\resources\hive_config.xml
  3. 如果您在上一步中手動複製了文件,請將[可執行文件夾]\hive-sdk-res文件夾中的內容移動到[可執行文件夾]\resources文件夾。
    • 如果您已經移動了[可執行文件夾]\hive-sdk-res中的所有內容,可以刪除hive-sdk-res文件夾。
  4. 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文件中的FILEVERSIONPRODUCTVERSION来设置版本,该文件位于[项目名称]文件夹内。修改后的版本在与Hive 服务器通信时用作appversion信息。

Visual Studio 建置和 Hive SDK 複製

  1. 使用 Visual Studio 打开sln,可执行文件将在构建期间创建于build\bin\x64\Debug(或 Master)文件夹中。
  2. 在使用 Visual Studio 2019 运行 Unity 2018.4.17 的结果时,需要进行Retarget Solution 过程。
  3. 从 Unity 构建期间创建的文件夹中复制文件到与可执行文件相同的文件夹,排除[Project name_Data].slnUnityCommon.props
  4. 以相同的方式复制localesresourcesswiftshader 文件夹。
  5. 修改hive_config.xml的内容以匹配项目,并在可执行文件下的resources文件夹中指定位置。(Appid、Google 相关、Facebook 相关)
  6. 如果游戏需要在hive_config.xml中输入市场值,请输入 HS,这是Hive 商店的市场代码。(然而,在hive_config.xml中输入的市场值不会影响实际服务。)
  7. build\bin\Project name_Data folder复制到可执行文件所在的文件夹。

  8. build\bin[Project name_Data]\plugins中的文件(.dll)是重复的,因此可以删除。

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

Redistributable packages 在开发者的 PC 以外的环境中是必需的。
在调试模式下构建时,需要 redistributable 包的调试版本 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