Aby złożyć żądanie Pull (PR) dla problemu MVVMCROSS, wykonaj te szczegółowe kroki:
1. Powieść problem: Po pierwsze, upewnij się, że możesz konsekwentnie odtwarzać problem. Ma to kluczowe znaczenie dla stworzenia wiarygodnego PR. Jeśli to możliwe, użyj aplikacji MVVMCROS Playground, aby zademonstrować problem. Ta próbka jest zawarta w kodzie źródłowym MVVMCROSS i zapewnia kontrolowane środowisko do izolowania i odtwarzania problemów [1].
2. Zbierz informacje: Zbierz jak najwięcej istotnych informacji na temat problemu. Obejmuje to:
-Kroki do powielania: Zapewnij jasny, krok po kroku przewodnik na temat odtworzenia problemu.
- Platforma (y) dotknięta: określ, które platformy (np. Android, iOS, UWP) występują problem.
- Fragmenty kodu: Dołącz wszelkie odpowiednie fragmenty kodu, które są zaangażowane w ten problem.
- Oczekiwane vs. faktyczne zachowanie: Opisz, czego się spodziewasz, w porównaniu z tym, co faktycznie się wydarzy [3].
3. Utwórz gałąź: w lokalnej kopii repozytorium MVVMCROSS utwórz nową gałąź dla swoich zmian. Ta gałąź powinna być oparta na najnowszej wersji kodu MVVMCROSS (np. „Main” lub „Rozwój”). Użyj opisowej nazwy dla swojego oddziału, który dotyczy problemu, który rozwiązujesz.
4. Dokonaj zmian: Wdrożenie poprawki lub ulepszenia w swoim oddziale. Upewnij się, że zmiany są minimalne i skupione na rozwiązaniu konkretnego problemu. Jeśli naprawisz błąd, spróbuj dołączyć test w celu zweryfikowania poprawki.
5. Przetestuj zmiany: Dokładnie przetestuj zmiany, aby upewnić się, że rozwiązują problem bez wprowadzania nowych problemów. Użyj aplikacji na placu zabaw lub własnego projektu testowego, aby zweryfikować poprawkę.
6. Sformatuj kod: Upewnij się, że kod przestrzega standardów kodowania MVVMCROSS i wytycznych formatowania. Możesz użyć narzędzi takich jak Roslyn Analizers, aby pomóc zachować spójność [4].
7. Popełniaj zmiany: Zastąp swoje zmiany za pomocą jasnego, opisowego przesłania zatwierdzenia. Wiadomość powinna zawierać odniesienie do numeru wydania, jeśli dotyczy (np. „Poprawki #XXXX: Krótki opis zmian”).
8. Pchnij gałąź: Pchnij gałąź do widelca repozytorium MVVMCROSS na GitHub.
9. Prześlij PR: Na GitHub przejdź do gałęzi i kliknij przycisk „Nowe żądanie Pull”. Wybierz gałąź podstawową (zwykle „main” lub „rozwinąć”) i wypełnij opis PR. Włączać:
- Krótkie podsumowanie zmian.
- Wszelkie istotne szczegóły lub punkty dyskusyjne.
- Linki do powiązanych problemów lub dyskusji.
10. Zaangażuj się ze społecznością: Po przesłaniu PR przygotuj się na zaangażowanie się w społeczność MVVMCROSS. Mogą żądać dodatkowych informacji, sugerować zmiany lub poprosić o aktualizację PR na podstawie informacji zwrotnych.
11. Zaktualizuj swój PR: Na żądanie zaktualizuj PR, pchając nowe zatwierdzenia do oddziału. GitHub automatycznie zaktualizuje PR o nowe zmiany.
Postępując zgodnie z tymi krokami, możesz skutecznie przyczynić się do MVVMCROSS i pomóc w rozwiązywaniu problemów w sposób współpracy.
Cytaty:[1] https://nicksnettravels.builttoroam.com/post-2018-07-31-debugging-and-contributing to-mvvmcross-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-no-loading-in-visual-studio-2019
[7] https://github.com/mvvmcross/mvvmcross/issues/1032
[8] https://github.com/mvvmcross/mvvmcross/issues/215