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.
Di seguito è riportato un esempio di risposta della 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 questo problema, attenersi alla seguente procedura:
Verificare la dimensione dell'IPA. Il limite massimo della dimensione del file per tutti i file binari è 2048 MiB, ovvero poco più di 2 GB.
Se la dimensione IPA rientra nel limite di dimensione del file ed è riproducibile, attenersi alla seguente procedura:
Controlla il tuo file
Info.pliste conferma seCFBundleDisplayNamecontiene delimitatori<array>.Rimuovi i delimitatori
<array>e ricostruisci la tua app. Il caricamento dovrebbe riuscire.Se i problemi persistono, contatta l'assistenza Firebase .
Se la dimensione IPA supera il limite di dimensione del file, apportare le modifiche necessarie per ridurre la dimensione del file.
Se la riduzione delle dimensioni del file IPA non risolve il problema, contatta il supporto Firebase e chiedi informazioni sull'utilizzo di Testflight .
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 al tester non interessa ricevere notifiche email e desidera solo poter accettare inviti alle app, può visualizzare gli inviti alle app in sospeso direttamente nel clip web di Firebase App Distribution: appdistribution.firebase.google.com .
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.
L'errore Sviluppatore aziendale non attendibile viene visualizzato se non ritieni attendibile il certificato dello sviluppatore sul dispositivo di prova prima di aprire l'app. Nell'app Impostazioni > schermata Gestione profili e dispositivo , seleziona il nome dello sviluppatore dell'app e fidati di esso.
L'errore Modalità sviluppatore richiesta viene visualizzato quando tenti di avviare un'app iOS con provisioning ad hoc su iOS 16 o versioni successive senza prima abilitare la Modalità sviluppatore.
Per abilitare la modalità sviluppatore e risolvere questo errore, attenersi alla seguente procedura:
- Sul tuo iPhone, apri l'app Impostazioni e quindi tocca Privacy e sicurezza .
- Scorri verso il basso fino a Sicurezza e tocca Modalità sviluppatore .
- Tocca il cursore Modalità sviluppatore .
- Tocca Riavvia .
- Dopo il riavvio del dispositivo, sblocca il dispositivo. Attivare la modalità sviluppatore? viene visualizzata la finestra di dialogo.
- Tocca Attiva . Ora puoi avviare la tua app e iniziare a testarla.
Se stai installando una distribuzione Ad Hoc, questo messaggio viene visualizzato quando lo sviluppatore non ha ancora configurato l'app per l'esecuzione sul tuo dispositivo di prova. Per rendere disponibile l'app, lo sviluppatore deve completare le istruzioni in Registrare dispositivi aggiuntivi .
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 effettuato l'accesso all'Account Google sbagliato. Le app a cui hai accesso sono associate all'account Google che hai utilizzato quando hai accettato per la prima volta l'invito a testare l'app. Riprova accedendo con l'account Google utilizzato in precedenza per accettare l'invito.
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.
Abilitazione degli avvisi in-app con l'SDK iOS di App Distribution
Utilizza i seguenti suggerimenti per risolvere i problemi che implicano l'abilitazione degli avvisi di nuove build in-app utilizzando l'SDK iOS di App Distribution.
Se hai già configurato l'SDK iOS di App Distribution nella tua app e i tuoi tester non ricevono avvisi in-app, assicurati che la tua app stia recuperando nuove versioni:
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 "[Firebase/AppDistribution]".
Verifica che il tester abbia accesso alla nuova versione:
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 che venga visualizzata la vista.
Se non viene restituita alcuna versione, 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 aggiornamenti, 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:
Sul dispositivo di prova, accedi al clip web Firebase App Distribution. Ricordati di selezionare l'account Google che hai utilizzato per primo quando hai accettato l'invito a testare l'app.
Assicurati che la nuova versione dell'app sia disponibile nel clip web.
Per impostazione predefinita, i tester devono accedere al proprio Account Google solo una volta per abilitare gli avvisi di nuove build e installare nuove build. 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 UserDefaults all'uscita, potresti cancellare lo stato del tuo 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.
Vedere Registrare dispositivi aggiuntivi .
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 di app, la versione viene rimossa dal dashboard di App Distribution e dall'app Web del tester di App Distribution. 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'IPA ed elimina la versione dal dashboard Distribuzione app. Quindi, ricarica l'IPA 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, è possibile distribuirla ai tester, che installano la versione dall'app Web per tester Distribuzione app sul proprio dispositivo di test.
Quando la versione è trascorsa 30 giorni dalla data di scadenza, viene visualizzata una notifica di scadenza della versione dell'app nella pagina Distribuzione app della console Firebase e nell'app Web del tester App Distribution.
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 .
Il profilo Firebase è un profilo di configurazione che consente alla distribuzione delle app di:
Registra 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'e-mail che include l'UDID del dispositivo di prova, 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 Firebase App Distribution sulla schermata iniziale del tuo dispositivo. La clip web ti consente di installare e accedere a tutte le tue app di prova in un unico posto. Le nuove build che sei invitato a testare vengono aggiunte automaticamente al clip web.
Per assistenza sull'installazione dei profili di configurazione sul tuo dispositivo iOS, fai riferimento alla documentazione di Apple .
Se sei un tester, puoi accedere a tutte le tue app di prova con la clip web Firebase App Distribution , che viene aggiunta automaticamente alla schermata iniziale del tuo dispositivo di prova 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:
Se non l'hai già fatto, accedi a Google e accetta l'invito.
In App di test seleziona l'app che desideri testare.
Nell'angolo in alto a destra della pagina dell'app, tocca mobile_screen_share .
Segui le istruzioni visualizzate per installare il profilo Firebase.
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.