Risoluzione problemi

Privacy Manifest non valido (ITMS-91056)

Se App Store Connect segnala questo errore:

ITMS-91056: Invalid privacy manifest - Il file PrivacyInfo.xcprivacy nel seguente percorso non è valido: …

Controlla il livello dell'app PrivacyInfo.xcprivacy dell'app:

• Il file deve essere un JSON valido.
• Usa solo chiavi e valori documentati da Apple.
• Non aggiungere un privacy manifest al pacchetto del plugin; aggiungilo alla tua app.

Vedi Privacy manifest e iOS URL handlers per gli esempi.

Errore permessi AD_ID in Google Play Console

Dopo aver inviato un'app su Google Play, potresti visualizzare:

Google Api Error: Invalid request - This release includes the com.google.android.gms.permission.AD_ID permission
but your declaration on Play Console says your app doesn't use advertising ID.

Il SDK di Facebook include AD_ID e altri permessi relativi alla pubblicità. Se la tua app non usa Facebook Login, disabilita il provider Facebook in capacitor.config.ts:

import type { CapacitorConfig } from '@capacitor/cli';

const config: CapacitorConfig = {
  plugins: {
    SocialLogin: {
      providers: {
        google: true,
        facebook: false,
        apple: true,
      },
    },
  },
};

export default config;

Poi esegui:

npx cap sync

Il plugin utilizza classi stub invece del vero SDK di Facebook, quindi le dipendenze e i permessi di Facebook non vengono inclusi nel tuo build.

Google Sign-In 28444 su Android

GetCredentialCustomException: [28444] Developer console is not set up correctly deriva da Google Credential Manager quando il certificato di firma dell'APK installato, il nome del pacchetto o webClientId non corrispondono a Google Cloud Console.

Usa il comando completo Checklist di troubleshooting per Google su Android. Dopo un login fallito, filtra Logcat per GoogleProvider; il plugin stampa package, signingSha1, e un valore mascherato webClientId per confrontarlo con i tuoi client OAuth.

Google Sign-In con account supervisionati da Family Link

Gli account supervisionati da Family Link possono fallire con:

NoCredentialException: No credentials available

Per le app che devono supportare account Family Link, disabilita il filtro authorized-account per la chiamata di login Google:

import { SocialLogin } from '@capgo/capacitor-social-login';

await SocialLogin.login({
  provider: 'google',
  options: {
    style: 'bottom',
    filterByAuthorizedAccounts: false,
    scopes: ['profile', 'email'],
  },
});

Punti chiave:

• Imposta filterByAuthorizedAccounts a false; il default è true.
• Il plugin riprova automaticamente con standard stile se bottom lo stile fallisce con NoCredentialException.
• Queste opzioni influenzano solo Android. iOS gestisce gli account Family Link normalmente.
• Il messaggio di errore suggerisce di disabilitare filterByAuthorizedAccounts quando viene rilevato questo errore.

Dove memorizzare gli access token

Usa @capgo/capacitor-persistent-account quando la tua app richiede uno storage nativo sicuro per i token di accesso o di refresh.

Su Android salva i dati in Account Manager. Su iOS li salva in Keychain.

Documentazione correlata

• Guida rapida
• Google Login su Android
• Configurazione del provider
• Privacy manifest e iOS URL handlers