콘텐츠로 이동

iOS

CocoaPods 이용하기

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

Hive SDK 저장소 추가

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

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

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를 설치하는 방법을 안내합니다.

  1. Xcode 프로젝트에서 패키지 추가 메뉴를 선택합니다.

    Unity

    Unity 환경에서 Hive SDK를 설치 후 Xcode 프로젝트를 빌드한 경우, pod install이 이미 자동으로 실행된 상태라면 반드시 pod deintegrate를 먼저 실행해야 합니다.

  2. Hive SDK 패키지 저장소를 찾아 버전을 명시합니다.

    1. 1에 아래 주소를 입력하세요.

      https://github.com/Com2uSPlatformCorp/HiveSDK-iOS-SPM
      
    2. 2에서 Exact Version을 선택 후 적용하려는 SDK 버전을 입력하세요.

    3. 3을 누르세요.

  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)에도 추가해야 합니다.

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

    • -Xlinker
    • -all_load