본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

문서 홈

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

카카오맵

내비게이션

광고

검색

더 보기

iOS

다운로드

이 문서는 iOS SDK(Kakao SDK for iOS)의 최신 버전 정보와 변경 이력을 제공합니다.

Kakao SDK 사용 시 주의 사항

  • Kakao SDK를 사용함에 있어 사용자는 (주)카카오를 사칭해서는 안됩니다.

  • Kakao SDK 사용에 따라 발생하는 모든 책임은 전적으로 사용자에게 있으며, (주)카카오는 사용자 또는 제3자에 대해 어떠한 책임도 지지 않습니다.

  • 사용자는 Kakao SDK를 상업적 용도로 판매할 수 없습니다.

최신 버전

iOS SDK는 SPM으로 설치할 수 있습니다. 시작하기를 참고합니다.

지도 SDK

지도 iOS SDK 가이드를 참고합니다.

최신 버전 샘플

최신 버전의 샘플 앱을 받으려면 [다운로드]를 선택합니다.

SDK다운로드배포일참고
iOS SDK 2.27.3Sample2026.4.14레퍼런스
ReactiveX iOS SDK 2.27.3Sample2026.4.14레퍼런스
* 샘플 앱은 tuist 프로젝트로, 사용 전 tuist install을 실행해 필요한 라이브러리를 설치해야 함

오픈소스 사용 고지문

변경 이력

버전변경 날짜변경 이력다운로드
2.27.32026.4.14
  • 버그 수정
Sample
RxSample
2.27.22026.1.27
  • 버그 수정
Sample
RxSample
2.27.12026.1.7
  • 내부 개선
Sample
RxSample
2.27.02025.12.29
  • 버그 수정
  • RxAlamofire 의존성 제거
Sample
RxSample
2.26.02025.11.12Sample
RxSample
2.25.02025.10.1
  • 앱 차단 상태 에러 추가: ApiFailureReason.BlockedApp
  • 카카오계정 제재 에러명 변경: ApiFailureReason.Blocked → ApiFailureReason.BlockedAccount
  • 친구 피커 인터페이스 변경: selectFriend(params:, enableMulti:, viewType:, completion:)
  • 친구 피커 인터페이스 제거: selectFriendPopup, selectFriends, selectFriendsPopup
  • 내부 개선
Sample
RxSample
2.24.62025.7.30
  • 내부 개선
Sample
RxSample
2.24.52025.7.7
  • 버그 수정
Sample
RxSample
2.24.42025.6.4
  • 버그 수정
Sample
RxSample
2.24.32025.6.2
  • 내부 개선
Sample
RxSample
2.24.22025.5.12
  • KakaoSDKFriendResources.bundle의 Info.plist에서 CFBundleExecutable 키 제거
Sample
RxSample
2.24.12025.4.22
  • 버그 수정
Sample
RxSample
2.24.02025.3.10
  • 친구 피커 API 응답 변경
    • maskingProfileNickname 프로퍼티 추가
  • 사용자 정보 조회 API 응답에 생일 윤달 여부 프로퍼티 추가
  • 내부 개선
Sample
RxSample
2.23.02024.10.14
  • Cocoapods 지원 종료
Sample
RxSample
2.22.72024.9.12
  • 내부 개선
Sample
RxSample
2.22.62024.8.28
  • 사용자 정보 조회 API 응답에서 CI 관련 프로퍼티 제거
  • 사용자 정보 조회 API 응답의 User에 uuid 프로퍼티 추가
Sample
RxSample
2.22.52024.7.23
  • 내부 개선
Sample
RxSample
2.22.42024.7.10
  • 버그 수정
Sample
RxSample
2.22.32024.6.20
  • 버그 수정
Sample
RxSample
2.22.22024.5.21
  • 내부 개선
Sample
RxSample
2.22.12024.4.18
  • 버그 수정
Sample
RxSample
2.22.02024.3.22
  • 개인정보 보호 목록(Privacy Manifest) 파일 지원
    • KakaoSDKCommon: PrivacyInfo.xcprivacy 파일 추가
    • KakaoSDKCertCore: PrivacyInfo.xcprivacy 파일 추가, 서명 적용
    • Alamofire 버전 5.9.0로 변경
  • 내부 개선
