Inicio de sesión con Google en Android

GitHub

Copiar una solicitud de configuración con los pasos de instalación y la guía de markdown completa para este complemento.

Introducción

En esta guía, aprenderá a configurar el inicio de sesión de Google con Capgo Social Login para Android. Supongo que ya ha leído la guía de configuración general.

En esta parte, aprenderás a configurar el inicio de sesión de Google en Android.

El certificado SHA1 de Android es muy complicado y no lo deseo a nadie tener que configurarlo. Los siguientes pasos asumen el escenario más simple de una aplicación que no está publicada en Google Play Store y que solo se utiliza por el simulador local o dispositivo de hardware de desarrollo.

Si has desplegado tu aplicación en Google Play Store, DEBE agregar un ID de cliente de Android adicional que contenga el SHA1 del console de Google Play para lanzamientos de producción. Puedes encontrar la huella SHA1 que Google Play utiliza para firmar tu paquete de lanzamiento bajo Test and release > Setup > App Signing.

Finalmente, es importante mencionar que si te equivocas, el error NO será obvio. Puede ser muy difícil de depurar. Si te peleas con la configuración, por favor mira los Github problemas.

Además, puedes mirar la sección de solución de problemas de Configuración de inicio de sesión de Google para Android para obtener más información.

Crear un identificador de cliente Android.
1. Haga clic en la barra de búsqueda
2. Buscar credentials y haga clic en el APIs and Services uno (número 2 en la captura de pantalla)
3. Haga clic en el create credentials
4. Seleccionar OAuth client ID
5. Seleccionar el Android tipo de aplicación
6. Abrir Android Studio
7. En la parte inferior de la navegación, encuentre la sección de Gradle Scripts
8. Encuentre build.gradle para el módulo app
9. Copia el android.defaultConfig.applicationIdEste será tu package name en el console de Google
10. Ahora, abre la terminal. Asegúrate de que estás en el android del directorio de tu aplicación y ejecuta ./gradlew signInReport
1. Desplázate hacia arriba en este comando. Deberías ver lo siguiente. Copia el SHA1.
1. Ahora, vuelve a la consola de Google. Ingresa tu applicationId como el Package Name y tu SHA1 en el campo de certificado y haz clic create
Crear un cliente web (esto es necesario para Android)
1. Ir a la Create credentials página en el Console de Google
2. Establecer el tipo de aplicación a Web
3. Hacer clic en Create
4. Copiar el ID del cliente, lo utilizarás como el webClientId en tu JS/TS code

Modificar tu MainActivity

Por favor, abra su aplicación en Android Studio. Puede ejecutar cap open android
Encuentre MainActivity.java
1. Abra el app carpeta
2. Encuentre java
3. Encuentre su MainActivity.java y haga clic en él

Modifique MainActivity.java. Por favor, agregue lo siguiente code

import ee.forgr.capacitor.social.login.GoogleProvider;
import ee.forgr.capacitor.social.login.SocialLoginPlugin;
import ee.forgr.capacitor.social.login.ModifiedMainActivityForSocialLoginPlugin;
import com.getcapacitor.PluginHandle;
import com.getcapacitor.Plugin;
import android.content.Intent;
import android.util.Log;
import com.getcapacitor.BridgeActivity;

// ModifiedMainActivityForSocialLoginPlugin is VERY VERY important !!!!!!
public class MainActivity extends BridgeActivity implements ModifiedMainActivityForSocialLoginPlugin {

      @Override
      public void onActivityResult(int requestCode, int resultCode, Intent data) {
        super.onActivityResult(requestCode, resultCode, data);

        if (requestCode >= GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MIN && requestCode < GoogleProvider.REQUEST_AUTHORIZE_GOOGLE_MAX) {
          PluginHandle pluginHandle = getBridge().getPlugin("SocialLogin");
          if (pluginHandle == null) {
            Log.i("Google Activity Result", "SocialLogin login handle is null");
            return;
          }
          Plugin plugin = pluginHandle.getInstance();
          if (!(plugin instanceof SocialLoginPlugin)) {
            Log.i("Google Activity Result", "SocialLogin plugin instance is not SocialLoginPlugin");
            return;
          }
          ((SocialLoginPlugin) plugin).handleGoogleLoginIntent(requestCode, data);
        }
      }

      // This function will never be called, leave it empty
      @Override
      public void IHaveModifiedTheMainActivityForTheUseWithSocialLoginPlugin() {}
}

Guardar el archivo

