Unity

사용할 Hive SDK 기능을 외부 라이브러리 형태로 추가합니다. Hive SDK는 인증, 결제, 푸시 알림, 광고 배너 등 다양한 기능을 제공하며, 개발자는 이중에서 사용할 기능만을 골라 설치해야 합니다. 여기에서는 가장 기본적인 기능인 인증과 결제 기능을 사용하는 예시를 안내합니다.

Hive SDK는 UnityPackage 버전에 External-Dependency-Manager for Unity(EDM4U) 패키지를 포함하여 배포하며, EDM4U 설정으로 빌드에 필요한 라이브러리를 자동 설치/배포하도록 구성되어 있습니다. EDM4U가 동작할 수 있는 빌드 환경이 마련되지 않았다면 이를 구축해야 합니다. EDM4U에서 제공하는 GUI를 이용하거나 Unix 셸인 Bash, 다시 말해 명령줄 인터페이스(CLI, Command Line Interface)를 통해서도 가능합니다.

수동 설치/업데이트 시 유의 사항¶

Hive SDK v4 24.3.0부터 Hive SDK Manager가 아니라 Unity 패키지로 Hive SDK Unity를 설치 또는 업데이트하는 경우, 앱을 빌드하기 전에 아래 경로에 있는 HIVESDK_{라이브러리_이름}Dependencies.xml 파일을 모두 삭제해야 합니다.

• Assets/Hive_SDK_v4/Dependencies
• Assets/Hive_SDK_v4/Editor

삭제해야할 파일들은 다음과 같습니다.

• HIVESDK_DefaultDependencies.xml
• HIVESDK_HerculesDependencies.xml
• HIVESDK_HiveAnalyticsConsentModeDependencies.xml
• HIVESDK_HiveDataStoreDependencies.xml
• HIVESDK_HiveDeviceManagementDependencies.xml
• HIVESDK_HiveGoogleInAppReviewDependencies.xml
• HIVESDK_HiveGoogleInAppUpdateDependencies.xml
• HIVESDK_HivePromotionDependencies.xml
• HIVESDK_HiveRealNameVerificationDependencies.xml
• HIVESDK_MarketAmazonDependencies.xml
• HIVESDK_MarketAppleDependencies.xml
• HIVESDK_MarketGoogleDependencies.xml
• HIVESDK_MarketHiveStoreDependencies.xml
• HIVESDK_MarketHuaweiDependencies.xml
• HIVESDK_MarketLebiDependencies.xml
• HIVESDK_MarketOneStoreDependencies.xml
• HIVESDK_MarketSamsungDependencies.xml
• HIVESDK_ProviderAdjustDependencies.xml
• HIVESDK_ProviderAppleDependencies.xml
• HIVESDK_ProviderAppleSignInDependencies.xml
• HIVESDK_ProviderAppsFlyerDependencies.xml
• HIVESDK_ProviderFacebookDependencies.xml
• HIVESDK_ProviderFirebaseDependencies.xml
• HIVESDK_ProviderGoogleDependencies.xml
• HIVESDK_ProviderGooglePlayGamesDependencies.xml
• HIVESDK_ProviderHiveMembershipDependencies.xml
• HIVESDK_ProviderHuaweiDependencies.xml
• HIVESDK_ProviderLineDependencies.xml
• HIVESDK_ProviderQQDependencies.xml
• HIVESDK_ProviderRecaptchaDependencies.xml
• HIVESDK_ProviderSingularDependencies.xml
• HIVESDK_ProviderVKDependencies.xml
• HIVESDK_ProviderWechatDependencies.xml
• HIVESDK_ProviderWeverseDependencies.xml
• HIVESDK_PushAmazonAdmDependencies.xml
• HIVESDK_PushGoogleFcmDependencies.xml

Android¶

Unity Android에서 Hive SDK 각 제품을 설치하는 방법을 안내합니다.

Android Resolver 설정¶

Unity를 실행해 Asset > External Dependency Manager > Android Resolver > Settings 메뉴를 클릭합니다.

Android Resolver Settings 창이 나타나면 빨간색으로 표시한 항목을 기본 설정으로 체크합니다.

Copy and patch settingsTempalte.gradle from 2022.2 항목은 Unity 2022.2 이상 버전에서만 체크하세요. Use Jetifier 기능은 Hive SDK에서 자동 지원하므로 선택 해제를 권장합니다.

Unity 최신 버전에서 Use Jetifier를 선택하면 Unity 가이드에 따라 Custom Gradle Properties Template을 생성해야 합니다.

ExternalDependency 설정¶

Hive > ExternalDependency 메뉴를 클릭합니다.

설정 창이 나타나면 사용하려는 Hive SDK 기능을 선택하세요. 예를 들어, Google 인증과 Google Play Store 결제 기능을 사용하려면 Auth Settings에서 Google Signin을, Market Settings에서 Google PlayStore를 선택합니다.

iOS¶

Unity iOS에서 Hive SDK 각 제품을 설치하는 방법을 안내합니다.

CocoaPods 설치¶

먼저 CocoaPods을 설치합니다. Unity를 실행해 Asset > External Dependency Manager > iOS Resolver > Install CocoaPods 메뉴를 클릭합니다.

CLI(Bash-shell)로도 설치할 수 있습니다.

$sudo gem install cocoapods

실행 결과가 아래와 같이 나타나면 설치 완료입니다.

iOS Resolver 설정¶

다음으로, CocoaPods 설정을 합니다. CocoaPods으로 iOS에서 사용하는 외부 라이브러리를 제공받을 경우 기존 .xcodeproj 파일의 확장자를 .xcworkspace로 변경해 제공합니다. .xcworkspace 형태로 빌드를 진행할 수 없다면 GUI를 이용해 설정을 변경해보세요. 빌드할 PC의 Unity에서 수행하는 CocoaPods 적용 방식이 변경되어 실행할 수 있습니다.

1. Unity를 실행해 Asset > External Dependency Manager > iOS Resolver > Settings 메뉴를 클릭합니다.

   2. iOS Resolver Settings 창이 나타나면 Cocoapods Integration 항목을 .xcworkspace로 설정하고, 프레임워크를 강제로 정적 방식으로 참조하지 않도록 Link framework statically를 체크 해제합니다.

   

ExternalDependency 설정¶

Hive > ExternalDependency 메뉴를 클릭합니다.

설정 창이 나타나면 사용하려는 Hive SDK 기능을 선택하세요. 예를 들어, Google 인증과 Apple AppStore 결제 기능을 사용하려면 Auth Settings에서 Google Signin을, Market Settings에서 Apple AppStore를 선택합니다.

Windows¶

Windows 패키지를 불러온 후에는 별도 설정이 필요하지 않습니다.