Upgrade Guide – Hive Developers

4.21.1 ⇨ 4.22.0

Hive SDK 릴리즈 정책과 제품 분류 변경

Hive SDK 4.22.0부터 Hive SDK 릴리즈 정책과 제품 분류가 아래와 같이 변경됩니다.

Hive SDK 4.22.0 이전: 모든 게임 엔진(Unity, Unreal, Android, iOS, Cocos2d-x)을 동일한 SDK 버전으로 릴리즈했습니다. 아래 예시를 참고하세요.
- Hive SDK 4.21.1 Unity/Unreal/Android/iOS/Cocos2d-x
- Hive SDK 4.16.4 Unity/Unreal/Android/iOS/Cocos2d-x
Hive SDK 4.22.0 이후: 게임 엔진(Unity, Unreal, Android, iOS, Cocos2d-x)과 OS(Windows, Android, iOS) 분류를 따라 SDK를 개별적으로 릴리즈합니다. 아래 분류를 참고하세요.
- Hive SDK v4 Unity iOS 22.0
- Hive SDK v4 Unity Android 22.0
- Hive SDK v4 Unity Windows 22.0 (구 크로스플레이)
- Hive SDK v4 Unreal iOS 22.0
- Hive SDK v4 Unreal Android 22.0
- Hive SDK v4 Unreal Windows 22.0 (구 크로스플레이)
- Hive SDK v4 Cocos2d-x iOS 22.0
- Hive SDK v4 Cocos2d-x Android 22.0
- Hive SDK v4 Android (Native) 22.0
- Hive SDK v4 iOS (Native) 22.0

iOS 프레임워크 적용하기 업데이트

서드 파티 프레임워크의 종속성, Podfile 파일 작성 예시, 프로젝트 메인 타겟으로 추가해야하는 프레임워크 상세 목록을 업데이트했습니다. 4.21.1 버전에서 사용했던 프레임워크, Pod 파일 작성 예시는 아래를 참고하세요.

서드 파티 프레임워크의 종속성

HiveProviderAppsFlyer (4.16.3)
- AppsFlyerFramework (6.9.1)
HiveProviderFacebook (4.16.3)
- FBSDKCoreKit (Podfile에 작성된 iOS 최소 지원 버전과 호환되는 최신 버전)
- FBSDKLoginKit (Podfile에 작성된 iOS 최소 지원 버전과 호환되는 최신 버전)
- FBSDKShareKit (Podfile에 작성된 iOS 최소 지원 버전과 호환되는 최신 버전)
HiveProviderFacebook/Facebook12 (4.16.3)
- Hive SDK와 호환성이 검증된 Facebook 12 버전. iOS 최소 지원 버전 10 이상
- FBSDKCoreKit (12.3.0)
- FBSDKLoginKit (12.3.0)
- FBSDKShareKit (12.3.0)
HiveProviderFacebook/Facebook13 (4.16.3)
- Hive SDK와 호환성이 검증된 Facebook 13 버전. iOS 최소 지원 버전 11 이상
- FBSDKCoreKit (13.2.0)
- FBSDKLoginKit (13.2.0)
- FBSDKShareKit (13.2.0)
HiveProviderFacebook/Facebook15 (4.16.3)
- Hive SDK와 호환성이 검증된 Facebook 15 버전. iOS 최소 지원 버전 12 이상
- FBSDKCoreKit (15.0.0)
- FBSDKLoginKit (15.0.0)
- FBSDKShareKit (15.0.0)
HiveProviderFirebase (4.16.3)
- FirebaseCore (10.4.0)
- FirebaseAnalytics (10.4.0)
HiveProviderAdjust (4.16.3)
- Adjust (4.33.3)
HiveProviderSingular (4.16.3)
- Singular-SDK (12.0.1)
HiveProviderGoogle (4.16.3)
- GoogleUtilities (7.8.0)

다음은 Podfile 파일 작성 예시입니다.


    source 'https://github.com/CocoaPods/Specs.git'
    # source로 Hive SDK 저장소를 추가
    source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'
    # Facebook 13 버전 사용 시 11.0, Facebook 15 버전 사용시 12.0
    platform :ios, '11.0'
    use_frameworks!
    inhibit_all_warnings!
      
    workspace 'HIVE_GAME'
    project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
        
      # 프로젝트의 메인 타겟
    target 'HIVE_GAME_COOL' do
      project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
      pod 'HiveAppTrackingTransparency', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderAdjust', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderAppsFlyer', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderFacebook', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderFirebase', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderGoogle', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderLine', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderQQ', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderSingular', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderVK', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderWechat', '${HIVE_SDK_VERSION}'
      pod 'HiveProviderWeverse', '${HIVE_SDK_VERSION}'
      pod 'HiveResource', '${HIVE_SDK_VERSION}'
      pod 'HiveSDK', '${HIVE_SDK_VERSION}'
      pod 'HiveSDKUnityPlugin', '${HIVE_SDK_VERSION}'
      pod 'HiveExtensions', '${HIVE_SDK_VERSION}'
      pod 'Hercules', '${HIVE_SDK_VERSION}'
      pod 'HiveResource', '${HIVE_SDK_VERSION}'
    end
      
    # Hive의 Push Extension 기능을 사용하기 위해 App Extension 타겟을 추가한 경우
    target 'HIVE_GAME_COOL_EXTENSION' do
      project 'ProjectPath/Project/HIVE_GAME.xcodeproj'
      pod 'HiveExtensions', '${HIVE_SDK_VERSION}'
    end
        
    post_install do |installer|
      installer.pods_project.targets.each do |target|
        target.build_configurations.each do |config|
          # fix for dyld issue in pods when using Project
          # LineSDKSwift 사용 시 pod project 설정 변경필요
          if ["LineSDKSwift"].include? target.name
            config.build_settings["BUILD_LIBRARY_FOR_DISTRIBUTION"] = "YES"
          # Xcode 14 에서 발생하는 CocoaPods bundle 타겟에 대한 Code signing 컴파일 에러 이슈 대응
          elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'
            config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'
          end
          # Hive의 Push Extension 기능을 사용하기 위해 App Extension 타겟을 추가한 경우
          config.build_settings["APPLICATION_EXTENSION_API_ONLY"] = "NO"
        end
      end
    end

