Risoluzione dei problemi e domande frequenti sulla distribuzione dell'app

iOSAndroid _

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

Utilizza i seguenti suggerimenti per risolvere i problemi che potresti riscontrare durante la distribuzione di app ai tuoi tester.

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 all'interno della console Firebase per configurarne uno."

Imposta un'e-mail di contatto nella console Firebase, se disponibile. Se il problema persiste, contatta l'assistenza Firebase .

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

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

Impossibile caricare il file APK

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

2. Se le dimensioni dell'APK rientrano nel limite delle dimensioni del file ed è riproducibile, contatta l'assistenza di 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

Distribuzione di Android App Bundle (AAB)

Errori di ricezione con accesso social/fornitori di API di terze parti

Quando carichi un AAB in App Distribution, Google Play rinuncia automaticamente all'APK generato utilizzando un certificato della chiave di firma dell'app di prova. Quando richiesto, devi registrare la tua app con i fornitori di 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 di Firebase.

Gli AAB che carico vengono visualizzati anche in Google Play?

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

Cosa succede se scollego Firebase da Google Play?

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

• Non potrai caricare nuovi bundle di app 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.

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 al tuo progetto Firebase e 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. Ciò significa che hai sia un'app Android Firebase 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 nella dashboard dell'app e viene distribuita a uno dei gruppi di Google Play (test interno, test chiuso, test aperto o produzione).

• La revisione dell'app in Google Play è completa e l'app è pubblicata. La tua app è pubblicata se la colonna Stato app mostra 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 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 dispone di 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 utilizzare tale indirizzo email 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 al tuo account Google con un altro indirizzo email .

Il tester non è in grado di visualizzare le app o le build corrette

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

L'e-mail a cui lo sviluppatore invia gli inviti e aggiunge le 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 che ottiene l'accesso.

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

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

2. Invita nuovamente il tester a testare la tua app. Il tester dovrebbe ricevere un'e-mail di invito.

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

Il tester non riceve le notifiche email

I tester potrebbero non ricevere notifiche e-mail se si verifica una delle seguenti condizioni:

• Le notifiche e-mail vengono inviate alle cartelle spam.

• I filtri e-mail sono impostati.

• L'invito è stato inviato a un account e-mail, ma il tester ha accettato con un altro account e-mail. Il tester riceve le nuove e-mail di rilascio per l'account e-mail a cui è stato originariamente inviato l'invito.

• Il tester è stato precedentemente invitato ma non ha accettato l'invito iniziale. Se il tester viene aggiunto alle versioni successive, App Distribution non invierà automaticamente notifiche di rilascio a quel tester perché il tester non ha accettato l'invito iniziale.

Soluzione 1

1. Chiedi al tester di controllare la cartella della posta indesiderata e gli eventuali filtri email impostati nel servizio di posta elettronica.

2. Se il tester ha annullato l'iscrizione alle e-mail, chiedigli di eseguire le seguenti operazioni:

   1. Trova un'e-mail che il tester ha ricevuto in precedenza dall'app.
   2. Fai clic su Gestisci impostazioni e-mail in basso e fai clic su Consenti alle e-mail di riabbonarsi.

Soluzione 2

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

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

L'app non indica che l'app è installata

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 bundle nell'app Firebase non corrisponde all'ID bundle dell'APK.

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

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

L'avviso 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 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, tocca OK > Trust .

Gli APK di prova non vengono installati

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

• Verificare che i certificati nella nuova versione corrispondano a quelli nella 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 ).

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 Google Workspace (in precedenza GSuite) che include impostazioni di restrizione.

Per rimuovere le impostazioni di restrizione:

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

2. Nella scheda Servizi , assicurati che Cloud Platform non sia limitato.

3. Una volta rimosse le impostazioni, prova ad accedere di nuovo.

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

Questo errore può verificarsi quando l'app installata è 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 ContentProvider name .

Puoi chiedere al tester di raccogliere una segnalazione di bug immediatamente dopo aver riscontrato il problema e di ispezionare 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 l'accesso"

Quando riscontri 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 disporre dell'autorizzazione per installare e testare 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 che non sia limitato dall'installazione e dal test delle app.

Prova su un nuovo dispositivo Android

Se sei un tester alle prime armi, vedi Configurazione come tester .

Se sei già un tester di App Distribution e ricevi un nuovo dispositivo Android su cui eseguire il test, invece di ripetere l'intero flusso del nuovo tester, procedi nel seguente modo:

1. Vai su 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.

Abilitazione delle funzionalità dei tester con App Distribution Android SDK

