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

kakao developers

관련사이트

사이드 메뉴

문서 홈

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

카카오맵

내비게이션

광고

검색

더 보기

Android

다운로드

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

Kakao SDK 사용 시 주의 사항

  • Kakao SDK를 사용함에 있어 사용자는 (주)카카오를 사칭해서는 안됩니다.
  • Kakao SDK 사용에 따라 발생하는 모든 책임은 전적으로 사용자에게 있으며, (주)카카오는 사용자 또는 제3자에 대해 어떠한 책임도 지지 않습니다.
  • 사용자는 Kakao SDK를 상업적 용도로 판매할 수 없습니다.

최신 버전

Android SDK는 Gradle 저장소(Repository) 설정으로 설치할 수 있습니다. 최신 버전 및 샘플 앱을 다운로드 받으려면 [버전]을 선택합니다.

SDK버전배포일참고
Android SDK Full Source & Samples2.23.42026.4.14레퍼런스
지도 SDK

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

오픈소스 사용 고지문

변경 이력

버전변경 날짜변경 이력
2.23.42026.4.14
  • compileSdk, targetSdk 36으로 변경
  • 내부 개선
2.23.32026.2.24
  • 내부 개선
2.23.22026.1.7
  • 내부 개선
2.23.12025.11.27
  • 로그인 방법 선택 API를 호출한 Activity가 MaterialComponents 기반 테마가 아닌 경우 크래시 발생하는 이슈 수정
2.23.02025.11.12
2.22.02025.9.30
  • 앱 차단 상태 에러 추가: ApiErrorCause.BlockedApp
  • 카카오계정 제재 에러명 변경: ApiErrorCause.BlockedAction → ApiErrorCause.BlockedAccount
  • 친구 피커 인터페이스에 파라미터 추가:
    • viewType: ViewType
    • enableMulti: Boolean
  • 친구 피커 인터페이스 제거:
    • selectFriendPopup
    • selectFriends
    • selectFriendsPopup
  • 피커 문구 오탈자 수정
  • 내부 개선
2.21.72025.8.22
  • 피커 화면 표시 상태에서 앱이 백그라운드로 전환된 후 시스템에 의해 프로세스가 종료되면, 이후 앱 재실행 시 프로세스 복원 과정에서 크래시가 발생하는 문제 수정
  • SDK 2.21.2 이상 버전에서 kotlinx.serialization 1.7.0 이상 버전 적용 시 enum 타입 프로퍼티가 null로 매핑되는 문제 수정
  • 내부 개선
2.21.62025.7.23
  • 피커 안정성 개선
2.21.52025.7.7
  • 친구 피커 검색 결과에 내 프로필도 포함되도록 변경
  • 피커 동시 호출 시 리스트 아이템 중복 현상 수정
2.21.42025.6.2
  • Kotlin 2.0.0 이상 버전에서 앱 난독화 시 간헐적 크래시 발생 문제 수정
  • 내부 개선
2.21.32025.5.8
  • Android 13 디바이스에서 특정 SDK 버전(2.21.1, 2.21.2)의 피커 사용 시 간헐적인 크래시 발생 문제 수정
  • 내부 개선
2.21.22025.4.22
  • 내부 개선
2.21.12025.3.27
  • compileSdk, targetSdk 35로 변경
2.21.02025.3.10
  • friend-core 모듈 추가
  • 친구 피커 관련 코드 패키지 변경
    • com.kakao.sdk.friend.* → com.kakao.sdk.friend.core.*
  • 친구 피커 API 응답 변경
    • maskingNickname 프로퍼티 추가
  • 배송지 선택 API 메서드 이름 변경
    • selectShippingAddresses() → selectShippingAddress()
  • 사용자 정보 조회 API 응답에 생일 윤달 여부 프로퍼티 추가
2.20.62024.9.12
  • 내부 개선
2.20.52024.8.28
  • 사용자 정보 조회 API 응답에서 CI 관련 정보 제거
  • 사용자 정보 조회 API 응답의 User에 uuid 추가
  • compileSdk, targetSdk 34로 변경
  • Kotlin 2.0.0 버전에서 컴파일 실패하는 문제 수정
2.20.42024.7.19
  • 카카오톡 로그인 PIP 지원
  • 내부 개선
2.20.32024.6.20
  • 내부 개선
2.20.22024.5.21
  • 내부 개선
2.20.12024.3.22
  • 내부 개선
