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

kakao developers

관련사이트
  • 문서
  • Flutter
  • v1에서 v2로 마이그레이션

사이드 메뉴

문서 홈

시작하기

카카오디벨로퍼스

로그인

커뮤니케이션

카카오맵

내비게이션

광고

검색

더 보기

Flutter

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 v1Flutter 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 v1Flutter SDK v2
파라미터 표기 변경UserApi.revokeServiceTerms(tags: tags)
UserApi.revokeScopes(scopes: scopes)		UserApi.revokeServiceTerms(tags)
UserApi.revokeScopes(scopes)

카카오톡 공유

변경 사항Flutter SDK v1Flutter 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>)
메서드 동작 변경아래 메서드 호출 시 카카오톡 공유 URI 반환
  • ShareClient.shareDefault()
  • ShareClient.shareCustom()
  • ShareClient.shareScrap()
아래 메서드 호출 시 공유를 위한 카카오톡 실행
  • ShareClient.shareDefault()
  • ShareClient.shareCustom()
  • ShareClient.shareScrap()
파라미터 변경ShareClient.uploadImage(File? image)ShareClient.uploadImage(String? imagePath)

도움이 되었나요?