Risoluzione dei problemi di App Distribution e DOMANDE FREQUENTI

iOS e versioni successive Android

Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande frequenti sulla distribuzione e sul test delle app con App Distribution.

Distribuzione di app

Segui questi suggerimenti per risolvere i problemi che potresti riscontrare quando che distribuiscono app ai tester.

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

Quando carichi un'app, potresti riscontrare questo errore:

"Impossibile trovare un indirizzo email di contatto per l'app <app-id>. Per configurarne uno, visita App Distribution nella console Firebase."

Imposta un'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 si verificano ripetutamente 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. La dimensione massima del file per tutti i file binari è 2048 MiB, ossia poco più di 2 GB.

2. Se le dimensioni dell'APK rientrano nel limite di dimensioni del file e sono riproducibili, contatta Assistenza Firebase.

Impossibile caricare 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

Distribuzione di Android App Bundle (AAB)

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

Quando carichi un AAB su App Distribution, Google Play si rinnova automaticamente l'APK generato usando un certificato di chiave di firma dell'app di test. Quando richiesto, devi registrare la tua app con provider API se vuoi continuare a usare dai servizi di terze parti. Una volta firmato, il certificato di test dell'app nella console Firebase.

Gli AAB che carico vengono visualizzati anche in Google Play?

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

Cosa succede se scollego Firebase di 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 esportare a Google Play tramite l'integrazione di App Distribution con Google Play.

• Le build esistenti continueranno a essere disponibili in Dashboard di Firebase App Distribution e ai tester.

• Tutti i dati esportati in precedenza tra Firebase e Google Play rimarranno invariati accessibili in entrambi i prodotti.

Posso riprovare a collegare un'app a Google Vuoi giocare?

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

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

• Per il progetto Firebase, disponi di uno dei seguenti ruoli: Proprietario o Amministratore Firebase.

• La tua app è registrata con Firebase e il tuo sviluppatore Google Play . Ciò 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 sono entrambe registrate utilizzando lo stesso nome di pacchetto.

• L'app in Google Play è configurata nell'app dashboard e viene distribuito a uno dei canali Google Play (test interni, test chiusi, test aperti o produzione).

• La revisione dell'app in Google Play è stata completata e l'app pubblicata. Il tuo L'app è pubblicata se la colonna Stato applicazione mostra una delle seguenti opzioni stati: Test interni (non test interni in versione bozza), Test chiusi, Test aperti o Produzione.

Se hai caricato un'app che in precedenza non soddisfaceva i criteri elencati sopra per ma al momento funziona. Puoi riprovare a collegare la tua app Firebase per Android a Google Play.

Installazione e test delle app

Utilizza i seguenti suggerimenti per risolvere i problemi che i tester potrebbero incontrare durante l'installazione e il test delle tue app.

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à collegato a un altro Account Google.
• Ricordati di utilizzare la password del tuo Account Google quando accedi con questo indirizzo email.

Per ulteriori informazioni, vedi Accedere all'Account Google con un altro indirizzo email.

Il tester non riesce a vedere le app o le build giuste

Se il tester ha accettato l'invito via email con un indirizzo email diverso da a cui è stato inviato l'invito, il tester potrebbe non riuscire a vedere le app corrette le build.

L'email a cui lo sviluppatore invia inviti e aggiunge alle nuove build (L'email A) può essere diversa dall'indirizzo email che il tester utilizza per accettare i invito (email B). In questo modo viene creato un link dietro le quinte. Ogni volta che l'indirizzo email A viene aggiunto alle nuove build, è in realtà l'indirizzo email B ad avere accesso.

Se il tester ha accettato l'invito con un altro indirizzo email, Per risolvere il problema, procedi nel seguente modo:

1. Elimina il tester dalla sezione Visualizza tutti i tester di Tester e Gruppi nell'app App Distribution pagina 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 le notifiche via email se si verifica una delle seguenti condizioni:

• Le notifiche via email vengono inviate alle cartelle Spam.

• Filtri email 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 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 notifiche di rilascio al tester perché non ha accettato l'invito iniziale.

Soluzione 1

1. Chiedi al tester di controllare la cartella Spam e gli eventuali filtri email impostati il proprio servizio email.

