android-guide.md

Android Guide

Please see the FAQ at bottom before opening new issues

1. Android SDK Requirements

You need the following packages

2. Google project configuration

• Open https://developers.google.com/identity/sign-in/android/start-integrating

• Scroll down and click Get a configuration file button

• Place the generated configuration file (google-services.json) into <YOUR_PROJECT_ROOT>/android/app

3. Installation

• run react-native link react-native-google-signin

• In android/settings.gradle you should have

...
include ':react-native-google-signin', ':app'
project(':react-native-google-signin').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-google-signin/android')

• Update android/build.gradle with

...
dependencies {
    classpath 'com.android.tools.build:gradle:2.1.2' // <--- update this
    classpath 'com.google.gms:google-services:3.0.0' // <--- add this
}

• Update android/app/build.gradle with

...
dependencies {
    compile fileTree(dir: "libs", include: ["*.jar"])
    compile "com.android.support:appcompat-v7:23.0.1"
    compile "com.facebook.react:react-native:+"
    compile(project(":react-native-google-signin")){         
        exclude group: "com.google.android.gms" // very important
    }
    compile 'com.google.android.gms:play-services-auth:9.2.1' // should be at least 9.0.0
}

apply plugin: 'com.google.gms.google-services' // <--- this should be the last line

• Register Module (in MainApplication.java)

import co.apptailor.googlesignin.RNGoogleSigninPackage;  // <--- import

public class MainApplication extends Application implements ReactApplication {

  ......

  @Override
    protected List<ReactPackage> getPackages() {
      return Arrays.<ReactPackage>asList(
          new MainReactPackage(),
          new RNGoogleSigninPackage() // <-- add this
      );
    }
  ......

}

• Update gradle wrapper in android/gradle/wrapper/gradle-wrapper.properties

replace

distributionUrl=https\://services.gradle.org/distributions/gradle-2.4-all.zip

with

distributionUrl=https\://services.gradle.org/distributions/gradle-2.14-all.zip

4. Running on simulator

Make sure you have a simulator with Google Play installed.

Also to help with performances, install HAXM from the Android SDK Manager.

Running on device

Nothing special here, as long as you run your app on a Google Android device (again with play store installed !)

FAQ

A. My project includes other react-native plugins which have different google play services versions. What to do ??

in android/app/build.gradle exclude google play services from the plugins you use. Like this:

compile(project(":PLUGIN_NAME")){         
        exclude group: "com.google.android.gms"
}

Then include play services version you need (at least 9.0.0 for this plugin (!))

B. My project includes an older version of react-native-google-signin. How to upgrade ?

first install the latest version npm install --save react-native-google-signin

You need to follow this guide again to make sure everything fit together (gradle version, google-services gradle version, etc...)

clean everything to be sure

cd android
./gradlew clean

now react-native run-android

C. After upgrading and thoroughly following the guide the build fail with Missing api_key/current_key object. what to do ?

open android/app/google-services.json and replace "api_key":[] with "api_key":[{ "current_key": "" }]

D. After the sign-in completes I get the following error error code 12501. what to do ?

This is a permission error. Make sure the certificate_hash in android/app/google-services.json matches your certificate.

To get your sha1-hash

keytool -exportcert -keystore ~/.android/debug.keystore -list -v

Also make sure the application id matches the one you enter on the cloud console.

E. I did everything and I still have problems to compile my project.

Read this medium article. Basically, if you have other play services libraries installed, you have to exclude some dependencies.