Risoluzione dei problemi di App Distribution e DOMANDE FREQUENTI

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 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:

1. Verifica le dimensioni dell'IPA. La dimensione massima del file per tutti i file binari è 2048 MiB, ossia poco più di 2 GB.

2. Se la dimensione IPA rientra nel limite di dimensione del file ed è riproducibile, segui questi passaggi:

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

   2. Rimuovi i delimitatori <array> e ricrea l'app. Il caricamento deve riuscire.

   3. Se i problemi persistono, contatta l'assistenza Firebase.

3. Se la dimensione IPA supera il limite di dimensione del file, apporta le modifiche necessarie a riduci le dimensioni del file.

4. Se la riduzione 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à 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 è interessato a ricevere notifiche via email e vuole potrà accettare inviti alle app, può visualizzare gli inviti alle app in attesa direttamente nel clip web di Firebase App Distribution: appdistribution.firebase.google.com.

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.

"Sviluppatore aziendale non attendibile" errore quando provi a eseguire app di test

Se non lo hai fatto, viene visualizzato l'errore Sviluppatore aziendale non attendibile considerare attendibile il certificato dello sviluppatore sul dispositivo di test prima di aprire l'app. Nell'app Impostazioni > Profili e schermata Gestione dispositivi, seleziona il nome sviluppatore dell'app e fidarti.

"Modalità sviluppatore richiesta" errore quando provi a eseguire app di test

L'errore Modalità sviluppatore richiesta viene visualizzato quando cerchi di lanciare un annuncio App per iOS di cui è stato eseguito il provisioning hoc su iOS 16 o versioni successive senza prima aver abilitato lo sviluppatore Modalità.

Per attivare la modalità sviluppatore e risolvere l'errore:

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. Attivare la modalità sviluppatore? .
6. Tocca Attiva. Ora puoi lanciare la tua app e iniziare a testarla.

"Dispositivo registrato. È tutto a posto. Riceverai un'email quando l'app sarà pronta per il test"

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

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

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

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.

Il tester non riceve avvisi in-app

Se hai già configurato l'SDK App Distribution per iOS nella tua app e tester non ricevono avvisi in-app, assicurati che la tua app sia recupero delle nuove 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 "[Firebase/AppDistribution]".

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

   • Se viene restituito un oggetto release valido, è probabile che sia presente di un problema nel ciclo di vita del controller della vista in cui la finestra di dialogo di avviso prima che appaia la vista.

   • Se non viene restituita alcuna release, il tester potrebbe non essere ancora associato a la nuova uscita. 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 aggiornamenti, chiedigli di seguire le di seguito i suggerimenti per assicurarti che abbiano accettato l'invito a testare app e che configurino correttamente il dispositivo di test:

     1. Sul dispositivo di test, accedi a Firebase App Distribution web graffetta. Ricordati di selezionare l'Account Google che hai usato per la prima volta ha accettato l'invito a testare l'app.

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

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 abilitare gli avvisi di nuove build e installare nuove build. Se ai tester viene richiesto di eseguire nuovamente l'accesso dopo aver chiuso e riaperto l'app, segui questi 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 UserDefaults quando esci, potresti cancellare lo stato del tester. App Distribution memorizza un flag che indica se il tuo tester ha già eseguito l'accesso all'app. Per saperne di più, consulta il repository GitHub.

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.

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

Consulta l'articolo Registrare altri dispositivi.

Per quanto tempo sono disponibili le release delle app?

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

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

Per maggiori informazioni, consulta l'articolo che App Distribution supporta un massimo di 1000 release.

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

Per mantenere la release dell'app disponibile 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 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 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, può distribuirla ai tester, che installano la release dall'App Distribution del tester dell'app web sul 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 nella pagina App Distribution della console Firebase e nell'app web del tester App Distribution.

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.

Che cos'è il profilo Firebase?

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

• Registrare il dispositivo di test raccogliendo l'ID dispositivo univoco del dispositivo (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 dispositivo.

• Installa un clip web Firebase App Distribution sulla home page del tuo dispositivo schermo. Il clip web ti consente di installare e accedere a tutte le app di test in in un unico posto. Le nuove build che hai ricevuto da un invito a testare sono automaticamente aggiunto al clip web.

Per assistenza sull'installazione dei profili di configurazione sul tuo dispositivo iOS, consulta: 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 Firebase App Distribution clip web, che viene aggiunto automaticamente al test alla schermata Home del dispositivo 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 già fatto, accedi a Google e accetta l'invito.

2. In Testa app, 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 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 settings (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.