Risoluzione dei problemi di App Distribution e DOMANDE FREQUENTI

Impossibile distribuire un'app a causa di un'email di contatto mancante

Durante il caricamento di un'app, potresti riscontrare questo errore:

"Non siamo riusciti a trovare un indirizzo email di contatto per l'app <app-id>. Visita App Distribution nella console Firebase per configurarne uno."

Imposta un indirizzo email di contatto nella console Firebase, se disponibile. Se il problema persiste, contatta l'assistenza Firebase.

Si è verificato un errore durante il provisioning dell'app (errori 400, 409 o 500)

Se riscontri ripetutamente gli errori 400, 409 o 500 durante il provisioning, contatta l'assistenza Firebase. Fornisci all'assistenza il numero del progetto Firebase e l'identificatore dell'app.

Impossibile caricare il file APK

1. Verifica le dimensioni dell'APK. Il limite massimo per le dimensioni dei file di tutti i file binari è 2048 MiB, ovvero poco più di 2 GB.

2. Se le dimensioni dell'APK rientrano nel limite di dimensioni del file e il problema è riproducibile, contatta l'assistenza Firebase.

Impossibile caricare l'APK con fastlane. L'APK non è firmato.

Verifica che l'APK sia firmato utilizzando quanto segue:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Ricezione di errori con l'accesso social/i provider di API di terze parti

Quando carichi un AAB su App Distribution, Google Play firma automaticamente l'APK generato utilizzando un certificato della chiave di firma dell'app di test. Quando ti viene richiesto, devi registrare la tua app con i provider API se vuoi continuare a utilizzare i loro servizi di terze parti. Una volta firmato, il certificato di test della tua app può essere visualizzato nella console Firebase.

I file AAB che carico vengono visualizzati anche su Google Play?

Le build AAB che carichi su App Distribution non vengono visualizzate nel tuo account sviluppatore Google Play (incluso Explorer per app bundle e la condivisione interna delle app).

Cosa succede se scollego Firebase da Google Play?

Se un'app Firebase per Android viene scollegata da Google Play, si verifica quanto segue:

• Non potrai caricare nuovi app bundle in App Distribution ed esportarli in Google Play tramite l'integrazione di App Distribution con Google Play.

• Le build esistenti continueranno a essere disponibili nella dashboard di Firebase App Distribution e per i tuoi tester.

• I dati precedentemente esportati tra Firebase e Google Play rimarranno accessibili in entrambi i prodotti.

Posso riprovare a collegare un'app a Google Play?

Per distribuire un Android App Bundle (AAB) tramite App Distribution e collegare automaticamente gli AAB caricati sia al tuo progetto Firebase sia al tuo account sviluppatore Google Play, assicurati di soddisfare i seguenti requisiti:

• Il tuo account sviluppatore Google Play ha uno dei seguenti livelli di accesso: Proprietario o Amministratore.

• Per il tuo progetto Firebase, hai uno dei seguenti ruoli: Proprietario o Amministratore Firebase.

• La tua app è registrata con Firebase e il tuo account sviluppatore Google Play. Questo significa che hai un'app Firebase per Android e un'app per Google Play.

• L'app in Google Play e l'app Firebase per Android vengono registrate entrambe con lo stesso nome di pacchetto.

• L'app in Google Play viene configurata nella dashboard dell'app e distribuita a uno dei canali Google Play (test interno, chiuso, aperto o produzione).

• La revisione dell'app in Google Play è stata completata e l'app pubblicata. L'app viene pubblicata se la colonna Stato app mostra uno dei seguenti stati: test interno (non test interno in bozza), test chiuso, test aperto o produzione.

Se hai caricato un'app che in precedenza non soddisfaceva i criteri di collegamento elencati sopra, ma ora li soddisfa, puoi riprovare a collegare l'app Firebase per Android a Google Play.

Il tester non ha un Account Google

Quando un utente crea un Account Google, riceve automaticamente un indirizzo Gmail.

Se un tester non ha un indirizzo Google Workspace o Gmail o se preferisce utilizzare un altro indirizzo email per accedere, chiedigli di collegare un indirizzo email non Gmail all'account e di utilizzarlo per accedere.

Quando sceglie un indirizzo email alternativo, il tester deve seguire queste linee guida:

• Non utilizzare un indirizzo Gmail.
• Non utilizzare un indirizzo email già associato a un altro Account Google.
• Ricordati di utilizzare la password dell'account Google quando accedi con questo indirizzo email.

Per saperne di più, vedi Accedi all'Account Google con un altro indirizzo email.

Il tester non riesce a visualizzare le app o le build corrette

