react-native-play-services
사용하기 전에
이 라이브러리는 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
수동 설치 (자동 설치가 안 될 시)
android/app/src/main/java/[...]/MainApplication.java
파일을 엽니다.
- 파일 최상단에
import io.humanscape.opensources.playservices.PlayServicesPackage;
를 작성합니다. getPackages()
메서드에서 반환하는 배열 안에new PlayServicesPackage()
를 추가합니다.
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')- 아래 구문을
android/app/build.gradle
파일의dependencies
스코프 안에 추가합니다.:compile project(':react-native-play-services')
API
; // Full-set API PlayServices; // Customizable API async { const status = await PlayServices; };
-
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: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 링크를 엽니다.
-