Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande frequenti sulla distribuzione e il test delle app con App Distribution.
Distribuire app
Utilizza i seguenti suggerimenti per risolvere i problemi che potresti riscontrare durante la distribuzione delle app ai tester.
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 Distribuzione app nella console Firebase per configurarne uno."
Imposta un'e-mail di contatto nella console Firebase, se disponibile. Se il problema persiste, contatta l'assistenza Firebase .
Se riscontri ripetutamente gli errori 400, 409 o 500 durante il provisioning, contatta l'assistenza Firebase . Fornisci supporto con il numero del progetto Firebase e l'identificatore dell'app.
Verifica la dimensione dell'APK. Il limite massimo della dimensione del file per tutti i file binari è 2048 MiB, ovvero poco più di 2 GB.
Se la dimensione dell'APK rientra nel limite di dimensione del file ed è riproducibile, contatta l'assistenza Firebase .
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)
Quando carichi un AAB in App Distribution, Google Play firma automaticamente l'APK generato utilizzando un certificato con chiave di firma dell'app di prova. Quando richiesto, devi registrare la tua app presso i fornitori API se desideri 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.
Le build AAB caricate su App Distribution non vengono visualizzate nel tuo account sviluppatore Google Play (incluso App Bundle Explorer e condivisione interna delle app).
Se un'app Android Firebase viene scollegata da Google Play, si verifica quanto segue:
Non potrai caricare nuovi app bundle su App Distribution ed esportarli su 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.
Tutti i dati precedentemente esportati tra Firebase e Google Play rimarranno accessibili in entrambi i prodotti.
Per distribuire un Android App Bundle (AAB) tramite App Distribution e collegare automaticamente gli AAB caricati sia al tuo progetto Firebase che 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 con il tuo account sviluppatore Google Play. Ciò significa che hai sia un'app Firebase per Android che un'app 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 viene configurata nel dashboard dell'app e distribuita in uno dei percorsi di Google Play (test interno, test chiuso, test aperto o produzione).
La revisione dell'app su Google Play è completata e l'app è pubblicata. La tua app viene pubblicata se nella colonna Stato app viene visualizzato uno dei seguenti stati: Test interno (non Test interno bozza), Test chiuso, Test aperto o Produzione.
Se hai caricato un'app che in precedenza non soddisfaceva i criteri sopra elencati per il collegamento, ma ora lo fa, puoi riprovare a collegare la tua app Android Firebase a Google Play .
Installazione e test delle app
Utilizza i seguenti suggerimenti per risolvere i problemi che i tuoi tester potrebbero riscontrare quando installano e testano le tue app.
Quando un utente crea un account Google, riceve automaticamente un indirizzo Gmail.
Se un tester non dispone di un indirizzo Google Workspace o Gmail o se preferisce utilizzare un altro indirizzo email per accedere, chiedi al tester di collegare un indirizzo email non Gmail all'account e di utilizzare tale indirizzo email per accedere.
Quando sceglie un'e-mail alternativa, 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 al tuo Account Google con un altro indirizzo email .
Se il tester ha accettato l'invito via email con un indirizzo email diverso da quello a cui è stato inviato l'invito, il tester potrebbe non essere in grado di vedere le app o le build giuste.
L'e-mail a cui lo sviluppatore invia gli inviti e aggiunge alle nuove build (E-mail A) può essere diversa dall'e-mail utilizzata dal tester per accettare l'invito (E-mail B). Questo crea un collegamento dietro le quinte. Ogni volta che l'e-mail A viene aggiunta a nuove build, in realtà è l'e-mail B ad ottenere l'accesso.
Se il tester ha accettato l'invito via email con un indirizzo email diverso, segui questi passaggi per risolvere il problema:
Elimina il tester dalla sezione Visualizza tutti i tester della scheda Tester e gruppi nella pagina Distribuzione app della console Firebase. Gli inviti esistenti verranno rimossi.
Invita nuovamente il tester a testare la tua app. Il tester dovrebbe ricevere un'e-mail di invito.
Assicurati che il tester accetti l'invito con lo stesso indirizzo email.
I tester potrebbero non ricevere notifiche email se si verifica una delle seguenti condizioni:
Le notifiche e-mail vengono inviate alle cartelle spam.
I filtri email sono impostati.
L'invito è stato inviato a un account e-mail, ma il tester ha accettato con un account e-mail diverso. Il tester riceve email di nuova versione per l'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 a versioni successive, App Distribution non invierà automaticamente notifiche di rilascio al tester perché il tester non ha accettato l'invito iniziale.
Soluzione 1
Chiedi al tester di controllare la cartella spam e gli eventuali filtri email impostati nel proprio servizio di posta elettronica.
Se il tester ha annullato l'iscrizione alle e-mail, chiedi al tester di effettuare quanto segue:
- Trova un'e-mail che il tester ha ricevuto in precedenza dall'app.
- Fai clic su Gestisci impostazioni email in basso e fai clic su Consenti la nuova iscrizione alle email .
Soluzione 2
Se il tester non desidera ricevere notifiche via email ma vuole poter accettare inviti alle app, può visualizzare gli inviti alle app in sospeso direttamente nell'app App Tester ( istruzioni per il download ).
Soluzione 3
Elimina il tester dalla sezione Visualizza tutti i tester della scheda Tester e gruppi nella pagina Distribuzione app nella console Firebase. Questa azione rimuove gli inviti esistenti.
Invita nuovamente il tester a testare la tua app. Il tester dovrebbe ricevere un'e-mail di invito. Assicurati che il tester accetti l'invito con lo stesso indirizzo email a cui è stato inviato l'invito.
Se un tester scarica e installa una versione ma l'interfaccia utente dei dettagli dell'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 bundle dell'APK corrisponda all'ID bundle dell'app Firebase utilizzata per caricare la distribuzione.
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:
Android versione 8 o successiva : nell'app Impostazioni , tocca Consenti da questa fonte .
Android versione 7 o precedente : nell'app Impostazioni , tocca Sicurezza e seleziona Origini sconosciute . Quando viene visualizzato il messaggio, toccare OK > Affidabilità .
Se l'installazione di un APK di prova sul dispositivo del tester non riesce:
- Verificare 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 ulteriori informazioni, consulta Considerazioni sulla firma .
- Assicurati che la versione del sistema operativo del dispositivo tester sia supportata dall'app (controlla
minSdkVersion).
Se l'app App Tester ti impedisce di accedere e ti reindirizza alla schermata di accesso, potresti utilizzare Google Workspace (in precedenza GSuite) che include impostazioni di restrizione.
Per rimuovere le impostazioni di restrizione:
Nella scheda App di Google Workspace, assicurati che Firebase App Distribution non sia impostato su Accesso: bloccato .
Nella scheda Servizi , assicurati che Cloud Platform non abbia restrizioni.
Una volta rimosse le impostazioni, prova ad accedere nuovamente.
Questo errore può verificarsi quando l'app da installare entra in conflitto con un'app già installata 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 una segnalazione di bug immediatamente dopo aver riscontrato il problema e di esaminare la segnalazione per ulteriori informazioni sulla causa. Il tester deve eliminare eventuali app in conflitto prima di poter installare la nuova app.
Quando riscontri un errore 403, significa che l'account che stai utilizzando 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 in Gestire l'accesso ai servizi che non sono controllati individualmente .
Se disponi di più account, prova ad accedere con un account diverso a cui non sia impedito di installare e testare app.
Se sei un tester per la prima volta, vedi Configurarsi come tester .
Se sei un tester di App Distribution esistente e ricevi un nuovo dispositivo Android su cui testare, invece di ripetere l'intero flusso del nuovo tester, segui questi passaggi:
Vai su appdistribution.firebase.google.com sul tuo dispositivo Android.
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.
Abilitazione delle funzionalità del tester con l'SDK Android di App Distribution
Utilizza i seguenti suggerimenti per risolvere i problemi che implicano l'abilitazione degli avvisi di nuove build in-app o l'invio di feedback in-app utilizzando l'SDK Android di App Distribution.
Se hai già configurato l'SDK Android App Distribution nella tua app per supportare il feedback in-app e i tuoi tester non sono in grado di inviare feedback, segui questi passaggi:
Abilita la registrazione dettagliata per l'SDK Android di App Distribution nella tua app:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEControlla i messaggi di errore nei log dell'app filtrando per "FirebaseAppDistribution".
Confermare che il tester abbia accesso alla versione installata:
Se i log indicano che "il tester non ha accesso a questa risorsa", il tuo tester potrebbe non essere stato invitato all'app o potrebbe non avere accesso alla versione.
Nel dashboard Distribuzione app della console Firebase, trova la versione esatta in esecuzione sul dispositivo del tester e assicurati che il tester sia elencato nella scheda Tester sulla scheda della versione e sia nello stato Accettato.
Se ancora non ricevi feedback, segui questi passaggi:
Sul dispositivo di test, accedi a Firebase App Distribution utilizzando App Tester o l'app Web tester. Assicurati di selezionare l'account Google che hai utilizzato per primo quando hai accettato l'invito a testare l'app.
Installa nuovamente l'app utilizzando App Tester o l'app Web di prova per assicurarti che il tester abbia accesso alla versione.
Prova a inviare feedback, assicurandoti nuovamente di accedere con lo stesso account Google.
Assicurati di aver abilitato l'API Firebase App Testers. Per ulteriori informazioni, consulta Abilitare l'API App Distribution Tester .
In Restrizioni chiave , assicurati che l'API Firebase App Testers sia inclusa nell'elenco delle API consentite.
Se quando invii un feedback visualizzi questo messaggio "Avrei inviato un feedback, ma non l'ho fatto a causa della modalità di sviluppo", disattiva la modalità sviluppatore sul dispositivo eseguendo questo comando:
adb shell setprop debug.firebase.appdistro.devmode falseControlla il tuo file
google-services.jsonper assicurarti di inviare feedback per il progetto e l'app corretti.Abilita la registrazione dettagliata per l'SDK Android di App Distribution nella tua app:
adb shell setprop log.tag.FirebaseAppDistribution VERBOSEControlla i messaggi di errore nei log dell'app filtrando per "FirebaseAppDistribution".
Se hai già configurato l'SDK Android App Distribution nella tua app e i tuoi tester non ricevono avvisi in-app, segui questi passaggi:
Verifica la presenza di messaggi di errore allegando un
OnFailureListenerall'attività restituita dall'API Firebase App Distribution.Giava
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> { if (e instanceof FirebaseAppDistributionException) { // Log exception here }});Kotlin
firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e -> if (e is FirebaseAppDistributionException) { // Log exception here } }Verifica che il tester abbia accesso alla nuova versione:
Abilita la modalità debug nella tua app. Per sapere come, consulta la documentazione di Google Analytics .
Esegui la tua app in un simulatore e cerca la stringa "FirebaseAppDistribution".
Se i registri indicano che non è stata trovata alcuna versione o che il tester non ha accesso, il tuo tester potrebbe non essere ancora associato alla nuova versione.
Nel dashboard Distribuzione app della console Firebase, assicurati che il tester sia incluso nella distribuzione della build e sia nello stato Accettato .
Se il tuo tester continua a non ricevere avvisi, chiedigli di seguire i suggerimenti seguenti per assicurarsi che abbia accettato l'invito a testare la tua app e che abbia configurato correttamente il dispositivo di test:
Sul dispositivo di test, accedi a Firebase App Distribution tramite App Tester o tramite l'app Web tester. Ricordati di selezionare l'account Google che hai utilizzato per primo quando hai accettato l'invito a testare l'app.
Verifica che la nuova versione dell'app sia disponibile in App Tester o nell'app Web tester.
Per impostazione predefinita, i tuoi tester devono accedere al proprio Account Google solo una volta per abilitare le funzionalità di test. Se ai tuoi tester viene richiesto di accedere nuovamente dopo aver chiuso e riaperto l'app, segui questi suggerimenti per assicurarti che la configurazione di distribuzione dell'app sia impostata correttamente:
Assicurati di aver abilitato l'API Firebase App Testers. Per ulteriori informazioni, consulta Abilitare l'API App Distribution Tester .
In Restrizioni chiave , assicurati che l'API Firebase App Testers sia inclusa nell'elenco delle API consentite.
Se in genere cancelli SharedPreferences all'uscita, potresti cancellare lo stato del tester. App Distribution memorizza un flag che indica se il tuo tester ha già effettuato l'accesso all'app. Per ulteriori informazioni, consultare il repository GitHub .
Domande frequenti
Firebase App Distribution prevede 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 di distribuzione app
Per aggiungere altri tester, richiedi un aumento del limite senza costi .
I tester hanno 30 giorni per accettare un invito a testare l'app prima che scada. Quando mancano 5 giorni alla scadenza di un invito, nella console Firebase accanto al tester viene visualizzato un avviso di scadenza su una versione. È possibile rinnovare un invito inviandolo nuovamente tramite il menu a discesa nella riga tester.
Le versioni dell'app vengono rimosse da App Distribution se si verifica una delle seguenti condizioni:
- La versione dell'app è più vecchia di 150 giorni.
- Superi il limite di 1.000 versioni dell'app e la versione dell'app è precedente alle 1.000 versioni dell'app più recenti.
Per ulteriori informazioni, consulta App Distribution supporta un massimo di 1.000 versioni .
Una volta che l'app raggiunge o supera il limite di scadenza di 150 giorni o il limite di 1.000 versioni, la versione viene rimossa dal dashboard Distribuzione app e dall'app Firebase App Tester. Se il tester ha installato la versione, la versione locale dell'app continua a essere eseguita.
Per mantenere disponibile la versione dell'app più a lungo, utilizza uno dei seguenti consigli:
- Prima che la versione dell'app scada o superi il limite di versione, scarica l'APK o l'AAB ed elimina la versione dal dashboard Distribuzione app. Quindi, ricarica l'APK o l'AAB come nuova build su App Distribution.
- Scarica la versione e caricala su Cloud Storage per l'archiviazione a lungo termine.
Le versioni dell'app scadono dopo 150 giorni
Quando carichi una versione della tua app su Firebase, la versione viene visualizzata nel dashboard Distribuzione app per 150 giorni, a partire dalla data di caricamento. Dopo aver caricato la versione, puoi distribuirla ai tester, che installano la versione dall'app Firebase App Tester sul proprio dispositivo di test.
Quando mancano 30 giorni alla data di scadenza, viene visualizzata una notifica di scadenza della versione dell'app nell'app Firebase App Tester.
App Distribution supporta un massimo di 1.000 versioni
La distribuzione delle app consente un massimo di 1.000 versioni per app. Quando la tua app raggiunge il limite di 1.000 versioni di app, App Distribution elimina automaticamente le versioni più vecchie che superano il limite.
Se desideri gestire manualmente le versioni delle app, utilizza l'API REST App Distribution per elencare ed eliminare le versioni delle app in blocco.
In caso di domande, contatta l'assistenza Firebase .
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.
Firebase App Distribution utilizza l'infrastruttura Firebase Test Lab e i limiti di quota e i prezzi sono gli stessi. Le quote di test vengono misurate in base al numero di test eseguiti al giorno. Per ulteriori informazioni sulle quote di test e sulla fatturazione, consulta Livelli di utilizzo, quote e prezzi per Test Lab .
Se superi la quota, riceverai errori di quota superata. La reimpostazione delle quote richiede circa 24 ore, pertanto è consigliabile evitare nuovi tentativi finché la quota non viene rilasciata. Tuttavia, se ricevi errori relativi all'infrastruttura dei tester automatizzati, è più probabile che le chiamate abbiano esito positivo se riprovi immediatamente.
Dovrai disporre dell'accesso Editor sul progetto Firebase per eseguire test con la funzionalità Tester automatizzato.
Per eliminare il tuo account tester di App Distribution e i dati associati, segui questi passaggi in ordine:
Visita https://appdistribution.firebase.google.com e accedi con il tuo account Google.
In alto a destra, fai clic su ( Gestisci account )
Eliminare l'account .
Facoltativo: nelle autorizzazioni del tuo account Google , revoca l'accesso da Firebase App Distribution. Tieni presente che la revoca dell'accesso senza prima eliminare l'account App Distribution non elimina l'account o i dati del tester.