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 en esta página justamente se encargan de hacerlo. En los próximos pasos, 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 del 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 hasta la ubicación del proyecto de Xcode de tu app.

  3. Si aún no creaste un Podfile para tu aplicación, créalo 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 del Pod para el botón “Acceder con Google”:

    pod 'GoogleSignInSwiftSupport'

  6. Guarda el archivo y ejecuta

    pod install
    .

  7. Abre el archivo .xcworkspace de workspace generado para tu aplicación en Xcode. Usa este archivo para todo desarrollo futuro en tu aplicación. (ten en cuenta que esto es diferente del archivo .xcodeproj project incluido, lo que generaría errores de compilación cuando se abre).

    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 del Acceso con Google a tu app (documentación de Xcode):

    Repositorio https://github.com/google/GoogleSignIn-iOS
    Versión 7.0.0
    Producto en paquete GoogleSignIn
  3. Si usas SwiftUI, también agrega el siguiente producto de paquete de extensión para el botón “Acceder con Google”:

    Producto en paquete GoogleSignInSwift

Obtén un ID de cliente de OAuth

Tu app necesita un ID de cliente de OAuth para identificarse en el backend de autenticación de Google. En el caso de las apps para iOS y macOS, el tipo de aplicación de ID de cliente de OAuth debe configurarse 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 string del 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 referencia futura.

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

Obtén un ID de cliente de OAuth existente

Obtén un ID de cliente del servidor OAuth

La mayoría de las apps deberán pasar la identidad de los usuarios que accedieron a su cuenta a algún tipo de servicio de backend. 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 Autentica 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 server, que representa a tu backend.

Para crear un ID de cliente del servidor, haz lo siguiente:

  1. Abre tu proyecto en la consola de Cloud.

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

Configura tu proyecto de aplicación

El Acceso con Google requiere que tu proyecto esté configurado con tu ID de cliente de OAuth y un esquema de URL personalizada. De manera opcional, también puedes agregar tu ID de cliente del servidor para la autenticación de backend, o bien optimizar tu app para tu dominio de Google Workspace.

Agrega tu ID de cliente de OAuth y tu esquema de URL personalizada

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 invertido es el 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 se selecciona un cliente de OAuth para 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 tokens de ID de usuarios para la autenticación de backend, configura también la clave GIDServerClientID en el archivo Info.plist de la app.

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

Opcional: Realiza optimizaciones para un dominio de Google Workspace o un dominio 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 dominio OpenID.

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

Firma tu aplicación

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

Próximos pasos

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