Comienza a usar el Acceso con Google para iOS y macOS

Antes de comenzar a integrar tu app para iOS o macOS en los componentes de Acceso con Google, haz lo siguiente: debes descargar las dependencias y configurar tu proyecto Xcode. Los pasos para esta página hacen precisamente eso. En los próximos pasos, se describe cómo realizar la integración. 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 Primeros pasos de CocoaPods .

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

  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 del Pod para la opción “Acceder con Google" :

    pod 'GoogleSignInSwiftSupport'

  6. Guarda el archivo y ejecuta lo siguiente:

    pod install

  7. Abre el archivo .xcworkspace del espacio de trabajo generado para tu aplicación en Xcode. Usa este archivo para todo desarrollo futuro en tu aplicación. (Nota que es diferente del archivo project de .xcodeproj incluido, que daría como resultado errores de compilación cuando se abran).

    Puedes consultar la app de ejemplo de Objective-C Podfile 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
    Paquete de producto GoogleSignIn
  3. Si usas SwiftUI, agrega también el siguiente producto del paquete de extensiones para "Acceder con Google" :

    Paquete de producto GoogleSignInSwift

Obtén un ID de cliente de OAuth

Tu app necesita un ID de cliente de OAuth para identificarse ante la autenticación de Google backend. En 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 botón. a continuació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 del ID de cliente, que deberás configurar Acceso con Google en tu app. Opcionalmente, puedes descarga el archivo de configuración, que contiene tu ID de cliente y otras de configuración de Terraform para consultarlos en el futuro.

Si ya creaste un ID de cliente de OAuth, puedes encontrar tu ID existente de OAuth. haciendo clic en el botón que aparece a continuación.

Obtén un ID de cliente de OAuth existente

Obtén un ID de cliente del servidor de OAuth

La mayoría de las apps deberán pasar la identidad de los usuarios que accedieron a sus cuentas a un servicio de backend de algún tipo. Para transmitir de forma segura la identidad de los usuarios que accedieron con Google para tu backend, debes usar tokens de ID, como se describe en Cómo autenticar con un servidor de backend. Para recuperar el token de ID de un usuario, se necesita un segundo ID de cliente: tu server el ID de cliente, que representa tu backend.

Para crear un ID de cliente del servidor:

  1. Abre tu proyecto en 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 Acceso con Google en tu .

Configura el proyecto de tu 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. También puedes agregar tu ID de cliente del servidor para autenticación de backend, o bien optimiza tu app para tu de Google Workspace.

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

Actualiza el archivo Info.plist de tu aplicación para agregar tu OAuth el ID de cliente y un esquema de URL personalizada basado en el ID de cliente invertido.

El ID de cliente invertido es tu ID de cliente en el orden de los valores de campos invertidos. Esto también se muestra en "Esquema de URL de iOS" cuando selecciones un cliente existente de OAuth para iOS en la nube 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 para la autenticación de backend, configura también la clave GIDServerClientID en el archivo Info.plist de tu app.

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

Opcional: Realiza optimizaciones para un dominio de OpenID o de Google Workspace

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 para almacenar credenciales a través del llavero.

Próximos pasos

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