Jak czytać raporty postępu dekompilacji

Procent ma znaczenie tylko z kontekstem: co policzono, dla jakiej kompilacji i kiedy. DecompHub zachowuje nazwę wskaźnika, zakres i źródło. Bez wiarygodnego pomiaru postęp pozostaje nieznany, a nie równy zeru.

Zgodność binarna a działanie

Dekompilacja typu matching ma odtworzyć kod generujący ten sam kod maszynowy co konkretna wersja oryginału. Liczą się kompilator i ustawienia, nie tylko źródła. FAQ decomp.me wyjaśnia porównywanie pojedynczych funkcji. Wynik funkcji nie jest procentem całej gry.

Zgodny zamiennik odtwarza zachowanie. ScummVM zastępuje pliki wykonywalne, korzystając z danych gier. Obsługa gry nie oznacza odsetka zgodnego kodu. Porty i badania sprzętu mogą być wartościowe bez takiego raportu.

Sprawdź mianownik

Raporty mogą liczyć funkcje, bajty, pliki, symbole lub rozpoznane zasoby. W hipotetycznym przykładzie 900 zgodnych funkcji na 1000 daje 90% według liczby funkcji. Jeśli pozostałe zawierają połowę bajtów kodu, wynik nie wynosi 90% według bajtów. To nie jest rzeczywisty pomiar z katalogu.

Sprawdź wskaźnik, jednostkę, zakres i źródło. Liczba bez udokumentowanej wartości całkowitej nie staje się procentem. Biblioteka, region i cały plik wykonywalny to różne zakresy.

objdiff dokumentuje narzędzia porównywania i raportowania. Samo użycie narzędzia nie określa konfiguracji ani mianownika wybranego przez projekt.

Oddziel wersje i zasoby

Gra może mieć wydania regionalne, rewizje i kompilacje debugowe. Ukończenie jednej nie dowodzi ukończenia pozostałych. Ocarina of Time opisuje wybór wersji docelowej.

Zgodność kodu i identyfikacja zasobów to osobne zadania. Ukończenie kodu nie oznacza zrozumienia każdej tekstury, dźwięku czy struktury danych. Nie uśredniaj wskaźników, chyba że autorzy definiują taką miarę łączną.

Rozróżniaj daty

Data raportu pochodzi od autora pomiaru. Data obserwacji oznacza moment odczytu przez DecompHub: świeży odczyt może dotyczyć starego wyniku. Pobranie metadanych lub edycja wpisu nie aktualizują samej miary.

Dokumentacja danych opisuje pola eksportu. Cytuj razem projekt, wskaźnik, zakres, URL i rodzaj daty.

Nie zgaduj brakujących wartości

Nieznany wynik może oznaczać nieobsługiwany format, niedostępną stronę, niejasny zakres lub nieukończoną kolekcję danych. Nie dowodzi braku pracy. Wartości ponad 100%, zmieniające się mianowniki i sprzeczne odznaki wymagają sprawdzenia, nie cichego poprawiania ani zastępowania gwiazdkami.

Przejrzyj projekty z pomiarami i porównuj równoważne dane. Błędy zgłaszaj z poziomu projektu, dołączając oryginalne źródło.