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
Si aún no tienes instalado CocoaPods, sigue los pasos de la Primeros pasos de CocoaPods .
Abre una ventana de terminal y navega a la ubicación de Xcode de tu app en un proyecto final.
Si aún no creaste un Podfile para tu aplicación, crea uno ahora:
pod init
Abre el Podfile creado para tu aplicación y agrega lo siguiente:
pod 'GoogleSignIn'
Si usas SwiftUI, también agrega la extensión del Pod para la opción “Acceder con Google" :
pod 'GoogleSignInSwiftSupport'
Guarda el archivo y ejecuta:
pod install
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
Abre tu proyecto en Xcode.
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 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:
Abre tu proyecto en Consola de Cloud.
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.