2.20.02024.3.4
  • 배송지 선택 API 추가
  • 메시지 템플릿 Content.title, Content.imageUrl nullable로 변경
  • TokenManager에 idToken이 누락되는 현상 수정
  • RxAuthApiClient.refreshToken() 호출 시 저장된 토큰이 없으면 크래시 발생하는 현상 수정
  • 내부 개선
2.19.02023.12.21
  • 카카오톡 채널 간편 추가(followChannel()) 지원
  • Reactive Extensions(Rx) 라이브러리 사용 환경에서 필요 토큰을 누락한 API 요청 시 오류 발생 현상 수정
  • 내부 개선
2.18.02023.11.15
  • 카카오스토리 모듈(story) 지원 종료
  • 내부 개선
2.17.02023.9.26
  • 카카오톡 채널 채팅, 카카오톡 채널 추가 신규 API 추가
    • 연결 페이지를 거치지 않고 카카오톡 채널로 바로 이동 (카카오톡 v10.0.5 이상)
    • 연결 페이지 URL을 반환하는 기존 API도 유지
  • 카카오톡 채널 채팅 연결 페이지 반환 API 이름 변경
    • channelChatUrl()(Deprecate) → chatChannelUrl()
  • 내부 개선
2.16.02023.9.7
  • 카카오톡 인증 서비스 모듈(cert) 추가, K2220 상품 지원
  • 피커 UI 최신화
  • 사용자 정보 조회 API에 properties 파라미터 추가
  • 카카오톡 채널 관계 조회 API 최신 버전으로 변경
  • 내부 개선
2.15.02023.7.13
  • 카카오계정 간편로그인 지원
  • 서비스 약관 동의 철회 API 추가
  • 동의항목 동의 내역 조회 API v2로 업데이트
  • 샘플앱 테스트 항목 개선
2.14.02023.5.31
  • 최소 지원 OS 버전 Android 6.0 이상으로 변경
  • 피커 안정성 개선
  • 내부 개선
2.13.02023.2.28
  • SDK 내부에서 사용하는 라이브러리 버전 업데이트
  • 카카오 로그인 prompts 파라미터에 Prompt.CREATE 값 추가
2.12.12023.1.19
2.12.02022.12.14
  • 캘린더 메시지 템플릿 추가
2.11.22022.9.29
  • 내부 개선
2.11.12022.9.19
  • Android 13 대응
  • 피커 안정성 개선
  • 카카오톡으로 로그인 시 동의 화면 재생성되는 현상 수정
  • 내부 개선
2.11.02022.6.29
  • 카카오톡 공유 제품명 변경에 따른 모듈, 클라이언트, 모델, 메서드 이름 변경
    • v2-link → v2-share
    • v2-link-rx → v2-share-rx
    • LinkClient → ShareClient
    • LinkResult → SharingResult
    • isKakaoLinkAvailable() → isKakaoTalkSharingAvailable()
    • defaultTemplate() → shareDefault()
    • customTemplate() → shareCustom()
    • scrapTemplate() → shareScrap()
    • defaultTemplateUri() → makeDefaultUrl()
    • customTemplateUri() → makeCustomUrl()
    • scrapTemplateUri() → makeScrapUrl()
  • 통합 모듈 추가
    • v2-all, v2-all-rx
2.10.02022.5.25
  • friend 모듈 추가
    • 피커 및 UI 리소스 번들 제공
2.9.12022.5.11
  • 내부 개선
2.9.02022.3.18
  • OpenID Connect 지원
  • 내부 개선
2.8.62022.2.16
  • 레거시(Legacy) 회원번호 지원을 위한 내부 개선
2.8.52022.1.24
  • 버그 수정
2.8.42021.12.10
  • 토큰 갱신 메서드 이름 변경
    • refreshAccessToken() → refreshToken()
  • v2-navi 모듈의 웹 길안내 지원 종료
    • navigateWebUrl() 메서드 삭제
    • 카카오내비 미설치 시 설치 페이지를 띄우도록 변경
  • 버그 수정
2.8.32021.11.18
  • 일부 Model Nullability 변경
    • AccessTokenInfo.id: Long → Long?
    • User.id: Long → Long?
    • Friend.favoriteCount: Int → Int?
  • 카카오톡 친구 목록 조회 응답에 allowedMsg 프로퍼티 추가
2.8.22021.10.14
  • 내부 개선
