콘텐츠로 이동

iOS

CocoaPods로 설치

CocoaPods으로 Hive SDK iOS를 설치하는 방법을 안내합니다.

Hive SDK 저장소 추가

생성된 Podfilesource로 Hive SDK 저장소를 추가합니다.

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

Xcode 프로젝트에 Hive 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)로 Hive SDK iOS를 설치하는 방법을 안내합니다.

Unity 프로젝트에 SDK 패키지 추가

Unity 환경에서 SPM 사용 여부의 기본값은 true입니다. 따라서 SPM을 지원하는 Hive SDK는 기본적으로 SPM으로 설치되며, SPM을 지원하지 않는 Hive SDK는 CocoaPods로 설치됩니다.

Unity 환경에서는 Hive SDK에서 제공하는 PostProcess 기능을 이용하면 패키지 종속성이 자동으로 추가되므로 보다 간편하게 Hive SDK iOS 패키지를 추가할 수 있습니다.

Note

SPM을 지원하는 Hive SDK여도, SPM이 아닌 CocoaPods로 설치하려면 Unity Editor에서 Assets > External Dependency Manager > iOS Resolver > Settings 경로에서 iOS Resolver Settings > Swift Package Manager Integration을 체크 해제하세요.

Unity 외 프로젝트에 SDK 패키지 추가

Xcode 프로젝트에서 아래와 같은 순서로 Hive SDK iOS 패키지를 추가합니다.

  1. File > Add Package Dependencies... 를 클릭합니다.

  2. 아래와 같은 순서로 Hive SDK iOS 패키지를 등록합니다.

    2.1. Hive SDK iOS 패키지 저장소에 해당하는 주소를 아래와 같이 입력하세요.

    https://github.com/Com2uSPlatformCorp/HiveSDK-iOS-SPM
    

    2.2. Dependency Rule에서 Exact Version 을 선택 후 적용하려는 SDK 버전을 입력하세요.

    2.3. Add Package를 클릭하세요.

  3. 패키지 로딩이 완료되면 Hive SDK iOS에서 제공하는 기능(인증, 빌링, 애널리틱스 등) 목록이 표시됩니다. 적용하고지하는 기능을 앱 타겟에 추가할 수 있습니다.

    Warning

    SPM을 지원하지 않는 아래 Hive SDK 기능은 CocoaPods를 이용해 추가해야 합니다.

    • HerculesSwift
    • HiveAuthV4ProviderQQ
    • HiveAuthV4ProviderLine
    • HiveAuthV4ProviderWechat
    • HiveAnalyticsProviderAirbridge

    Podfile에 각 기능별 종속성을 pod 구문으로 작성한 후 pod install을 실행하세요.
    또한 추가로 적용할 종속성이 있다면 동일하게 CocoaPods를 이용해 추가할 수 있습니다. 이 때, 기존에 SPM으로 추가한 Hive SDK 기능은 포함하면 안 됩니다.

  4. 메인 앱 타겟의 Build Settings에서 Other Linker Flags (OTHER_LDFLAGS)에 아래 두 값을 차례로 추가합니다.

    • -Xlinker
    • -all_load