Comienza a usar el Acceso con Google para iOS y macOS

Antes de comenzar a integrar tu app para iOS o macOS con los componentes de Acceso con Google, debes descargar las dependencias y configurar tu proyecto de Xcode. Los pasos que se indican en esta página hacen precisamente eso. En los pasos siguientes, se describe cómo integrar las funciones de Acceso con Google en tu app.

Antes de comenzar

Instala una versión actual de Xcode.

Instala las dependencias de Acceso con Google en tu proyecto

CocoaPods

  1. Si aún no tienes instalado CocoaPods, sigue los pasos de la guía de Introducción de CocoaPods.

  2. Abre una ventana de terminal y navega a la ubicación del proyecto de Xcode de tu app.

  3. Si aún no creaste un Podfile para tu aplicación, crea uno ahora: 

    pod init

  4. Abre el Podfile creado para tu aplicación y agrega lo siguiente: 

    pod 'GoogleSignIn'

  5. Si usas SwiftUI, también agrega la extensión de pod para el botón "Acceder con Google": 

    pod 'GoogleSignInSwiftSupport'

  6. Guarda el archivo y ejecuta: 

    pod install

  7. Abre el archivo workspace .xcworkspace generado para tu aplicación en Xcode. Úsalo en todos los desarrollos futuros de tu aplicación. (Ten en cuenta que esto es diferente del archivo project .xcodeproj incluido, que generaría errores de compilación cuando se abra).

    Puedes consultar el Podfile de la app de ejemplo de Objective-C para ver un ejemplo.

Swift Package Manager

  1. Abre tu proyecto en Xcode.

  2. Agrega las dependencias de Acceso con Google a tu app (documentación de Xcode):

    Repositorio https://github.com/google/GoogleSignIn-iOS
    Versión 7.0.0
    Empaquetar producto GoogleSignIn

  3. Si usas SwiftUI, también agrega el siguiente producto del paquete de extensión para el botón "Acceder con Google":

    Empaquetar producto GoogleSignInSwift

Obtén un ID de cliente de OAuth

Tu app necesita un ID de cliente de OAuth para identificarse ante el backend de autenticación de Google. En el caso de las apps para iOS y macOS, el tipo de aplicación del ID de cliente de OAuth se debe configurar como iOS.

Si aún no creaste un ID de cliente de OAuth, haz clic en el siguiente botón para hacerlo.

Crea un ID de cliente de OAuth

Después de crear el ID de cliente de OAuth, toma nota de la cadena de ID de cliente, que necesitarás para configurar el Acceso con Google en tu app. De manera opcional, puedes descargar el archivo de configuración, que contiene tu ID de cliente y otros datos de configuración, para usarlo como referencia en el futuro.

Si ya creaste un ID de cliente de OAuth, puedes encontrar tu información de OAuth existente haciendo clic en el siguiente botón.

Obtén un ID de cliente de OAuth existente

Obtén un ID de cliente de servidor de OAuth

La mayoría de las apps deberán pasar la identidad de los usuarios que accedieron a un servicio de backend de algún tipo. Para pasar de forma segura la identidad de los usuarios que accedieron con Google a tu backend, usa tokens de ID, como se explica en Autenticación con un servidor de backend. Para recuperar el token de ID de un usuario, se requiere un segundo ID de cliente, el ID de cliente de tu servidor, que representa tu backend.

Para crear un ID de cliente de servidor, sigue estos pasos:

  1. Abre tu proyecto en la consola de Cloud.

  2. Crea un nuevo ID de cliente de OAuth de tipo aplicación web. Anota la cadena de ID de cliente, que necesitarás para configurar el Acceso con Google en tu app.

Configura tu proyecto de aplicación

Acceder con Google requiere que tu proyecto esté configurado con tu ID de cliente de OAuth y un esquema de URL personalizado. De forma opcional, también puedes agregar el ID de cliente de tu servidor para la autenticación de backend o optimizar tu app para tu dominio de Google Workspace.

Agrega tu ID de cliente de OAuth y el esquema de URL personalizado

Actualiza el archivo Info.plist de tu app para agregar tu ID de cliente de OAuth y un esquema de URL personalizado basado en el ID de cliente invertido.

El ID de cliente revertido es tu ID de cliente con el orden de los campos delimitados por puntos invertido. Esto también se muestra en "Esquema de URL de iOS" cuando seleccionas un cliente de OAuth de iOS existente en la consola de Cloud. Por ejemplo: com.googleusercontent.apps.1234567890-abcdefg

<key>GIDClientID</key>
<string>YOUR_IOS_CLIENT_ID</string>
<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>YOUR_DOT_REVERSED_IOS_CLIENT_ID</string>
    </array>
  </dict>
</array>

Opcional: Configura la autenticación de backend

Si necesitas obtener los tokens de ID de los usuarios para la autenticación de backend, también configura la clave GIDServerClientID en el archivo Info.plist de tu app.

<key>GIDServerClientID</key>
<string>YOUR_SERVER_CLIENT_ID</string>

Opcional: Optimiza para un dominio de Google Workspace o un reino de OpenID

Usa el parámetro GIDHostedDomain si deseas optimizar el flujo de acceso para un dominio de Google Workspace.

<key>GIDHostedDomain</key>
<string>YOUR_HOSTED_DOMAIN</string>

Usa el parámetro GIDOpenIDRealm si deseas especificar un reino de OpenID.

<key>GIDOpenIDRealm</key>
<string>YOUR_OPENID_REALM</string>

Cómo firmar tu aplicación

Tu aplicación debe estar firmada con un certificado emitido por Apple para ejecutarse de forma nativa en dispositivos macOS y iOS y almacenar credenciales a través del llavero.

Próximos pasos

Ahora que descargaste las dependencias del proyecto y configuraste tu proyecto de Xcode, puedes agregar el Acceso con Google a tu app para iOS.