Skip to content

Commit

Permalink
docs: even better developer_error troubleshooting (#25)
Browse files Browse the repository at this point in the history
  • Loading branch information
vonovak authored Sep 8, 2024
1 parent 241b92e commit cd0ada0
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 7 deletions.
13 changes: 7 additions & 6 deletions docs/setting-up/get-config-file.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ Please note that you **do not** need Firebase to configure Google Sign In. Howev

Read below on how to set up Google Sign In for your Android app.

### Obtain SHA-1 certificate fingerprints

:::warning
This is crucial for Google Sign-In to work on Android. If not done correctly, you will get the infamous [`DEVELOPER_ERROR` error](/docs/troubleshooting#developer_error).
:::danger
Completing this guide is crucial for Google Sign-In to work on Android. If not done correctly, you will get the infamous `DEVELOPER_ERROR` error [(how to troubleshoot it)](/docs/troubleshooting#developer_error).
:::

### Obtain SHA-1 certificate fingerprints

You likely have multiple signing configurations - for example for building local debug and release APKs, builds on [Expo EAS](https://docs.expo.dev/app-signing/managed-credentials/#inspecting-credentials-configuration), and [Play App Signing](https://support.google.com/googleplay/android-developer/answer/9842756?hl=en) for production deployments. You will need to get the SHA1 certificate fingerprints
for _all_ keystores you intend to use and enter them _all_ in Firebase or Google Cloud Console.

Expand All @@ -34,9 +34,10 @@ import TabItem from '@theme/TabItem';

<TabItem value="playStore" label="When releasing via Google Play Store">
Check if "Google Play App Signing" is enabled for your app [in the console](https://play.google.com/console/u/0/).
If it is enabled, you need to obtain the "App signing certificate" `SHA-1`.
If it is enabled, you need to take the following steps:

You can find it at: App -> Release (in the left sidebar) -> Setup -> App integrity. Under the App signing key certificate, copy `SHA-1 certificate fingerprint`.
1. In Google Play Console, navigate to: \<Your App\> -> Release section (in the left sidebar) -> Setup -> App Signing.
2. Under the "App signing key certificate" _and also_ "Upload key certificate", take note of `SHA-1 certificate fingerprint`.

</TabItem>
</Tabs>
Expand Down
2 changes: 1 addition & 1 deletion docs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ This is always (_always_!) a configuration mismatch between your app and Google'
Follow these pointers:

- [Search the issue tracker](https://github.com/react-native-google-signin/google-signin/issues?q=is%3Aissue+DEVELOPER+ERROR+is%3Aclosed) for old reports of the error
- Make sure that your SHA certificate fingerprints and package name you entered in Firebase / Google Cloud Console are correct. If you are in development, make sure your development signing fingerprint is added as well.
- Make sure that your SHA certificate fingerprints and package name you entered in Firebase / Google Cloud Console are correct. [See how your app was signed](https://x.com/vonovak/status/1692127631473529226). If you are in development, make sure your development signing fingerprint is added as well.
- Follow the [setup guide](/docs/setting-up/get-config-file) and perform its steps once again.
- If you're passing `webClientId` in configuration object to `GoogleSignin.configure()` make sure it's correct and that it is of type web (NOT Android!). You can get your `webClientId` from [Google Developer Console](https://console.developers.google.com/apis/credentials). It is listed under "OAuth 2.0 client IDs".

Expand Down

0 comments on commit cd0ada0

Please sign in to comment.