source 'https://github.com/CocoaPods/Specs.git'

# source로 Hive SDK 저장소를 추가

source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'

# Facebook 13 버전 사용 시 11.0, Facebook 15 버전 사용시 12.0

platform :ios, '11.0'

use_frameworks!

inhibit_all_warnings!

workspace 'HIVE_GAME'

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

# 프로젝트의 메인 타겟

target 'HIVE_GAME_COOL' do

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

pod 'HiveAppTrackingTransparency', '${HIVE_SDK_VERSION}'

pod 'HiveProviderAdjust', '${HIVE_SDK_VERSION}'

pod 'HiveProviderAppsFlyer', '${HIVE_SDK_VERSION}'

pod 'HiveProviderFacebook', '${HIVE_SDK_VERSION}'

pod 'HiveProviderFirebase', '${HIVE_SDK_VERSION}'

pod 'HiveProviderGoogle', '${HIVE_SDK_VERSION}'

pod 'HiveProviderLine', '${HIVE_SDK_VERSION}'

pod 'HiveProviderQQ', '${HIVE_SDK_VERSION}'

pod 'HiveProviderSingular', '${HIVE_SDK_VERSION}'

pod 'HiveProviderVK', '${HIVE_SDK_VERSION}'

pod 'HiveProviderWechat', '${HIVE_SDK_VERSION}'

pod 'HiveProviderWeverse', '${HIVE_SDK_VERSION}'

pod 'HiveResource', '${HIVE_SDK_VERSION}'

pod 'HiveSDK', '${HIVE_SDK_VERSION}'

pod 'HiveSDKUnityPlugin', '${HIVE_SDK_VERSION}'

pod 'HiveExtensions', '${HIVE_SDK_VERSION}'

pod 'Hercules', '${HIVE_SDK_VERSION}'

pod 'HiveResource', '${HIVE_SDK_VERSION}'

end

# Hive의 Push Extension 기능을 사용하기 위해 App Extension 타겟을 추가한 경우

target 'HIVE_GAME_COOL_EXTENSION' do

project 'ProjectPath/Project/HIVE_GAME.xcodeproj'

pod 'HiveExtensions', '${HIVE_SDK_VERSION}'

end

post_install do |installer|

installer.pods_project.targets.each do |target|

target.build_configurations.each do |config|

# fix for dyld issue in pods when using Project

# LineSDKSwift 사용 시 pod project 설정 변경필요

if ["LineSDKSwift"].include? target.name

config.build_settings["BUILD_LIBRARY_FOR_DISTRIBUTION"] = "YES"

# Xcode 14 에서 발생하는 CocoaPods bundle 타겟에 대한 Code signing 컴파일 에러 이슈 대응

elsif config.build_settings['WRAPPER_EXTENSION'] == 'bundle'

config.build_settings['CODE_SIGNING_ALLOWED'] = 'NO'

end

# Hive의 Push Extension 기능을 사용하기 위해 App Extension 타겟을 추가한 경우

config.build_settings["APPLICATION_EXTENSION_API_ONLY"] = "NO"

end

Hive SDK 기본 동작을 위한 필수 적용 프레임워크추가 선택 적용이 가능한 프레임워크

HiveSDK
- Hive SDK의 전반적인 동작에 필수적인 프레임워크
HiveAppTrackingTransparency
- iOS 14 이상의 디바이스에서 앱추적 권한을 획득하기 위한 프레임워크
HiveResource
- Hive SDK에서 제공하는 UI 리소스 번들(.bundle). 반드시 프로젝트의 메인 타겟("HIVE_GAME_COOL")에 추가되어야 합니다.

HiveExtensions
- Hive 푸시 알림의 추가 확장 기능을 사용하기 위한 프레임워크
HiveProviderAdjust
- Adjust 마케팅 트래킹 프레임워크
HiveProviderAppsFlyer
- AppsFlyer 마케팅 트래킹 프레임워크
HiveProviderFacebook
- Facebook 로그인 및 기타 소셜 기능을 사용하기 위한 프레임워크
HiveProviderFirebase
- Firebase 마케팅 트래킹 프레임워크
HiveProviderGoogle
- Google 로그인을 위한 프레임워크
HiveProviderLine
- Line 로그인을 위한 프레임워크
HiveProviderQQ
- QQ 로그인을 위한 프레임워크
HiveProviderSingular
- Singular 마케팅 트래킹 프레임워크
HiveProviderVK
- VK 로그인을 위한 프레임워크
HiveProviderWechat
- Wechat 로그인을 위한 프레임워크
HiveProviderWeverse
- Weverse 로그인을 위한 프레임워크
HiveSDKPlugin
- Hive SDK C++ 언어용 인터페이스 플러그인 프레임워크
HiveSDKUnityPlugin
- Hive SDK C# 언어용 인터페이스 플러그인 프레임워크
Hercules
- 보안 모듈 프레임워크

Android 모듈 수준 build.gradle 파일 업데이트

AppsFlyer 라이브러리 설정을 추가했습니다.

4.21.1 ⇨ 4.22.0

Hive SDK 릴리즈 정책과 제품 분류 변경

iOS 프레임워크 적용하기 업데이트

Android 모듈 수준 build.gradle 파일 업데이트

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원