Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@actbase/react-native-kakaosdk

zusinshinpei68MITdeprecated1.3.6TypeScript support: included
react-native, kakaosdk, kakao login, 카카오로그인, kakaolink, 카카오링크, kakao link, 카카오톡 채널, kakao channel, 플러스친구, plusfriend

readme

KakaoSDK for React Native

platforms npm npm github issues github closed issues Issue Stats

기능

기본설정하기

iOS 설정

프로젝트에 내 앱 설정

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

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

프로젝트에 내 앱 설정(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을 이용하면 소스를 받을 필요 없고, 로컬에 인스톨해줘야 하는 모듈도 리모트에서 받아올 수 있으며, 필요한 기능 라이브러리만 사용하여 앱파일 크기를 줄일 수 있습니다.

  1. Gradle repository
subprojects {
    repositories {
        mavenCentral()
        maven { url 'http://devrepo.kakao.com:8088/nexus/content/groups/public/' }
    }
}
  1. 프로가드 적용시에는 아래 옵션을 설정에 추가합니다.
-keep class com.kakao.** { *; }
-keepattributes Signature
-keepclassmembers class * {
  public static <fields>;
  public *;
}
-dontwarn android.support.v4.**,org.slf4j.**,com.google.android.gms.**
  1. 다음과 같이 앱 설정을 합니다. [strings.xml]

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

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

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

[AndroidManifest.xml]

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

  2. 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>

사용하기

카카오링크

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

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