如何使用高级功能
为Android配置¶
要使用Hercules的高级功能,应在Android Gradle模块中启用预制件功能。
设置您的 Android Studio 项目¶
-
对于 Android Gradle 插件 < 4.1
- 将以下内容添加到您的 gradle.properties 文件中。
-
对于 Android Gradle 插件 ≥ 4.1
- 将以下内容添加到 build.gradle 文件中的 android 块中。
设置 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 高级功能,请参见下文。
- 在插件目录顶部的Hercules文件夹中找到头文件和库,并将它们添加到您的游戏项目中
- 如果在HIVESDK.Build.cs中设置了
Target.Platform == UnrealTargetPlatform.Win64
,则需要如下所示的.lib设置。