Questo articolo fornisce una guida per l'archiviazione di errori (bugs) individuati nel contesto del progetto Firefox OS , che include anche Gaia e B2G .
Bugzilla
Come nella maggior parte dei progetti Mozilla, Bugzilla viene utilizzato per gestire lo stato di bugs e problemi individuati in programmi appartenenti al progetto. Dopo aver scopeto un bug puoi archiviarlo in Bugzilla - nota che esiste un prodotto specifico per Firefox OS, contenente componenti che trattano argomenti che possono essere classificati nel contesto di Gaia, Gonk e Gecko. Si consiglia di utilizzare questo componente per archiviare i bugs individuati in Firefox OS, Gaia, etc.
Archiviazione dei bugs
Per archiviare un bug, è possibile utilizzare questo modello proposto da Bugzilla e seguire le istruzioni riportate qui di seguito nel compilarlo.
Campi obbligatori e facoltativi
Quando si archivia un bug, alcuni campi sono obbligatori:
| Campo | Descrizione |
|---|---|
| Componente | Scegliete la categoria di appartenenza del bug. Se non avete idea di quale categoria assegnare, scegliete la categoria "Generale". |
| Sommario | Fornite un sintesi della descrizione del bug |
| Descrizione | Descrivete chiaramente la situazione. Un buon bug dovrebbe contenere una descrizione, passo per passo, della procedura per riprodurre il problema (Steps To Reproduce -STR), dei risultati che uno si aspetta e dei risultati riscontrati. Si prega di indicare anche la frequenza di riproduzione (cioè quante volte il bug appare se ripetete i passi più e più volte). |
| Informazione relativa al Build | Andate a Impostazioni> Informazioni sul dispositivo> Ulteriori informazioni e menzionate nel bug le seguenti caratteristiche: versione del sistema operativo, il numero dei build, la Versione della Piattaforma, l' identificatore del Build, l' Aggiornamento del canale e l'informazione del Git Commit. (Se si dispone di un computer Mac / Linux con adb e git installato, è possibile eseguire questo script e incollare l'output dello script del bug.) |
| Immagini delle schermate | Si prega di allegare una immagine dello schermo che possa essere utile per analizzare il bug. (Sul dispositivo Fiamma, tenere premuto il tasto Power e Abbassa Volume simultaneamente per 2 secondi fino a quando il telefono non mostri una notifica della avvenuta acquisizione ddell'immagine dello schermo. Succesivamente trasferire l'immagine acquisita sul computer utilizzando un attacco USB.) |
| Video | Se il bug riguarda transizioni dello schermo che sono difficili da catturare attraverso l'acquisizione di immagini delle schermate, si prega di girare un video. Caricate il file del video come allegato al bug oppure caricate il video su YouTube e poi allegate l'indirizzo dell'URL del video utilizzando la funzione di copia-incolla . |
| Registrazioni ADB | Se il vostro computer contiene una installazione di ADB, per favore collegatelo al telefono ed eseguite il comando | adb logcat |. Si prega di inserire l'output di questo comando in un file di testo e quindi allegarlo al bug. |
The following fields are optional:
| Campo | Descrizione |
|---|---|
| Dipedenze/blocchi | Mostare la dipendenza fra i vari bugs. |
| Parola chiave | Parole chiave per Bugzilla. Gruppi specifici le useranno per rintracciare il bug. |
| Lavagna | Contiene etichette. Inserisci etichette utili per rintracciare il bug. Si consiglia di non rimuovereetichette assegnate da altri senza permesso. |
| Vedi Anche | A volte due diversi problemi sono in qualche modo collegati. La loro connessione puo' essere riportata qui |
| Bandierine | Bandierine per il monitoraggio dello stato; la bandierina più utilizzata nei bugs del sistema operativo Firefox e' "Blocca-B2G". Se un bug contiene la bandierina blocco-B2G, significa che e' necessario prestare più attenzione alle specificahe del bug in quanto puo' bloccare la distribuzione. |
| Sicurezza | Se un bug è relativo alla sicurezza dei dati personali, la perdita di guadagno o simili questioni, selezionat la casella di controllo cosicche sarà visiable solamente ai dipendenti interessati. |
Per ulteriori informazioni sui campi Bugzilla, è possibile visualizzare la pagina dei campi Bugzilla su Bugzilla.
Archiviazione di bugs di localizzazione
Quando uncontrate un stringa non tradotta puo' significare due cose:
-
- Il localizzatore non ha potuto tradurre la stringa a causa di un problema legato alla localizzabilita' (l12y). Si prega di inviare un bug in questo caso.
Come archiviare bugs di localizzazione (l12y)
- Nel sistema operativo Firefox, andate su Impostazioni> Informazioni sul dispositivo> Ulteriori informazioni e attivate il menu Developer
- Andate a Impostazioni> Developer e attivate pseudo-localizzazione.
- Andate a Impostazioni> Lingua e scorrere fino alla fine per selezionare inglese accentato.
- Tornate indietro e guardate la stringa non tradotta. Se appare in normale inglese e non inglese accentato, si tratta molto probabilmente di un poblema legato allalocalizzabilità (l12y).
- In Bugzilla, aprite un bug sotto la sezione del prodotto 'Firefox OS'. Selezionate il componente dove la stringa non tradotta appare. Aggiungete 'l12y' nel campo Parola chiave.
- Si prega di compilare tutti gli altri campi obbligatori.
Tipiche Parole chiave
La seguente tabella fornisce informazioni sulle tipiche parole chiave che vedrete utilizzate nei bugs del sistema operativo Firefox.
Si deve sempre indicare il build / l'OS / la piattaforma (e) utilizzati per verificare il bug nei commenti relativi all' errore riscontrato, prima di modificare lo stato a verificato. Se il bug è riportato su tutte e tre le piattaforme e si dispone di una sola piattaforma per verificare la correzione, andate avanti e annotate le vostre osservazioni nel bug, ma non segnalate il bug come verificato. Tutte le piattaforme devono essere controlle prima di modificare lo Stato a verificato.
Infine, se altri bug sono stati contrassegnati come un duplicato del bug che state verificando, assicuratevi di controllare e annotare pure quelli. Spesso i programmatori indicano bug correlati, ma non identici, come duplicati e questi possono essere trascurati se non appaiono selezionati.
| Parola Chiave | Descrizione |
|---|---|
| meta | Indica che il bug è un bug di monitoraggio dello stato. Mozilla usa questa etichetta per controllare lo stato di vari bugs o delle implementazioni delle storie degli utenti. Una volta segnalato in questo modo, i programmatori non dovrebbero mettere delle pezze sopra a questi bugs. Si ricorda che i responsabili di progetto e il personale che si occupa della qualita' usano meta bugs per sequire lo stato delle varie applicazioni. |
| qablocker | Utilizzare questa parola chiave per i bug che stanno bloccando test di verifica (manuali o automatizzati di un aspetto specifico) e che devono essere risolti prima della scadenza relativa alla pubblicazione della prossima versione Beta o RC. |
| qawanted | Utilizzare questa parola chiave per i bug che hanno bisogno di più informazioni, che richiedono di essere riprodotti o verificati di nuovo, o che sono duplicati (ma non si riesce a trovare il bug originale che e' stato duplicato). Sulla lavagna viene riportato l' avanzamento delle verifiche di qualita' obbligatorie; questa parola chiave deve essere rimossa quando le verifiche di qualita' richieste sono state completate. |
| regression |
Questa parola chiave significa che il problema è stato risolto, ma poi è ritornato (regredito) e il bug in questione è un nuovo bug, archiviato per registrare la regressione. Può anche riferirsi a problemi al di fuori quelli identificati nella registrazione iniziale del bug o riscontrati nei test di fumo e che sono stati individuti nei build attuali e che funzionavano in build precedenti. Il monitoraggio di tali errori aiuta ad identificare aree di fragilita' e soggette a rottura. Tali errori sono utili per la identificazione di nuovi test da aagiungere ai test di verifica che appaionno nelle liste dei pre-Test e dei test di fumo. |
| regressionwindow-wanted |
Indica che il bug è una regressione e che sarebbe importante che qualcuno identificasse il momento in cui è accaduto e il relativo specifico controllo. |
| steps-wanted | Mette in evidenza un bug che potrebbe migliorare se qualcuno identificasse la procedura per riprodurlo. |
| verifyme | Significa che questo bug è pronto per essere verificato con l'ultima build FX OS da una persona diversa dal contatto di verifica qualita' indicato nel bug. Il bug contiene specifici dettagli di configurazione della macchinada utilizzarsi per verificare la correzione. Si dovrebbe cercare di riprodurre l'errore, e, se d'accordo che la stato Fixed è corretto, cambiare lo stato a verificato. |
| crash | Aggiungete questa parola chiave se si incontra un rottura del programma in FX OS. |
Nota: È possibile fare riferimento alle "Guida di come scrivere un Bug". La pagina WIKI di Mozilla B2G QA ha anche alcune risorse utili sulla gestione dei bug del sistema operativo di Firefox; le pagine più utili sono Uso di Bugzilla e Incoming triage bug per Firefox OS.
Note: For more information on handling bugs during Gaia development, read Submitting a Gaia patch.