SDK 문제 해결

Hive SDK 사용과 관련한 FAQ 모음입니다.

실행 오류¶

Google Play 스토어와 Onestore의 게임이 동시에 설치되지 않습니다.

Facebook SDK의 파일 공유 기능을 사용하지 않는 게임이라면, AndroidManifest.xml 파일에서 아래의 내용을 제거하여 대응할 수 있습니다.

<provider android:authorities="com.facebook.app.FacebookContentProvider{APP_ID}"
android:name="com.facebook.FacebookContentProvider"
android:exported="true"/>

Hive SDK를 적용한 후 Firebase Analytics가 비활성화됩니다.

Hive SDK를 적용한 게임에서 Firebase Analytics를 적용 했으나 이벤트가 수집이 되지않는 경우, 아래 내용을 확인하세요.

AndroidManifest.xml 파일에서 메타데이터를 변경합니다.

<application>
<meta-data android:name="firebase_analytics_collection_deactivated" tools:node="remove" />
<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />

Hive SDK 초기화가 완료된 후에 Firebase Analytics를 활성화합니다.

// Hive SDK v4 초기화 요청
AuthV4.setup (delegate (
ResultAPI result, Boolean isAutoSignIn, String did, List providerTypeList) {
    if (result.code == ResultAPI.Code.Success) {
        // 초기화 성공
        if (Configuration.getAgeGateU13() == false) {
        // 13세 이상인 경우 Firebase Analytics 수집 활성화
        setAnalyticsCollectionEnabled(true);
        }
        else {
        // 13세 미만인 경우 Firebase Analytics 수집 비활성화
        setAnalyticsCollectionEnabled(false);
        }
    }
});

iOS 푸시가 수신되지 않습니다.

iOS 빌드에서 푸시가 수신되지 않는 경우, 아래 내용을 확인하세요.

푸시 인증서가 정상적으로 등록되어있는지, 푸시 인증서가 만료되었는지 확인
- 콘솔 가이드 > 노티피케이션 > 푸시 인증서 관리 가이드 참고
등록된 푸시 인증서와 실제 빌드에서 사용하는 토큰의 APNS 서버 환경이 일치하는지 확인
- Hive 푸시 상용서버에서는 APNS Real 서버로, Hive Sandbox 서버에서는 APNS Sandbox 서버로 푸시를 요청합니다.
- 테스트하는 빌드가 엔터프라이즈 또는 Ad-hoc 빌드인 경우 APNS Real 서버에서 사용 가능한 푸시 토큰이 전달되며, Development 빌드의 경우 APNS Sandbox 서버에서 사용가능 한 푸시토큰이 전달됩니다.
푸시 알림 XCode 설정 확인
- SDK 가이드 > 노티피케이션 > 사전 준비 > iOS 가이드 참고

주의 사항¶

HiveSDK v4 Unity 24.3.0 혹은 24.4.0을 적용 후, Android의 Huawei 빌드 시 주의사항

HiveSDK v4 Unity 24.3.0 혹은 24.4.0 를 적용하여 Android의 Huawei 빌드 시 아래 설정 가이드 내용을 반영해야 합니다.
(미설정 시 Huawei IAP 상품 구매 시 에러 발생)

설정 가이드

AndroidPostBuildProcessor.cs 수정 Unity 프로젝트에서 /Assets/Hive_SDK_v4/Editor/Android/AndroidPostBuildProcessor.cs 에서 아래 내용 확인하여 적용

코드 추가

// 추가 코드
using Hive.Unity.Editor;

기존 코드를 제거 후 코드 추가

// 제거 코드
string huaweiDependenciesXml = Application.dataPath + "/Hive_SDK_v4/Editor/HIVESDK_ProviderHuaweiDependencies.xml";
if (File.Exists(huaweiDependenciesXml)) {
// 추가 코드
bool useHuawei = ExternalDependencyDictionaryManager.isUseDependency(ExternalDependencyType.Huawei);
if (useHuawei) {

기존 코드를 제거 후 코드 추가

// 제거 코드
string huaweiDependenciesXml = Application.dataPath + "/Hive_SDK_v4/Editor/HIVESDK_ProviderHuaweiDependencies.xml";
if (File.Exists(huaweiDependenciesXml)) {
// 추가 코드
bool useHuawei = ExternalDependencyDictionaryManager.isUseDependency(ExternalDependencyType.Huawei);
if (useHuawei) {

HiveSDK v4 Unity 24.3.0 혹은 24.4.0을 적용 후, Android의 Firebase 애널리틱스 사용 시 주의사항

HiveSDK v4 Unity 24.3.0 혹은 24.4.0 를 적용하여 Android의 Firebase 애널리틱스 기능을 사용할 경우 아래 가이드 내용을 반영해야 합니다. (미설정 시 Firebase 애널리틱스 이벤트 전송 불가) 그리고 Firebase 설정이 정상 적용되었는지 확인할 경우 가이드 3 내용을 확인 바랍니다.

설정 가이드

launcherTemplate.gradle 생성 Project Settings > Player > Publishing Settings > Build 항목 내 Custom Launcher Gradle Template 체크
plugin 적용 생성된 Assets/Plugins/Android/launcherTemplate.gradle 파일 내 최 하단에 다음 코드 추가
```
apply plugin: 'com.google.gms.google-services'
```
테스트 터미널을 통해 adb shell setprop debug.firebase.analytics.app {package name}입력 Firebase 콘솔 Debug View 에서 정상 동작 확인

참고 사항¶

SDK Manager를 통한 SDK 업그레이드가 실패하는 원인

정식 배포 버전이 아니라 개별 전달받은 Hive SDK일 경우 업그레이드 에러가 발생합니다. Hive Manager는 Hive SDK 바이너리로 버전을 확인하기 때문에 등록되지 않은 버전을 업그레이드할 수 없습니다. 이러한 경우 솔루션아키텍트에 문의바랍니다.
Hive SDK 원본 파일의 일부를 변경한 경우 업그레이드를 실패합니다. Hive > Hive SDK Manager > Restore Hive SDK를 클릭해 원본으로 복구한 후 업그레이드 시도바랍니다.

Onestore 빌드 시 Google 빌드와의 차이점

기본적으로는 구글 빌드 설정과 동일하게 설정하면 됩니다.

Hive SDK 내부에서 hive_config.xml에 설정된 appid에 따라 결제동작이 결정되므로, appid 값만 Onestore용 appid로 설정하면 됩니다.

이외에 설정해야하는 키 정보가 Onestore/Google 간에 다른 부분이 있는 경우 다르게 설정하면 됩니다.

SDK 가이드 > 기본설정 > Configuration 파일 > 개요 가이드를 참고바랍니다.