2.8.12021.9.17
  • 피드 메시지 기능 확장(참고: 피드 메시지)
    • FeedTemplate에 itemContent 프로퍼티 추가
    • ItemContent 모델 추가
2.8.02021.9.17
  • 버그 수정
2.7.02021.9.3
2.6.02021.8.6
  • 커머스 템플릿에 화폐 단위 파라미터 추가
  •   currencyUnit
  •   currencyUnitPosition
  • 프로필 동의항목 분리에 따른 Model 업데이트
  • 버그 수정
2.5.32021.7.13
  • HTTP 헤더 인코딩 예외처리 추가
2.5.22021.6.17
  • 스토리 쓰기 API: 파라미터명 변경
    • android/iosExecutionParams → android/iosExecParam
    • android/iosMarketParams → android/iosMarketParam
  • 버그 수정
2.5.12021.5.26
  • 카카오톡 채널 관계 조회 API의 url 및 Model 키 값 변경
    • ChannelRelations → Channels
    • ChannelRelation → Channel
  • 사용자 정보 조회 API의 Account Model에 profileNicknameNeedsAgreement, profileImageNeedsAgreement 추가
2.5.02021.4.30
  • 동의항목 동의 내역 조회, 동의항목 동의 철회 API 추가
  • Model 정리
  • 사용자 정보 응답 중 프로필의 기본 이미지 여부(isDefaultImage) 추가
2.4.22021.3.29
  • 버그 수정
2.4.12021.3.10
  • 버그 수정
2.4.02021.3.2
  • 모듈 구조 개선
    • isKakaoTalkLoginAvailable(), loginWithKakaoTalk(), loginWithKakaoAccount() API v2-user 모듈로 이동
    • 공통 모듈과 네트워크 모듈 분리
  • signup() API 추가
  • User 모델의 프로퍼티 추가(hasSignedUp, birthdayType, isKorean, isKoreanNeedsAgreement)
  • 카카오톡 친구 목록 조회 API에 friendOrder 파라미터 추가
2.3.02021.1.21
  • 카카오 로그인에 OAuth Prompt 지원
2.2.02020.12.18
  • 카카오톡 프로필 조회, 카카오톡 친구 목록 조회 API의 secure_resource 파라미터 삭제
    • 프로필 이미지 URL HTTPS로만 제공
  • 내부 함수 개선
2.1.02020.12.9
  • 로그인 보안 향상을 위한 PKCE 적용
2.0.62020.11.25
  • 카카오톡 채널 차단 상태(BLOCKED) 추가
2.0.52020.10.23
  • 버그 수정
2.0.42020.10.20
  • Android Studio 요구 사양 3.6.1 이상으로 변경
  • 버그 수정
    • Android 11 이상 타게팅 시 카카오톡 간편로그인 등 외부 패키지 사용 불가능 현상 대응
2.0.32020.10.5
  • 강제 로그인 옵션 추가
  • 리스트 템플릿의 헤더 영역 배경 이미지 제거
2.0.22020.8.27
  • 메시지 템플릿 모델 클래스 패키지 변경
    • com.kakao.sdk.template → com.kakao.sdk.template.model
2.0.12020.8.21
  • 카카오내비 API 변경
    • 위도 및 경도 좌표 자료형 String으로 변경
    • 메소드명: navigateUri() → navigateWebUrl()
    • 구조체명: NaviOptions → NaviOption
2.0.02020.8.10
  • 정식 배포
2.0.0-beta072020.7.31
  • 클라이언트 이름 및 구조 개선
  • 토큰 및 토큰저장소 사용성 개선
2.0.0-beta062020.7.15
  • 카카오 로그인 API의 메소드명 일부 변경:
    • authorizeWithKakaoTalk()
    • loginWithKakaoTalk()
    • loginWithNewScopes()
    • isKakaoTalkLoginAvailable()
  • 토큰저장소 리턴타입 nullable로 변경
2.0.0-beta052020.6.30
  • Reactive Extensions(Rx) 라이브러리를 사용하지 않는 SDK 배포
  • AccessTokenInfo 응답에 expiresIn 프로퍼티 추가
2.0.0-beta042020.3.24
  • 로그인 계정 확인 페이지 적용
2.0.0-beta032020.2.14
  • 세부 스펙 변경
  • 버그 수정
2.0.0-beta022019.12.26
  • 버그 수정
2.0.0-beta012019.12.9
  • 베타 서비스 개시

도움이 되었나요?