Segnalazioni bug e richieste di feature

NextATC scrive la diagnostica principale in NextATC.log nella cartella del plugin. All’avvio conserva una sessione precedente in .previous_session. I bug report includono automaticamente i log NextATC correnti e precedenti disponibili, compresi Traffic e AutoFly quando presenti. La revisione elenca i file raccolti; i log precedenti aiutano dopo una chiusura inattesa, ma non dimostrano un crash. Per un report inviato da Unicom, allega anche NextATC.log della stessa sessione interessata, se disponibile.

Apri Plugins → NextATC → Bug / Feature Request. Il reporter interno al plugin è un benefit per i Patreons e verifica nuovamente il diritto di supporto quando viene inviato un report. Scegli se stai segnalando un bug o richiedendo una feature prima di inserire i dettagli.

Nel plugin, una richiesta di funzionalità senza screenshot viene inviata direttamente, senza creare un ZIP o aprire la revisione del pacchetto. Se includi screenshot, controlla il ZIP preparato prima dell’invio.

Cosa viene incluso#

• I bug includono descrizione, log del volo corrente senza credenziali, identificativi degli account o percorsi personali e solo le impostazioni esplicitamente consentite. Includono inoltre tutti i GeoJSON diagnostici creati durante il volo corrente; quelli più vecchi vengono esclusi. Le feature request non raccolgono mai log, impostazioni o diagnostica GeoJSON.
• Entrambi possono includere fino a dieci screenshot PNG del volo corrente. Gli screenshot vengono inclusi senza modifiche: controlla attentamente le miniature.
• Non vengono intenzionalmente inclusi email Patreon, token di login, password, chiavi API, indirizzi IP, ID installazione o percorsi della cartella personale.

Per aggiungere uno screenshot, premi Scatta uno screenshot ora. Il reporter si nasconde brevemente mentre la funzione nativa di X-Plane salva il PNG, poi torna allo stesso dialogo con la nuova anteprima selezionata. Deseleziona ciò che non vuoi inviare: la miniatura scompare e libera il posto, senza cancellare il PNG salvato da X-Plane. Le dieci miniature restano in un'unica griglia; raggiunto il limite, rimuovine una prima di scattarne un'altra. Puoi chiudere il reporter in qualsiasi momento e tornare più tardi senza perdere bozza, anteprima o selezioni.

Se User Debug è disattivato, la prima schermata del reporter mostra un avviso grande. Attivalo nelle Opzioni prima di riprodurre il problema o scattare gli screenshot, così la segnalazione conterrà i dettagli diagnostici più utili.

Prima dell'invio#

Quando serve un pacchetto, NextATC crea NextATC-bug-report.zip oppure NextATC-feature-request.zip nella cartella bugreport del plugin. Puoi controllare esattamente cosa verrà inviato con Apri cartella locale; la cartella della segnalazione contiene soltanto lo ZIP. Quindi premi il pulsante di invio quando sei pronto. La chiusura della finestra nasconde solo l'operazione attiva e Cancel la interrompe. Il risultato dell'upload appare sempre nell'OSD senza riaprire un reporter chiuso. Lo ZIP locale resta disponibile finché non lo rimuovi tu.

Gli upload automatici sono limitati a 100 MiB e tre report in un periodo mobile di 24 ore. I Patreons mantengono l'accesso alle conversazioni sui report esistenti sul sito web; un nuovo report automatico richiede un entitlement di supporto Patreon attivo.

Inviare un report da Unicom#

I sostenitori Patreon paganti attivi possono anche inviare un report dal sito, dalla pagina New report di Unicom. Accedi prima con Patreon. L'iscrizione viene verificata nuovamente al momento dell'invio; le iscrizioni gratuite, di prova o regalate non concedono l'accesso ai nuovi report.

Scegli Bug report, Feature request o Support request, indica un oggetto e descrivi cosa è successo, cosa ti aspettavi e come riprodurlo. Un bug report via web richiede il file X-Plane/Log.txt leggibile interessato; il rilevamento automatico incompleto della versione o dei dettagli del volo non impedisce l'invio. Una feature request non richiede log. Revisiona i log e gli screenshot per informazioni private prima di caricarli: la sanificazione diagnostica automatica del plugin non si applica a un file allegato manualmente.

Il tuo account fornisce l'identità del reporter. Dopo l'invio, il report appare in My bug reports, My feature requests o My support requests, dove puoi seguire la conversazione. Se la connessione fallisce dopo l'invio, controlla quelle sezioni prima di inviarne un altro. Le conversazioni sui report esistenti rimangono disponibili anche se la tua iscrizione a pagamento termina.

Richieste di supporto#

Una richiesta di supporto è una domanda ad Antonello su come configurare o usare NextATC, per gli stessi sostenitori paganti. In questa versione si invia da Unicom con New support request: il reporter dentro NextATC offre bug report e richieste di feature. Allega Log.txt e NextATC.log della sessione quando aiutano. Se si rivela un bug, diventa un bug report con lo stesso numero (SUP-12 diventa BUG-12).

Consigli per un report utile#

• Segnala un solo problema per report.
• Indica aeroporto di partenza e di arrivo, pista, parcheggio, fase di volo, l'ultima azione premuta e l'ora approssimativa.
• Per un aereo sintetico che non si muove, aggiungi il suo callsign e il motivo stopped: mostrato nel suo tooltip sul Nav Display; vedi Traffico.
• Non cancellare la cartella del plugin prima di segnalare: NextATC.log, i log della sessione precedente e settings.ini sono salvati al suo interno. NextATC conserva una sola sessione precedente, quindi invia il report prima di volare altre sessioni.

Screenshot del Nav Display#

Take Screenshot Now nasconde il reporter e cattura ciò che è visibile dietro. Chiudi il reporter, apri il Nav Display sulla pagina da mostrare, riapri il reporter e premi il pulsante. Il comando assegnabile NextATC/bug_report_toggle apre e chiude il reporter; funziona solo con un entitlement da supporter Patreon attivo.

Dove sono i log#

NextATC.log e NextATC.traffic.log sono in X-Plane/Resources/plugins/NextATC/. Il Log.txt di X-Plane è nella cartella principale di X-Plane.