react-native-play-services-faisal-edition

Use Google Play Services API in React Native.

Usage no npm install needed!

<script type="module">
  import reactNativePlayServicesFaisalEdition from 'https://cdn.skypack.dev/react-native-play-services-faisal-edition';
</script>

README

react-native-play-services

EN | KO

NPM LICENSE Stars Actions Status

사용하기 전에

이 라이브러리는 React Native 0.60.5+ 버전에서 만들어졌습니다. 이하 버전에 대해 정상 동작을 보장할 수 없습니다. 버전을 0.60.5 이상으로 업그레이드한 후 사용하시는 것을 권장합니다.

React Native 공식 문서 - Upgrading to new React Native versions

소개

React Native에서 Google Play Services API를 사용할 수 있는 라이브러리입니다.

기능

  • Google Play Services를 사용할 수 있는지 검사하기
  • Google Play Services를 활성화할 수 있는 설정 페이지로 이동
  • Google Play Services를 업데이트할 수 있는 Play Store 링크로 이동

설치

npm 혹은 yarn을 이용한 설치

$ npm install react-native-play-services --save

혹은,

$ yarn add react-native-play-services

수동 설치 (자동 설치가 안 될 시)

  1. android/app/src/main/java/[...]/MainApplication.java 파일을 엽니다.
  • 파일 최상단에 import io.humanscape.opensources.playservices.PlayServicesPackage; 를 작성합니다.
  • getPackages() 메서드에서 반환하는 배열 안에 new PlayServicesPackage()를 추가합니다.
  1. android/settings.gradle에 아래 구문을 추가합니다.
    include ':react-native-play-services'
project(':react-native-play-services').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-play-services/android')
  2. 아래 구문을 android/app/build.gradle 파일의 dependencies 스코프 안에 추가합니다.:
      compile project(':react-native-play-services')

API

import PlayServices from 'react-native-play-services';

// Full-set API

PlayServices.sync();


// Customizable API

(async () => {
  const status = await PlayServices.checkPlayServicesStatus();
  switch (status) {
    case PlayServices.GooglePlayServicesStatus.GMS_DISABLED:
      PlayServices.goToSetting();
      break;
    // handle anything.
  }
})();

  • Constants

    • GooglePlayServicesStatus
      • GooglePlayServicesStatus.AVAILABLE
        • Google Play Services API를 사용할 수 있습니다.
      • GooglePlayServicesStatus.GMS_DISABLED
        • Google Play Services가 비활성화되어 있습니다.
        • 설정에서 활성화를 해주어야 합니다.
      • GooglePlayServicesStatus.GMS_NEED_UPDATE
        • Google Play Services를 업데이트해야 합니다.
        • Play Store에서 업데이트를 진행해야 합니다.
      • GooglePlayServicesStatus.INVALID
        • Google Play Services의 상태를 알 수 없습니다.

  • Functions

    • sync()
      •   sync: (params: { onGmsDisabled?: () => {}, onGmsNeedUpdate?: () => {} }) => Promise<void>;
      • Google Play Services 상태를 최신으로 유지하는 동작을 실행합니다.
      • onGmsDisabled가 없을 시, goToSettings() 함수를 실행합니다.
      • onGmsNeedUpdate가 없을 시 goToMarket() 함수를 실행합니다.
    • checkPlayServicesStatus()
      •   checkPlayServicesStatus: () => Promise<GooglePlayServicesStatus>;
      • Google Play Services 상태를 체크하고, GooglePlayServicesStatus를 반환합니다.
    • goToSetting()
      •   goToSetting: () => Promise<void>;
      • Google Play Services를 활성화할 수 있는 앱 설정으로 진입합니다.
    • goToMarket()
      •   goToMarket: () => Promise<void>;
      • Google Play Services를 업데이트할 수 있는 Play Store 링크를 엽니다.