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

kakao developers

Related sites
  • Docs
  • Flutter
  • Migrate v1 to v2

사이드 메뉴

Kakao Map

Search

Flutter

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

ChangeFlutter SDK v1Flutter SDK v2
Web browser launch method and parameter changeslaunchBrowserTab(shareUrl, popupOpen: true)launchBrowser(shareUrl)
launchBrowser() parameter removedpopupOpen: true-
launchBrowser() parameter added-useBrowserSessionOnIOS
Kakao scheme receiving flow unifiedStream<String?> kakaoSchemeStream
Future<String?> receiveKakaoScheme()
void receiveKakaoScheme(Function(Uri)? callback)

Kakao Login

ChangeFlutter SDK v1Flutter SDK v2
Parameter notation changedUserApi.revokeServiceTerms(tags: tags)
UserApi.revokeScopes(scopes: scopes)
UserApi.revokeServiceTerms(tags)
UserApi.revokeScopes(scopes)

Kakao Talk Share

ChangeFlutter SDK v1Flutter SDK v2
Methods removedWebSharerClient.uploadImage()
WebSharerClient.scrapImage()
-
Return type changedShareClient.shareDefault(Future<Uri>)
ShareClient.shareCustom(Future<Uri>)
ShareClient.shareScrap(Future<Uri>)
ShareClient.shareDefault(Future<void>)
ShareClient.shareCustom(Future<void>)
ShareClient.shareScrap(Future<void>)
Behavior changedCalls the following methods return a sharing URI
  • ShareClient.shareDefault()
  • ShareClient.shareCustom()
  • ShareClient.shareScrap()
Calls the following methods launch Kakao Talk for sharing
  • ShareClient.shareDefault()
  • ShareClient.shareCustom()
  • ShareClient.shareScrap()
Parameter changedShareClient.uploadImage(File? image)ShareClient.uploadImage(String? imagePath)

Was this helpful?