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, DEBES agregar un ID de cliente de Android adicional que contenga el SHA1 del console de Google Play para versiones 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 tienes problemas 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 del navegador, encuentre la sección de Gradle Scripts
8. Buscar build.gradle para el módulo app
9. Copy the android.defaultConfig.applicationIdEste será tu package name en el panel 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 de 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. Vaya a la Create credentials página en el Console de Google
2. Establezca el tipo de aplicación a Web
3. Haga clic en Create
4. Copie el identificador del cliente, lo utilizará como el webClientId en su JS/TS code

Modifique su 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.login. Create a button and run the following code on click.
```
const res = await SocialLogin.login({
  provider: 'google',
  options: {}
})
// handle the response
console.log(JSON.stringify(res))
```
  If you initialize Google with 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. Entrar en 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 un nombre de paquete, una huella SHA-1 o un ID de cliente desacordado.

Administrador de credenciales, SHA-1 y Firebase

En Android, este plugin utiliza el Administrador de credenciales de Google (y Inicia sesión con Google), no la versión legadaandroidx.credentials y errores de Logcat como __CAPGO_KEEP_0__ GoogleSignInClient API. Logcat errors such as GetCredentialCustomException: [28444] Developer console is not set up correctly vienen de esa pila.

Filtrar Logcat con GoogleProvider o CapgoSocialLogin ¿o qué? webClientId ¿o qué?

¿o qué?

¿o qué?	Configuración de Google Cloud necesaria	Sección titulada “Configuración de Google Cloud necesaria”
Necesita dos tipos de identificadores de cliente OAuth 2.0 en el mismo proyecto de Google Cloud: El tipo de cliente El uso Donde va Web aplicación El tipo de cliente El uso Donde va Android aplicación El tipo de cliente El uso Donde va	Servidor / token de identificación de audiencia	`webClientId` in `SocialLogin.initialize()`
en 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.
Desde la certificación de la clave de firma de la aplicación en la consola de Play > Integridad de la aplicación > 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 subida ya está 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 es necesario publicar la aplicación en Producción para email y profile los alcances. Los enlaces de activos digitales (assetlinks.json) no son necesarios 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 Juegos, también registra el SHA-1 de la 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 compilación de depuración configurada incorrectamente, aún puede haber un error de coincidencia de SHA-1 o ID de cliente. Corrija la configuración de la consola antes.

Extrae el 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

Agrega ese 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 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-llave para el detalle de implementación en @capgo/capacitor-clave-llave @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 de Autenticación en dos factores.