Start integrating Google Sign-In into your iOS app

Before you can begin integrating your iOS app with the Google Sign-In components, you must download the dependencies and configure your Xcode project. The steps on this page do just that. The next steps then describe how to integrate Google Sign-In features into your app.

Before you begin

Set up your CocoaPods dependencies

Google Sign-In uses CocoaPods to install and manage dependencies. Open a terminal window and navigate to the location of the Xcode project for your application. If you have not already created a Podfile for your application, create one now:

pod init

Open the Podfile created for your application and add the following:

pod 'GoogleSignIn'

Save the file and run:

pod install

This creates an .xcworkspace file for your application. Use this file for all future development on your application.

Get an OAuth client ID

If you haven't already created an OAuth client ID, click the button below to do so.

Create an OAuth client ID

After you create the OAuth client ID, take note of the client ID string, which you will need to configure Google Sign-in in your app. You can optionally download the configuration file, which contains your client ID and other configuration data, for future reference.

If you already created an OAuth client ID, you can find your existing OAuth information by clicking the button below.

Get an existing OAuth client ID

Add a URL scheme to your project

Google Sign-in requires a custom URL Scheme to be added to your project. To add the custom scheme:

  1. Open your project configuration: double-click the project name in the left tree view. Select your app from the TARGETS section, then select the Info tab, and expand the URL Types section.

  2. Click the + button, and add your reversed client ID as a URL scheme.

    The reversed client ID is your client ID with the order of the dot-delimited fields reversed. For example: 

    com.googleusercontent.apps.1234567890-abcdefg

When completed, your config should look something similar to the following (but with your application-specific values):

Next steps

Now that you've downloaded the project dependencies and configured your Xcode project, you can add Google Sign-In to your iOS app.