flutter_kakao_maps_sdk

Description:

flutter kakao maps sdk

flutter_kakao_maps_sdk #
KakaoMapsSDK for Flutter
⚠️ 현재 개발 진행중인 패키지입니다.
Requirements #

Dart sdk: ">=3.1.0 <4.0.0"
Flutter: ">=3.13.0"
Android: 6.0(API level 23) 이상 (참고)
iOS: iOS13 이상 (참고)

Installation #
$ flutter pub add flutter_kakao_maps_sdk
copied to clipboard
Configuration #
Android #


앱 등록
먼저, 카카오 개발자 사이트 에서 지도를 사용 할 앱 등록을 합니다. 자세한 안내는 앱 등록 을 참고합니다.


네이티브 앱 키 추가
카카오 개발자 사이트를 통해 앱 등록을 하면 네이티브 앱 키(App Key) 가 발급됩니다. 발급받은 네이티브 앱 키를 AndroidManifest.xml 의 <application> 안에 아래와 같이 추가합니다. 앱 키 관련 자세한 안내는 앱 키 를 참고합니다.
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
<uses-permission android:name="android.permission.INTERNET" />

...

<application
...
<meta-data
android:name="com.kakao.vectormap.APP_KEY"
android:value="${APP_KEY}"/> // 네이티브 앱 키 넣기
</application>
</manifest>
copied to clipboard
phase 마다 다르게 앱 키를 넣어야 할 때는 android:name="com.kakao.vectormap.${phase}.APP_KEY" 이렇게 이름 설정을 합니다.


키 해시 추가
마지막으로, 플랫폼 등록 후 키 해시(Key Hash) 를 추가하면 인증을 위한 절차가 끝납니다. 이와 관련 자세한 안내는 플랫폼 등록 과 키 해시 부분을 참고합니다.


프로가드 설정 (선택)
앱 배포 시, 코드 축소, 난독화, 최적화 를 하는 경우, 카카오지도 SDK를 제외하고 진행하기 위하여 ProGuard 규칙 파일에 다음 코드를 추가합니다.
-keep class com.kakao.vectormap.** { *; }
-keep interface com.kakao.vectormap.**
copied to clipboard


iOS #


앱 등록
먼저, 카카오 개발자 사이트 에서 지도를 사용 할 앱 등록을 합니다. 자세한 안내는 앱 등록 을 참고합니다.


네이티브 앱 키 추가
카카오 개발자 사이트를 통해 앱 등록을 하면 네이티브 앱 키(App Key) 가 발급됩니다. Info.plist 에 아래와 같은 필드를 추가합니다.
<key>KAKAO_APP_KEY</key>
<string>${APP_KEY}</string>
<key>KAKAO_PHASE</key>
<string>${APP_PHASE}</string>
copied to clipboard
KAKAO_APP_KEY : KakaoMapsSDK 사용을 위해서 필수로 입력해야 하는 필드입니다. 발급받은 네이티브 앱 키를 해당 필드에 등록합니다.
KAKAO_PHASE : 테스트를 위해 phase별로 등록한 앱은 앱의 phase 정보를 해당 필드에 등록합니다. alpha, beta, sandbox중 하나를 해당 필드에 등록합니다. 예를 들어, https://sandbox-developers.kakao.com 의 경우 KAKAO_PHASE 필드에 sandbox 로 명시합니다. real인 경우, 공란으로 둡니다.


프로모션 디스플레이 설정 (선택)
ProMotion Display가 지원되는 기기에 대해서만 프로모션이 동작합니다. Info.plist 에 아래와 같은 필드를 추가합니다.
<key>CADisableMinimumFrameDurationOnPhone</key>
<true/>
copied to clipboard