Tutorial/Guide on how to use this?

sfPlayer1 / Matcher

Tool for tracking elements in obfuscated Java archives across releases

GNU General Public License v3.0

75 stars 41 forks source link

Tutorial/Guide on how to use this? #38

Open GavinRay97 opened 1 year ago

GavinRay97 commented 1 year ago

Really useful tool -- thanks for writing it! However, it would be great if there was some documentation on how to use it.

I imagine the most common usecase is something like:

Import .jar/directory of .jars from <original>
Import .jar/directory of .jars from <modified>
Display a pretty diff of the modified methods and classes

I've managed to figure out how to import two .jars but I'm not really sure how to view only the differences.

sfPlayer1 commented 1 year ago

It is not so much a diff tool (doesn't even have a proper diff view) but for finding common parts between obfuscated jars. Tools like Proguard assign random names to everything so a minor update may look completely different, Matcher tries to undo this so 3rd party work against the old jar can be ported to the new jar without starting over.

GavinRay97 commented 1 year ago

Ah okay thank you -- that's slightly different from my specific usecase where the source code is 99% the same between the .jar's but there are a few .class-files with manual patches that I'm trying to understand.

Appreciate the response (and still think it'd be useful to have some general documentation/screenshot tutorials) 👍