Για να υποβάλετε ένα αίτημα έλξης (PR) για ένα ζήτημα MVVMCROSS, ακολουθήστε αυτά τα λεπτομερή βήματα:
1. Αναπαράγοντας το ζήτημα: Πρώτον, βεβαιωθείτε ότι μπορείτε να αναπαράγετε το ζήτημα με συνέπεια. Αυτό είναι ζωτικής σημασίας για τη δημιουργία αξιόπιστου PR. Εάν είναι δυνατόν, χρησιμοποιήστε την εφαρμογή δείγμα MVVMCROSS Playground για να αποδείξετε το πρόβλημα. Αυτό το δείγμα περιλαμβάνεται στον πηγαίο κώδικα MVVMCross και παρέχει ένα ελεγχόμενο περιβάλλον για την απομόνωση και αναπαραγωγή ζητημάτων [1].
2. Συλλέξτε πληροφορίες: Συλλέξτε όσο το δυνατόν περισσότερες σχετικές πληροφορίες σχετικά με το θέμα. Αυτό περιλαμβάνει:
-Βήματα για την αναπαραγωγή: Παρέχετε έναν σαφή οδηγό βήμα προς βήμα για το πώς να αναπαράγετε το ζήτημα.
- επηρεάζονται οι πλατφόρμες: καθορίστε ποιες πλατφόρμες (π.χ. Android, iOS, UWP) αντιμετωπίζουν το πρόβλημα.
- Κωδικά αποσπάσματα: Συμπεριλάβετε τυχόν σχετικά αποσπάσματα κώδικα που εμπλέκονται στο θέμα.
- Αναμενόμενη έναντι πραγματικής συμπεριφοράς: Περιγράψτε τι περιμένετε να συμβεί σε σχέση με το τι συμβαίνει πραγματικά [3].
3. Δημιουργήστε ένα υποκατάστημα: Στο τοπικό αντίγραφο του αποθετηρίου MVVMCROSS, δημιουργήστε ένα νέο υποκατάστημα για τις αλλαγές σας. Αυτός ο κλάδος θα πρέπει να βασίζεται στην τελευταία έκδοση του κώδικα MVVMCross (π.χ., «κύρια» ή «αναπτυσσόμενη» υποκατάστημα). Χρησιμοποιήστε ένα περιγραφικό όνομα για το υποκατάστημα σας που σχετίζεται με το πρόβλημα που αντιμετωπίζετε.
4. Κάντε αλλαγές: Εφαρμόστε τη λύση ή τη βελτίωση στο υποκατάστημα σας. Βεβαιωθείτε ότι οι αλλαγές σας είναι ελάχιστες και επικεντρώνονται στην επίλυση του συγκεκριμένου ζητήματος. Εάν διορθώνετε ένα σφάλμα, προσπαθήστε να συμπεριλάβετε μια δοκιμή για να επαληθεύσετε τη λύση.
5. Δοκιμάστε τις αλλαγές σας: Δοκιμάστε διεξοδικά τις αλλαγές σας για να βεβαιωθείτε ότι επιλύουν το πρόβλημα χωρίς να εισαγάγετε νέα προβλήματα. Χρησιμοποιήστε την εφαρμογή δείγματος παιδικής χαράς ή το δικό σας δοκιμαστικό έργο για να επαληθεύσετε τη λύση.
6. Μορφή του κώδικα σας: Βεβαιωθείτε ότι ο κωδικός σας συμμορφώνεται με τα πρότυπα κωδικοποίησης MVVMCross και τις οδηγίες μορφοποίησης. Μπορείτε να χρησιμοποιήσετε εργαλεία όπως οι αναλυτές της Roslyn για να βοηθήσετε στη διατήρηση της συνέπειας [4].
7. Δέσμευση των αλλαγών σας: Δέσμευση των αλλαγών σας με ένα σαφές, περιγραφικό μήνυμα δέσμευσης. Το μήνυμα θα πρέπει να περιλαμβάνει αναφορά στον αριθμό έκδοσης, εάν ισχύει (π.χ. "διορθώσεις #xxxx: σύντομη περιγραφή των αλλαγών").
8. Πιέστε το υποκατάστημα σας: Σπρώξτε το υποκατάστημα σας στο πιρούνι σας του αποθετηρίου MVVMCROSS στο GitHub.
9. Υποβάλετε το PR: On Github, μεταβείτε στο υποκατάστημα σας και κάντε κλικ στο κουμπί "Νέο αίτημα έλξης". Επιλέξτε τον κλάδο βάσης (συνήθως «κύρια» ή «ανάπτυξη») και συμπληρώστε την περιγραφή PR. Συμπεριλαμβάνω:
- Μια σύντομη περίληψη των αλλαγών.
- Οποιεσδήποτε σχετικές λεπτομέρειες ή σημεία συζήτησης.
- Σύνδεσμοι με συναφή θέματα ή συζητήσεις.
10. Εμπλέξτε με την κοινότητα: Αφού υποβάλετε το PR σας, να είστε έτοιμοι να ασχοληθείτε με την κοινότητα MVVMCROSS. Μπορούν να ζητήσουν πρόσθετες πληροφορίες, να προτείνουν αλλαγές ή να σας ζητήσουν να ενημερώσετε το PR σας με βάση τα σχόλια.
11. Ενημερώστε το PR σας: Εάν ζητήσετε, ενημερώστε το PR σας πιέζοντας νέες δεσμεύσεις στο υποκατάστημα σας. Το GitHub θα ενημερώσει αυτόματα το PR με τις νέες αλλαγές σας.
Ακολουθώντας αυτά τα βήματα, μπορείτε να συμβάλλετε αποτελεσματικά στο MVVMCROSS και να βοηθήσετε στην επίλυση των προβλημάτων με τρόπο συνεργασίας.
Αναφορές:[1] https://nicksnettravels.builttoroam.com/post-2018-07-31-debugging-andtributing-to-mvmcross-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-dding-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