2. Se il tester ha annullato l'iscrizione alle email, chiedigli di eseguire la seguenti:

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

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).

Nota: per visualizzare gli inviti alle app in attesa, è necessario l'indirizzo email dell'account di Google l'account utilizzato dal tester per accedere all'app App Tester deve corrispondere al destinatario all'indirizzo email dell'invito dello sviluppatore.

Soluzione 3

1. Elimina il tester dalla sezione Visualizza tutti i tester di Tester e Gruppi nell'app App Distribution nella 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 dell'app non indica 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 bundle dell'APK corrisponda all'ID bundle dell'app Firebase impiegata per caricare la distribuzione.

Avviso di Android che mi informa che il dispositivo non riesce a installare app sconosciute

L'avviso Android viene visualizzato se all'app o al browser in esecuzione non è stata ancora concessa l'autorizzazione per installare app al di fuori di Google Play. Per concedere l'autorizzazione:

• Versione di Android 8 o 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 prompt, tocca OK > Fiducia.

Impossibile installare gli APK di prova

Se un APK di prova non viene installato sul dispositivo di un tester:

• Verifica che i certificati della nuova versione corrispondano a quelli della installata sul dispositivo del tester. Il sistema Android consente da aggiornare se i certificati corrispondono. Per scoprire di più, consulta la sezione Considerazioni per la firma.
• Assicurati che la versione del sistema operativo del dispositivo tester sia supportata dall'app (controlla la minSdkVersion).

Impossibile accedere all'app Android App Tester

Se l'app App Tester ti impedisce di accedere e ti reindirizza a alla schermata di accesso, è possibile che tu stia utilizzando una versione di Google Workspace (in precedenza G Suite) che include le impostazioni delle limitazioni.

Per rimuovere le impostazioni relative alle limitazioni:

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 restrizioni.

3. Prova ad accedere di nuovo una volta rimosse le impostazioni.

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

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

Puoi chiedere al tester di raccogliere segnalazione di bug subito dopo aver riscontrato il problema ed esamina il report per ulteriori informazioni informazioni sulla causa. Il tester deve eliminare le app in conflitto prima che la nuova app possa essere installata.

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

Quando si verifica un errore 403, significa che l'account in uso non dispone dell'autorizzazione per installare e testare 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 del tuo account. L'amministratore deve seguire le istruzioni riportate in Gestire l'accesso ai servizi non controllabili individualmente.

Se disponi di più account, prova ad accedere con un account diverso a cui non sia consentito installare e testare app.

Test su un nuovo dispositivo Android

Se sei un tester per la prima volta, consulta l'articolo Configurare come tester.

Se sei già un tester di App Distribution e ricevi un nuovo dispositivo Android per anziché ripetere l'intero flusso di test, segui queste istruzioni: 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 Android App Tester dell'app.

Attivazione delle funzionalità dei tester con l'SDK Android App Distribution

Utilizza i seguenti suggerimenti per risolvere i problemi relativi all'attivazione di nuove funzionalità in-app generare avvisi o inviare feedback in-app utilizzando l'SDK per Android App Distribution.

Il tester non può avviare feedback nell'app

Se hai già configurato l'SDK Android App Distribution nella tua app per supportare i feedback in-app e i tuoi 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 se sono presenti 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", il tester potrebbe non essere stato invitato all'app o potrebbe non avere accesso alla release.

   2. Nella dashboard App Distribution della console Firebase, individua il la release esatta in esecuzione sul dispositivo del tester e assicurati che il tester è elencato nella scheda Tester della scheda di rilascio e si trova nella Stato accettato.

   Se continui a non ricevere il feedback, procedi nel seguente modo:

   1. Sul dispositivo di test, accedi a Firebase App Distribution usando l'app Tester o l'app web dei tester. Assicurati di selezionare l'Account Google utilizzata per la prima volta quando hai accettato l'invito a testare l'app.

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

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

4. Assicurati di aver attivato l'API Firebase App Testers. Per ulteriori informazioni, consulta Abilitare l'API App Distribution Tester.

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

Mancata ricezione del feedback inviato nell'app

1. Se visualizzi questo messaggio quando invii un feedback, "Avrebbe inviato feedback, ma non per via della modalità di sviluppo." Disabilita 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 che lo stai inviando 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. Verifica 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, procedi nel seguente modo:

