Segnala i bug

I bug ci sono. È un dato di fatto. Ma possono essere risolti. E, tanto è migliore la segnalazione creata, tanto più è facile per la squadra di sviluppo la replicazione del problema, l'investigazione, e infine la sua risoluzione.

Tutte le segnalazioni di bug devono essere registrate nel sistema di tracciamento dei bug ufficiale. Lì vengono tracciate anche le richieste di nuove funzionalità, usando l'elemento wishlist come severity. Ma prima di farlo, fai quanto segue:

Passaggio 1: aggiorna all'ultima versione

Effettua l'aggiornamento alle ultime versioni rilasciate di Kdenlive. Non rispondiamo a segnalazioni di bug per vecchie versioni di Kdenlive (a meno che non siano ancora riproducibili nell'ultima versione).

Passaggio 2: cerca nella documentazione ufficiale di Kdenlive

RTFM - Read The Fine Manual è una frase spesso usata per prendere in giro gli utenti che pongono domande a cui si potrebbe rispondere leggendo la documentazione. Ai tempi e nell'era dei tutorial di YouTube, questo potrebbe non essere più così importante o rilevante, ma ti invitiamo a consultare la documentazione ufficiale di Kdenlive. Consente di eseguire ricerche, e contiene una grande quantità di informazioni valide e preziose.

Passaggio 3: cerca nei forum

Kdenlive ha una grande comunità attiva nei forum e nelle stanze di chat. Controlla nel forum ufficiale se altri utenti hanno riscontrato lo stesso problema. Forse esiste una correzione, o una soluzione alternativa. Altri canali da controllare sono

Passaggio 4: esegui una ricerca tra i problemi aperti

Cerca nel sistema di tracciamento dei bug. Forse il problema che stai riscontrando è già stato segnalato, oppure è già stato addirittura risolto. Lo stato del bug è un buon indicatore su cosa sta succedendo al momento:

  • REPORTED è un bug che è stato segnalato, ma non è successo nulla dal quel momento. Potrebbe esserci una discussione a riguardo, quindi vale la pena controllare se può applicarsi al tuo problema.
  • NEEDSINFO è un bug segnalato che necessita di ulteriore riscontro. Ciò significa che un membro della squadra di sviluppo lo ha esaminato, ma ha bisogno di maggiori dettagli
  • CONFIRMED significa che il bug è riproducibile (sia da altri utenti che dalla squadra di sviluppo)
  • ASSIGNED significa che uno sviluppatore sta gestendo il bug
  • RESOLVED significa che il bug è stato risolto nella versione di sviluppo

Passaggio 5: segnala il bug

Se si verifica un arresto anomalo all'avvio di Kdenlive, o quando provi a riprodurre un file video, segui questa procedura:

  1. Se hai compilato Kdenlive e/o MLT da solo, assicurati di aver seguito tutti i passaggi descritti nelle nostre istruzioni.
  2. Controlla di non avere installate più versioni di MLT
  3. Prova a riprodurre il tuo file video con il lettore di FFmpeg. Da un terminale: ffplay miovideo.mpg
  4. Prova a riprodurre il tuo file video con il lettore di MLT. Da un terminale: melt miovideo.mpg

Includi i risultati come allegati nella tua segnalazione di bug.

Per una buona segnalazione di bug, includi le seguenti informazioni:

  • La tua versione di Kdenlive e MLT. Puoi copiare queste informazioni dal menu di Kdenlive > Aiuto > Informazioni.
  • Il tuo sistema operativo (SO), ad esempio Windows, la distribuzione Linux, oppure MacOS con la sua versione
  • Il metodo di installazione di Kdenlive, ad esempio Windows installer o standalone, oppure Linux flatpak/snap/ppa o appimage
  • I passaggi dettagliati per riprodurre il bug. Le schermate e le registrazioni dello schermo sono molto utili per replicare il problema.
  • Qualsiasi messaggio di errore o file di log che puoi fornire. Non copiare e incollare il contenuto del log nella segnalazione del bug, ma aggiungilo come allegato.
  • Se il bug provoca l'arresto anomalo di Kdenlive, fornisci un backtrace.

Come ottenere informazioni utili sugli arresti anomali (backtrace)

Un backtrace contiene informazioni preziose per la squadra di sviluppo. Richiede un po' di configurazione specifica del sistema operativo e di magie della riga di comando, quindi potrebbe non essere adatto a tutti.

Linux appimage

Installa i seguenti pacchetti: gdb, kdenlive-dbg, libmlt-dbg (i nomi dei pacchetti potrebbero essere leggermente diversi a seconda della distribuzione)

Se compare la finestra del gestore degli arresti anomali di KDE quando Kdenlive si blocca, lì puoi copiare i dati che fornisce. Altrimenti, avvia Kdenlive da un terminale come questo:

  1. Digita gdb kdenlive
  2. Dopo che gdb ha letto i simboli di debug, digita run

Linux Flatpak

Per prima cosa assicurati che i simboli di debug di Flatpak siano installati, digitando flatpak install org.kde.kdenlive.Debug nella riga di comando.

Ora puoi avviare il Flatpak da riga di comando in questo modo:

  1. Avvia una shell all'interno del sandbox Flatpak di Kdenlive: flatpak run --command=sh --devel org.kde.kdenlive
  2. Digita gdb /app/bin/kdenlive
  3. Dopo che gdb ha letto i simboli di debug, digita run

Per maggiori dettagli sul debug di Flatpak, vedi qui: https://docs.flatpak.org/en/latest/debugging.html

Windows

  1. Compila Kdenlive con KDE Craft localmente, come descritto qui.
  2. Digita nella riga di comando cd C:/CraftRoot/mingw64/bin
  3. Avvia gdb con gdb
  4. Avvia Kdenlive -> ottieni il numero del PID
  5. attach 3288 (sostituisci 3288 con il numero del PID)
  6. Attendi il prompt (gdb)
  7. Digita c

Dopo aver seguito le istruzioni specifiche per la piattaforma qui sopra per avviare Kdenlive puoi innescare il bug. Quando Kdenlive si blocca, vai alla finestra del terminale, e digita:

thread apply all bt full

Quindi premi Invio finché non vedi i dati completi. Copia il log in un file, e allegalo alla segnalazione del bug.