Se il tester ha accettato l'invito via email con un indirizzo email diverso da quello a cui è stato inviato l'invito, potrebbe non essere in grado di visualizzare le app o le build corrette.

L'indirizzo email a cui lo sviluppatore invia gli inviti e che aggiunge alle nuove build (indirizzo email A) può essere diverso da quello utilizzato dal tester per accettare l'invito (indirizzo email B). In questo modo viene creato un link in background. Ogni volta che l'indirizzo email A viene aggiunto alle nuove build, è l'indirizzo email B che ottiene l'accesso.

Se il tester ha accettato l'invito via email con un indirizzo email diverso, segui questi passaggi per risolvere il problema:

1. Elimina il tester dalla sezione Visualizza tutti i tester della scheda Tester e gruppi nella pagina App Distribution della console Firebase. Gli inviti esistenti vengono rimossi.

2. Invita di nuovo il tester a testare la tua app. Il tester dovrebbe ricevere un'email di invito.

3. Assicurati che il tester accetti l'invito con lo stesso indirizzo email.

Il tester non riceve notifiche via email

I tester potrebbero non ricevere notifiche via email se si verifica una delle seguenti condizioni:

• Le notifiche via email vengono inviate alle cartelle Spam.

• I filtri email sono impostati.

• L'invito è stato inviato a un account email, ma il tester lo ha accettato con un account email diverso. Il tester riceve le email relative alle nuove release all'account email a cui è stato originariamente inviato l'invito.

• Il tester è stato invitato in precedenza, ma non ha accettato l'invito iniziale. Se il tester viene aggiunto alle release successive, App Distribution non invierà automaticamente le notifiche di release a questo tester perché non ha accettato l'invito iniziale.

Soluzione 1

1. Chiedi al tester di controllare la cartella Spam ed eventuali filtri email impostati nel suo servizio email.

2. Se il tester ha annullato l'iscrizione alle email, chiedigli di procedere nel seguente modo:

   1. Trova un'email che il tester ha ricevuto in precedenza dall'app.
   2. Fai clic su Gestisci le impostazioni email in basso e poi su Consenti email per riabbonarsi.

Soluzione 2

Se il tester non vuole ricevere notifiche via email, ma vuole poter accettare gli inviti alle app, può visualizzare gli inviti alle app in attesa direttamente nell'app App Tester (istruzioni per il download).

Soluzione 3

1. Elimina il tester dalla sezione Visualizza tutti i tester della scheda Tester e gruppi nella pagina App Distribution della console Firebase. Questa azione rimuove gli inviti esistenti.

2. Invita di nuovo il tester a testare la tua app. Il tester dovrebbe ricevere un'email di invito. Assicurati che il tester accetti l'invito con lo stesso indirizzo email a cui è stato inviato.

L'app non indica che è installata

Se un tester scarica e installa una release, ma l'interfaccia utente dei dettagli sull'app non mostra che l'app è installata, si tratta di un problema noto. In alcuni casi, l'ID pacchetto nell'app Firebase non corrisponde all'ID pacchetto dell'APK.

Verifica che l'ID pacchetto dell'APK corrisponda all'ID pacchetto dell'app Firebase che hai utilizzato per caricare la distribuzione.

Avviso di Android che indica che il mio dispositivo non può installare app sconosciute

L'avviso di Android viene visualizzato se l'app o il browser in esecuzione non ha ancora ricevuto l'autorizzazione per installare app al di fuori di Google Play. Per concedere l'autorizzazione:

• Android 8 o versioni successive: nell'app Impostazioni, tocca Consenti da questa sorgente.

• Android 7 o versioni precedenti: nell'app Impostazioni, tocca Sicurezza e seleziona Origini sconosciute. Quando viene visualizzato il messaggio, tocca Ok > Attendibile.

Installazione degli APK di test non riuscita

Se non è possibile installare un APK di test sul dispositivo di un tester:

• Verifica che i certificati nella nuova versione corrispondano a quelli della versione installata sul dispositivo del tester. Il sistema Android consente l'aggiornamento dell'app solo se i certificati corrispondono. Per saperne di più, consulta Considerazioni sulla firma.
• Assicurati che la versione del sistema operativo del dispositivo del tester sia supportata dall'app (controlla il minSdkVersion).

Impossibile accedere all'app Android App Tester

Se l'app App Tester ti impedisce di accedere e ti reindirizza alla schermata di accesso, è possibile che tu stia utilizzando un account Google Workspace (precedentemente G Suite) che include impostazioni di limitazione.

Per rimuovere le impostazioni di limitazione:

1. Nella scheda App di Google Workspace, assicurati che Firebase App Distribution non sia impostato su Accesso: bloccato.

