Questo articolo spiega come funzionano i report pre-lancio. Se hai generato un report pre-lancio e vuoi sapere come interpretarne i risultati, vai a Comprendere il report pre-lancio.
I report pre-lancio vengono generati automaticamente quando carichi un app bundle o un APK, in base alla capacità del nostro laboratorio dispositivi. Quando si eseguono i report pre-lancio, ogni elemento viene testato al momento del caricamento e del salvataggio in produzione, in modo identificare i problemi in modo proattivo prima che la tua app raggiunga gli utenti. Sono inclusi test per:
- Problemi di stabilità
- Problemi di compatibilità con Android
- Problemi di prestazioni
- Problemi di accessibilità
Come funziona un rapporto pre-lancio
Dopo aver caricato un app bundle o aver salvato una release nel canale di produzione, li installiamo su un gruppo di dispositivi Android nel nostro Test Lab. Dopodiché lanciamo ed eseguiamo automaticamente la scansione della tua app per diversi minuti. Il crawler esegue azioni di base, ad esempio digitazione, tocco e scorrimento. Puoi anche fornire test personalizzati o testare le credenziali dell'account da far utilizzare al crawler.
Al termine della scansione, useremo i risultati per compilare il report pre-lancio. Eseguiremo anche la disinstallazione della tua app da tutti i dispositivi di Test Lab.
Valutare l'idoneità dell'app per un report pre-lancio
Il report pre-lancio funzionerà fintanto che saremo in grado di installare ed eseguire la scansione dell'app. Tuttavia, alcune app potrebbero richiedere piccole modifiche al codice. Tra gli esempi più comuni ci sono le app che richiedono la convalida del paese o dell'installazione. Per scoprire di più, consulta le nostre domande frequenti.
Nota: tieni presente che i dispositivi di test non possono eseguire test su app senza un'attività di avvio principale, tra cui Avvio app, widget, tastiere e quadranti.
Comprimi tutto Espandi tutto
Generare un report pre-lancio
Generiamo automaticamente i report pre-lancio in base alla capacità complessiva del nostro laboratorio dispositivi. Se la capacità lo consente, vengono eseguiti automaticamente quando viene caricato un app bundle o una release viene salvata in produzione.
Personalizzare i test
Puoi personalizzare i test per rendere il report pre-lancio più completo e pertinente per la tua app.
Se la tua app ha una schermata di accesso e vuoi che il crawler esegua il test della procedura di accesso o dei contenuti visualizzati dopo l'accesso, devi fornire le credenziali dell'account.
Nota: non è necessario fornire le credenziali se la tua app supporta la funzionalità "Accedi con Google" (che consente al crawler di accedere automaticamente) o se hai già fornito le credenziali nella pagina Contenuti app.
Di seguito sono riportati alcuni aspetti importanti da ricordare per le credenziali di test:
- Le credenziali fornite vengono utilizzate a solo scopo di test.
- Pur facendo del nostro meglio per mantenere protette le credenziali di test, consigliamo di non aggiungere credenziali ufficiali nel report pre-lancio. Crea invece un nome utente e una password da utilizzare solo per l'account di test.
- Le credenziali possono essere inserite automaticamente soltanto nelle app Android che usano i widget Android standard. Non è possibile usare le credenziali in app che usano OpenGL per visualizzare controlli personalizzati o app che usano WebView per un flusso di autenticazione basato sul web.
- Google accederà automaticamente se la tua app supporta la funzione "Accedi con Google".
- Apri Play Console.
- Seleziona un'app.
- Nel menu a sinistra, vai alla pagina Impostazioni relative al report pre-lancio (Testa e rilascia
> Test > Report pre-lancio > Impostazioni). Nella sezione "Credenziali dell'account di test", seleziona Fornisci credenziali. Nella sezione "Credenziali dell'account di test", seleziona Fornisci credenziali.
- Inserisci:
- Nome utente: il nome utente associato al tuo account di test.
- Password: la password associata al tuo account di test.
- Fai clic su Salva. Queste credenziali verranno utilizzate per tutti i test futuri, a meno che non vengano modificate.
- Apri Play Console.
- Seleziona un'app.
- Nel menu a sinistra, vai alla pagina Impostazioni relative al report pre-lancio (Testa e rilascia
> Test > Report pre-lancio > Impostazioni).
- Apporta le modifiche:
- Per modificare le credenziali: nella sezione "Credenziali dell'account di test", inserisci le credenziali aggiornate nei campi nome utente e password.
- Per rimuovere le credenziali: nella sezione "Credenziali dell'account di test", seleziona Non fornire credenziali.
- Nota: se rimuovi le credenziali di test dell'app, dovrai aggiungere nuove credenziali prima che eventuali test futuri possano accedere all'app.
- Fai clic su Salva. Queste credenziali verranno utilizzate per tutti i test futuri, a meno che non vengano modificate.
Se vuoi controllare i passaggi che il crawler esegue durante il test della tua app, puoi fornire uno script Robo o un ciclo di gioco.
Puoi controllare i passaggi che il crawler esegue durante il test della tua app fornendo uno script Robo affinché esegua azioni specifiche, come testare un comune percorso dell'utente o una nuova sezione dell'app.
Quando esegui un test con uno script allegato, il crawler esegue prima le azioni nello script e poi esegue la scansione dell'app come al solito.
Per caricare uno script nel report pre-lancio:
- Registra lo script utilizzando lo strumento Firebase in Android Studio (Android Studio > Strumenti > Firebase > Test Lab > Registra script Robo). Per ulteriori dettagli, visita il Centro assistenza Firebase.
- Nota: non è necessario un account Firebase per creare uno script Robo.
- Quando lo script è pronto, apri Play Console.
- Seleziona un'app.
- Nel menu a sinistra, vai alla pagina Impostazioni relative al report pre-lancio (Testa e rilascia
> Test > Report pre-lancio > Impostazioni). Carica lo script nella sezione "Controllare come il report pre-lancio esamina l'app". Puoi trascinare il file o selezionare Carica.
- Fai clic su Salva.
Se stai testando un gioco o un'app che utilizza OpenGL, devi fornire un ciclo di gioco per ricevere un report pre-lancio attendibile. Un ciclo di gioco definisce le azioni che il crawler deve eseguire. Puoi testare più di un ciclo di gioco nella stessa app.
Per utilizzare i cicli di gioco nel report pre-lancio:
- Modifica il gioco procedendo nel seguente modo:
- Avvia il ciclo.
- Esegui il ciclo.
- (Facoltativo) Chiudi il ciclo. Devi apportare queste modifiche nel tuo ambiente di sviluppo. Per ulteriori dettagli, visita il Centro assistenza Firebase.
- Nota: non è necessario un account Firebase per utilizzare i cicli di gioco nel report pre-lancio.
- Carica la versione del gioco. Il crawler rileva ed esegue automaticamente il ciclo di gioco.
Puoi aggiungere fino a tre link diretti al report pre-lancio per testare altri punti di ingresso per la tua app.
Il crawler funziona come di consueto per diversi minuti, quindi chiude l'app e visita ogni link diretto, eseguendo la scansione per altri 30 secondi. Eventuali problemi rilevati durante queste scansioni aggiuntive vengono inseriti normalmente nel report.
Per informazioni su come creare e testare i link diretti per la tua app, visita il sito Android for Developers.
Se vuoi visualizzare i risultati dei test per lingue specifiche, puoi configurare le preferenze riguardanti la lingua nella pagina Impostazioni relative al report pre-lancio. Puoi selezionare fino a cinque lingue.
Suggerimento: dato che il report pre-lancio viene eseguito automaticamente quando carichi un app bundle di test, puoi aggiungere le preferenze relative alle lingue soltanto dopo il completamento del test iniziale.
- Apri Play Console.
- Seleziona un'app.
- Nel menu a sinistra, vai alla pagina Impostazioni relative al report pre-lancio (Testa e rilascia
> Test > Report pre-lancio > Impostazioni).
- Nella sezione "Testare l'app in lingue specifiche", seleziona + Aggiungi lingua.
- Seleziona fino a cinque lingue. Per i test futuri verranno visualizzati soltanto i risultati relativi a queste lingue.
- Nota: se non selezioni alcuna lingua, selezioneremo automaticamente le lingue in cui la tua app ha il maggior numero di installazioni.
- Fai clic su Salva.
Visualizzare il report pre-lancio
Quando il report pre-lancio è disponibile, puoi visualizzare un riepilogo del test che include il numero di errori, avvisi e problemi di minore entità rilevati durante il test, categorizzati in base al tipo di problema. Vedrai anche un consiglio di lancio basato sui risultati dei test dell'app.
Per visualizzare un riepilogo del report pre-lancio:
- Apri Play Console.
- Seleziona un'app.
- Seleziona Testa e rilascia
> Test > Report pre-lancio > Panoramica.
- Esamina ogni sezione:
- Stabilità
- Prestazioni
- Accessibilità
- Sicurezza e attendibilità
- Se una sezione presenta un problema, seleziona Mostra riepilogo per espanderla.
- Seleziona Visualizza dettagli per visualizzare informazioni più dettagliate sui tuoi problemi.
- Per visualizzare i report pre-lancio precedenti, scorri fino alla tabella nella sezione "Dettagli dei report" alla fine della pagina.
Nota: se vedi la dicitura "Test in corso", significa che l'ultimo test non si è ancora concluso. Se non è stato possibile eseguire l'ultimo test, potrebbe essere visualizzato il messaggio "Test non riuscito". Per eseguire un altro test, pubblica un altro app bundle.
Per visualizzare i risultati dettagliati del report pre-lancio:
- Apri Play Console.
- Seleziona un'app.
- Nel menu a sinistra, vai alla pagina Dettagli del report pre-lancio ( Testa e rilascia
> Test > Report pre-lancio > Dettagli).
- Esamina le schede Stabilità, Rendimento, Accessibilità e Screenshot. In ogni pagina, vedrai i dettagli completi dei risultati dell'ultimo test, tra cui analisi dello stack, screenshot e grafici.
Nota: se vedi la dicitura "Test in corso", significa che l'ultimo test non si è ancora concluso. Se non è stato possibile eseguire l'ultimo test, potrebbe essere visualizzato il messaggio "Test non riuscito". Per eseguire un altro test, pubblica un altro app bundle.
Comprimi tutto Espandi tutto
In genere i risultati del test sono disponibili entro un'ora dal caricamento dell'app bundle. In alcuni casi, riceverai i risultati diverse ore dopo il caricamento. Se il report non viene completato dopo due giorni, prova a caricare di nuovo l'elemento. Verrà attivato un nuovo report.
Puoi comunque ricevere un report pre-lancio se non è un problema per te apportare piccole modifiche al codice.
I dispositivi di test si trovano negli Stati Uniti. Se l'app utilizza la geolocalizzazione o presenta limitazioni sui contenuti in base al paese, i dispositivi di test potranno mostrare solo i contenuti disponibili nella loro area geografica.
Se devi testare la tua app nell'ambito di una geolocalizzazione al di fuori dell'area geografica in cui si trovano i dispositivi di test, ai fini del test puoi pubblicare un app bundle che rimuova i requisiti per le località. Esistono due modi per rilevare l'esecuzione dei report pre-lancio in Test Lab:
La piattaforma di test non supporta le app che verificano se un dispositivo ha un controllo privilegiato (accesso root) su Android.
Per informazioni dettagliate su come diminuire il rischio di entrate pubblicitarie fraudolente grazie al test automatizzato delle app, consulta il sito Google Developers.
I dispositivi di test non sono in grado di effettuare acquisti durante il test. Se l'accesso ad alcune parti dell'app richiede abbonamenti o prodotti in-app, gli scenari di test potrebbero essere limitati.
Sì. I test dei report pre-lancio verranno eseguiti comunque.
Tuttavia, in caso di offuscamento o rimozione dei simboli di debug dal codice, l'offuscamento o la rimozione si applicherà all'analisi dello stack di eventuali arresti anomali o ANR rilevati durante il test. Per consentirci di semplificare il debug delle analisi dello stack, ti consigliamo di caricare un file di deoffuscamento o di simbolizzazione.
Puoi scoprire di più sul caricamento dei file di deoffuscamento o di simbolizzazione.
No. La piattaforma di test non supporta il precaricamento di dispositivi con contenuti multimediali o app preinstallate.
Tuttavia, se vuoi eseguire test su un'app con dati precaricati, puoi pubblicare una versione di test della tua app con i file multimediali incorporati nel relativo app bundle.
Se per la tua app è in corso un test aperto o se è stata pubblicata in versione di produzione, per il test del report pre-lancio verrà usato un ID considerato come autorizzato per la tua app.
Se per la tua app non è in corso alcun test aperto e non hai un app bundle attivo pubblicato in produzione, l'app non supererà il controllo della licenza. Riceverai comunque i risultati del report pre-lancio, ma l'app risulterà senza licenza. Per eseguire test su app di questo tipo, puoi pubblicare una versione chiusa della tua app in cui i servizi di gestione licenze sono disattivati.
Per impostazione predefinita, i dispositivi di test sono impostati in modo da eseguire i test con un orientamento di pagina verticale fisso. Tuttavia, se la tua app è bloccata in orizzontale, dovresti vedere video e screenshot in modalità Orizzontale.
Scegliamo i dispositivi di test che offrono un'ampia copertura in tutto l'ecosistema e tengono conto della popolarità del dispositivo, della frequenza degli arresti anomali, delle risoluzioni dello schermo, dei produttori, della versione del sistema operativo Android e altro ancora. La selezione dei dispositivi utilizzati per il test può variare.
Se hai escluso alcuni dispositivi dal targeting nel file manifest dell'app, il report pre-lancio li esclude anche nei test, ma non sceglierà come target alcun dispositivo extra per la tua app.
Il report pre-lancio è basato su Firebase Test Lab. Per personalizzare i dispositivi testati, valuta la possibilità di eseguire i tuoi test nella Console Firebase.
Sì, eseguiremo l'app su un emulatore e ne eseguiremo la scansione come con un dispositivo fisico.
Il nostro gruppo di dispositivi include smartphone, tablet, Wear OS e computer come Chromebook. Non è possibile testare le app direttamente su Android Automotive OS o sui dispositivi Android TV.
Il nostro gruppo di dispositivi include i dispositivi Android 9 e versioni successive.