Risoluzione dei problemi di Test Lab e DOMANDE FREQUENTI

Questa pagina fornisce assistenza per la risoluzione dei problemi e risposte alle domande frequenti sull'esecuzione di test con Firebase Test Lab. Sono documentati anche i problemi noti. Se non riesci a trovare quello che cerchi o hai bisogno di ulteriore aiuto, unisciti al canale #test-lab su Firebase Slack o contatta l'assistenza Firebase.

Risoluzione dei problemi

Perché l'esecuzione del test richiede così tanto tempo?

Quando selezioni un dispositivo con un livello di capacità elevato nel catalogo Test Lab, i test potrebbero iniziare più rapidamente. Quando un dispositivo ha una capacità ridotta, i test potrebbero richiedere più tempo. Se il numero di test richiamati è molto maggiore della capacità dei dispositivi selezionati, il completamento dei test può richiedere più tempo.

I test eseguiti su dispositivi con qualsiasi livello di capacità potrebbero richiedere più tempo a causa dei seguenti fattori:

• Traffico, che influisce sulla disponibilità del dispositivo e sulla velocità del test.
• Guasti del dispositivo o dell'infrastruttura, che possono verificarsi in qualsiasi momento. Per verificare se è stata segnalata un'infrastruttura per Test Lab, consulta la dashboard dello stato di Firebase.

Per scoprire di più sulla capacità dei dispositivi in Test Lab, consulta le informazioni sulla capacità dei dispositivi per Android e iOS.

Perché ricevo risultati del test inconcludenti?

I risultati inconcludenti dei test si verificano comunemente a causa di esecuzioni di test annullate o errori dell'infrastruttura.

Gli errori di infrastruttura sono causati da problemi interni di Test Lab, come errori di rete o comportamenti imprevisti del dispositivo. Test Lab ritira internamente le esecuzioni di test che producono errori di infrastruttura più volte prima di segnalare un risultato non conclusivo; tuttavia, puoi disattivare questi tentativi utilizzando failFast.

Per determinare la causa dell'errore, segui questi passaggi:

1. Controlla se sono presenti interruzioni note nella dashboard dello stato di Firebase.

2. Ripeti il test in Test Lab per verificare che sia riproducibile.

   Nota: Test Lab non addebita costi per gli errori dell'infrastruttura.

3. Se applicabile, prova a eseguire il test su un altro dispositivo o tipo di dispositivo.

Se il problema persiste, contatta il team Test Lab nel canale#test-lab su Firebase Slack.

Perché lo sharding ha allungato la durata dei miei test?

Lo sharding può allungare la durata dei test quando il numero di shard specificato supera il numero di dispositivi disponibili per l'utilizzo in Test Lab. Per evitare questa situazione, prova a passare a un altro dispositivo. Per ulteriori informazioni sulla scelta di un altro dispositivo, vedi Capacità del dispositivo.

Perché il mio test richiede molto tempo per iniziare?

Quando invii una richiesta di test, l'app viene prima convalidata, firmata nuovamente e così via in preparazione all'esecuzione dei test su un dispositivo. Normalmente, questa procedura viene completata in meno di pochi secondi, ma può essere influenzata da fattori come le dimensioni dell'app.

Una volta preparata l'app, le esecuzioni dei test vengono pianificate e rimangono in una coda finché un dispositivo non è pronto per eseguirle. Finché non vengono completate tutte le esecuzioni dei test, lo stato della matrice sarà "In attesa" (indipendentemente dal fatto che le esecuzioni dei test siano in coda o in esecuzione).

Nota: il tempo di attesa del test per un dispositivo disponibile non viene conteggiato nel tempo di fatturazione.

Perché il mio test richiede molto tempo per essere completato?

Al termine dell'esecuzione del test, gli artefatti di test vengono scaricati dal dispositivo, elaborati e caricati su Cloud Storage. La durata di questo passaggio può essere influenzata dalla quantità e dalle dimensioni degli artefatti.

Risoluzione dei problemi specifici di Android

L'app non restituisce dati e non è possibile individuare gli screenshot

Gli artefatti di esecuzione dei test (come screenshot e file di log) vengono archiviati in Google Cloud Storage e visualizzati direttamente nella console Firebase. Se l'esecuzione del test è stata eseguita negli ultimi 90 giorni, verifica di aver assegnato ruoli a livello di progetto (proprietario del progetto, editor del progetto o visualizzatore del progetto). Assicurati inoltre che Cloud Audit Logging non sia abilitato per il tuo progetto o la tua organizzazione.

Se l'esecuzione è stata eseguita più di 90 giorni fa, molto probabilmente gli artefatti di test sono stati eliminati automaticamente. Puoi controllare la configurazione dei bucket dei risultati facendo clic sulla scheda Risultati del test nella dashboard Test Lab. Il bucket dei risultati predefinito è configurato per conservare gli oggetti per 90 giorni.

