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 l'IPA

Di seguito è riportato un esempio di risposta di rete del browser:

{
"status": "IN_PROGRESS",
  "message": "There was an error processing your
distribution. Ensure you are uploading a valid IPA or APK and try again."
}

Per risolvere il problema, procedi nel seguente modo:

1. Verifica le dimensioni del file IPA. 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'IPA rientrano nel limite di dimensioni del file e sono riproducibili, segui questi passaggi:

   1. Controlla il file Info.plist e verifica se CFBundleDisplayName contiene delimitatori <array>.

   2. Rimuovi i delimitatori <array> e ricrea l'app. Il caricamento dovrebbe andare a buon fine.

   3. Se continui a riscontrare problemi, contatta l'assistenza Firebase.

3. Se le dimensioni del file IPA superano il limite, apporta le modifiche necessarie per ridurle.

4. Se la riduzione delle dimensioni del file IPA non risolve il problema, contatta l'assistenza Firebase e chiedi informazioni sull'utilizzo di Testflight.

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 e vuole solo poter accettare gli inviti alle app, può visualizzare gli inviti alle app in attesa direttamente nel web clip Firebase App Distribution: appdistribution.firebase.google.com.

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.

Errore "Sviluppatore aziendale non attendibile" quando si tenta di eseguire l'app di test

L'errore Sviluppatore aziendale non attendibile viene visualizzato se non hai considerato attendibile il certificato dello sviluppatore sul dispositivo di test prima di aprire l'app. Nell'app Impostazioni > schermata Profili e gestione dispositivi, seleziona il nome dello sviluppatore dell'app e consideralo attendibile.

Errore "Modalità sviluppatore richiesta" quando si tenta di eseguire l'app di test

L'errore Modalità sviluppatore obbligatoria viene visualizzato quando provi ad avviare un'app per iOS con provisioning ad hoc su iOS 16 o versioni successive senza prima attivare la modalità sviluppatore.

Per attivare la modalità sviluppatore e risolvere questo errore, segui questi passaggi:

1. Sull'iPhone, apri l'app Impostazioni e tocca Privacy e sicurezza.
2. Scorri verso il basso fino a Sicurezza e tocca Modalità sviluppatore.
3. Tocca il cursore Modalità sviluppatore.
4. Tocca Riavvia.
5. Dopo il riavvio, sblocca il dispositivo. Viene visualizzata la finestra di dialogo Attivare la modalità sviluppatore?
6. Tocca Attiva. Ora puoi lanciare l'app e iniziare i test.

"Ecco fatto, dispositivo registrato. Riceverai un'email quando l'app sarà pronta per il test"

Se stai installando una distribuzione ad hoc, questo messaggio viene visualizzato quando lo sviluppatore non ha ancora configurato la propria app per l'esecuzione sul tuo dispositivo di test. Per rendere l'app disponibile per te, lo sviluppatore deve completare le istruzioni riportate in Registra altri dispositivi.

L'Account Google non ha accesso all'app di test

Se il tuo Account Google non ha accesso a un'app di test che hai installato in precedenza (o per cui hai accettato un invito), è probabile che tu abbia eseguito l'accesso all'Account Google sbagliato. Le app a cui hai accesso sono associate all'Account Google che hai utilizzato quando hai accettato l'invito a testare l'app per la prima volta. Riprova eseguendo l'accesso con l'Account Google che hai utilizzato in precedenza per accettare l'invito.

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.

Il tester non riceve avvisi in-app

Se hai già configurato l'SDK App Distribution per iOS nella tua app e i tuoi tester non ricevono avvisi in-app, assicurati che l'app recuperi le nuove release:

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

2. Esegui l'app in un simulatore e cerca la stringa "[Firebase/AppDistribution]".

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

   • Se viene restituito un oggetto di rilascio valido, è probabile che si sia verificato un problema nel ciclo di vita del View Controller, in cui la finestra di dialogo di avviso viene caricata prima della visualizzazione della vista.

   • Se non viene restituita alcuna release, il tester potrebbe non essere ancora associato alla nuova release. 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 gli aggiornamenti, 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 alla clip web di Firebase App Distribution. Ricordati di selezionare l'Account Google che hai utilizzato la prima volta che hai accettato l'invito a testare l'app.

     2. Assicurati che la nuova release dell'app sia disponibile nel web clip.

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 gli avvisi relativi alle nuove build e installarle. 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 UserDefaults quando esci, 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.

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.

Quando viene creata una nuova release per i caricamenti su iOS?

Vedi Registra altri dispositivi.

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 dell'app, la release viene rimossa dalla dashboard di App Distribution e dall'app web per i tester di App Distribution. 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 consigli:

• Prima che la release dell'app scada o superi il limite di release, scarica il file IPA ed elimina la release dalla dashboard di App Distribution. Poi, ricarica l'IPA 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 web per tester App Distribution sul loro dispositivo di test.

Quando mancano 30 giorni alla data di scadenza della release, viene visualizzata una notifica di scadenza della release dell'app nella pagina App Distribution della console Firebase e nell'app web per tester App Distribution.

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.

Che cos'è il profilo Firebase?

Il profilo Firebase è un profilo di configurazione che consente a App Distribution di:

• Registra il dispositivo di test raccogliendo l'ID dispositivo univoco (UDID). Se stai testando una distribuzione ad hoc, Firebase invia allo sviluppatore dell'app un'email che include l'UDID del dispositivo di test, insieme alle istruzioni su come includere il dispositivo nel profilo di provisioning dell'app in modo che la build possa essere testata sul tuo dispositivo.

• Installa un clip web di Firebase App Distribution nella schermata Home del tuo dispositivo. La clip web ti consente di installare e accedere a tutte le tue app di test in un unico posto. Le nuove build che ti viene chiesto di testare vengono aggiunte automaticamente alla web clip.

Per assistenza sull'installazione dei profili di configurazione sul tuo dispositivo iOS, consulta la documentazione di Apple.

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

Se sei un tester, puoi accedere a tutte le tue app di test con il clip web Firebase App Distribution, che viene aggiunto automaticamente alla schermata Home del dispositivo di test quando installi il profilo Firebase. Se stai testando una distribuzione ad hoc, devi prima installare il profilo prima di poter testare l'app.

Se stai testando una distribuzione Enterprise, puoi installare manualmente il profilo:

1. Se non l'hai ancora fatto, accedi a Google e accetta l'invito.

2. In App di test, seleziona l'app che vuoi testare.

3. In alto a destra nella pagina dell'app, tocca mobile_screen_share.

4. Segui le istruzioni visualizzate per installare il profilo Firebase.

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.