마이그레이션

이 문서는 Flutter SDK(Kakao SDK for Flutter)의 정식 서비스 버전 변경 사항을 안내합니다.

주요 변경 사항

• 멀티 패키지 구조 도입
• 일부 API 지원 종료: Daum 검색, 로컬, 푸시 알림
• 초기화 방식 변경
  • KakaoContext → KakaoSdk.init()
• 로그아웃 및 연결 해제 시 토큰 폐기하도록 변경
• 액세스 토큰(Access token) 또는 리프레시 토큰(Refresh token) 만료 시 반환하는 에러 변경
  • KakaoClientError → KakaoAuthError 또는 KakaoApiError
• 카카오톡 공유 웹 공유 기능을 제공하기 위한 WebSharerClient 추가
  • LinkClient에서 웹 공유 기능을 분리하여 별도 클래스로 제공
• 일부 클래스 및 메서드 이름 및 구조 변경
  • Kakao SDK for Android, iOS와 동일한 기능 및 유사한 사용성 제공

메서드 이름 변경 사항

카카오톡

kakao_flutter_sdk_talk 패키지에서 제공하는 메서드의 변경 사항은 아래와 같습니다.

0.9.0 이하 버전	최신 버전
customMemo()	sendCustomMemo()
defaultMemo()	sendDefaultMemo()
customMessage()	sendCustomMessage()
defaultMessage()	sendDefaultMessage()
scrapMemo()	sendScrapMemo()
scrapMessage()	sendScrapMessage()
plusFriends()	channels()
channelAddUrl()	addChannelUrl()

카카오톡 공유

kakao_flutter_sdk_share 패키지에서 제공하는 메서드의 변경 사항은 아래와 같습니다.

0.9.0 이하 버전	최신 버전
defaultWithTalk()	shareDefault()
customWithTalk()	shareCustom()
scrapWithTalk()	shareScrap()
defaultWithWeb()	makeDefaultUrl()
customWithWeb()	makeCustomUrl()
scrapWithWeb()	makeScrapUrl()

모델 변경 사항

User

사용자 정보 조회의 응답 객체로, 변경 사항은 아래와 같습니다.

• 일부 열거형(enum) 값을 보다 직관적인 문자열로 수정 (예: TEEN → age_15_19, TWENTIES → age_20_29)

Friends

카카오톡 친구 목록 조회의 응답 객체로, 변경 사항은 아래와 같습니다.

• 친구 목록을 페이지 형태로 분할해 조회할 수 있도록 FriendsContext 추가
• 친구 목록 정렬 기준을 정의하는 Order 추가

DefaultTemplate

카카오톡 공유 또는 카카오톡 메시지에 사용하는 기본 템플릿으로, 변경 사항은 아래와 같습니다.

• ItemContent 내부 프로퍼티 타입 변경
  • profileImageUrl: String? → Uri?
  • titleImageUrl: String? → Uri?

NaviCoordType

• 열거형(enum) 클래스 NaviCoordType의 이름을 CoordType으로 변경