페이지 이동경로
  • 문서>
  • 시작하기

시작하기

Flutter 마이그레이션

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

Flutter SDK 0.9.0 이하 버전 사용 시, 이 문서를 참고하여 최신 버전에 맞게 애플리케이션(이하 앱)과 Flutter SDK를 업데이트해야 합니다.

주요 변경 사항

  • 멀티 패키지 구조 도입
  • 일부 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 이하 버전 1.0.0 이상 버전
customMemo() sendCustomMemo()
defaultMemo() sendDefaultMemo()
customMessage() sendCustomMessage()
defaultMessage() sendDefaultMessage()
scrapMemo() sendScrapMemo()
scrapMessage() sendScrapMessage()
plusFriends() channels()
channelAddUrl() addChannelUrl()

카카오스토리

kakao_flutter_sdk_story 패키지에서 제공하는 메서드의 변경 사항은 다음과 같습니다.

0.9.0 이하 버전 1.0.0 이상 버전
myStory() story()
myStories() stories()
postPhotos() postPhoto()
deleteStory() delete()
scrapLink() linkInfo()
scrapImages() upload()

카카오톡 공유

kakao_flutter_sdk_link 패키지에서 제공하는 메서드의 변경 사항은 다음과 같습니다.

0.9.0 이하 버전 1.0.0 이상 버전
customWithTalk() customTemplate()
defaultWithTalk() defaultTemplate()
scrapWithTalk() scrapTemplate()
customWithWeb() customTemplateUri()
defaultWithWeb() defaultTemplateUri()
scrapWithWeb() scrapTemplateUri()

모델 변경 사항

User

사용자 정보 가져오기의 응답 객체로, 변경 사항은 다음과 같습니다.

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

Friends

친구 목록 가져오기의 응답 객체로, 변경 사항은 다음과 같습니다.

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

StoryPostResult

DefaultTemplate

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

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

DefaultTemplate

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