如何使用高级功能

为Android配置¶

要使用Hercules的高级功能，应在Android Gradle模块中启用预制件功能。

设置您的 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 预处理器标志。
- 玩家设置 → 其他设置 → 脚本编译 → 脚本定义符号
启用允许“非安全”代码。
- 玩家设置 → 其他设置 → 脚本编译 → 允许“非安全”代码

为虚幻引擎配置¶

Hive SDK 虚幻插件中包含的 Hercules 模块不支持 Hercules 高级功能。
要在虚幻环境中使用 Hercules 高级功能，请参见下文。

hive::Configuration::setUseHercules(false);

在插件目录顶部的Hercules文件夹中找到头文件和库，并将它们添加到您的游戏项目中
如果在HIVESDK.Build.cs中设置了Target.Platform == UnrealTargetPlatform.Win64，则需要如下所示的.lib设置。

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