iOS
CocoaPods 이용하기¶
CocoaPods으로 Hive SDK iOS를 설치하는 방법을 안내합니다.
Hive SDK 저장소 추가¶
생성된 Podfile에 source로 Hive SDK 저장소를 추가합니다.
Xcode 프로젝트에 SDK 추가¶
Xcode 프로젝트 디렉토리의 Podfile을 수정하여 Hive SDK를 추가합니다.
source 'https://github.com/CocoaPods/Specs.git'
# source로 SDK 저장소를 추가
source 'https://github.com/Com2uSPlatformCorp/HiveSDK-iOS'
$HIVE_SDK_VERSION = '26.1.0' # 사용할 SDK 버전
$IOS_DEPLOYMENT_TARGET_VERSION = '13.0' # 게임에서 지원할 iOS 최소 지원 버전
$IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION = '13.0' # 사용할 SDK에서 지원하는 iOS 최소 지원 버전 (사용할 SDK 버전의 릴리스 노트를 참고하여 작성)
platform :ios, $IOS_DEPLOYMENT_TARGET_VERSION
use_frameworks!
inhibit_all_warnings!
project 'HIVE_SDK_Sample_App.xcodeproj'
target 'HIVE_SDK_Sample_App' do
# 이 곳에 사용할 프레임워크들을 추가합니다. 최소 1개 이상의 프레임워크가 있어야 합니다.
# 예시: 인증에서 Google IdP 로그인 사용 시 아래 프레임워크 추가
pod 'HiveAuthV4ProviderGoogle', $HIVE_SDK_VERSION # 인증(AuthV4)의 Google IdP 로그인 사용 시
end
post_install do |installer|
installer.pods_project.targets.each do |target|
target.build_configurations.each do |config|
# 각 프레임워크들의 iOS 타겟이 15 미만인 경우 15로 변경
if config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'].to_f < $IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION.to_f
config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = $IOS_DEPLOYMENT_MINIMUM_TARGET_VERSION.to_f
end
# xcode 15 TOOLCHAIN_DIR 관련 컴파일 에러 이슈 대응
xcconfig_path = config.base_configuration_reference.real_path
xcconfig = File.read(xcconfig_path)
xcconfig_mod = xcconfig.gsub(/DT_TOOLCHAIN_DIR/, "TOOLCHAIN_DIR")
File.open(xcconfig_path, "w") { |file| file << xcconfig_mod }
end
end
end
Swift Package Manager 이용하기 (Beta)¶
Swift Package Manager(SPM)로 iOS SDK를 설치하는 방법을 안내합니다.
-
Xcode 프로젝트에서 패키지 추가 메뉴를 선택합니다.
Unity
Unity 환경에서 Hive SDK를 설치 후 Xcode 프로젝트를 빌드한 경우,
pod install이 이미 자동으로 실행된 상태라면 반드시pod deintegrate를 먼저 실행해야 합니다. -
Hive SDK 패키지 저장소를 찾아 버전을 명시합니다.
-
1에 아래 주소를 입력하세요.
-
2에서
Exact Version을 선택 후 적용하려는 SDK 버전을 입력하세요. -
3을 누르세요.
-
-
패키지 로딩이 끝나고 제품 목록이 뜨면, 원하는 Hive SDK 제품(인증, 빌링, 애널리틱스 등)을 앱 타겟에 적용합니다.
Warning
SPM을 지원하지 않는 아래 Hive SDK 제품은 CocoaPods를 이용해 추가해야 합니다.
- HerculesSwift
- HiveAuthV4ProviderQQ
- HiveAuthV4ProviderLine
- HiveAuthV4ProviderWechat
- HiveAnalyticsProviderAirbridge
Podfile에 이들에 대한 pod 구문을 작성한 후
pod install을 실행하세요. 이 때, SPM으로 이미 적용한 Hive SDK 제품은 포함하면 안 됩니다. 또 추가로 적용할 종속성이 있다면 마찬가지로 CocoaPods를 이용해 추가할 수 있습니다.Unity
Unity 환경에서 Hive SDK를 설치 후 Xcode 프로젝트를 산출한 경우, 앱 타겟이 아닌
UnityFramework타겟에 Hive SDK 제품을 적용합니다. 단,Hive_AuthV4ProviderFacebook,Hive_AnalyticsProviderAdjust제품은 메인 앱 타겟(Unity-iPhone)에도 추가해야 합니다. -
메인 앱 타겟의 Build Settings에서 Other Linker Flags(
OTHER_LDFLAGS)에 아래 두 값을 차례로 추가합니다.-Xlinker-all_load

