Android Native
Android Native 설치 가이드¶
Hercules Android Native Library는 Maven Central을 통해 설치할 수 있습니다.
1. Maven Central 저장소 설정¶
프로젝트의 settings.gradle 또는 settings.gradle.kts에서 Maven Central 저장소가 등록되어 있는지 확인합니다.
dependencyResolutionManagement의 repositories에 mavenCentral()이 이미 있다면 별도 설정은 필요하지 않습니다.
기존 dependencyResolutionManagement가 있지만 mavenCentral()이 없다면 기존 repositories에 mavenCentral()을 추가합니다.
settings.gradle 또는 settings.gradle.kts에서 저장소를 관리하지 않는 프로젝트라면 Hercules를 사용하는 모듈의 build.gradle 또는 build.gradle.kts에 다음 내용을 추가합니다.
Warning
기존 repositories 항목이 있는 경우 해당 항목을 삭제하거나 덮어쓰지 말고 mavenCentral()만 추가합니다.
2. Hercules 종속성 추가¶
Hercules를 사용할 Android 모듈의 build.gradle 또는 build.gradle.kts에 Hercules 종속성을 추가합니다.
Gradle (Groovy DSL)¶
Kotlin DSL¶
Gradle Sync를 실행하면 Maven Central에서 Hercules AAR이 자동으로 다운로드됩니다.
3. C/C++에서 Hercules 사용¶
Hercules의 지원 ABI는 다음과 같습니다.
C/C++에서 API를 사용하는 경우 Android 모듈에서 Prefab을 활성화합니다.
Gradle (Groovy DSL)¶
Kotlin DSL¶
이후 사용하는 네이티브 빌드 시스템에 따라 CMake 또는 ndk-build 설정을 추가합니다.
4. CMake 설정¶
ndk-build를 사용하거나 C/C++에서 사용하지 않는 경우 CMake 설정을 건너뜁니다.
4.1 Gradle에 CMake 연결¶
Hercules를 사용하는 모듈의 Gradle 설정에서 CMakeLists.txt를 연결합니다.
Gradle (Groovy DSL)¶
Kotlin DSL¶
이미 CMake를 사용하고 있는 프로젝트라면 기존 externalNativeBuild 설정을 그대로 사용합니다.
4.2 CMakeLists.txt에 Hercules 연결¶
Hercules Prefab 패키지를 find_package로 가져온 후 Hercules를 사용할 네이티브 타겟에 연결합니다.
예를 들어 프로젝트의 네이티브 라이브러리 이름이 native-lib인 경우:
cmake_minimum_required(VERSION 3.22.1)
project("sample")
add_library(native-lib SHARED
native-lib.cpp
)
find_package(Hercules REQUIRED CONFIG)
target_link_libraries(native-lib
Hercules::Hercules
)
5. ndk-build 설정¶
CMake를 사용하거나 C/C++에서 사용하지 않는 경우 ndk-build 설정을 건너뜁니다.
5.1 Gradle에 ndk-build 연결¶
Hercules를 사용하는 모듈의 Gradle 설정에서 Android.mk를 연결합니다.
Gradle (Groovy DSL)¶
Kotlin DSL¶
이미 ndk-build를 사용하고 있는 프로젝트라면 기존 externalNativeBuild 설정을 그대로 사용합니다.
5.2 Android.mk에 Hercules 연결¶
Hercules를 사용할 네이티브 모듈의 LOCAL_SHARED_LIBRARIES에 Hercules를 추가하고 Prefab 모듈을 import합니다.
예를 들어 프로젝트의 네이티브 라이브러리 이름이 native-lib인 경우:
LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS)
LOCAL_MODULE := native-lib
LOCAL_SRC_FILES := native-lib.cpp
LOCAL_SHARED_LIBRARIES := Hercules
include $(BUILD_SHARED_LIBRARY)
$(call import-module,prefab/Hercules)
NDK r21 미만도 지원해야 하는 경우 Prefab import 전에 다음 설정을 추가합니다.
ifneq ($(call ndk-major-at-least,21),true)
$(call import-add-path,$(NDK_GRADLE_INJECTED_IMPORT_PATH))
endif
6. API 사용¶
예:
#include <Hercules.h>
...
unsigned int version = HerculesGetVersion();
__android_log_print(ANDROID_LOG_INFO, "Hercules", "version: %u", version);
초기화는 Hive SDK가 초기화 될 때 함께 이루어집니다.
InitializeHercules 호출은 필요하지 않습니다.
7. 버전 변경¶
설치할 Hercules 버전을 변경하려면 dependencies에 지정된 버전을 변경합니다.
Gradle (Groovy DSL)¶
Kotlin DSL¶
8. Hercules 제거¶
Hercules를 제거하려면 해당 모듈의 dependencies에서 Hercules 종속성을 삭제합니다.
C/C++에서 Hercules를 사용했다면 CMake 또는 ndk-build에 추가했던 Hercules 연결 설정도 함께 제거합니다.
CMake:
ndk-build:
Hercules 외에 Prefab 패키지를 사용하는 종속성이 없다면 Gradle의 buildFeatures.prefab 설정도 제거할 수 있습니다.