Game > Gamebase > iOS SDK 사용 가이드 > 시작하기

Environments

[INFO]

최소사양 : iOS8 이상 또는 일부 IDP지원 시 iOS9 이상
arm7, arm7s, arm64, i386, x86_64 지원 기기
Xcode9 이상

Installation

Gamebase는 아래와 같은 방법으로 설정이 가능합니다.

Download

Gamebase.framework.zip 및 필요한 adapter 들을 다운로드 받습니다.
또한 각 IdP의 인증을 하기위한 SDK파일들을 다운로드 받아야합니다. 해당 IdP의 로그인을 사용할 때만 포함하면 됩니다.
다운로드한 뒤, 해당 SDK파일을 프로젝트의 target에 포함시켜야 합니다.

3rd Party SDK Download

Gamebase SDK Gamebase Auth Adapter External(iOS) SDK & Compatible Version 용도 External SDK Download Link Support iOS Version
Gamebase Gamebase.framework, Gamebase.bundle Gamebase의 Interface 및 핵심 로직을 포함 iOS8 or later
Gamebase Auth Adapters GamebaseAuthFacebookAdapter.framework FacebookSDK v4.17.0 Facebook 로그인을 지원 LINK [Go to Download] iOS8 or later
GamebaseAuthPaycoAdapter.framework PaycoID Login 3rd SDK v1.1.6 Payco 로그인을 지원 LINK [Go to Download] iOS8 or later
GamebaseAuthNaverAdapter.framework naveridlogin-sdk-ios-4.0.10 Naver 로그인을 지원 LINK [Go to Download] iOS9 or later
GamebaseAuthGamecenterAdapter.framework GameKit.framework Gamecenter 로그인을 지원 iOS8 or later
GamebaseAuthGoogleAdapter.framework Google 로그인을 지원 iOS9 or later
GamebaseAuthTwitterAdapter.framework Twitter 로그인을 지원 iOS8 or later
GamebaseAuthLineAdapter.framework LINE 로그인을 지원 LINK [Go to Download] iOS8 or later
Gamebase IAP GamebasePurchaseIAPAdapter.framework StoreKit.framework 게임 내 결제를 지원 Gamebase IAP 내에 포함 iOS8 or later
Gamebase Push GamebasePushAdapter.framework Push를 지원 Gamebase내에 포함 iOS8 or later

[주의]

Gamebase Framework 파일 중 이름에 Adapter가 포함되어 있는 파일들은 선택적으로 프로젝트 내에서 사용여부를 결정할 수 있으며, 해당 Adapter Framework를 사용하기 위해서는 위의 표에 명시된 외부 SDK들이 필요할 수 있습니다. 일부 인증 Adpater의 경우 위의 표에 있는 Support iOS Version에 유의해야합니다. (지원 버전이 iOS9이상인 Auth Adpater를 빌드에 포함 시 iOS8이하에서는 runtime Crash가 발생합니다.)


[INFO]

각 IdP에서 제공하는 외부 SDK에 대한 설정은 각 IdP의 가이드 문서를 참고하시길 바랍니다.

Xcode Settings

압축을 풀면, 다음과 같이 Gamebase.framework 등의 SDK를 볼 수 있습니다.

unzip gamebase

  • 1) Framework 파일을 Project의 Project Navigator로 끌어와서 import합니다. 이 때 추가된 Framework 파일들은 프로젝트 target에 추가되어야 합니다.
  • 2) Gamebase.bundle 파일도 Copy Bundle Resources 에 추가합니다. Gamebase.bundle Bundle Resources
  • 3) Gamebase를 사용하기 위해서는 Gamebase의 framework외에, Gamebase에서 사용하고 있는 외부 SDK들의 기능을 포함하기 위하여, 여러 framework와 library 파일을 linker에서 참조할 수 있도록 추가해야합니다. 아래 항목들을 추가해야합니다.
    • libicucore.tbd (Gamebase SDK v1.1.5 이상에서 추가)
    • libz.tbd
    • libsqlite3.tbd
    • libstdc++.tbd
    • AdSupport.framework
    • ImageIO.framework
    • GameKit.framework
    • StoreKit.framework Link Binary With Libraries
  • 4) Target > Build Settings > Linking > Other Linker Flags-ObjC를 추가해야 합니다. Other Linker Flags
  • 5) Target > Build Settings > Enable BitcodeNo로 설정합니다. Enable Bitcode
  • 6) NaverAuthAdapter를 사용하는 경우에는 NaverSDK에서 제공하는 NaverThirdPartyLogin.framework 파일을 Target > General > Embedded Binaries에 추가해야 합니다. Naver Embeded Binaries

[INFO]

Linker에 -ObjC옵션 설정은 Static Library에 있는 모든 Objective-C class와 category를 로드합니다.
따라서 이 옵션을 설정하지 않았을 때에 selector not recognized와 같은 오류가 Runtime 상에서 발생할 수 있습니다.

CocoaPods Settings

Gamebase iOS SDK는 CocoaPods를 통해서도 설정할 수 있습니다.

  • 1) Xcode를 실행해 프로젝트를 생성합니다.
  • 2) Terminal을 실행해 CocoaPods을 적용하려는 프로젝트의 디렉터리로 이동합니다.
  • 3) pod init 명령어를 실행해 Podfile을 생성합니다.
  • 4) 생성된 Podfile을 편집기로 열어 다음과 같은 내용을 작성합니다.
platform :ios, '9.0'

target 'SampleApplication' do
    pod 'Gamebase'
    pod 'GamebaseAuthFacebookAdapter'
    pod 'GamebaseAuthGamecenterAdapter'
    pod 'GamebaseAuthPaycoAdapter'
    pod 'GamebaseAuthNaverAdapter'
    pod 'GamebaseAuthTwitterAdapter'
    pod 'GamebaseAuthGoogleAdapter'
    pod 'GamebaseAuthLineAdapter'
    pod 'GamebasePushAdapter'
    pod 'GamebasePurchaseIAPAdapter'
end

[INFO]

target 'SampleApplication' do 부분에는 생성한 프로젝트의 타겟명을 입력합니다.
pod 'Gamebase', '1.11.1' 과 같이 작성해 특정 버전을 지정 할 수 있습니다. 각각의 pod에 버전을 명시하지 않으면 최신 버전이 설정됩니다.
특정 Adapter만 선택적으로 적용할 수 있습니다.

[주의]

Gamebase 최신 버전을 사용하지 않으면 일부 Adapter의 사용이 불가능 할 수 있습니다.

  • 5) Podfile 작성이 완료되면 pod install 또는 pod update 명령어를 실행해 Gamebase를 설치합니다.
  • 6) 설치가 완료되면 프로젝트명.xcworkspace 파일이 생성됩니다. 이후부터는 생성된 xcworkspace 파일을 통해 개발을 진행합니다.
  • 7) Target > Build Settings > Enable Bitcode를 No로 설정합니다. Enable Bitcode

[INFO]

더 자세한 CocoaPods 사용법에 대해서는 CocoaPods GuideUsing CocoaPods 페이지를 참고하시길 바랍니다.

3rd-Party Provider SDK Guide

API Reference

API Reference는 SDK 내에 포함되어 있습니다.

API Deprecate Governance

Gamebase에서 더 이상 지원하지 않는 API는 Deprecate 처리합니다. Deprecated 된 API는 다음 조건 충족 시 사전 공지 없이 삭제될 수 있습니다.

  • 5회 이상의 마이너 버전 업데이트

    • Gamebase Version Format - XX.YY.ZZ
      • XX : Major
      • YY : Minor
      • ZZ : Hotfix
  • 최소 5개월 경과