2. Nella scheda Servizi, assicurati che Cloud Platform non abbia limitazioni.

3. Una volta rimosse le impostazioni, prova a eseguire di nuovo l'accesso.

Errore durante l'installazione di un file AAB: "Impossibile installare l'app"

Questo errore può verificarsi quando l'app che stai installando è in conflitto con un'app già installata sul dispositivo. Ad esempio, potrebbe essere una variante diversa della stessa app con la stessa autorizzazione personalizzata o lo stesso nome ContentProvider.

Puoi chiedere al tester di raccogliere una segnalazione di bug subito dopo aver riscontrato il problema ed esaminare la segnalazione per ulteriori informazioni sulla causa. Il tester deve eliminare tutte le app in conflitto prima di poter installare la nuova app.

Errore 403: "Contatta l'amministratore per ottenere l'accesso"

Se ricevi un errore 403, significa che l'account che stai utilizzando non dispone dell'autorizzazione per installare e testare le app. L'accesso è determinato dall'amministratore del dominio del tuo account in Google Workspace.

Se ritieni di dover avere l'autorizzazione per installare e testare le app, chiedi all'amministratore del tuo account Google Workspace di modificare le impostazioni dell'account. L'amministratore deve seguire le istruzioni riportate in Gestisci l'accesso ai servizi non controllabili individualmente.

Se hai più account, prova ad accedere con un altro account che non abbia limitazioni per l'installazione e il test delle app.

Esegui il test su un nuovo dispositivo Android

Se è la prima volta che esegui un test, consulta Configura il tuo account come tester.

Se sei già un tester di App Distribution e ricevi un nuovo dispositivo Android su cui eseguire i test, anziché ripetere l'intero flusso per i nuovi tester, segui questi passaggi:

1. Vai alla pagina appdistribution.firebase.google.com sul tuo dispositivo Android.

2. Accedi con il tuo account tester esistente e fai clic sul pulsante Scarica App Tester nella parte inferiore dello schermo per installare l'app Android App Tester.

Il tester non può avviare il feedback nell'app

Se hai già configurato l'SDK Android App Distribution nella tua app per supportare il feedback in-app e i tester non riescono a inviare feedback, segui questi passaggi:

1. Attiva il logging dettagliato per l'SDK Android App Distribution nella tua app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Controlla la presenza di messaggi di errore nei log dell'app filtrando per "FirebaseAppDistribution".

3. Verifica che il tester abbia accesso alla release installata:

   1. Se i log indicano che "il tester non ha accesso a questa risorsa", è possibile che il tester non sia stato invitato all'app o che non abbia accesso alla release.

   2. Nella dashboard App Distribution della console Firebase, individua la release esatta in esecuzione sul dispositivo del tester e assicurati che il tester sia elencato nella scheda Tester della scheda della release e che sia nello stato Accettato.

   Se continui a non ricevere feedback, segui questi passaggi:

   1. Sul dispositivo di test, accedi a Firebase App Distribution utilizzando App Tester o l'app web per i tester. Assicurati di selezionare l'Account Google che hai utilizzato la prima volta che hai accettato l'invito a testare l'app.

   2. Installa di nuovo l'app utilizzando App Tester o l'app web di test per assicurarti che il tester abbia accesso alla release.

   3. Prova a inviare il feedback, assicurandoti di accedere con lo stesso Account Google.

4. Assicurati di aver abilitato l'API Firebase App Testers. Per saperne di più, consulta Abilita l'API App Distribution Tester.

5. In Restrizioni delle chiavi, assicurati che l'API Firebase App Testers sia inclusa nell'elenco delle API consentite.

Non ricevo i feedback inviati nell'app

1. Se quando invii un feedback visualizzi il messaggio "Avrebbe inviato feedback, ma non lo ha fatto a causa della modalità di sviluppo", disattiva la modalità sviluppatore sul dispositivo eseguendo questo comando:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Controlla il file google-services.json per assicurarti di inviare il feedback per il progetto e l'app corretti.

3. Attiva il logging dettagliato per l'SDK Android App Distribution nella tua app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Controlla la presenza di messaggi di errore nei log dell'app filtrando per "FirebaseAppDistribution".

Il tester non riceve avvisi in-app

Se hai già configurato l'SDK Android App Distribution nella tua app e i tester non ricevono avvisi in-app, segui questi passaggi:

