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

kakao developers

관련사이트

사이드 메뉴

오픈 문서

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

인공지능

플랫폼 API

API 제공

전용 API

어드민 API

더 보기

Android

다운로드

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

최신 버전

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

SDK버전배포일참고
Partner Android SDK Full Source & Samples2.24.02026.6.12레퍼런스

오픈소스 사용 고지문

Android SDK는 오픈소스 라이브러리를 사용합니다. 관련 내용은 고지문에서 확인할 수 있습니다.

변경 이력

버전변경 날짜변경 이력
2.24.02026.6.12
  • 피커 기능 추가
    • 채팅방 피커 멀티 선택 지원
    • 탭 피커 초기 탭 설정 지원
    • 탭 피커의 친구 탭, 채팅방 탭, 채팅방 멤버 피커 단일 및 다중 선택 지원
  • 피커 인터페이스 변경
    • enableMulti 파라미터 제거
  • 채팅방 피커, 탭 피커 응답 클래스 변경
    • SelectedChat → SelectedChats
  • 피커 요청 파라미터 변경
    • selectParams, chatSelectParams, chatMemberSelectParams, initialPickerTab 프로퍼티 추가
    • maxPickableCount, minPickableCount 프로퍼티 SelectParams 클래스 하위로 이동
  • 카카오톡 프로필 조회 API 응답에 id 추가
  • 장기 미이용 앱 에러 코드 추가
  • 내부 개선
2.23.42026.4.14
  • compileSdk, targetSdk 36으로 변경
  • 안드로이드 16 기기로 채팅방 멤버 피커에서 시스템 뒤로가기 시 피커 종료 현상 수정
  • 내부 개선
2.23.32026.2.24
  • 내부 개선
2.23.22026.1.7
  • SSO 토큰 만료 여부 식별을 위한 isExpired 프로퍼티 추가
  • 내부 개선
2.23.12025.11.27
  • 카카오 로그인 방법 선택 API를 호출한 Activity가 MaterialComponents 기반 테마가 아닌 경우 크래시 발생하는 이슈 수정
2.23.02025.11.12
  • 카카오 로그인 방법 선택 API 추가
  • SSO 기능 추가
2.22.02025.9.30
  • 앱 차단 상태 에러 추가: ApiErrorCause.BlockedApp
  • 카카오계정 제재 에러명 변경: - ApiErrorCause.BlockedAction → ApiErrorCause.BlockedAccount
  • 채팅방 멤버 피커, 탭 피커: 싱글 선택 지원
  • 친구 피커 인터페이스에 파라미터 추가:
    • viewType: ViewType
    • enableMulti: Boolean
  • 피커 인터페이스 제거: selectFriendPopup, selectFriends, selectFriendsPopup, selectChatPopup, selectPopup
  • 피커 문구 오탈자 수정
  • 내부 개선
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
  • 다음 지원 기능 제거
  • 서로 다른 페이즈의 카카오톡 앱이 설치된 안드로이드 15 디바이스에서 카카오톡으로 메시지 발송 기능 실행 시 크래시 발생 문제 수정
  • 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
  • 친구, 채팅방 피커 관련 코드 패키지 변경
    • com.kakao.sdk.friend.* → com.kakao.sdk.friend.core.*
  • 친구 피커 API 응답 변경
    • maskingNickname 프로퍼티 추가
  • 배송지 선택, 배송지 등록, 배송지 수정 API 메서드 이름 변경
    • selectShippingAddresses() → selectShippingAddress()
    • createShippingAddresses() → createShippingAddress()
    • updateShippingAddresses() → updateShippingAddress()
  • 사용자 정보 조회 API 응답에 생일 윤달 여부 프로퍼티 추가
  • Omega 페이즈 제거
2.20.62024.9.12
  • 연령인증 정보 조회 API 응답에 hasCi 프로퍼티 추가
2.20.52024.8.28
  • 연령인증 정보 조회 API 응답에서 CI 관련 정보 제거
  • 사용자 정보 조회 API 응답에서 CI 관련 정보 제거
  • 사용자 정보 조회 API 응답의 User에 uuid 추가
  • compileSdk, targetSdk 34로 변경
  • Kotlin 2.0.0 버전에서 컴파일 실패하는 문제 수정
2.20.42024.7.19
  • 카카오톡 로그인, 카카오톡 인증 로그인 PIP 지원
  • 내부 개선
2.20.32024.6.20
  • 말풍선 출처 앱을 지정하는 파라미터 제공
    • 대상: partner-share 모듈의 WebSharerClient
