추가 기능 설정하기
Android 설정하기¶
Hercules 추가 기능 사용을 위해서는 Android Gradle 모듈에 prefab 기능이 사용 설정되어 있어야 합니다.
Android Studio 프로젝트 설정하기¶
-
Android Gradle Plugin 4.1 미만 사용시
- gradle.properties 파일에 아래와 같이 추가합니다.
-
Android Gradle 플러그인 4.1 이상 사용시
- build.gradle 파일에 있는 android 블록에 아래와 같이 추가합니다.
CMake / ndk-build 설정하기 (C/C++ 사용시)¶
- NDK r21 이상 사용 시
// CMake 사용시
find_package(hercules REQUIRED CONFIG)
target_link_libraries(
...
hercules::Hercules
)
// 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를 찾아 프로젝트에 import 해줍니다.
시뮬레이터 혹은 디바이스 타겟 경로에 포함되어 있는 헤더 중 아무 것이나 선택하여 사용해도 무방합니다.
경로는 다음과 같습니다.
Unity 설정하기¶
Project Settings 설정하기¶
-
Unity 전처리기 플래그에 USE_HERCULES를 추가합니다.
- Player Settings → Other Settings → Script Compilation → Scripting Define Symbols
-
Allow ‘unsafe’ Code를 허용하도록 체크합니다.
- Player Settings → Other Settings → Script Compilation → Allow ‘unsafe’ Code
Unreal 설정하기¶
Hive SDK Unreal Plugin이 포함하는 허큘리스 모듈은 허큘리스 추가 기능을 지원하지 않습니다.
Unreal 환경에서 허큘리스 추가 기능을 사용하려면 아래를 참고하세요.
- Hive SDK Unreal Plugin에 포함된 허큘리스 모듈 제거
-
플러그인 최상단에 위치한 Hercules 폴더에 있는 헤더와 라이브러리를 게임 프로젝트에 추가
- HIVESDK.Build.cs에서
Target.Platform == UnrealTargetPlatform.Win64
이면 아래 설정이 필요합니다.