Contributi al progetto World Locking Tools for Unity
Il modo più prezioso per contribuire al progetto World Locking Tools in questo momento consiste nel presentare problemi. Qualsiasi feedback su come allineare meglio il progetto World Locking Tools for Unity alle esigenze del progetto è estremamente prezioso.
Anche se qualsiasi feedback che pubblica è utile, ecco alcuni suggerimenti su come rendere i tuoi più interattivi.
Usare le etichette in modo appropriato
Sia quando si invia inizialmente un problema e quando si segue un problema come collaboratore, l'uso corretto delle etichette è estremamente utile per coordinare con altri collaboratori.
Provare a distinguere in modo accurato ciò che è un bug, qual è una richiesta di funzionalità e che cos'è un suggerimento più ampio in futuro. Tutti sono preziosi, ma sono più preziosi una volta identificati come tali.
Analogamente, se un problema sembra non eseguibile nel formato corrente, l'applicazione dell'etichetta appropriata (ad esempio, "non chiaro") può contribuire a migliorare la posizione in cui è utilizzabile. I commenti specifici del problema sono, naturalmente, estremamente preziosi. Ma l'etichetta corretta può portare altri utenti a visualizzare un commento che altrimenti potrebbe andare inosservato.
Segnalazione di un bug
I problemi possono essere inviati dal portale dei problemi in GitHub. Prendere il tempo per segnalare un problema o fare un suggerimento che altri potranno trarre vantaggio anche da è sempre apprezzato.
Ogni report di bug ha un proprio contesto, ma in generale, più dei seguenti sono inclusi più rapidamente un problema può essere risolto.
File di log dal dispositivo
I file di log dal dispositivo possono risultare utili per analizzare i problemi, soprattutto in combinazione con le acquisizioni dello schermo suggerite di seguito. Possono essere ottenuti usando Windows Device Portal durante la connessione al dispositivo, in Cartelle utente di Esplora file > di sistema > \ LocalAppData \ WorldLockingTools
File di log dell'app Unity
UnityPlayer.log si trova nella sottocartella TempState. Si tratta di un file di testo normale.
Registrazione diagnostica degli strumenti di blocco globale
Il file di diagnostica si trova nella sottocartella LocalState . Il nome del file viene generato automaticamente in base al modello seguente:
FrozenWorld-<device name>-<capture date and time>.hkfwSi tratta di un file binario che richiede software specializzato da esaminare.
Si noti che per acquisire una registrazione diagnostica è necessario abilitare la registrazione diagnostica nel componente World Locking Tools Manager nella scena. Per informazioni dettagliate, vedere la documentazione di diagnostica.
Procedura di riproduzione
Specificare il modo in cui si verifica il problema. L'ideale è avere un bug che si verifica al 100% del tempo dopo un determinato set di passaggi. Ma anche per un bug che si è visto solo una volta, il più dettagliato è possibile correlare i passaggi che portano al problema, meglio è.
La procedura di riproduzione deve seguire il formato generale seguente:
- A partire da questo normale stato stabile...
- Poi ho fatto questo (o notato questa cosa insolita)...
- Quindi il sistema ha iniziato a mostrare questo comportamento non corretto...
Screenshot
Le acquisizioni dello schermo consentono di identificare il contesto completo in cui si è verificato il problema. In particolare, la visualizzazione della diagnostica degli strumenti di blocco globale sullo schermo consente di correlare l'esperienza alle informazioni nei log. Le acquisizioni dello schermo possono essere immagini snapshot o acquisizioni di video.
Informazioni dispositivo
- Che tipo di dispositivo?
- Esecuzione della versione del sistema operativo
Ambiente di compilazione
- Versione di Unity
- Versione di Visual Studio
Proposta di una funzionalità
Quando si scopre che World Locking Tools fa quasi ciò di cui hai bisogno, le probabilità sono che qualcun altro stia soffrendo la stessa limitazione. Siamo interessati a correggere le lacune nella documentazione ed esempi, come nel fornire nuove funzionalità.
Nel proporre una nuova funzionalità, è più utile chiarire cosa si sta cercando di fare. Anche se le idee su come implementarla possono essere utili, le proposte che rendono chiaro il valore aggiunto hanno maggiori probabilità di ottenere trazione. Rendere il problema che la funzionalità risolve ovvio, preferibilmente con ciò che è possibile ottenere con esso in uno scenario reale.
Assicurarsi di allegare l'etichetta "miglioramento" al problema della proposta inviata.
Contributi al codice
Si tratta di un progetto open source, quindi naturalmente chiunque può creare un fork per sviluppare in qualsiasi momento. Se qualcuno è abbastanza generoso da condividere il lavoro, allora è molto apprezzato, sia che venga ripiegato nel repository principale o meno.
Durante questo periodo di implementazione iniziale, saranno disponibili risorse limitate da rivedere e accettare richieste pull nel repository principale. È consigliabile evitare di investire molto tempo in un fork presupponendo che venga unito nuovamente al repository principale.
Un modo per attenuare il rischio consiste nell'inviare un problema che propone ciò che è previsto (con etichetta "miglioramento") prima di investire molto tempo in un'implementazione. Questo aspetto è anche rivolto ad altri collaboratori che potrebbero esaminare la stessa area di problema.