Utilice el inicio de sesión de Google en su aplicación
1. Primero, importe SocialLogin
```
import { SocialLogin } from '@capgo/capacitor-social-login';
```
2. Llame a initialize. Esto debe llamarse solo una vez.
```
// onMounted is Vue specific
// webClientId is the client ID you got in the web client creation step not the android client ID.
onMounted(() => {
  SocialLogin.initialize({
    google: {
      webClientId: '673324426943-avl4v9ubdas7a0u7igf7in03pdj1dkmg.apps.googleusercontent.com',
    }
  })
})
```
3. Llame a SocialLogin.loginCrear un botón y ejecute el siguiente code al hacer clic.
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response
console.log(JSON.stringify(res))
```
  Si inicia Google con mode: 'offline', SocialLogin.login() devuelve serverAuthCode para tu flujo de intercambio de backend. No llames SocialLogin.refresh({ provider: 'google' }) en la aplicación en ese modo. Intercambia serverAuthCode en tu backend, almacena el token de refresco de Google allí, y refresca en el backend.
Configura el emulador para la prueba
1. Ir a Device manager y haz clic en el botón de más
2. Crear un dispositivo virtual
3. Selecciona cualquier dispositivo con un Play Store icono
  
  Como puedes ver, el pixel 8 soporta los Play Store servicios
4. Haz clic next
5. Seguro que el imagen del sistema es del tipo Google Play. DEBE SER de tipo Google Play
6. Haz clic en siguiente
7. Confirme su dispositivo. Puede nombrar su emulador como prefiera
8. Entrar en Device Manager Y arranque su simulador
9. Después de que arranque el simulador, vaya a sus ajustes
10. Entrar en Google Play
1. Haga clic Update Y espere unos 60 segundos
Prueba tu aplicación

Si has hecho todo correctamente, deberías ver el flujo de inicio de sesión de Google funcionando correctamente:

Solución de problemas

Sección titulada “Solución de problemas”

Si tienes algún problema, compara primero la configuración de tu aplicación con los valores de la consola de Google Cloud. Los errores de inicio de sesión de Google en Android suelen estar causados por una coincidencia de nombre de paquete, SHA-1 o ID de cliente

Sección titulada “Administrador de credenciales, SHA-1 y Firebase”androidx.credentials En Android, este plugin utiliza el Administrador de credenciales de Google ( GoogleSignInClient y Inicia sesión con Google), no la versión legada del plugin ‘API’. Errores de Logcat como GetCredentialCustomException: [28444] Developer console is not set up correctly vienen de esa pila.

Filtrar Logcat con GoogleProvider o CapgoSocialLogin ¿Qué alternativas hay? webClientId ¿Qué alternativas hay?

¿Qué alternativas hay?

Configuración de Cloud de Google necesaria

Sección titulada “Configuración de Cloud de Google necesaria”	Necesitas dos tipos de identificadores de cliente OAuth 2.0 en el mismo proyecto de Cloud de Google:	Tipo de cliente
Usado para lo siguiente:	Servidor / ID de token de audiencia	`webClientId` in `SocialLogin.initialize()`
Android, uno por clave de firma	Prueba que su APK está autorizada para llamar a Google	solo en la consola de Google Cloud. No pase este ID a `webClientId`

Un error común es utilizar el ID del cliente de Android como webClientId. El Administrador de credenciales requiere el ID del cliente web allí. El cliente de Android solo necesita el nombre de paquete correcto y la SHA-1 registrados en la consola.

Cree un cliente OAuth de Android para cada certificado que firma los builds que prueba:

De ./gradlew signingReport para la variante de depuración.
De el APK o AAB que realmente instala.
De la consola de Play > Integridad de la aplicación > Certificado de clave de firma de la aplicación. Esto es necesario para los builds de la tienda de Play, incluso si su SHA-1 de la clave de carga es ya registrado.

El applicationId en android/app/build.gradle debe coincidir exactamente con el nombre del paquete de cliente OAuth de Android, incluyendo cualquier .debug sufijo.

Si la pantalla de consentimiento de OAuth está en modo de prueba, agregue cada cuenta de Google que pruebe bajo Usuarios de prueba > Público. No se requiere publicar la aplicación en producción para email y profile los permisos. Los enlaces de activos digitales (assetlinks.json) no se requieren para iniciar sesión con Google a través del Administrador de credenciales.

Las modificaciones en Cloudflare pueden tardar hasta unas pocas horas en propagarse.

Error 28444: El panel de desarrolladores no está configurado correctamente

Esto sucede casi siempre cuando Google rechaza la combinación del certificado de firma de APK instalado, el nombre del paquete y webClientId. Trabaja a través de esta lista de verificación:

Confirmar webClientId es el ID del cliente de la aplicación web y termina con .apps.googleusercontent.com.
Ejecuta la aplicación, reproduce el error y lee Logcat para GoogleProvider, signingSha1=, y package=.
En Google Cloud Console > Credenciales, abre tu cliente OAuth de Android y verifica el nombre de paquete exacto y SHA-1.
Si estás probando una versión de lanzamiento, registra el SHA-1 de esa versión, no solo el keystore de depuración.
Si la aplicación se distribuye a través de la Tienda de Juegos, también registra el SHA-1 de firma de la aplicación.
Asegúrate de que los clientes web y Android estén en el mismo proyecto de Google Cloud.
Si la pantalla de consentimiento está en Pruebas, confirma que el usuario de Google es un usuario de prueba.
Espera y vuelve a intentarlo después de cambios en la consola.

USER_CANCELLED Después de seleccionar una cuenta en una configuración de depuración mal configurada, todavía puede haber un error de coincidencia de SHA-1 o ID de cliente. Corrige la configuración de la consola arriba.

Extrae el SHA-1 del paquete que instalas.

Edición de depuración o local:

cd android && ./gradlew signingReport

APK de lanzamiento firmado:

keytool -printcert -jarfile android/app/release/app-release.apk

Agrega ese SHA-1 a un cliente OAuth de Android con el nombre de paquete correspondiente, reinstala el mismo APK firmado y vuelve a intentarlo:

adb install android/app/release/app-release.apk

Los tokens están anidados bajo result:

const login = await SocialLogin.login({ provider: 'google' });
const idToken = login.result?.idToken;

Para Firebase Auth, crea credenciales con ese idToken y utiliza el ID de cliente web como webClientId en initialize.

Si no puedes obtener el certificado SHA-1 de desarrollo, prueba un keystore personalizado. Este comentario de problema explica cómo agregar un keystore a tu proyecto.

Si estás utilizando Google Login en Android para planificar la autenticación y los flujos de cuenta, conecta con Usando @capgo/capacitor-login-social para la capacidad nativa en Usando @capgo/capacitor-login-social @capgo/capacitor-login-social para el detalle de implementación en @capgo/capacitor-login-social @capgo/capacitor-clave-de-pasaje para el detalle de implementación en @capgo/capacitor-clave-de-pasaje @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-biometría-nativa, y Autenticación en dos factores para el detalle de implementación en Autenticación en dos factores.