Per conservare più a lungo gli artefatti di test, esegui il comando gcloud firebase test android run con il flag --results-bucket e inserisci il nome del bucket dei risultati. Per saperne di più, consulta la documentazione di riferimento di gcloud firebase test android run.

Perché ricevo risultati parziali o mancanti dei test case di strumentazione?

Quando esegui test di strumentazione, potresti visualizzare errori di test che indicano risultati parziali che contengono messaggi come Test run failed to complete. Expected x tests, received y (dove y è inferiore a x). Questo errore significa che Test Lab non è riuscito ad analizzare logcat per i marcatori di inizio o fine del caso di test che vengono solitamente generati da AndroidJUnitRunner.

Di seguito sono riportate alcune cause comuni del problema:

Descrizione del problema	Possibile risoluzione
Lo scenario di test non è stato eseguito a causa di un timeout. Se la durata totale dei test è superiore a un timeout specificato o a un timeout massimo, Test Lab annulla il resto degli scenari di test.	Aumenta il timeout della matrice per assicurarti che tutti i test possano essere completati. Dividi i test in shard, se non l'hai già fatto, in modo che ogni shard esegua un sottoinsieme dei test e venga completato in un periodo di tempo più breve. Se hai già abilitato lo sharding, aumenta il numero di shard.
Il caso di test non è stato completato perché è stato chiuso prematuramente o si è bloccato. Il caso di test potrebbe terminare prematuramente a causa di un'eccezione non rilevata o di un errore di asserzione. I casi di test possono bloccarsi in un ciclo infinito o non essere in grado di procedere, ad esempio se l'app non mostra la visualizzazione corretta e il caso di test non può eseguire l'azione sull'interfaccia utente.	Controlla il video e il logcat per capire dove si è interrotto il test.
Un esecutore del test personalizzato (inclusa l'estensione di AndroidJUnitRunner) ha subito un arresto anomalo in modo imprevisto o ha scritto marcatori di inizio o fine dello scenario di test imprevisti in logcat.	Controlla il codice del test runner.
Sono stati scritti log eccessivi in logcat, che hanno sovraccaricato il buffer o causato l'arresto anomalo del processo logcat.	Riduci le scritture a logcat.
Si è verificato un arresto anomalo dell'app in fase di test.	Esegui il debug dell'app.

---

Domande frequenti

Quali sono le quote senza costi per Test Lab? Cosa devo fare se le esaurisco?

Firebase Test Lab offre quote senza costi per i test sui dispositivi e per l'utilizzo delle API Cloud. Tieni presente che la quota di test utilizza il piano tariffario standard di Firebase, mentre le quote dell'API Cloud non lo fanno.

• Quota di test

  Le quote di test sono determinate dal numero di dispositivi utilizzati per eseguire i test. Il piano Firebase Spark prevede una quota di test fissa senza costi per gli utenti. Per il piano Blaze, le tue quote potrebbero aumentare se il tuo utilizzo di Google Cloud aumenta nel tempo. Se raggiungi la quota di test, attendi il giorno successivo o esegui l'upgrade al piano Blaze se attualmente utilizzi il piano Spark. Se hai già scelto il piano Blaze, puoi richiedere un aumento della quota. Per maggiori informazioni, vedi Quota di test.

  Puoi monitorare l'utilizzo della quota di test nella console Google Cloud.

• Quota API Cloud Testing

  L'API Cloud Testing prevede due limiti di quota: richieste al giorno per progetto e richieste ogni 100 secondi per progetto. Puoi monitorare l'utilizzo nella console Google Cloud.

• Quota dell'API Cloud Tool Results

  L'API Cloud Tool Results prevede due limiti di quota: query al giorno per progetto e query ogni 100 secondi per progetto. Puoi monitorare l'utilizzo nella console Google Cloud.

  Per ulteriori informazioni sui limiti delle API, consulta la pagina Quote delle API Cloud per Test Lab. Se hai raggiunto una quota API:

  • Invia una richiesta per quote più elevate modificando le quote direttamente nella console Google Cloud (tieni presente che la maggior parte dei limiti è impostata sul valore massimo per impostazione predefinita) oppure

  • Richiedi quote API più elevate compilando un modulo di richiesta nella console Google Cloud o contattando l'assistenza Firebase.

Come faccio a sapere se il traffico che raggiunge il mio backend proviene da Test Lab?

Dal backend, puoi determinare se il traffico proviene da dispositivi di test ospitati da Firebase controllando l'indirizzo IP di origine rispetto ai nostri intervalli IP.

Test Lab funziona con VPC-SC?

Test Lab non funziona con VPC-SC, che blocca la copia di app e altri artefatti di test tra lo spazio di archiviazione interno di Test Lab e i bucket dei risultati degli utenti.

Come faccio a rilevare i test instabili in Test Lab?

Per rilevare un comportamento instabile nei test, ti consigliamo di utilizzare l'opzione --num-flaky-test-attempts . Le nuove esecuzioni di test per la rimozione di test instabili vengono fatturate o conteggiate ai fini della quota giornaliera come le esecuzioni di test normali.

Tieni presente che:

• L'intera esecuzione del test viene eseguita di nuovo quando viene rilevato un errore. Non è previsto il supporto per il nuovo tentativo solo dei casi di test non riusciti.
• Le esecuzioni di nuovi tentativi di deflake sono pianificate per essere eseguite contemporaneamente, ma non è garantito che vengano eseguite in parallelo, ad esempio quando il traffico supera il numero di dispositivi disponibili.

Nota: gli errori di infrastruttura sono indipendenti dalla funzionalità di eliminazione dei test instabili e non attivano nuove esecuzioni.

Domande frequenti specifiche per iOS

Test Lab supporta Appium, Flutter/FlutterDriver, ReactNative/Jest o Cucumber?

Sebbene alcuni di questi elementi siano nella nostra roadmap, al momento non possiamo impegnarci a supportare queste piattaforme di test e sviluppo di app.

Dove posso trovare i dettagli del dispositivo, come la risoluzione e così via?

Informazioni dettagliate sul dispositivo sono disponibili tramite l'API e sono accessibili dal client gcloud utilizzando il comando describe:

gcloud firebase test ios models describe MODEL

Posso utilizzare lo sharding con i test iOS?

Lo sharding non è supportato in modo nativo in Test Lab per iOS. Tuttavia, puoi utilizzare il client Flank per suddividere gli scenari di test iOS.

Nota :l'utilizzo dello sharding di Flank iOS crea matrici di test separate per ogni shard.

Per farlo, imposta la chiave e i valori OnlyTestIdentifiers nel file .xctestrun. Per ulteriori dettagli, consulta la pagina man per xcodebuild.xctestrun.

Perché nel mio test iOS mancano video nei risultati?

Per iOS 18 o versioni successive, non siamo in grado di supportare i video nei risultati.

Domande frequenti specifiche per Android

Test Lab supporta i dispositivi indossabili?

Sì! Test Lab supporta Google Pixel Watch. Ora puoi eseguire test sulla tua app Wear autonoma su Google Pixel Watch. Per scoprire di più sui dispositivi Test Lab, consulta Test sui dispositivi disponibili.

Test Lab supporta i dispositivi Google più recenti?

Sì! Test Lab supporta Google Pixel Tablet e Google Pixel Fold. Puoi eseguire i test sui tuoi dispositivi fisici autonomi. Per scoprire di più sui dispositivi Test Lab, consulta Test sui dispositivi disponibili.

Come faccio a rilevare un test in esecuzione in Test Lab?

Se stai testando la tua app in Firebase o eseguendo test per un report pre-lancio in Play Console, puoi rilevare se un test viene eseguito su un dispositivo ospitato da Firebase controllando la proprietà di sistema firebase.test.lab nel file MainActivity. Puoi quindi eseguire istruzioni aggiuntive in base al valore booleano di testLabSetting. Per ulteriori informazioni, vedi Comportamenti di test modificati.

Test Lab supporta Appium, Flutter/FlutterDriver, ReactNative/Jest o Cucumber?

Sebbene alcuni di questi elementi siano nella nostra roadmap, al momento non possiamo impegnarci a supportare queste piattaforme di test e sviluppo di app. Tuttavia, se hai creato la tua app con un framework che supporta Espresso (ad esempio, Flutter), puoi scrivere un test di strumentazione utilizzando Espresso e poi eseguire il test in Test Lab.

Test Lab supporta il test di app offuscate, ad esempio con ProGuard o R8?

Test Lab non supporta esplicitamente l'offuscamento o la deoffuscamento. Anche se l'app verrà probabilmente eseguita, tutti i dati offuscati, come le analisi dello stack, appariranno offuscati nei log.

Posso utilizzare il mio dispositivo pieghevole in diverse posizioni e stati di piegatura durante i test su Test Lab?

Sì! Puoi testare il tuo dispositivo pieghevole in stati e posture pieghevoli.

I dispositivi pieghevoli possono essere in vari stati di piegatura, ad esempio FLAT (completamente aperto) o HALF_OPENED (tra completamente aperto e completamente chiuso).

Le posture, invece, consistono in un orientamento specifico del dispositivo e in uno stato di piegatura. Ad esempio, la postura da tavolo, che è uno stato HALF_OPENED in orientamento orizzontale, o la postura a libro, che è uno stato HALF_OPENED in orientamento verticale.

Se esegui test di strumentazione, puoi utilizzare la libreria Jetpack WindowManager e seguire la documentazione relativa al test dell'app sui dispositivi pieghevoli per testare diversi stati e posture.

In alternativa, gli stati disponibili sono specifici per il dispositivo e possono essere usati tramite adb shell command cmd device_state.

• Per elencare lo stato attuale, esegui adb shell cmd device_state state.
• Per impostare o sostituire lo stato attuale, esegui adb shell cmd device_state state <IDENTIFIER>.
• Per reimpostare lo stato, esegui adb shell cmd device_state state reset.
• Per controllare gli stati disponibili, esegui il comando adb shell cmd device_state print-states sul dispositivo pieghevole.

Google Pixel Fold (ID modello felix)

$ adb shell cmd device_state print-states
Supported states: [
    DeviceState{identifier=0, name='CLOSED', app_accessible=true},
    DeviceState{identifier=1, name='HALF_OPENED', app_accessible=true},
    DeviceState{identifier=2, name='OPENED', app_accessible=true},
    DeviceState{identifier=3, name='REAR_DISPLAY_STATE', app_accessible=true},
]

Samsung Galaxy Z Fold4 (ID modello q4q)

$ adb shell cmd device_state print-states
Supported states: [
    DeviceState{identifier=0, name='CLOSE', app_accessible=true},
    DeviceState{identifier=1, name='TENT', app_accessible=true},
    DeviceState{identifier=2, name='HALF_FOLDED', app_accessible=true},
    DeviceState{identifier=3, name='OPEN', app_accessible=true},
]

Posso provare Test Lab se non ho un'app?

A differenza di altri prodotti Firebase, non è necessario aggiungere un SDK Firebase per utilizzare Test Lab. Se non hai ancora un'app, puoi scaricare un APK online o creare un'app e un APK di test da uno degli esempi nel repository GitHub di AndroidX. Tieni presente che per eseguire un test Robo è necessario solo il file APK dell'app, mentre un test di strumentazione richiede sia un'app sia un APK di test creati dal codice sorgente. Per ulteriori informazioni, leggi l'articolo sui test strumentati.

Per scoprire di più sulle funzionalità di Test Lab, consulta Inizia a eseguire test per Android con Firebase Test Lab.

Quali dispositivi sono più adatti per i test di confronto degli screenshot?

Il test di confronto degli screenshot si basa sul confronto delle asserzioni di test con le immagini dello schermo ottenute durante l'esecuzione di un test con le immagini di riferimento che rappresentano il comportamento previsto. Questi test potrebbero essere più fragili su alcuni tipi di dispositivi rispetto ad altri. Per questi tipi di test, ti consigliamo di scegliere come target dispositivi emulatore Arm (*.arm). I dispositivi emulatore Arm utilizzano immagini molto simili o identiche agli emulatori "generici" di Android Studio.

Ti consigliamo inoltre di esaminare le librerie di test che possono contribuire a rendere i test degli screenshot più solidi in presenza di modifiche previste.

Test Lab aggiorna i dispositivi virtuali?

Sì! I dispositivi virtuali vengono aggiornati quando vengono apportate le seguenti modifiche:

1. Aggiornamenti alle immagini esistenti
2. Ritiro dei livelli API precedenti
3. Vengono aggiunti nuovi livelli API Android

Come faccio ad attivare i report sulla copertura?

Per attivare i report sulla copertura, aggiungi coverage=true al campo environmentVariables. Se utilizzi Android Test Orchestrator, devi fornire una directory in cui memorizzare i risultati della copertura:

--environment-variables coverage=true,coverageFilePath=/sdcard/Download/

Se non utilizzi Orchestrator, puoi specificare un percorso del file:

--environment-variables coverage=true,coverageFile=/sdcard/Download/coverage.ec

Dove posso trovare i dettagli del dispositivo, come risoluzione, ABI supportati e così via?

Informazioni dettagliate sul dispositivo sono disponibili tramite l'API e sono accessibili dal client gcloud utilizzando il comando describe:

gcloud firebase test android models describe MODEL

---

Problemi noti

Captcha di accesso

Il test Robo non può bypassare le schermate di accesso che richiedono un'azione aggiuntiva dell'utente oltre all'inserimento delle credenziali per accedere, ad esempio, il completamento di un CAPTCHA.

Problemi noti specifici per iOS

Accesso automatico

L'accesso automatico con un Account Google non è supportato nei Robo test per iOS+ (beta).

Problemi noti specifici per Android

Supporto del framework UI

Il test Robo funziona meglio con le app che utilizzano elementi UI del framework UI di Android (inclusi gli oggetti View, ViewGroup e WebView). Se utilizzi il test Robo per testare app che utilizzano altri framework UI, incluse le app che utilizzano il motore di gioco Unity, il test potrebbe terminare senza esplorare oltre la prima schermata.