Primeros pasos con 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 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 de Acceso con Google en tu proyecto

CocoaPods

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

2. Abre una ventana de terminal y navega a la ubicación del proyecto 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, agrega también 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 .xcworkspace 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), que genera errores de compilación cuando se abre).

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

Administrador de paquetes de Swift

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	6,0.2
   Producto del paquete	GoogleSignIn

3. Si usas SwiftUI, agrega también el siguiente producto de paquete de extensiones para el botón “Acceder con Google”.

   Producto del 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 del 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 de ID de cliente, que necesitarás para configurar el Acceso con Google en tu app. Si lo deseas, 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 botón que aparece a continuació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 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 Autentica con un servidor de backend. Para recuperar el token de ID de un usuario se necesita un segundo ID de cliente (tu ID de cliente de server) que representa tu backend.

Para crear un ID de cliente del servidor:

1. Abre tu proyecto en Cloud Console.

2. Crea un nuevo ID de cliente de OAuth de aplicación web. Anota la string 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 el proyecto se configure 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, también, optimizar la 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 el ID de cliente de OAuth y un esquema de URL personalizada según el ID de cliente invertido.

El ID de cliente invertido es tu ID de cliente con el orden de los campos delimitados por puntos invertidos. También se muestra en "Esquema de URL de iOS" cuando se selecciona un cliente de OAuth de iOS existente en Cloud Console. 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.

Nota: Este es el ID de cliente de OAuth de tu proyecto de backend, no el de tu app para iOS o macOS. Debes obtener un ID de cliente de servidor OAuth y especificarlo aquí.

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

Opcional: Optimiza tu app 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 de OpenID.

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

Firma de 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 mediante el llavero.

Próximos pasos

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