@actbase/react-native-kakaosdk

KakaoSDK for React Native

기능

• 카카오 사용자관리
• 카카오링크
• 카카오톡
• 카카오스토리
• 카카오톡 채널
• 카카오 내비

기본설정하기

iOS 설정

프로젝트에 내 앱 설정

카카오계정을 통해 인증을 받고 자신의 앱 실행을 위해서 아래 사진과 같이 URL Types 항목을 추가해야 합니다. URL Schemes에는 KAKAO_APP_KEY 앞에 "kakao" 문자열을 붙여서 등록합니다.

카카오 개발자 웹사이트에 등록된 해당 앱의 네이티브 앱 키를 프로젝트 plist 파일에 등록을 합니다. "KAKAO_APP_KEY"라는 이름으로 Key를 추가하고, Type은 String, Value는 해당 앱의 네이티브 앱 키 값으로 등록합니다.

프로젝트에 내 앱 설정(iOS9 지원)

iOS9에서는 다양한 기능이 추가되면서 동작 및 설정의 변화가 생겼습니다. iOS9에서 올바로 Kakao SDK를 사용하기 위해서는 다음과 같은 두가지 설정을 앱의 plist(또는 프로젝트의 Info 설정)에 반드시 해 주어야 합니다.

Kakao SDK가 사용하는 카카오 앱들의 커스텀 스킴 스위칭을 허용하는 화이트리스트 추가 두번째, LSApplicationQueriesSchemes의 키로 Array 값 kakao{your_app_key} 및 카카오 앱들의 커스텀 스킴들을 등록합니다. 다음은 예시 입니다.

<key>LSApplicationQueriesSchemes</key>
<array>
    <!-- 공통 -->
    <string>{YOUR_KAKAO_APP_KEY}</string>

    <!-- 간편로그인 -->
    <string>kakaokompassauth</string>
    <string>storykompassauth</string>

    <!-- 카카오톡링크 -->
    <string>kakaolink</string>
    <string>kakaotalk-5.9.7</string>

    <!-- 카카오스토리링크 -->
    <string>storylink</string>
</array>

보다 자세한 설명은 Privacy and Your App을 참고합니다.

Android 설정

Gradle 환경에서 사용하기

Gradle을 이용하면 소스를 받을 필요 없고, 로컬에 인스톨해줘야 하는 모듈도 리모트에서 받아올 수 있으며, 필요한 기능 라이브러리만 사용하여 앱파일 크기를 줄일 수 있습니다.

• Gradle repository

subprojects {
    repositories {
        mavenCentral()
        maven { url 'http://devrepo.kakao.com:8088/nexus/content/groups/public/' }
    }
}

• 프로가드 적용시에는 아래 옵션을 설정에 추가합니다.

-keep class com.kakao.** { *; }
-keepattributes Signature
-keepclassmembers class * {
  public static <fields>;
  public *;
}
-dontwarn android.support.v4.**,org.slf4j.**,com.google.android.gms.**

• 다음과 같이 앱 설정을 합니다. [strings.xml]

앱생성시 발급된 네이티브 앱키를 kakao_app_key이란 이름으로 정의하고, AndroidManifest.xml에서 앱키를 등록합니다.

<resources>
    <string name="kakao_app_key">{YOUR_KAKAO_APP_KEY}</string>
</resources>

앱키 값은 개발자 웹사이트에서 제공하는 대쉬보드의 설정 > 일반 > 앱 키 > 네이티브 앱 키 메뉴를 통해 확인 가능합니다.

[AndroidManifest.xml]

• 서버와의 통신을 위해 network 권한을 설정합니다.

• com.kakao.sdk.AppKey 이름으로 앱키를 등록합니다.

<uses-permission android:name="android.permission.INTERNET" />

<application>
    ...
    <meta-data
        android:name="com.kakao.sdk.AppKey"
        android:value="@string/kakao_app_key" />
    ...
</application>

사용하기

카카오링크

카카오톡링크는 미리 정의된 메시지 템플릿을 이용하여 메시지를 전송합니다. 카카오톡링크로 보낼 수 있는 메시지 템플릿 유형은 다음과 같습니다.

자세히 보고 싶은 메시지를 클릭하세요.