Utilizza i seguenti suggerimenti per risolvere i problemi che implicano l'abilitazione di avvisi di nuova build in-app o l'invio di feedback in-app utilizzando l'SDK Android di App Distribution.

Il tester non può avviare il feedback nell'app

Se hai già configurato l'SDK Android di App Distribution nella tua app per supportare il feedback in-app e i tuoi tester non sono in grado di inviare feedback, procedi nel seguente modo:

1. Abilita la registrazione dettagliata per l'SDK Android di App Distribution nella tua app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

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

3. Verificare che il tester abbia accesso alla versione 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 versione.

   2. Nella dashboard di App Distribution 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 di rilascio e sia nello stato Accettato.

   Se ancora non ricevi feedback, procedi nel seguente modo:

   1. Sul dispositivo di prova, accedi a Firebase App Distribution utilizzando App Tester o l'app Web del tester. Assicurati di selezionare l'account Google che hai utilizzato per la prima volta quando hai accettato l'invito a testare l'app.

   2. Installa nuovamente l'app utilizzando App Tester o l'app Web di test per assicurarti che il tester abbia accesso alla versione.

   3. Prova a inviare feedback, assicurandoti nuovamente di accedere con lo stesso account Google.

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

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

Mancata ricezione del feedback inviato nell'app

1. Se visualizzi questo messaggio quando invii il feedback, "Avrei inviato il feedback, ma non l'ho fatto a causa della modalità di sviluppo", disabilita la modalità sviluppatore sul dispositivo eseguendo questo comando:

   adb shell setprop debug.firebase.appdistro.devmode false
   

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

3. Abilita la registrazione dettagliata per l'SDK Android di 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 App Distribution Android SDK nella tua app e i tester non ricevono avvisi in-app, procedi nel seguente modo:

1. Verifica la presenza di messaggi di errore allegando un OnFailureListener all'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
                     }
     }
   

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

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

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

      Se i log indicano che non è stata trovata alcuna versione o che il tester non ha accesso, il tester potrebbe non essere ancora associato alla nuova versione.

   3. Nella dashboard di App Distribution della console Firebase, assicurati che il tuo 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 riportati di seguito per assicurarsi che abbia accettato l'invito a testare la tua app e che abbia configurato correttamente il dispositivo di test:

      1. Sul dispositivo di prova, 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 nuova versione dell'app sia disponibile in App Tester o nell'app Web del tester.

Al tester è stato chiesto di accedere nuovamente dopo aver chiuso l'app

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

• Verifica 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 al momento della disconnessione, potresti cancellare lo stato del tuo tester. App Distribution archivia un contrassegno che indica se il tuo tester ha già effettuato l'accesso all'app. Per ulteriori informazioni, vedere il repository GitHub .

Domande frequenti

Ci sono 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 di distribuzione app

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

I miei inviti di tester scadono?

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 di Firebase viene visualizzato un avviso di scadenza accanto al tester su una versione. Un invito può essere rinnovato inviandolo nuovamente tramite il menu a discesa nella riga del tester.

Per quanto tempo sono disponibili le versioni dell'app?

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, vedere App Distribution supporta un massimo di 1.000 versioni .

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

Per mantenere la versione dell'app disponibile più a lungo, utilizzare uno dei seguenti consigli:

• 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. Quindi, ricarica l'APK o l'AAB come nuova build in 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 nella dashboard di Distribuzione app per 150 giorni, a partire dalla data di caricamento. Dopo aver caricato la release, puoi distribuirla ai tester, che installano la release dall'app Firebase App Tester sul proprio dispositivo di test.

Quando il rilascio è a 30 giorni dalla data di scadenza, viene visualizzata una notifica di scadenza del rilascio dell'app sul rilascio nell'app Firebase App Tester.

App Distribution supporta un massimo di 1.000 versioni

App Distribution 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 meno recenti al di sopra del limite.

Se desideri gestire manualmente le versioni dell'app, utilizza l'API REST di App Distribution per elencare ed eliminare le versioni dell'app in blocco.

In caso di domande, contatta l'assistenza Firebase .

Come posso accedere alle app di prova 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 in un unico posto.

Come faccio a eliminare il mio account di tester?

Per eliminare il tuo account tester di App Distribution e i relativi dati associati, procedi nel seguente ordine:

1. Visita 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 del tuo account Google , revoca l'accesso da Firebase App Distribution. Tieni presente che la revoca dell'accesso senza prima eliminare il tuo account App Distribution non comporta l'eliminazione dell'account o dei dati del tester.