Sample
RxSample
2.21.12024.3.15
  • 앱스토어 업로드 시 검증 단계에서 minimum os does not support 에러가 발생하는 현상 수정
    • Xcode 15.3 사용, 프로젝트의 iOS Deployment Target이 Kakao SDK의 설정인 13.0보다 높고, 바이너리 모듈(KakaoSDKFriendCore, KakaoSDKCertCore)을 사용하는 경우 발생
Sample
RxSample
2.21.02024.3.4
  • 배송지 선택 API 추가
  • 메시지 템플릿 Content.title, Content.imageUrl nullable로 변경
  • VisionOS 컴파일 지원
  • AuthController.handleOpenUrl(url:options) 메서드 내부 콜백 실행 성공 시 반환 값 true로 변경
  • 내부 개선
Sample
RxSample
2.20.02023.12.21
  • 카카오톡 채널 간편 추가(followChannel()) 지원
  • 내부 개선
Sample
RxSample
2.19.02023.11.15
  • 카카오스토리 모듈(KakaoSDKStory, RxKakaoSDKStory) 지원 종료
  • 내부 개선
Sample
RxSample
2.18.22023.11.3
  • 내부 개선
Sample
RxSample
2.18.12023.10.20
  • 내부 개선
Sample
RxSample
2.18.02023.9.26
  • 카카오톡으로 로그인의 launchMethod 기본값 .UniversalLink로 변경
  • 카카오톡 채널 채팅, 카카오톡 채널 추가 신규 API 추가
    • 연결 페이지를 거치지 않고 카카오톡 채널로 바로 이동 (카카오톡 v10.0.5 이상)
  • 연결 페이지 URL을 반환하는 기존 API도 유지
  • 카카오톡 채널 채팅 연결 페이지 반환 API 이름 변경
    • makeUrlForChannelChat()(Deprecate) → makeUrlForChatChannel()
  • 레퍼런스 DocC 적용
  • 내부 개선
Sample
RxSample
2.17.02023.9.7
  • 카카오톡 인증 서비스 모듈(Cert ) 추가, K2220 상품 지원
  • 피커 UI 최신화
  • 카카오톡 채널 관계 조회 API 최신 버전으로 변경
  • 내부 개선
Sample
RxSample
2.16.02023.7.13
  • iOS 최소 지원 버전 13.0으로 상향
  • Friends 모듈 SPM 지원
  • 카카오계정 간편로그인 지원을 위한 Prompt.SelectAccount 추가
  • 서비스 약관 동의 철회 API 추가
  • 동의항목 동의 내역 조회 API v2로 업데이트
  • 샘플 앱 테스트 항목 개선
Sample
RxSample
2.15.02023.4.14
  • 내부 개선
  • 버그 수정
Sample
RxSample
2.14.02023.2.14
  • 아래 모듈에 App Extension 지원
    • KakaoSDKCommon/RxKakaoSDKCommon, KakaoSDKAuth/RxKakaoSDKAuth, KakaoSDKShare/RxKakaoSDKShare, KakaoSDKTemplate
  • SPM으로 iOS SDK 설치 시, 대소문자 구분 APFS(Apple File System)에서 발생하는 패키지 참조 오류 수정
  • 카카오 로그인 prompts 파라미터에 Prompt.Create 값 추가
  • 내부 개선
Sample
RxSample
2.13.12022.12.30
  • Rx iOS SDK 2.12.0, 2.13.0 버전의 토큰 발급 및 갱신, 추가 동의 시 .TokenNotFound 버그 수정
Sample
RxSample
2.13.02022.12.14
  • 캘린더 메시지 템플릿 추가
Sample
RxSample
2.12.02022.12.1Sample
RxSample
2.11.32022.9.29
  • 내부 개선
Sample
RxSample
2.11.22022.9.19Sample
RxSample
2.11.12022.7.29
  • Xcode 14 이상 버전에서 발생하는 Swift 5.7 SE-0341 관련 빌드 오류 수정
