如何使用高级功能
為 Android 配置¶
要使用 Hercules 的高級功能,應在 Android Gradle 模塊中啟用 prefab 功能。
設定您的 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 預處理器標誌。
- 玩家設定 → 其他設定 → 腳本編譯 → 腳本定義符號
-
啟用允許「不安全」代碼。
- 玩家設置 → 其他設置 → 腳本編譯 → 允許「不安全」代碼
為 Unreal 配置¶
Hive SDK Unreal 插件中包含的 Hercules 模組不支持 Hercules 高級功能。
要在 Unreal 環境中使用 Hercules 高級功能,請參見下文。
- 在插件目錄頂部的Hercules文件夾中找到標頭和庫,並將它們添加到您的遊戲項目中
- 如果在HIVESDK.Build.cs中設置了
Target.Platform == UnrealTargetPlatform.Win64
,則需要如下所示的.lib設置。