1. Controlla la presenza di messaggi di errore collegando un OnFailureListener all'attività restituita dall'API Firebase App Distribution.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. Verifica che il tester abbia accesso alla nuova release:

   1. Attiva la modalità di debug nella tua app. Per scoprire come fare, consulta la documentazione di Google Analytics.

   2. Esegui l'app in un simulatore e cerca la stringa "FirebaseAppDistribution".

      Se i log indicano che non è stata trovata alcuna release o che il tester non ha accesso, è possibile che il tester non sia ancora associato alla nuova release.

   3. Nella dashboard App Distribution della console Firebase, assicurati che il tester sia incluso nella distribuzione della build e che sia nello stato Accettato.

      Se il tester continua a non ricevere avvisi, chiedigli di seguire questi suggerimenti per assicurarsi di aver accettato l'invito a testare la tua app e di aver configurato correttamente il dispositivo di test:

      1. Sul dispositivo di test, accedi a Firebase App Distribution utilizzando App Tester o l'app web per i tester. Ricordati di selezionare l'Account Google che hai utilizzato per la prima volta quando hai accettato l'invito a testare l'app.

      2. Verifica che la nuova release dell'app sia disponibile in App Tester o nell'app web per i tester.

Al tester viene chiesto di accedere di nuovo dopo aver chiuso l'app

Per impostazione predefinita, i tester devono accedere al proprio Account Google una sola volta per attivare le funzionalità di test. Se ai tuoi tester viene chiesto di accedere di nuovo dopo aver chiuso e riaperto l'app, segui questi suggerimenti per assicurarti che la configurazione di App Distribution sia impostata correttamente:

• Verifica di aver abilitato l'API Firebase App Testers. Per saperne di più, consulta Abilita l'API App Distribution Tester.

• In Restrizioni delle chiavi, assicurati che l'API Firebase App Testers sia inclusa nell'elenco delle API consentite.

• Se in genere cancelli SharedPreferences al momento della disconnessione, potresti cancellare lo stato del tester. App Distribution memorizza un flag che indica se il tester ha già eseguito l'accesso all'app. Per maggiori informazioni, consulta il repository GitHub.

Come faccio ad accedere all'agente App Testing?

Per accedere all'anteprima dell'agente App Testing, puoi attivare e iniziare a utilizzare la funzionalità tramite il banner nella pagina Release della console Firebase.

Se hai ignorato il banner, vai alla scheda Scenari di test per trovarlo. Un proprietario avrà l'autorizzazione per attivare l'intero progetto.

Se continui a riscontrare problemi con l'attivazione della funzionalità, contatta l'assistenza Firebase con il messaggio: "Richiesta di accesso all'agente App Testing App Distribution".

L'attivazione di questa funzionalità la renderà disponibile per tutto il mio team o solo per me?

In questo modo, la funzionalità verrà attivata per l'intero progetto.

Ho attivato la funzionalità, ma non la vedo ancora

Prova ad aggiornare il browser. Se continui a riscontrare problemi di visualizzazione della funzionalità dopo aver aggiornato il browser, contatta l'assistenza Firebase con il messaggio: "Richiesta di accesso all'agente App Testing App Distribution".

Che cosa sono gli scenari di test dei prerequisiti e come funzionano?

Gli scenari di test prerequisiti ti consentono di concatenare gli scenari di test per evitare di duplicare i passaggi in più test, ad esempio per un flusso di accesso o di onboarding comune. Quando assegni un prerequisito a un test, questo viene eseguito prima del test principale. Se un passaggio del prerequisito non va a buon fine, l'intero test viene considerato non riuscito. L'esecuzione del test finale mostra i passaggi del test dei prerequisiti e del test principale in un'unica visualizzazione, in modo da poter vedere l'intera esecuzione in un unico posto.

Tieni presente che uno scenario di test utilizzato come prerequisito per un altro scenario di test non può essere eliminato finché non viene rimosso come prerequisito dall'altro scenario di test. Puoi rimuovere i prerequisiti dagli scenari di test selezionando Nessuno dal menu a discesa dei prerequisiti nella finestra di dialogo di modifica dello scenario di test.

L'agente App Testing supporta le app Flutter?

Sì, l'agente App Testing supporta le app per Android create con Flutter.

Esistono limiti di quota per i test di scansione casuale con l'agente App Testing?

I test di scansione casuale dell'agente App Testing utilizzano l'infrastruttura di Firebase Test Lab, i cui limiti e prezzi sono gli stessi. Le quote di test vengono misurate in base al numero di test eseguiti al giorno. Per scoprire di più sulle quote di test e sulla fatturazione, consulta Livelli di utilizzo, quote e prezzi per Test Lab.

Quali sono i limiti di ripetizione della quota per i test di scansione casuale con l'agente App Testing?

