Kakao Plus Friend for React Native
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
android
ios
.gitattributes
.gitignore
README.md
index.js
package.json

README.md

react-native-kakao-plus-friend

Note

안녕하세요. 술 한 병으로 모두가 어깨춤을 추게하는 '꽁알' 서비스를 준비중인 JOOTOPIA입니다. RN으로 서비스를 개발하는 중 카카오플러스 친구 기능이 필요하여 본 모듈을 제작하게 되었습니다. 지원하지 않는 기능 및 오류가 있으시면 이슈란에 남겨주시기 바랍니다.

Getting started

$ npm install react-native-kakao-plus-friend --save

빠른 설치

react-native link 를 이용하시면 빠른 설치가 가능합니다.

$ react-native link react-native-kakao-plus-friend

수동 설치

위 react-native link 를 사용하시지 않는 분들은 본 모듈을 IOS, Android에 사용하기위해 아래와 같은 링크 절차를 거쳐야 합니다.

iOS

  1. In XCode, in the project navigator, right click LibrariesAdd Files to [your project's name]
  2. Go to node_modulesreact-native-kakao-plus-friend and add RNKakaoPlusFriend.xcodeproj
  3. In XCode, in the project navigator, select your project. Add libRNKakaoPlusFriend.a to your project's Build PhasesLink Binary With Libraries
  4. Run your project (Cmd+R)<

Android

  1. Open up android/app/src/main/java/[...]/MainActivity.java
  • Add import com.reactlibrary.RNKakaoPlusFriendPackage; to the imports at the top of the file
  • Add new RNKakaoPlusFriendPackage() to the list returned by the getPackages() method
  1. Append the following lines to android/settings.gradle:
    include ':react-native-kakao-plus-friend'
    project(':react-native-kakao-plus-friend').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-kakao-plus-friend/android')
    
  2. Insert the following lines inside the dependencies block in android/app/build.gradle:
      compile project(':react-native-kakao-plus-friend')
    

Install KakaoOpenSDK

IOS

카카오 PlusFriend를 사용하기위해서는 KakaoOpenSDK가 필요합니다. 아래 카카오 공식 가이드에서 OpenSDK를 다운 받으시기 바랍니다. https://developers.kakao.com/docs/ios/getting-started#kakao-sdk-설치

Note: CocoaPod 사용중인 경우에도 다운 받으셔야합니다. pod 'KakaoOpenSDK' 스펙에는 플러스친구를 사용하기위한 Framework가 없습니다. 때문에 SDK를 받으셔서 개발중인 Xcode 프로젝트에 KakaoPlusFriend.framework 를 Frameworks Group 에 drag & drop 해주시기 바랍니다.

SDK 설치가 완료되었다면, 카카오 플러스친구 공식가이드 https://developers.kakao.com/docs/ios/plusfriend 를 참고하셔 설정을 ㅇ완료하시길 바랍니다.

Android

카카오 공식가이드

개발 환경 구성 https://developers.kakao.com/docs/android/getting-started

플러스 친구 https://developers.kakao.com/docs/android/plusfriend 를 참고하시기 바랍니다.

Note : 위 '카카오 공식 가이드-개발 환경 구성에 /android/app/build.gradle 를 설정해주시는 부분이 있는데, 플러스친구 설정은 나와있지 않습니다. 찾아본 결과 dependencies에 아래와 같이 추가해주셔야 합니다.

/android/app/build.gradle

dependencies {
    ...

    // 카카오 플러스친구 sdk를 사용하기 위해 필요.
    compile group: 'com.kakao.sdk', name: 'plusfriend', version: project.KAKAO_SDK_VERSION

}

Usage

import RNKakaoPlusFriend from 'react-native-kakao-plus-friend';

  //...RN CODE

   //친구 추가 하기로 링크
  addFriend= async ()=>{
      await RNKakaoPlusFriend.addFriend('kakao plus friend code');
  }
  //바로 채팅하기로 링크
  chat= async ()=>{
      await RNKakaoPlusFriend.chat('kakao plus friend code');
  }

  //...RN CODE

Note: 참고로 안드로이드에서는 플러스 친구 링크를 연동하지 않는 편이 좋습니다. 이 API는 카카오톡이 설치되어있지 않은 환경에서는 카카오톡 앱 설치 링크로 유도됩니다. 따라서, 구글 플레이스토어 정책상 앱 설치 유도로 간주되어 앱 서비스가 정지되는 경우가 발생합니다. 위 사용에서 if(Platform.OS==='ios') 와 같은 조건문을 붙여 IOS 환경에서만 사용하시길 권장드립니다.