如何使用高级功能

為 Android 配置¶

要使用 Hercules 的高級功能，應在 Android Gradle 模塊中啟用 prefab 功能。

設定您的 Android Studio 專案¶

對於 Android Gradle 插件 < 4.1
- 將以下內容添加到您的 gradle.properties 文件中。
```
android.enablePrefab=true
```
對於 Android Gradle 插件 ≥ 4.1
- 將以下內容添加到 build.gradle 文件中的 android 區塊。
```
android {
    ...
    buildFeatures {
        prefab true
    }
}
```

設定 CMake / ndk-build（使用 C/C++ 時）¶

對於 NDK ≥ r21

// When using CMake
find_package(hercules REQUIRED CONFIG)

target_link_libraries(
  ...
  hercules::Hercules
)

// When using Android.mk
LOCAL_SHARED_LIBRARIES := Hercules

ifneq ($(call ndk-major-at-least,21),true)
    $(call import-add-path,$(NDK_GRADLE_INJECTED_IMPORT_PATH))
endif
$(call import-module, prefab/hercules)

NDK < r21

將Hercules.h檔案添加到您的專案中，並使用.so檔案路徑的直接連結。

// CMake
target_link_libraries(
    ...
    ${CMAKE_CURRENT_SOURCE_DIR}/../build/intermediates/merged_native_libs/${CMAKE_BUILD_TYPE}/out/lib/${ANDROID_ABI}/libHercules.so
)

// Android.mk
include $(CLEAR_VARS)
LOCAL_MODULE := Hercules
LOCAL_SRC_FILES := ../build/intermediates/merged_native_libs/debug/out/lib/$(TARGET_ARCH_ABI)/libHercules.so
include $(PREBUILT_SHARED_LIBRARY)
LOCAL_SHARED_LIBRARIES := Hercules

配置 iOS¶

如何配置¶

在通过 CocoaPods 安装的 Hercules 框架的路径下找到 .h 文件，并将其导入到项目中。
您可以选择并使用模拟器或设备目标路径中包含的任何头文件。

路徑是： ${PROJECT_ROOT_DIR}/Pods/Hercules/Hive_SDK_iOS_External_${HIVE_SDK_VERSION}/Hercules.xcframework/${SIMULATOR_OR_PHONEOS}/Hercules.framework/Headers/Hercules.h

為 Unity 配置¶

專案設定¶

將 USE_HERCULES 添加到 Unity 預處理器標誌。
- 玩家設定 → 其他設定 → 腳本編譯 → 腳本定義符號
啟用允許「不安全」代碼。
- 玩家設置 → 其他設置 → 腳本編譯 → 允許「不安全」代碼

為 Unreal 配置¶

Hive SDK Unreal 插件中包含的 Hercules 模組不支持 Hercules 高級功能。
要在 Unreal 環境中使用 Hercules 高級功能，請參見下文。

hive::Configuration::setUseHercules(false);

在插件目錄頂部的Hercules文件夾中找到標頭和庫，並將它們添加到您的遊戲項目中
如果在HIVESDK.Build.cs中設置了Target.Platform == UnrealTargetPlatform.Win64，則需要如下所示的.lib設置。

PublicAdditionalLibraries.Add(ModuleDirectory + "/ThirdParty/windows/lib/Hercules.lib");