이 문서는 Partner iOS SDK(Kakao Partner SDK for iOS)의 FriendStatic 모듈(KakaoPartnerSDKFriendStatic, RxKakaoPartnerSDKFriendStatic) 사용 방법을 안내합니다.

피커 기능을 제공하는 Friend 모듈(KakaoPartnerSDKFriend, RxKakaoPartnerSDKFriend)은 리소스 번들을 포함하고 있어 일부 개발 환경에서 Cocoapods으로 설치가 불가능할 수 있습니다. 이 경우, 정적 프레임워크(Static framework) 파일로 제공하는 FriendStatic을 사용할 수 있습니다.

FriendStatic 모듈이 의존하는 모듈들을 설치해야 합니다. FriendStatic 모듈 외의 모든 모듈은 Cocoapods으로만 배포합니다. Podfile에 아래 내용을 추가한 후 pod install로 설치합니다.

pod 'KakaoPartnerSDKCommon'
pod 'KakaoSDKUser'

정적 프레임워크로 설치할 경우, Cocoapods으로 설치 시 전체 설치가 아닌, 필요한 모듈만 개별 설치해야 하는 점에 주의합니다.

위 예제에 포함되지 않은 다른 모듈도 필요 시 추가 설치할 수 있으나 Friend 모듈(KakaoPartnerSDKFriend, RxKakaoPartnerSDKFriend)은 Cocoapods으로 함께 설치하면 안 됩니다. 정적 프레임워크로 배포되는 FriendStatic 모듈은 Cocoapods으로 배포하는 Friend 모듈과 함께 사용할 수 없습니다.

정적 프레임워크로 KakaoPartnerSDKFriendStatic, RxKakaoPartnerSDKFriendStatic 모듈을 설치하는 경우에도 Podfile에 피커 사용 시 추가 설정은 필수입니다. 이 설정을 누락할 경우, 정상적으로 빌드를 완료할 수 없습니다.

아래 [다운로드] 버튼을 클릭해 Partner iOS SDK의 변경 이력 문서로 이동합니다. 해당 문서의 버전별 [다운로드]에서 [Static: Friend]을 클릭해 Friend 모듈의 정적 프레임워크 파일을 다운로드받습니다.

다운로드받은 파일을 압축 해제하면 KakaoPartnerSDKFriendStatic 폴더와 라이선스 파일을 확인할 수 있습니다.

KakaoPartnerSDKFriendStatic 폴더 안의 KakaoPartnerSDKFriendStatic.xcframework 폴더를 [Build Phase] > [Link Binary With Libraries]에 [+] 버튼 클릭 또는 드래그앤드롭(Drag and drop)해 추가합니다.

SwiftRxSwift

프레임워크 설정 화면(Swift)

정적 프레임워크 파일로 KakaoPartnerSDKFriendStatic, RxKakaoPartnerSDKFriendStatic 모듈을 설치할 경우, 피커에 사용되는 UI 요소 등 리소스 번들을 별도 설치해야 합니다. KakaoSDKFriendResources.bundle 파일을 [Build Phase] > [Copy Bundle Resources]에 [+] 버튼 클릭 또는 드래그앤드롭해 추가합니다.

리소스 번들 설정 화면