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 이상 사용시

  • NDK r21 미만 사용시
    • Hercules.h 파일을 별도로 프로젝트에 추가하고 .so 파일 경로를 직접 링크하여 사용합니다.

    • iOS 설정하기

    설정방법

  • CocoaPods를 통해 프로젝트에 설치된 Hercules 프레임워크의 경로 하위에서 .h를 찾아 프로젝트에 import 해줍니다. 시뮬레이터 혹은 디바이스 타겟 경로에 포함되어 있는 헤더 중 아무 것이나 선택하여 사용해도 무방합니다. 경로는 다음과 같습니다.
    • “${PROJECT_ROOT_DIR}/Pods/Hercules/Hive_SDK_iOS_External_${HIVE_SDK_VERSION}/Hercules.xcframework/${SIMULATOR_OR_PHONEOS}/Hercules.framework/Headers/Hercules.h”

    • Unity 설정하기

    모바일

  • Unity 전처리기 플래그에 USE_HERCULES를 추가합니다.
    • Player Settings -> Other Settings -> Script Compilation -> Scripting Define Symbols

  • Allow ‘unsafe’ Code를 허용하도록 체크합니다.
    • Player Settings -> Other Settings -> Script Compilation -> Allow ‘unsafe’ Code

    • Windows

    • Scripting Define Symbols에 USE_HERCULES 입력 합니다.
    • Allow ‘unsafe’ Code를 체크 합니다.
    • HerculesPlugin를 사용 해서 Hercules 추가 API를 사용 합니다.

    Unreal 설정하기

    모바일

    Hive SDK Unreal Plugin이 포함하는 허큘리스 모듈은 허큘리스 추가 기능을 지원하지 않습니다. Unreal 환경에서 허큘리스 추가 기능을 사용하려면 아래를 참고하세요.

    1. Hive SDK Unreal Plugin에 포함된 허큘리스 모듈 제거

    2. 제거한 허큘리스 모듈을 사용하지 않도록 설정

    3. 플러그인 최상단에 위치한 Hercules 폴더에 있는 헤더와 라이브러리를 게임 프로젝트에 추가

    Windows

    HIVESDK.Build.cs에서 Target.Platform == UnrealTargetPlatform.Win64이면 아래와 같이 .lib 설정이 요구됩니다.

    설정을 완료한 후, 아래 예시와 같이 추가 기능을 사용합니다.