Sample
RxSample
2.11.02022.6.29
  • 카카오톡 공유 제품명 변경에 따른 모듈, 클래스, 모델, 메서드 이름 변경
    • KakaoSDKLink → KakaoSDKShare
    • RxKakaoSDKLink → RxKakaoSDKShare
    • LinkApi → ShareApi
    • LinkResult → SharingResult
    • isKakaoLinkAvailable() → isKakaoTalkSharingAvailable()
    • isKakaoLinkUrl() → isKakaoTalkSharingUrl()
    • defaultLink() → shareDefault()
    • customLink() → shareCustom()
    • scrapLink() → shareScrap()
    • makeSharerUrlforDefaultLink() → makeDefaultUrl()
    • makeSharerUrlforCustomLink() → makeCustomUrl()
    • makeSharerUrlforScrapLink() → makeScrapUrl()
Sample
RxSample
2.10.12022.6.10
  • 버그 수정
Sample
RxSample
2.10.02022.5.25
  • KakaoSDKFriend 모듈 추가
    • 피커 및 UI 리소스 번들 제공
Sample
RxSample
2.9.12022.3.31
  • 카카오톡 공유 버그 수정
  • 레퍼런스 문구 수정
Sample
RxSample
2.9.02022.3.18
  • OpenID Connect 지원
  • signup() 메서드에 properties 파라미터 추가
Sample
RxSample
2.8.62022.2.16
  • 레거시(Legacy) 회원번호 지원을 위한 내부 개선
Sample
RxSample
2.8.52022.1.24
  • Swift Package Manager(SPM) 지원
  • 내부 코드 개선: KakaoSDKCommon
    • iOS 13 이상 환경에서 UIApplication.shared.keyWindow(Deprecate) 사용하지 않도록 변경
Sample
RxSample
2.8.42021.12.10
  • 토큰 갱신 메서드 이름 및 파라미터 변경
    • refreshAccessToken(refreshToken: String?) → refreshToken(token: OAuthToken?)
  • KakaoSDKNavi 모듈의 웹 길안내 지원 종료
    • webNavigateUrl() 메서드 삭제
    • 카카오내비 미설치 시 설치 페이지를 띄우도록 변경
Sample
RxSample
2.8.32021.11.18
  • KakaoSDKCommon, RxKakaoSDKCommon 모듈의 초기화 클래스명 변경
    • KakaoSDKCommon → KakaoSDK
    • RxKakaoSDKCommon → RxkakaoSDK
  • 일부 Model Nullability 변경
    • Friends.favoriteCount: Int → Int?
  • 카카오톡 친구 목록 조회 응답에 allowedMsg 필드 추가
  • 소스 저장소를 Nexus에서 Github으로 이전
Sample
RxSample
2.8.22021.10.26
  • RxSwift 6 및 Xcode 13 대응
    • Single 반환 시 에러 처리를 onError() → onFailure()로 변경
Sample
RxSample
2.8.12021.9.28
  • 피드 메시지 기능 확장(참고: 피드 메시지)
    • FeedTemplate에 itemContent 필드 추가
    • ItemContent 오브젝트 추가
Sample
RxSample
2.8.02021.9.17
  • 내부 개선
Sample
RxSample
2.7.12021.9.8
  • 버그 수정
Sample
RxSample
2.7.02021.9.3
  • 내부 개선
Sample
RxSample
2.6.02021.8.6
  • 커머스 템플릿에 화폐 단위 파라미터 추가
    • currencyUnit
    • currencyUnitPosition
  • 프로필 동의항목 분리에 따른 Model 업데이트
Sample
RxSample
2.5.62021.8.2
  • 버그 수정
Sample
RxSample
2.5.52021.7.14
  • 에러 관련 버그 수정 및 로직 개선
  • SdkError에서 GeneralFailed 삭제
Sample
RxSample
2.5.42021.7.8
  • 버그 수정
Sample
RxSample
2.5.32021.5.26
  • 카카오톡 채널 관계 조회 API의 url 및 Model 키 값 변경
    • ChannelRelations → Channels
    • ChannelRelation → Channel
  • 사용자 정보 조회 API의 Account Model에 profileNicknameNeedsAgreement, profileImageNeedsAgreement 추가
  • 버그 수정
