Inicio de sesión con Google en Android

Copiar un prompt de configuración con los pasos de instalación y la guía de markdown completa para este plugin.

Introducción

En esta guía, aprenderás a configurar el inicio de sesión de Google con Capgo Social Login para Android. Supongo que ya has 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 las liberaciones de producción. Puedes encontrar la huella SHA1 que Google Play utiliza para firmar tu paquete de liberación 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 sientes confundido con la configuración, por favor mira los Github problemas.

Además, puedes mirar la sección de solución de problemas de la 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 por 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. Copie 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 de tu aplicación y ejecuta ./gradlew signInReport
1. Desplázate hacia arriba de este comando. Deberías ver lo siguiente. Copie 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. 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))
```
  If 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. Ve 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. Hacer clic next
5. Asegúrate de que la imagen del sistema sea del tipo Google Play. DEBE SER de tipo Google Play
6. Hacer clic en siguiente
7. Confirma tu dispositivo. Puedes nombrar tu emulador como prefieras
8. Ir a Device Manager y arranca tu simulador
9. Después de que arranque el simulador, ve a sus ajustes
10. Ir a Google Play
1. Haz clic Update y espera 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

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.

Administrador de credenciales, SHA-1 y Firebase

En Android, este plugin utiliza el Administrador de credenciales de Google (androidx.credentials y Inicia sesión con Google), no la versión legada GoogleSignInClient 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 tenemos? webClientId ¿Qué alternativas tenemos?

¿Qué alternativas tenemos?

¿Qué alternativas tenemos?	¿Qué alternativas tenemos?	¿Qué alternativas tenemos?
Configuración de Google Cloud necesaria	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 de cliente de Android como webClientId. El Administrador de credenciales requiere el ID de 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:

Debug: desde ./gradlew signingReport para la variante de depuración.
Release: desde el APK o AAB que realmente instala.
Play App Signing: desde 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 aplicaciones incluso si su SHA-1 de 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 en Usuarios de prueba > Público. No se requiere publicar la aplicación en Producción para email y profile permisos. Los enlaces de activos digitales (assetlinks.json) no se requieren para Iniciar sesión con Google a través del Administrador de credenciales.

Los cambios 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 Play, también registra el SHA-1 de firma de Play.
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 cuenta 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 compilación de depuración configurada incorrectamente, todavía puede haber un error de coincidencia de SHA-1 o ID de cliente. Corrige la configuración de la consola antes.

Extrae la SHA-1 de la compilación que instalas.

Compilaciones de depuración o locales:

cd android && ./gradlew signingReport

APK de lanzamiento firmado:

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

Añade esa SHA-1 a un cliente de OAuth de Android con el nombre de paquete correspondiente, reinstala el mismo APK firmado y prueba de nuevo:

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 eso idToken y utiliza el ID del 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-privada para el detalle de implementación en @capgo/capacitor-clave-privada @capgo/capacitor-biometría-nativa para el detalle de implementación en @capgo/capacitor-biometría-nativa Autenticación en dos factores para el detalle de implementación en Autenticación en dos factores.