Se superi la quota durante l'esecuzione di test di scansione casuali, riceverai errori di superamento della quota. Le quote vengono reimpostate dopo circa 24 ore, quindi dovresti evitare di riprovare finché la quota non viene rilasciata. Tuttavia, se ricevi errori relativi all'infrastruttura, è più probabile che le chiamate vadano a buon fine se riprovi immediatamente.

Quali autorizzazioni sono necessarie per utilizzare l'agente App Testing?

Se utilizzi il bucket Google Cloud Storage (GCS) predefinito, devi disporre del ruolo Editor nel progetto Firebase.

Se utilizzi un bucket personalizzato, non hai bisogno del ruolo Editor. Devi invece disporre di un ruolo che contenga le seguenti autorizzazioni:

• Firebase Quality Admin
• Firebase Test Lab Admin
• Storage Object User

Il bucket personalizzato deve essere di proprietà di un progetto con fatturazione abilitata e la specifica di un bucket comporterà addebiti per lo spazio di archiviazione utilizzato.

Quanto dura il timeout per i test dell'agente App Testing?

I test guidati dall'AI hanno un timeout di 5 minuti, mentre i test di scansione casuale hanno un timeout di 10 minuti.

Esistono limiti per l'aggiunta di tester alla mia app?

Firebase App Distribution ha i seguenti limiti per i tester:

• Aggiungi un massimo di 500 tester a un progetto Firebase

• Aggiungi un massimo di 200 tester a un gruppo App Distribution

Per aggiungere altri tester, richiedi un aumento del limite senza costi.

I miei inviti per i tester scadono?

I tester hanno 30 giorni di tempo per accettare un invito a testare l'app prima che scada. Quando mancano 5 giorni alla scadenza di un invito, nella console Firebase viene visualizzato un avviso di scadenza accanto al tester di una release. Un invito può essere rinnovato inviandolo di nuovo tramite il menu a discesa nella riga del tester.

Per quanto tempo sono disponibili le release delle app?

Le release dell'app vengono rimosse da App Distribution se si verifica una delle seguenti condizioni:

• La release dell'app risale a più di 150 giorni fa.
• Superi il limite di 1000 release dell'app e la release dell'app è precedente alle 1000 release più recenti.

Per saperne di più, consulta App Distribution supporta un massimo di 1000 release.

Una volta che l'app raggiunge o supera il limite di scadenza di 150 giorni o il limite di 1000 release, la release viene rimossa dalla dashboard di App Distribution e dall'app Firebase App Tester. Se il tester ha installato la release, la versione locale dell'app continua a essere eseguita.

Per mantenere disponibile la release dell'app più a lungo, utilizza uno dei seguenti suggerimenti:

• Prima che la release dell'app scada o superi il limite di release, scarica l'APK o l'AAB ed elimina la release dalla dashboard di App Distribution. Poi, ricarica l'APK o l'AAB come nuova build su App Distribution.
• Scarica la release e caricala su Cloud Storage per l'archiviazione a lungo termine.

Le release dell'app scadono dopo 150 giorni

Quando carichi una release della tua app su Firebase, questa viene visualizzata nella dashboard di App Distribution per 150 giorni, a partire dalla data di caricamento. Dopo aver caricato la release, puoi distribuirla ai tester, che la installano dall'app Firebase App Tester sul proprio dispositivo di test.

Quando mancano 30 giorni alla data di scadenza della release, nella release dell'app Firebase App Tester viene visualizzata una notifica di scadenza della release dell'app.

App Distribution supporta un massimo di 1000 release

App Distribution consente un massimo di 1000 release per app. Quando la tua app raggiunge il limite di 1000 release, App Distribution elimina automaticamente le release meno recenti che superano il limite.

Se vuoi gestire manualmente le release dell'app, utilizza l'API REST App Distribution per elencare ed eliminare le release dell'app collettivamente.

In caso di domande, contatta l'assistenza Firebase.

Come faccio ad accedere alle app di test che ho installato sul mio dispositivo?

Se sei un tester, ti consigliamo di scaricare Firebase App Tester, un'app che ti consente di accedere a tutte le build di test in un unico posto.

Come faccio a eliminare il mio account tester?

Per eliminare il tuo account tester App Distribution e i dati associati, segui questi passaggi nell'ordine indicato:

1. Visita la pagina https://appdistribution.firebase.google.com e accedi con il tuo Account Google.

2. In alto a destra, fai clic su settings (Gestisci account).

   Elimina account.

3. (Facoltativo) Nelle autorizzazioni dell'Account Google, revoca l'accesso a Firebase App Distribution. Tieni presente che la revoca dell'accesso senza prima eliminare il tuo account App Distribution non comporta l'eliminazione del tuo account o dei tuoi dati di tester.