Udostępnij za pośrednictwem


Współtworzenia projektu World Locking Tools for Unity

Najbardziej cennym sposobem współtworzenia projektu World Locking Tools w tej chwili jest zgłaszanie problemów. Każda opinia na temat lepszego dopasowania projektu World Locking Tools for Unity do potrzeb projektu projektu jest niezwykle cenna.

Chociaż wszelkie opinie, które publikujesz, są cenne, oto kilka wskazówek dotyczących zwiększenia możliwości działania.

Odpowiednie używanie etykiet

Zarówno podczas początkowego przesyłania problemu, jak i podczas wykonywania czynności w związku z problemem jako współautor, odpowiednie używanie etykiet jest niezwykle przydatne podczas koordynowania z innymi współautorami.

Staraj się dokładnie rozróżniać, co to jest usterka, co to jest żądanie funkcji i jaka jest szersza sugestia w przyszłości. Wszystkie są cenne, ale są one bardziej cenne po zidentyfikowaniu jako takie.

Podobnie, jeśli problem wydaje się nie do zastosowania w bieżącej formie, zastosowanie odpowiedniej etykiety (na przykład "niejasne") może pomóc w ulepszeniu go w miejscu, w którym można wykonywać działania. Konkretne komentarze w samej kwestii są oczywiście bardzo cenne. Jednak właściwa etykieta może prowadzić inne osoby do wyświetlenia komentarza, który w przeciwnym razie może być niezauważony.

Zgłaszanie usterki

Problemy można przesłać z portalu problemów w witrynie GitHub. Pośmiń czas na zgłoszenie problemu lub sugestię, że inni skorzystają z nich, a także zawsze są doceniane.

Każdy raport o usterce ma swój własny kontekst, ale ogólnie rzecz biorąc, tym więcej z poniższych informacji jest uwzględnianych, tym szybciej można rozwiązać problem.

Pliki dziennika z urządzenia

Pliki dziennika z urządzenia mogą być niezmiennie pomocne podczas badania problemów, szczególnie w połączeniu z przechwytywaniem ekranu sugerowanym poniżej. Można je uzyskać przy użyciu portalu urządzeń z systemem Windows podczas nawiązywania połączenia z urządzeniem w obszarze Foldery użytkowników Eksploratora > plików systemu > \ LocalAppData \ WorldLockingTools

Plik dziennika aplikacji Aparatu Unity

UnityPlayer.log znajduje się w podfolderze TempState. Jest to plik w postaci zwykłego tekstu.

Nagranie diagnostyczne narzędzi world locking Tools

Plik diagnostyczny znajduje się w podfolderze LocalState . Nazwa pliku jest generowana automatycznie zgodnie z następującym wzorcem:

FrozenWorld-<device name>-<capture date and time>.hkfw

Jest to plik binarny, który wymaga wyspecjalizowanego oprogramowania do zbadania.

Należy pamiętać, że zarejestrowanie nagrania diagnostycznego wymaga włączenia rejestrowania diagnostycznego w składniku World Locking Tools Manager w scenie. Szczegółowe informacje można znaleźć w dokumentacji diagnostyki .

Kroki ponownego odtworzenia

Określ, jak łatwo występuje problem. Idealnym rozwiązaniem jest usterka, która występuje 100% czasu po określonym zestawie kroków. Ale nawet w przypadku usterki, która wystąpiła tylko raz, tym bardziej szczegółowe można powiązać kroki prowadzące do problemu, tym lepiej.

Kroki odtworzenia powinny być wykonywane w następującym ogólnym formularzu:

  1. Począwszy od tego normalnego stabilnego stanu...
  2. Potem to zrobiłem (lub zauważyłem tę niezwykłą rzecz)...
  3. Następnie system zaczął wyświetlać to nieprawidłowe zachowanie...

Zrzuty ekranu

Przechwytywanie ekranu pomoże zidentyfikować pełny kontekst, w ramach którego wystąpił problem. W szczególności wyświetlenie diagnostyki narzędzia world locking Tools na ekranie może pomóc skorelować środowisko z informacjami w dziennikach. Przechwytywanie ekranu może być obrazami migawek lub przechwytywaniem wideo.

Informacje o urządzeniu

  • Jakiego typu urządzenie?
  • Uruchamianie jakiej wersji systemu operacyjnego?

Środowisko kompilacji

  • Wersja aparatu Unity
  • Wersja programu Visual Studio

Proponowanie funkcji

Gdy okaże się, że narzędzia World Locking Tools prawie robią to, czego potrzebujesz, prawdopodobieństwo, że ktoś inny cierpi na to samo ograniczenie. Jesteśmy tak samo zainteresowani rozwiązaniem luk w naszej dokumentacji i przykładach, jak w przypadku zapewniania nowych możliwości.

Proponując nową funkcję, najbardziej cenną jest, aby wyjaśnić, co to jest próba wykonania. Podczas gdy pomysły na jego wdrożenie mogą być również pomocne, propozycje, które jasno określą wartość dodaną, są bardziej skłonne do uzyskania trakcji. Rozwiąż problem, który funkcja rozwiązuje, najlepiej z tym, co można osiągnąć w rzeczywistym scenariuszu.

Pamiętaj, aby dołączyć etykietę "ulepszenia" do przesłanego problemu z propozycją.

Współtworzenia kodu

Jest to projekt open source, więc oczywiście każdy może utworzyć rozwidlenie do opracowania w dowolnym momencie. Jeśli ktoś jest wystarczająco hojny, aby udostępnić z powrotem pracę, to jest bardzo doceniane, czy jest składany z powrotem do głównego repozytorium, czy nie.

W tym początkowym okresie wdrażania będziemy mieli ograniczone zasoby do przeglądania i akceptowania żądań ściągnięcia do głównego repozytorium. Zaleca się unikanie inwestowania dużo czasu w rozwidlenie przy założeniu, że zostanie on scalony z powrotem do głównego repozytorium.

Jednym ze sposobów ograniczenia ryzyka jest przesłanie problemu proponując to, co jest zamierzone (oznaczone etykietą "ulepszenie"), zanim zainwestuje dużo czasu w implementację. Jest to również uwzględniane w stosunku do innych współautorów, którzy mogą przyjrzeć się temu samemu obszarowi problemu.

Zobacz też

Proces wydawaniakonwencji kodowania