Inizia
Copia una riga di configurazione con i passaggi di installazione e la guida markdown completa per questo plugin.
Set up this Capacitor plugin in the project.
Use the package manager already used by the project.
Install these package(s): `@capgo/capacitor-firebase-authentication`
Run the required Capacitor sync/update step after installation.
Read this markdown guide for the full setup steps: https://raw.githubusercontent.com/Cap-go/website/refs/heads/main/apps/docs/src/content/docs/docs/plugins/firebase-authentication/getting-started.mdx
Use that guide for platform-specific steps, native file edits, permissions, config changes, imports, and usage setup.
If that guide references other docs pages, read them too.
Installa
Sezione intitolata “Installa”bun add @capgo/capacitor-firebase-authenticationbunx cap syncImporta
Sezione intitolata “Importa”import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';API Panoramica
Sezione intitolata “API Panoramica”applyActionCode
Sezione intitolata “applicaCodiceVerifica”Applica il codice di verifica code inviato all'utente via email.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.applyActionCode({} as ApplyActionCodeOptions);confirmPasswordReset
Sezione intitolata “confermaResetPassword”Completa il processo di reimpostazione della password.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.confirmPasswordReset({} as ConfirmPasswordResetOptions);confirmVerificationCode
Sezione intitolata “confermaCodiceDiVerifica”Completa il processo di verifica del numero di telefono.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.confirmVerificationCode({} as ConfirmVerificationCodeOptions);createUserWithEmailAndPassword
Sezione intitolata “creaUtenteConEmailEPassword”Crea un nuovo account utente con email e password. Se l'account nuovo è stato creato, l'utente viene acceduto automaticamente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.createUserWithEmailAndPassword({} as CreateUserWithEmailAndPasswordOptions);deleteUser
Sezione intitolata “eliminaUtente”Elimina e disconnette l'utente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.deleteUser();fetchSignInMethodsForEmail
Sezione intitolata “fetchSignInMethodsForEmail”Recupera i metodi di accesso per un indirizzo email.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.fetchSignInMethodsForEmail({} as FetchSignInMethodsForEmailOptions);getCurrentUser
Sezione intitolata “getCurrentUser”Recupera l'utente attualmente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getCurrentUser();getPendingAuthResult
Sezione intitolata “getPendingAuthResult”Restituisce il risultato di autenticazione in sospeso. SignInResult Se il tuo app ha lanciato un flusso di accesso web e il sistema pulisce l'app mentre è in background.
Disponibile solo per Android.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getPendingAuthResult();getIdToken
Sezione intitolata “getIdToken”Estrae il token di autenticazione Firebase ID per l'utente correntemente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getIdToken();getIdTokenResult
Sottosezione intitolata “getIdTokenResult”Restituisce un token JSON Web (JWT) deserializzato utilizzato per identificare l'utente a un servizio Firebase.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getIdTokenResult();getRedirectResult
Sottosezione intitolata “getRedirectResult”Restituisce il SignInResult dal flusso di accesso basato sulla reindirizzamento.
Se l'accesso non è stato avvenuto con successo, fallisce con un errore.
Se non è stato chiamato alcun operazione di reindirizzamento, restituisce un SignInResult con un utente nullo.
Disponibile solo per Web.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getRedirectResult();getTenantId
Sezione intitolata “getTenantId”Ottieni l'ID tenant.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.getTenantId();isSignInWithEmailLink
Sezione intitolata “isSignInWithEmailLink”Controlla se un link in arrivo è un collegamento di accesso con email adatto a signInWithEmailLink.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.isSignInWithEmailLink({} as IsSignInWithEmailLinkOptions);linkWithApple
Sezione intitolata “linkWithApple”Collega l'account utente con il provider di autenticazione Apple.
L'utente deve essere connesso al layer nativo.
L'opzione di configurazione non ha effetto qui. skipNativeAuth Copia nel portapenne
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithApple();linkWithEmailAndPassword
Sezione intitolata “linkWithEmailAndPassword”Collega l'account utente con il provider di autenticazione Email.
L'utente deve essere connesso al layer nativo. skipNativeAuth L'opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithEmailAndPassword({} as LinkWithEmailAndPasswordOptions);linkWithEmailLink
Sezione intitolata “linkWithEmailLink”Collega l'account utente con il provider di autenticazione Email.
L'utente deve essere connesso al layer nativo. skipNativeAuth L'opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithEmailLink({} as LinkWithEmailLinkOptions);linkWithFacebook
Sezione intitolata “linkWithFacebook”Collega l'account utente con il provider di autenticazione Facebook.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth L'opzione di configurazione non ha alcun effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithFacebook();linkWithGameCenter
Sezione intitolata “linkWithGameCenter”Collega l'account utente con il provider di autenticazione di Game Center.
L'utente deve essere connesso al layer nativo.
Il skipNativeAuth L'opzione di configurazione non ha alcun effetto qui.
Disponibile solo per iOS.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithGameCenter();linkWithGithub
Sezione intitolata “linkWithGithub”Collega l'account utente con il provider di autenticazione GitHub.
L'utente deve essere connesso al layer nativo.
Il skipNativeAuth L'opzione di configurazione non ha alcun effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithGithub();linkWithGoogle
Sezione intitolata “linkWithGoogle”Collega l'account utente al provider di autenticazione Google.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithGoogle();linkWithMicrosoft
Sezione intitolata “linkWithMicrosoft”Collega l'account utente al provider di autenticazione Microsoft.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithMicrosoft();linkWithOpenIdConnect
Sezione intitolata “linkWithOpenIdConnect”Collega l'account utente a un provider OpenID Connect.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithOpenIdConnect({} as LinkWithOpenIdConnectOptions);linkWithPhoneNumber
Sezione intitolata “linkWithPhoneNumber”Collega l'account utente a un provider di autenticazione tramite numero di telefono.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth opzione di configurazione non ha effetto qui.
Utilizza il phoneVerificationCompleted listener per essere notificato quando la verifica è completata.
Utilizza il phoneVerificationFailed listener per essere notificato quando la verifica è fallita.
Utilizza il phoneCodeSent listener per ottenere l'ID di verifica.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithPhoneNumber({} as LinkWithPhoneNumberOptions);linkWithPlayGames
Sezione intitolata “linkWithPlayGames”Collega l'account utente al provider di autenticazione Play Games.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth opzione di configurazione non ha effetto qui.
Disponibile solo per Android.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithPlayGames();linkWithTwitter
Sezione intitolata “linkWithTwitter”Collega l'account utente al provider di autenticazione Twitter.
L'utente deve essere connesso al layer nativo.
La skipNativeAuth opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithTwitter();linkWithYahoo
Sezione intitolata “linkWithYahoo”Collega l'account utente al provider di autenticazione Yahoo.
The utente deve essere connesso al layer nativo.
Il skipNativeAuth l'opzione di configurazione non ha effetto qui.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.linkWithYahoo();Rilancia i dati di account utente, se connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.reload();revokeAccessToken
Sottosezione intitolata “revocaAccessToken”Revoca il token di accesso specificato. Attualmente supporta solo i token di accesso OAuth Apple.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.revokeAccessToken({} as RevokeAccessTokenOptions);sendEmailVerification
Sottosezione intitolata “inviaEmailVerifica”Invia un'email di verifica al utente attualmente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.sendEmailVerification();sendPasswordResetEmail
Sezione intitolata “sendPasswordResetEmail”Invia un'email di reimpostazione della password.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.sendPasswordResetEmail({} as SendPasswordResetEmailOptions);sendSignInLinkToEmail
Sezione intitolata “sendSignInLinkToEmail”Invia un link di accesso all'email specificata all'utente.
Per completare l'accesso con il link email, chiama signInWithEmailLink con l'indirizzo email e il link email forniti nell'email inviata all'utente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.sendSignInLinkToEmail({} as SendSignInLinkToEmailOptions);setLanguageCode
Sezione intitolata “setLanguageCode”Imposta il linguaggio utente code per le operazioni di autenticazione.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.setLanguageCode({} as SetLanguageCodeOptions);setPersistence
Sezione intitolata “setPersistence”Imposta il tipo di persistenza per la sessione di autenticazione salvata attualmente.
Disponibile solo per Web.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.setPersistence({} as SetPersistenceOptions);setTenantId
Sezione intitolata “setTenantId”Imposta l'ID tenant.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.setTenantId({} as SetTenantIdOptions);signInAnonymously
Sezione intitolata “signInAnonymously”Effettua l'accesso come utente anonimo.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInAnonymously();signInWithApple
Sezione intitolata “signInWithApple”Avvia il flusso di accesso Apple.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithApple();signInWithCustomToken
Sezione intitolata “signInWithCustomToken”Avvia il flusso di accesso con token personalizzato.
Questo metodo non può essere utilizzato in combinazione con skipNativeAuth su Android e iOS. signInWithCustomToken interface of the Firebase JS SDK directly.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithCustomToken({} as SignInWithCustomTokenOptions);signInWithEmailAndPassword
Copia nel portapenneSezione intitolata “signInWithEmailAndPassword”
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithEmailAndPassword({} as SignInWithEmailAndPasswordOptions);signInWithEmailLink
Copia nel portapenneSezione intitolata “signInWithEmailLink”
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithEmailLink({} as SignInWithEmailLinkOptions);signInWithFacebook
Sezione intitolata “signInWithFacebook”Avvia il flusso di accesso con Facebook.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithFacebook();signInWithGameCenter
Sezione intitolata “signInWithGameCenter”Avvia il flusso di accesso con Game Center.
Disponibile solo per iOS.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithGameCenter();signInWithGithub
Sezione intitolata “signInWithGithub”Starts the GitHub sign-in flow.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithGithub();signInWithGoogle
Sezione intitolata “signInWithGoogle”Avvia il flusso di accesso con Google.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithGoogle();signInWithMicrosoft
Sezione intitolata “Accedi con Microsoft”Avvia il flusso di accesso Microsoft.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithMicrosoft();signInWithOpenIdConnect
Sezione intitolata “Accedi con OpenID Connect”Avvia il flusso di accesso OpenID Connect.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithOpenIdConnect({} as SignInWithOpenIdConnectOptions);signInWithPhoneNumber
Sezione intitolata “Accedi con numero di telefono”Avvia il flusso di accesso utilizzando un numero di telefono.
Utilizza il phoneVerificationCompleted listener per essere informato quando la verifica è completata.
Utilizza il phoneVerificationFailed listener per essere informato quando la verifica fallisce.
Utilizza il phoneCodeSent ascoltatore per ottenere l'ID di verifica.
Disponibile solo per Android e iOS.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithPhoneNumber({} as SignInWithPhoneNumberOptions);signInWithPlayGames
Sezione intitolata “signInWithPlayGames”Avvia il flusso di accesso a Play Games.
Disponibile solo per Android.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithPlayGames();signInWithTwitter
Sezione intitolata “signInWithTwitter”Avvia il flusso di accesso a Twitter.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithTwitter();signInWithYahoo
Sezione intitolata “signInWithYahoo”Avvia il flusso di accesso a Yahoo.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signInWithYahoo();Avvia il flusso di disconnessione.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.signOut();Scollega un provider da un account utente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.unlink({} as UnlinkOptions);Aggiorna l'indirizzo email dell'utente attualmente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.updateEmail({} as UpdateEmailOptions);updatePassword
Sezione intitolata “aggiorna password”Aggiorna la password dell'utente attualmente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.updatePassword({} as UpdatePasswordOptions);updateProfile
Sezione intitolata “aggiornaProfilo”Aggiorna i dati del profilo dell'utente.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.updateProfile({} as UpdateProfileOptions);useAppLanguage
Sezione intitolata “usaLinguaApp”Imposta la lingua utente code come lingua predefinita dell'applicazione.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.useAppLanguage();useEmulator
Sezione intitolata “usaEmulatore”Instrumenta l'app per comunicare con l'emulatore di autenticazione.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.useEmulator({} as UseEmulatorOptions);verifyBeforeUpdateEmail
Sezione intitolata “verificaPrimaAggiornaEmail”Verifica l'indirizzo email nuovo prima di aggiornare l'indirizzo email dell'utente attualmente connesso.
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.verifyBeforeUpdateEmail({} as VerifyBeforeUpdateEmailOptions);checkAppTrackingTransparencyPermission
Sezione intitolata “verifica la trasparenza della tracciatura dell'app”Verifica lo stato corrente della trasparenza della tracciatura dell'app
Disponibile solo su iOS
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.checkAppTrackingTransparencyPermission();requestAppTrackingTransparencyPermission
Sezione intitolata “richiedi la trasparenza della tracciatura dell'app”Apre il dialogo del sistema per autorizzare la tracciatura dell'app
Attenzione: L'utente potrebbe aver disabilitato la richiesta di tracciatura nei impostazioni del dispositivo, vedi la documentazione di Apple.
Disponibile solo su iOS
import { FirebaseAuthentication } from '@capgo/capacitor-firebase-authentication';
await FirebaseAuthentication.requestAppTrackingTransparencyPermission();Riferimento di tipo
Sezione intitolata “Riferimento di tipo”ApplyActionCodeOptions
Sezione intitolata “Applica opzioni di codice di azione”export interface ApplyActionCodeOptions { /** * A verification code sent to the user. * * @since 0.2.2 */ oobCode: string;}ConfirmPasswordResetOptions
Sezione intitolata “Conferma opzioni di reset della password”export interface ConfirmPasswordResetOptions { /** * A verification code sent to the user. * * @since 0.2.2 */ oobCode: string; /** * The new password. * * @since 0.2.2 */ newPassword: string;}ConfirmVerificationCodeOptions
Sezione intitolata “Conferma opzioni di codice di verifica”export interface ConfirmVerificationCodeOptions { /** * The verification ID received from the `phoneCodeSent` listener. * * The `verificationCode` option must also be provided. * * @since 5.0.0 */ verificationId: string; /** * The verification code either received from the `phoneCodeSent` listener or entered by the user. * * The `verificationId` option must also be provided. * * @since 5.0.0 */ verificationCode: string;}SignInResult
Sezione intitolata “Risultato di accesso”export interface SignInResult { /** * The currently signed-in user, or null if there isn't any. * * @since 0.1.0 */ user: User | null; /** * Credentials returned by an auth provider. * * @since 0.1.0 */ credential: AuthCredential | null; /** * Additional user information from a federated identity provider. * * @since 0.5.1 */ additionalUserInfo: AdditionalUserInfo | null;}CreateUserWithEmailAndPasswordOptions
Sezione intitolata “Crea utente con opzioni di accesso con e-mail e password”export interface CreateUserWithEmailAndPasswordOptions { /** * @since 0.2.2 */ email: string; /** * @since 0.2.2 */ password: string;}FetchSignInMethodsForEmailOptions
Sezione intitolata “FetchSignInMethodsForEmailOptions”export interface FetchSignInMethodsForEmailOptions { /** * The user's email address. * * @since 6.0.0 */ email: string;}FetchSignInMethodsForEmailResult
Sezione intitolata “FetchSignInMethodsForEmailResult”export interface FetchSignInMethodsForEmailResult { /** * The sign-in methods for the specified email address. * * This list is empty when [Email Enumeration Protection](https://cloud.google.com/identity-platform/docs/admin/email-enumeration-protection) * is enabled, irrespective of the number of authentication methods available for the given email. * * @since 6.0.0 */ signInMethods: string[];}GetCurrentUserResult
Sezione intitolata “GetCurrentUserResult”export interface GetCurrentUserResult { /** * The currently signed-in user, or null if there isn't any. * * @since 0.1.0 */ user: User | null;}GetIdTokenOptions
Sezione intitolata “GetIdTokenOptions”export interface GetIdTokenOptions { /** * Force refresh regardless of token expiration. * * @since 0.1.0 */ forceRefresh: boolean;}GetIdTokenResult
Sezione intitolata “GetIdTokenResult”export interface GetIdTokenResult { /** * The Firebase Auth ID token JWT string. * * @since 0.1.0 */ token: string;}GetIdTokenResultOptions
Sezione intitolata “GetIdTokenResultOptions”export interface GetIdTokenResultOptions { /** * Force refresh regardless of token expiration. * * @since 7.4.0 */ forceRefresh: boolean;}GetIdTokenResultResult
Sezione intitolata “GetIdTokenResultResult”export interface GetIdTokenResultResult { /** * The authentication time in milliseconds since the epoch. * * This is the time the user authenticated (signed in) and not the time the token was refreshed. * * @since 7.4.0 */ authTime: number; /** * The ID token expiration time in milliseconds since the epoch. * * @since 7.4.0 */ expirationTime: number; /** * The ID token issuance time in milliseconds since the epoch. * * @since 7.4.0 */ issuedAtTime: number; /** * The sign-in provider through which the ID token was obtained. * * @since 7.4.0 */ signInProvider: string | null; /** * The type of second factor associated with this session, provided the user was multi-factor * authenticated (eg. phone, etc). * * @since 7.4.0 */ signInSecondFactor: string | null; /** * The entire payload claims of the ID token including the standard reserved claims as well as * the custom claims. * * @since 7.4.0 */ claims: Record<string, unknown>;}Fonte di Verità
Sezione intitolata “Fonte di Verità”Questa pagina è generata dal plugin src/definitions.tsRiepilogare la sincronizzazione quando i dati pubblici API cambiano in fase di sviluppo.