2.20.22024.5.21
  • 카카오톡 인증 서비스 모듈(cert-rx) 추가
  • 카카오톡 인증 서비스 K3220 상품 지원
  • 내부 개선
2.20.12024.3.22
  • 카카오톡 인증 로그인에 identifyItems 파라미터 추가
  • 내부 개선
2.20.02024.3.4
  • 배송지 선택, 배송지 등록, 배송지 수정 API 추가
  • 메시지 템플릿 Content.title, Content.imageUrl nullable로 변경
  • TokenManager에 idToken이 누락되는 현상 수정
  • RxAuthApiClient.refreshToken() 호출 시 저장된 토큰이 없으면 크래시 발생하는 현상 수정
  • 내부 개선
2.19.02023.12.21
  • 카카오톡 채널 간편 추가(followChannel()) 지원
  • talk 모듈의 Friends 모델 내 serviceUserId 프로퍼티 삭제
  • 채팅방 피커 응답 변경
    • 삭제: type
    • 추가: roomType
  • 인하우스 앱: 채팅방 목록 조회 응답 변경
    • 삭제: chatType
    • 추가: roomType
  • Reactive Extensions(Rx) 라이브러리 사용 환경에서 필요 토큰을 누락한 API 요청 시 오류 발생 현상 수정
  • 내부 개선
2.18.02023.11.15
  • 카카오톡 친구 목록 조회 API의 friendType 파라미터 제거
  • 카카오톡 친구 목록 조회 API 응답 relation의 story 항목 제거
  • 피커 기능의 serviceTypeFilter 파라미터 제거
  • 내부 개선
2.17.02023.9.26
  • 카카오톡 채널 채팅, 카카오톡 채널 추가 신규 API 추가
    • 연결 페이지를 거치지 않고 카카오톡 채널로 바로 이동 (카카오톡 v10.0.5 이상)
    • 연결 페이지 URL을 반환하는 기존 API도 유지
  • 카카오톡 채널 채팅 연결 페이지 반환 API 변경
    • channelChatUrl()(Deprecate) → chatChannelUrl()
  • 내부 개선
  • OMEGA 페이즈 지원
  • 연령인증 정보 조회 API 최신 버전으로 변경
2.16.02023.9.7
  • 카카오톡 인증 서비스 모듈(cert) 추가, K2220 상품 지원
  • 피커 UI 최신화
  • 사용자 정보 조회 API에 properties 파라미터 추가
  • 카카오톡 채널 관계 조회 API 최신 버전으로 변경
  • 내부 개선
2.15.02023.7.13
  • 카카오계정 간편로그인 지원
  • 서비스 약관 동의 철회 API 추가
  • 동의항목 동의 내역 조회 API v2로 업데이트
  • 샘플앱 테스트 항목 개선
  • Automotive OS 전용 QR 로그인 페이지 적용
2.14.02023.5.31
  • 최소 지원 OS 버전 Android 6.0 이상으로 변경
  • 카카오톡 인증 로그인 settleId 파라미터 지원
  • 피커 안정성 개선
2.13.02023.2.28
  • SDK 내부에서 사용하는 라이브러리 버전 업데이트
  • 카카오 로그인 prompts 파라미터 값 변경
    • 삭제: Prompt.SIGNUP
    • 추가: Prompt.CREATE
  • verifyAge() 제공 모듈 및 클래스 변경: partner-auth → partner-user
  • Android Automotive OS 지원
2.12.12023.1.19
  • 특정 동선에서 피커 NullPointerException 발생하는 이슈 수정
  • androidx.fragment 일부 버전에서 탭 피커의 앱 바가 중복 생성되는 버그 수정
2.12.02022.12.14
  • 캘린더 메시지 템플릿 추가
2.11.22022.9.29
  • 다음-카카오 계정통합 동선 개선
2.11.12022.9.19
  • 초기화 메서드에 KA 헤더 정보용 서비스 SDK 식별자 파라미터 sdkIdentifier 추가
  • Android 13 대응
  • 피커 안정성 개선
  • androidx.fragment 1.5.0 이상 버전 사용 시 피커 크래시 현상 수정
  • 카카오톡으로 로그인 시 동의 화면 재생성되는 현상 수정
2.11.02022.6.29
  • 카카오톡 공유 제품명 변경에 따른 모듈, 클라이언트, 모델, 메서드 이름 변경
    • v2-partner-link → v2-partner-share
    • v2-partner-link-rx → v2-partner-share-rx
    • 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-partner-all, v2-partner-all-rx
    • v2-all, v2-all-rx
