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

시작하기

Flutter

이 문서는 Kakao SDK for Flutter(이하 Flutter SDK) 사용법을 설명합니다.

기능 소개

Flutter SDK는 Flutter로 작성된 애플리케이션(이하 앱)에서 카카오 API를 편리하게 호출할 수 있도록 도와주는 SDK입니다. 현재 Android 및 iOS 앱을 정식으로 지원하며, 추후 Web 앱 또한 지원 예정입니다.

요구 사양

Flutter SDK를 사용하기 위한 최소 요구 사양은 아래와 같습니다.

  • Flutter 2.0 이상
  • Dart 2.12.0 이상
  • Android Studio 3.0 이상
  • Android 4.4(API 19) 이상
  • iOS 11 이상
참고: 외부 라이브러리 의존성

Flutter SDK는 다음 라이브러리를 사용합니다.

설치하기

Step 1. pubspec.yaml 파일에 의존성 설정

pubspec.yaml 파일의 dependencies 하위에 다음과 같이 Flutter SDK에 대한 의존성을 추가합니다. 전체 설치 또는 필요한 패키지 선택 설치가 가능합니다. 설정 추가 시 들여 쓰기에 주의합니다.

dependencies:
  kakao_flutter_sdk: ^1.1.1 # 전체 추가
  kakao_flutter_sdk_user: ^1.1.1 # 카카오 로그인
  kakao_flutter_sdk_talk: ^1.1.1 # 카카오톡(소셜, 메시지)
  kakao_flutter_sdk_story: ^1.1.1 # 카카오스토리
  kakao_flutter_sdk_link: ^1.1.1 # 카카오링크
  kakao_flutter_sdk_navi: ^1.1.1 # 카카오내비
Step 2. Flutter SDK 설치

[Flutter commands] 바의 [Pub get] 버튼을 눌러 Flutter SDK를 설치합니다.

정식 서비스 시 변경 사항

Flutter SDK 0.9.0 이하 버전을 사용하고 있었다면, 최신 버전 업데이트 시 Flutter 마이그레이션을 참고하여 변경 사항을 적용해야 합니다.

참고: 모듈간 의존성

Kakao SDK의 일부 모듈은 다른 모듈에 의존성이 있으며, 각 모듈은 설치 시 의존하는 모듈을 자동으로 함께 설치합니다. 모듈간 의존성 구조는 아래 이미지를 참고합니다.

모듈간 의존성 구조도

설정하기

[내 애플리케이션] > [플랫폼]에서 Android, iOS 플랫폼 정보를 입력합니다. 이 설정은 Flutter SDK를 통해 카카오 API를 사용하려면 필수입니다. 자세한 안내는 플랫폼 등록을 참고합니다.

참고: 번들 ID 확인 방법

iOS 플랫폼 등록 시 필요한 앱의 번들 ID는 Xcode의 [Target] > [General] > [Bundle Identifier]에서 확인할 수 있습니다. Xcode에서 프로젝트를 직접 열거나, ${Project} > ios 폴더에 마우스 우클릭하여 Xcode를 통해 프로젝트를 열 수 있습니다. 아래 이미지를 참고합니다.

초기화

설치설정을 완료했다면, 초기화를 거쳐 Flutter SDK를 사용할 수 있습니다.

아래 예제를 참고하여 main() 함수에 Flutter SDK 초기화 코드를 추가합니다. runApp() 메서드 호출 전 Flutter SDK를 초기화해야 한다는 점에 주의합니다. ${YOUR_NATIVE_APP_KEY} 부분에는 [내 애플리케이션] > [앱 키]에서 확인한 네이티브 앱 키를 입력합니다.

import 'package:kakao_flutter_sdk_common/kakao_flutter_sdk_common.dart';

void main() {
    ...
    KakaoSdk.init(nativeAppKey: '${YOUR_NATIVE_APP_KEY}');
    runApp(MyApp());
    ...
}

더보기