Per inviare una richiesta di pull (PR) per un problema MVVMCRoss, seguire questi passaggi dettagliati:
1. Riproduzione del problema: in primo luogo, assicurati di poter riprodurre il problema in modo coerente. Questo è fondamentale per la creazione di un PR affidabile. Se possibile, utilizzare l'app campione MVVMCRoss Playground per dimostrare il problema. Questo campione è incluso nel codice sorgente MVVMCROSS e fornisce un ambiente controllato per isolare e riprodurre i problemi [1].
2. Raccogli le informazioni: raccogliere quante più informazioni pertinenti possibili sul problema. Questo include:
-Passaggi per riprodurre: fornire una guida chiara e passo-passo su come riprodurre il problema.
- Le piattaforme interessate: specificare quali piattaforme (ad es. Android, iOS, UWP) stanno vivendo il problema.
- Snippet di codice: includere tutti gli snippet di codice pertinenti coinvolti nel problema.
- Previsto vs. Comportamento reale: descrivi ciò che ti aspetti che accada rispetto a ciò che effettivamente accade [3].
3. Crea una filiale: nella copia locale del repository MVVMCRoss, crea una nuova filiale per le modifiche. Questo ramo dovrebbe essere basato sull'ultima versione del codice MVVMCRoss (ad esempio, `Main` o` Sviluff` Filiale). Usa un nome descrittivo per il tuo ramo che si riferisce al problema che stai affrontando.
4. Apporta modifiche: implementa la correzione o il miglioramento nel tuo ramo. Assicurati che le modifiche siano minime e focalizzate sulla risoluzione del problema specifico. Se stai fissando un bug, prova a includere un test per verificare la correzione.
5. Test delle modifiche: testare accuratamente le modifiche per assicurarti che risolvano il problema senza introdurre nuovi problemi. Usa l'app di esempio del parco giochi o il tuo progetto di test per verificare la correzione.
6. Formatta il codice: assicurarsi che il codice aderisca agli standard di codifica MVVMCRoss e alle linee guida di formattazione. È possibile utilizzare strumenti come gli analizzatori di Roslyn per aiutare a mantenere la coerenza [4].
7. Commettono le tue modifiche: commetti le modifiche con un messaggio di commit chiaro e descrittivo. Il messaggio dovrebbe includere un riferimento al numero di emissione, se applicabile (ad esempio, "Corregge #xxxx: breve descrizione delle modifiche").
8. Spingi il tuo ramo: spingi il ramo sulla forcella del repository MVVMCRoss su GitHub.
9. Invia il PR: su GitHub, vai alla tua filiale e fai clic sul pulsante "Nuova richiesta pull". Seleziona il ramo di base (di solito `main` o` sviluppa`) e riempire la descrizione PR. Includere:
- Un breve riassunto delle modifiche.
- Eventuali dettagli pertinenti o punti di discussione.
- Collegamenti a questioni o discussioni correlate.
10. Coinvolgi con la comunità: dopo aver inviato il tuo PR, preparati a impegnarsi con la comunità MVVMCRoss. Possono richiedere ulteriori informazioni, suggerire modifiche o chiederti di aggiornare il tuo PR in base al feedback.
11. Aggiorna il tuo PR: se richiesto, aggiorna il tuo PR spingendo nuovi commit sulla tua filiale. GitHub aggiornerà automaticamente il PR con le nuove modifiche.
Seguendo questi passaggi, è possibile contribuire efficacemente a MVVMCRoss e aiutare a risolvere i problemi in modo collaborativo.
Citazioni:[1] https://nicksnettravels.builtoroam.com/post-2018-07-31-debugging-and-contributing-to-mvvvmcross-aspx/
[2] https://www.mvvmcross.com/mvvmcross-5-release/
[3] https://www.nuget.org/packages/mvvmcross/
[4] https://www.mvvmcross.com/documentation/advanced/analysis
[5] https://stackoverflow.com/questions/61632172/mvvmcross-problem-with-adding-new-contentpage
[6] https://stackoverflow.com/questions/61528243/mvvmcross-pdb-debug-symbols-not-loading-in-visual-studio-2019
[7] https://github.com/mvvmcross/mvvmcross/issues/1032
[8] https://github.com/mvvmcross/mvvmcross/issues/215