2.10.02022.5.25
  • 모듈 구조 변경
    • partner-friend 모듈이 friend 모듈을 참조하도록 변경
  • prompt.SIGNUP 추가
2.9.12022.5.11
  • 피커 안정성 개선
2.9.02022.3.18
  • OpenID Connect 지원
  • 내부 개선
2.8.62022.2.16
  • 내부 개선
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?
    • FriendRelation.talk: Relation → Relation?
    • FriendRelation.story: Relation → Relation?
  • 사용자 정보 조회 응답에 name 프로퍼티 추가
  • 카카오톡 친구 목록 조회 응답에 allowedMsg 프로퍼티 추가
  • Chat.unreadMesageCount 프로퍼티 삭제
  • 피커 버그 수정
2.8.22021.10.14
  • 채팅방 멤버 피커, 탭 피커 버그 수정
2.8.12021.9.28
  • 피드 메시지 기능 확장(참고: 피드 메시지)
    • FeedTemplate에 itemContent 프로퍼티 추가
    • ItemContent 모델 추가
2.8.02021.9.17
  • 탭 피커 기능 추가
2.7.02021.9.3
  • 채팅방 피커 기능 추가
  • 사용자 정보 조회(meForPartner()) 응답에 accountCreationDate, accountCreationDateNeedsAgreement 추가
2.6.02021.8.6
  • 친구 피커 정식 배포
  • 커머스 템플릿에 화폐 단위 파라미터 추가
  •   currencyUnit
  •   currencyUnitPosition
  • 프로필 동의항목 분리에 따른 Model 업데이트
  • 카카오계정 로그인 시 CustomTab이 계속 호출되는 이슈 수정
2.6.0-beta022021.7.16
  • 친구 피커 내부 로직 개선
  • 친구 피커 문구 수정 반영
  • KA 헤더 예외처리 추가
2.6.0-beta012021.6.30
  • 친구 피커 API 추가
2.5.32021.7.13
  • KA 헤더 예외처리 추가
2.5.22021.6.17
  • 스토리 쓰기 API: 파라미터명 변경
    • andoird/iosExecutionParams → andoird/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
  • DEV / SANDBOX 페이즈에서 카카오톡으로 로그인을 위한 카카오톡 패키지명 추가
2.4.12021.3.10
  • chatList(), chatMembers()의 secureResource 파라미터 삭제
  • 버그 수정
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
  • 신규 모듈 추가
    • partner-auth: 그룹 내 다른 앱의 refreshToken을 사용한 accessToken 발급 기능 제공
    • partner-link: 말풍선 출처 앱을 지정하는 파라미터 제공
  • 로그인 보안 향상을 위한 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.05
  • 강제 로그인 옵션 추가
  • 리스트 템플릿의 헤더 영역 배경 이미지 제거
2.0.22020.08.27
  • 메시지 템플릿 모델 클래스 패키지 변경
    • com.kakao.sdk.template → com.kakao.sdk.template.model
2.0.12020.08.21
  • 카카오내비 API 변경
    • 위도 및 경도 좌표 자료형 String으로 변경
    • 메서드명 변경: navigateUri() → navigateWebUrl()
    • 구조체명 변경: NaviOptions → NaviOption
2.0.02020.08.10
  • 정식 배포
2.0.0-beta072020.07.31
  • 클라이언트 이름 및 구조 개선
  • 토큰 및 토큰저장소 사용성 개선
2.0.0-beta062020.07.15
  • 카카오 로그인 API의 메서드명 일부 변경:
    • authorizeWithKakaoTalk()
    • loginWithKakaoTalk()
    • loginWithNewScopes()
    • isKakaoTalkLoginAvailable()
  • 토큰저장소 리턴타입 nullable로 변경
2.0.0-beta052020.06.30
  • Reactive Extensions(Rx) 라이브러리를 사용하지 않는 SDK 배포
  • AccessTokenInfo 응답에 expiresIn 프로퍼티 추가
2.0.0-beta042020.03.24
  • 로그인 계정 확인 페이지 적용
2.0.0-beta032020.02.14
  • 세부 스펙 변경
  • 버그 수정
2.0.0-beta022019.12.26
  • partner-common 모듈화
  • 버그 수정
2.0.0-beta012019.12.09
  • 베타 서비스 개시

도움이 되었나요?