[INFO]
최소 사양
- 사용자 실행 환경: iOS 11 이상
- 빌드 환경: Xcode 14.1(iOS 16.1 SDK) 이상
[주의]
일부 IdP 지원 시 하단 3rd Party Gamebase Auth Adapters 표 안의 Support iOS Version 항목을 참고하세요. AppStore 출시 시에는 반드시 Apple 버전 정책에 준수해야 합니다.
- https://developer.apple.com/ios/submit/
Gamebase는 아래와 같은 방법으로 설정이 가능합니다.
Gamebase.xcframework 및 필요한 Adapter들을 다운로드합니다.
또한 각 IdP의 인증을 위한 SDK 파일들을 다운로드해야 합니다. 해당 IdP의 로그인을 사용할 때만 포함하면 됩니다.
다운로드한 뒤, 해당 SDK 파일을 프로젝트의 target에 포함시켜야 합니다.
Gamebase iOS SDK Components
Gamebase SDK | Gamebase Auth Adapter | External(iOS) SDK & Compatible Version | 용도 | Support iOS Version |
---|---|---|---|---|
Gamebase | Gamebase.xcframework Gamebase.bundle |
NHNCloudSDK 1.6.2 | Gamebase의 Interface 및 핵심 로직을 포함 | iOS 11 or later |
Gamebase Auth Adapters | GamebaseAuthFacebookAdapter.xcframework | FacebookSDK 14.1.0 | Facebook 로그인을 지원 | iOS 11 or later |
GamebaseAuthPaycoAdapter.xcframework | PaycoID Login 3rd SDK v1.5.8 | PAYCO 로그인을 지원 | iOS 11 or later | |
GamebaseAuthNaverAdapter.xcframework | naveridlogin-sdk-ios-4.1.1 | NAVER 로그인을 지원 | iOS 11 or later | |
GamebaseAuthGamecenterAdapter.xcframework | GameKit.framework | Gamecenter 로그인을 지원 | iOS 11 or later | |
GamebaseAuthGoogleAdapter.xcframework | GoogleSignIn 7.0.0 | Google 로그인을 지원 | iOS 11 or later | |
GamebaseAuthTwitterAdapter.xcframework | Twitter 로그인을 지원 | iOS 11 or later | ||
GamebaseAuthLineAdapter.xcframework | LineSDK 5.8.2 | LINE 로그인을 지원 | iOS 11 or later | |
GamebaseAuthAppleidAdapter.xcframework | Sign In with Apple | iOS 11 or later arm64 지원 |
||
GamebaseAuthHangameAdapter.xcframework | HangameID SDK 1.8.6 | Hangame 로그인을 지원 | iOS 11 or later | |
GamebaseAuthWeiboAdapter.xcframework | weibo_ios_sdk-3.3.4 | Weibo 로그인을 지원 | iOS 11 or later | |
GamebaseAuthKakaogameAdapter.xcframework | KakaoGame 3.14.14 | Kakao 로그인을 지원 | iOS 11 or later | |
Gamebase IAP Adapters | GamebasePurchaseIAPAdapter.xcframework | StoreKit.framework NHNCloudIAP 1.6.2 |
게임 내 결제 지원 | iOS 11 or later |
Gamebase Push Adapters | GamebasePushAdapter.xcframework | NHNCloudPush 1.6.2 | Push를 지원 | iOS 11 or later |
[주의]
Sign In with Apple에 필요한 AuthenticationServices.framework를 추가할 경우에는 반드시 Optional로 설정해야 합니다. Required로 설정할 경우에는 iOS 11 이하 기기에서는 실행 직후 크래시가 발생합니다.
Gamebase SDK iOS 2.13.0부터 iOS 9 이상에서 Sign In with Apple이 지원되며, 추가로 Gamebase Console에 Service ID를 설정해야 합니다.
[주의]
Gamebase Framework 파일 중 이름에 Adapter가 포함되어 있는 파일들은 선택해 프로젝트 내에서 사용 여부를 결정할 수 있으며, 사용하지 않는 Adapter Framework는 제거하는 것을 권장합니다. 해당 Adapter Framework를 사용하려면 위의 표에 명시된 외부 SDK들이 필요할 수 있습니다. 일부 인증 Adapter의 경우 위의 표에 있는 지원하는 iOS 버전에 유의해야 합니다. (지원 버전이 iOS 11 이상인 Auth Adpater를 빌드에 포함하면 iOS 10 이하에서는 런타임 크래시가 발생합니다.)
[INFO]
각 IdP에서 제공하는 외부 SDK에 대한 설정은 각 IdP의 가이드 문서를 참고하시길 바랍니다.
압축을 풀면 다음과 같이 Gamebase.xcframework 등의 SDK를 볼 수 있습니다.
[INFO]
Linker에 -ObjC옵션 설정은 Static Library에 있는 모든 Objective-C class와 category를 로드합니다.
따라서 이 옵션을 설정하지 않았을 때에 selector not recognized와 같은 오류가 Runtime 상에서 발생할 수 있습니다.
[주의]
- Unity(2019.3 이상) 빌드할 경우, Gamebase iOS SDK를 UnityFramework 타겟에만 import 해줍니다.
- Unity 빌드를 하게 되면 Xcode 프로젝트 타겟에 Unity-iPhone, UnityFramework가 생깁니다.
- 각 타겟에 Gamebase iOS SDK를 중복해서 import 할 경우, 동작에 문제가 있을 수 있으니 유의해야 합니다.
Gamebase iOS SDK는 CocoaPods를 통해서도 설정할 수 있습니다.
platform :ios, '11.0'
target 'SampleApplication' do
pod 'Gamebase'
pod 'GamebaseAuthFacebookAdapter'
pod 'GamebaseAuthGamecenterAdapter'
pod 'GamebaseAuthPaycoAdapter'
pod 'GamebaseAuthNaverAdapter'
pod 'GamebaseAuthTwitterAdapter'
pod 'GamebaseAuthGoogleAdapter'
pod 'GamebaseAuthLineAdapter'
pod 'GamebaseAuthAppleidAdapter'
pod 'GamebaseAuthWeiboAdapter'
pod 'GamebasePushAdapter'
pod 'GamebasePurchaseIAPAdapter'
# 다음 모듈의 사용 방법은 고객 센터로 문의하시기 바랍니다.
pod 'GamebaseAuthHangameAdapter'
pod 'GamebaseAuthKakaogameAdapter'
end
[INFO]
target 'SampleApplication' do 부분에는 생성한 프로젝트의 타깃 이름을 입력합니다.
pod 'Gamebase', '2.48.0'과 같이 작성해 특정 버전을 지정할 수 있습니다. 각각의 pod에 버전을 명시하지 않으면 최신 버전이 설정됩니다.
특정 Adapter만 선택해서 적용할 수 있습니다.
[주의]
Gamebase 최신 버전을 사용하지 않으면 일부 Adapter의 사용이 불가능 할 수 있습니다.
[INFO]
더 자세한 CocoaPods 사용법에 대해서는 CocoaPods Guide의 Using CocoaPods 페이지를 참고하시길 바랍니다.
[주의]
- NHN Cloud Console에서 새 프로젝트를 생성하여 Gamebase 서비스를 활성화했는지 반드시 확인하세요.
- 각 IdP 콘솔에서 Client ID를 발급 받아 Gamebase 콘솔에 입력했는지 반드시 확인하세요.
<key>LSApplicationQueriesSchemes</key>
<array>
<string>fbapi</string>
<string>fb-messenger-share-api</string>
</array>
<key>LSApplicationQueriesSchemes</key>
<array>
<string>naversearchthirdlogin</string>
<string>naversearchapp</string>
</array>
URL Scheme을 설정해야 합니다.
ATS 설정을 위해서 Info.plist 파일에 Scheme을 등록합니다.
<key>LSApplicationQueriesSchemes</key>
<array>
<string>lineauth2</string>
</array>
<key>LSApplicationQueriesSchemes</key>
<array>
<string>sinaweibo</string>
<string>weibosdk</string>
<string>weibosdk2.5</string>
<string>weibosdk3.3</string>
</array>
{ "url_scheme_ios_only": "Your URL Scheme" }
NAVER
{ "url_scheme_ios_only": "Your URL Scheme", "service_name": "Your Service Name" }
LINE
<key>LineSDKConfig</key>
<dict>
<key>ChannelID</key>
<string>{Issued LINE ChannleID}</string>
</dict>
API Reference는 SDK 내에 포함되어 있습니다.
Gamebase에서 더 이상 지원하지 않는 API는 Deprecate 처리합니다. Deprecated 된 API는 다음 조건 충족 시 사전 공지 없이 삭제될 수 있습니다.
5회 이상의 마이너 버전 업데이트
최소 5개월 경과