v1에서 v2로 마이그레이션

이 문서는 Flutter SDK(Kakao SDK for Flutter) v1(2.0.0 미만 버전)에서 v2(2.0.0 이상 버전)로 업그레이드하는 사용자를 위한 정보를 제공합니다.

주요 변경 사항

• 초기화 방식 변경
  • 변경: KakaoSdk.init() → await KakaoSdk.init()
• 최소 지원 버전 변경
  • 변경: Dart: 3.4.0 이상 → 3.9.0 이상
  • 변경: Flutter: 3.22.0 이상 → 3.38.0 이상
• 보안상의 이슈로 웹 팝업 방식 로그인 지원 종료
  • 웹 환경에서 지원 종료: UserApi.loginWithKakaoTalk()
  • 웹 환경에서 지원 종료: UserApi.loginWithKakaoAccount()
  • 웹 환경에서 지원 종료: UserApi.loginWithNewScopes()
• 안드로이드 커스텀 URL 클래스 수정
  • 카카오 로그인
    • 변경: android:name="com.kakao.sdk.flutter.AuthCodeCustomTabsActivity" → android:name="com.kakao.sdk.flutter.auth.AuthCodeHandlerActivity"
  • 배송지 선택
    • 변경: android:name="com.kakao.sdk.flutter.AppsHandlerActivity" → android:name="com.kakao.sdk.flutter.auth.AppsHandlerActivity"
  • 카카오톡 채널 간편 추가
    • 변경: android:name="com.kakao.sdk.flutter.FollowChannelHandlerActivity" → android:name="com.kakao.sdk.flutter.auth.AppsHandlerActivity"
• 커스텀 URL 스킴 수신 메서드 동작 방식 변경, 앱의 실행 여부와 상관 없이 단일 메서드로 동작
  • 제거: Future<String?> receiveKakaoScheme()
  • 제거: Stream<String?> kakaoSchemeStream()
  • 추가: void receiveKakaoScheme(Function(Uri)? callback)
• 웹 URL 실행 인터페이스 변경
  • 변경: launchBrowserTab() → launchUrl()
• 카카오톡 공유 동작 간소화
  • 변경: ShareClient.shareDefault(), ShareClient.shareCustom(), ShareClient.shareScrap() 호출 시, URI 반환 → 카카오톡 실행

인터페이스 변경 사항

공통

변경 사항	Flutter SDK v1	Flutter SDK v2
웹 브라우저 실행 메서드 및 파라미터 변경	launchBrowserTab(shareUrl, popupOpen: true)	launchBrowser(shareUrl))
launchBrowser() 파라미터 삭제	popupOpen: true	-
launchBrowser() 파라미터 추가	-	useBrowserSessionOnIOS
카카오 스킴 수신 방식 통일	Stream<String?> kakaoSchemeStream Future<String?> receiveKakaoScheme()	void receiveKakaoScheme(Function(Uri)? callback)

카카오 로그인

변경 사항	Flutter SDK v1	Flutter SDK v2
파라미터 표기 변경	UserApi.revokeServiceTerms(tags: tags) UserApi.revokeScopes(scopes: scopes)	UserApi.revokeServiceTerms(tags) UserApi.revokeScopes(scopes)

카카오톡 공유

변경 사항	Flutter SDK v1	Flutter SDK v2
메서드 제거	WebSharerClient.uploadImage() WebSharerClient.scrapImage()	-
메서드 반환 타입 변경	ShareClient.shareDefault(Future<Uri>) ShareClient.shareCustom(Future<Uri>) ShareClient.shareScrap(Future<Uri>)	ShareClient.shareDefault(Future<void>) ShareClient.shareCustom(Future<void>) ShareClient.shareScrap(Future<void>)
메서드 동작 변경	ShareClient.shareDefault(), ShareClient.shareCustom(), ShareClient.shareScrap() 호출 시 공유하기 URI 반환	ShareClient.shareDefault(), ShareClient.shareCustom(), ShareClient.shareScrap() 호출 시 공유를 위한 카카오톡 실행
파라미터 변경	ShareClient.uploadImage(File? image)	ShareClient.uploadImage(String? imagePath)