Migrate from v1 to v2

This document provides guidance for users upgrading from Flutter SDK (Kakao SDK for Flutter) v1 (versions earlier than 2.0.0) to v2 (versions 2.0.0 and later).

Important changes

• Initialization method changed
  • Changed: KakaoSdk.init() → await KakaoSdk.init()
• Minimum supported versions changed
  • Changed: Dart 3.4.0 or higher → 3.9.0 or higher
  • Changed: Flutter 3.22.0 or higher → 3.38.0 or higher
• Web popup login is no longer supported due to security issues
  • No longer supported on web: UserApi.loginWithKakaoTalk()
  • No longer supported on web: UserApi.loginWithKakaoAccount()
  • No longer supported on web: UserApi.loginWithNewScopes()
• Android custom URL handler classes changed
  • Kakao Login
    • Changed: android:name="com.kakao.sdk.flutter.AuthCodeCustomTabsActivity" → android:name="com.kakao.sdk.flutter.auth.AuthCodeHandlerActivity"
  • Select shipping address
    • Changed: android:name="com.kakao.sdk.flutter.AppsHandlerActivity" → android:name="com.kakao.sdk.flutter.auth.AppsHandlerActivity"
  • Follow Kakao Talk Channel
    • Changed: android:name="com.kakao.sdk.flutter.FollowChannelHandlerActivity" → android:name="com.kakao.sdk.flutter.auth.AppsHandlerActivity"
• Custom URL scheme receiving flow changed to a single method regardless of app running state
  • Removed: Future<String?> receiveKakaoScheme()
  • Removed: Stream<String?> kakaoSchemeStream()
  • Added: void receiveKakaoScheme(Function(Uri)? callback)
• Web URL execution interface changed
  • Changed: launchBrowserTab() → launchUrl()
• Kakao Talk Share flow simplified
  • Changed: ShareClient.shareDefault(), ShareClient.shareCustom(), and ShareClient.shareScrap() now execute Kakao Talk launch for sharing instead of returning a URI

Interface changes

Common

Change	Flutter SDK v1	Flutter SDK v2
Web browser launch method and parameter changes	launchBrowserTab(shareUrl, popupOpen: true)	launchBrowser(shareUrl)
launchBrowser() parameter removed	popupOpen: true	-
launchBrowser() parameter added	-	useBrowserSessionOnIOS
Kakao scheme receiving flow unified	Stream<String?> kakaoSchemeStream Future<String?> receiveKakaoScheme()	void receiveKakaoScheme(Function(Uri)? callback)

Kakao Login

Change	Flutter SDK v1	Flutter SDK v2
Parameter notation changed	UserApi.revokeServiceTerms(tags: tags) UserApi.revokeScopes(scopes: scopes)	UserApi.revokeServiceTerms(tags) UserApi.revokeScopes(scopes)

Kakao Talk Share

Change	Flutter SDK v1	Flutter SDK v2
Methods removed	WebSharerClient.uploadImage() WebSharerClient.scrapImage()	-
Return type changed	ShareClient.shareDefault(Future<Uri>) ShareClient.shareCustom(Future<Uri>) ShareClient.shareScrap(Future<Uri>)	ShareClient.shareDefault(Future<void>) ShareClient.shareCustom(Future<void>) ShareClient.shareScrap(Future<void>)
Behavior changed	ShareClient.shareDefault(), ShareClient.shareCustom(), ShareClient.shareScrap() Returns a sharing URI when called.	ShareClient.shareDefault(), ShareClient.shareCustom(), ShareClient.shareScrap() Launches Kakao Talk for sharing when called.
Parameter changed	ShareClient.uploadImage(File? image)	ShareClient.uploadImage(String? imagePath)