Sample
RxSample
2.5.22021.5.3
  • 버그 수정
Sample
RxSample
2.5.02021.4.30
  • Swift5 (5.0) 마이그레이션
  • 동의항목 동의 내역 조회, 동의항목 동의 철회 API 추가
  • Model 정리
  • 사용자 정보 응답 중 프로필에 기본 이미지 여부(isDefaultImage) 추가
Sample
RxSample
2.4.12021.3.10
  • 버그 수정
Sample
RxSample
2.4.02021.3.2
  • 모듈 구조 개선
    • isKakaoTalkLoginAvailable(), loginWithKakaoTalk(), loginWithKakaoAccount() API KakaoSDKUser 모듈로 이동
    • 공통 모듈과 네트워크 모듈 분리
  • signup() API 추가
  • User 모델의 프로퍼티 추가(hasSignedUp, isKorean, isKoreanNeedsAgreement)
  • 카카오톡 친구 목록 조회 API에 friendOrder 파라미터 추가
Sample
RxSample
2.3.22021.2.8
  • 버그 수정
Sample
RxSample
2.3.12021.2.1
  • 버그 수정
    • iOS 14 대응, AuthenticationSession의 callbackURLScheme: 값 수정
Sample
RxSample
2.3.02021.1.21
  • 카카오 로그인에 OAuth Prompt 지원
Sample
RxSample
2.2.02020.12.18
  • 카카오톡 프로필 조회, 카카오톡 친구 목록 조회 API의 secure_resource 파라미터 삭제
    • 프로필 이미지 URL HTTPS로만 제공
  • 내부 함수 개선
Sample
RxSample
2.1.02020.12.9
  • 로그인 보안 향상을 위한 PKCE 적용
Sample
RxSample
2.0.52020.11.25
  • 카카오톡 채널 차단 상태(BLOCKED) 추가
Sample
RxSample
2.0.42020.10.12
  • 버그 수정
Sample
RxSample
2.0.32020.10.6
  • 강제 로그인 옵션 추가
  • 리스트 템플릿의 헤더 영역 배경 이미지 제거
Sample
RxSample
2.0.22020.9.4
  • Cocoapods DynamicCodable Dependency 삭제
  • serverCallbackArgs 처리 추가
Sample
RxSample
2.0.12020.8.21
  • Retry Request Error 처리 추가
  • NaviApi에 WGS84 인터페이스 추가
  • NaviOptions → NaviOption 구조체명 변경
Sample
RxSample
2.0.02020.8.10
  • 정식 배포
Sample
RxSample
2.0.0-beta.72020.7.31
  • Pod 소스와 샘플 앱 패키징 분리
  • 레퍼런스 문구 개선
Sample
RxSample
2.0.0-beta.62020.7.15
  • SDK API명 일부 수정:
    • KakaoSDKCommon.initSDK() 변경
    • AuthApi.shared.loginWithKakaoAccount() 추가
    • AuthApi.shared.loginWithKakaoTalk() 추가
SDK&Sample
RxSDK&RxSample
2.0.0-beta.52020.6.23
  • Reactive Extensions(Rx) 라이브러리를 사용하지 않는 일반 SDK 분리 배포:
    • KakaoSDK(신규)
    • RxKakaoSDK(기존 ReactiveX)
  • Alamofire 5 적용
SDK&Sample
RxSDK&RxSample
2.0.0-beta.42020.4.22
  • 디펜던시 버전 지정
  • 버그 수정
RxSDK&RxSample
2.0.0-beta.32020.3.24
  • 로그인 계정 확인 페이지 적용
  • 앱스토어 서밋 에러 해결 (코코아팟 베타버전 이슈)
RxSDK&RxSample
2.0.0-beta.22019.12.26
  • 토큰저장소 사용자화
  • 버그 수정
RxSDK&RxSample
2.0.0-beta.12019.12.9
  • 베타 서비스 개시
RxSDK&RxSample

도움이 되었나요?