1. Controlla la presenza di messaggi di errore allegando un OnFailureListener alla Task restituito dall'API App Distribution di Firebase.

   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 nell'app. Per scoprire come, 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 hanno accesso, il tester potrebbe non essere ancora associato al nuovo .

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

      Se il tester continua a non ricevere avvisi, chiedigli di seguire i suggerimenti di seguito per assicurarti che abbiano accettato l'invito a testare la tua app che abbia configurato correttamente il dispositivo di test:

      1. Sul dispositivo di test, accedi a Firebase App Distribution tramite App Tester o tramite l'app web del 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 release della nuova app sia disponibile in App Tester oppure l'app web tester.

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

Per impostazione predefinita, i tester devono accedere al proprio Account Google una sola volta per poter attivare le funzionalità di test. Se i tester vengono ti viene chiesto di eseguire nuovamente l'accesso dopo aver chiuso e riaperto l'app, segui queste istruzioni suggerimenti per assicurarti che la configurazione di App Distribution sia impostata correttamente:

• Verifica di aver attivato l'API Firebase App Testers. Per maggiori informazioni, vedi Attivare l'API App Distribution Tester.

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

• Se in genere cancelli SharedPreferences all'uscita, è possibile che tu stia cancellando lo stato del tester. App Distribution archivia un flag che indica se il tester ha già effettuato l'accesso all'app. Per ulteriori informazioni, consulta Repository GitHub.

Domande frequenti

Sono previsti limiti per l'aggiunta di tester alla mia app?

Firebase App Distribution prevede i seguenti limiti di tester:

• Aggiungere un massimo di 500 tester a un progetto Firebase

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

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

I miei inviti ai tester hanno una scadenza?

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, viene visualizzata una notifica di scadenza nella Console Firebase accanto al tester in una release. È possibile rinnovare un invito inviandolo di nuovo tramite il menu a discesa nella riga del tester.

Per quanto tempo sono disponibili le release dell'app?

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

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

Per ulteriori informazioni, vedi App Distribution supporta un massimo di 1000 release.

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

Per mantenere disponibile la release dell'app più a lungo, usa una delle seguenti opzioni raccomandazioni:

• Prima che la release dell'app scada o superi il limite di release, scarica il file APK o AAB ed elimina la release dalla dashboard 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 versione dell'app su Firebase, la release viene visualizzata nella Dashboard 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.

Dopo 30 giorni dalla data di scadenza della release, viene rilasciata una release dell'app. la notifica di scadenza viene visualizzata nella release nell'app Firebase App Tester.

App Distribution supporta un massimo di 1000 release

App Distribution consente un massimo di 1000 release per app. Quando l'app raggiunge il limite di 1000 release, App Distribution elimina automaticamente il meno recente release che superano il limite.

Se vuoi gestire manualmente le release dell'app, utilizza l'API REST App Distribution all'elenco ed elimina più release di app in blocco.

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 tue build di test da un'unica posizione.

Esistono limiti di quota per la funzionalità Tester automatico?

Firebase App Distribution utilizza l'infrastruttura Firebase Test Lab e la sua quota limiti e prezzi sono gli stessi. Le quote di test vengono misurate in base al numero vengono eseguiti quotidianamente. Per scoprire di più su quote di test e fatturazione, consulta Utilizzo livelli, quote e prezzi per Test Lab.

Quali sono i limiti di ripetizione della quota per la funzionalità Automated Tester?

Se superi la quota, riceverai errori di quota superata. Le quote richiedono circa 24 ore per la reimpostazione, quindi dovresti evitare nuovi tentativi fino al rilascio della quota. Tuttavia, se ricevi errori relativi all'infrastruttura di Automated Tester, le chiamate hanno maggiori probabilità di andare a buon fine se riprovi immediatamente.

Quali autorizzazioni sono necessarie per eseguire la funzionalità beta di Tester automatico?

Per eseguirlo, devi disporre dell'accesso Editor al progetto Firebase i test con la funzionalità Tester automatico.

Come si elimina il mio account tester?

Per eliminare il tuo account tester App Distribution e i relativi 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 (Gestisci account)

   Elimina account.

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