Skip to content

How to contribute

Ricardo Fernández Serrata edited this page Sep 12, 2024 · 8 revisions

There is a lot of packages descriptions to improve. Some can be slightly incorrect and some are nearly nonexistent. You know what you have to do! :)

You can also add new packages :

  1. All non documented packages can be displayed by selecting the unlisted filter.

  2. Try to document each new package and create a pull request (please read this first) or create an issue.

The UAD-ng list is a JSON list that can be found here.

A package is defined like this:

"com.google.mainline.telemetry": {
    "list": "Google",
    "description": "First line of the a description\nThis is a new line",
    "dependencies": null,
    "neededBy": null,
    "labels": null,
    "removal": "Unsafe"
},

dependencies, neededBy and labels are fields which will most likely change in the near future (for the v0.6 or v0.7).

  • list: can be Google, Misc (miscellaneous), Oem (manufacturer), Aosp, Pending, Carrier (isp).
  • removal: can be Recommended, Advanced, Expert, Unsafe (see more)

Decompile an APK

Extracting packages

Connecting your device (using a cable)

  1. Download ADB from here, unzip it and open a terminal in the ADB folder
  2. Enable and go to developer options (Settings -> about -> 4 taps on build info) on your phone
  3. Enable USB debugging
  4. In the terminal you opened before type adb devices
  5. Now accept the pop-up on your device

Connecting your device (using Wireless ADB)

Listing packages (using a cable)

  1. To list all the packages on the phone type adb shell pm list packages
  2. Let's say there's a package you need to extract, type adb shell pm path com.test
  3. You'll get something like package:/odm/overlay/test.apk
  4. You delete the package: part and copy the rest, so for example /odm/overlay/test.apk
  5. Now you take the APK from the device by adb pull /odm/overlay/test.apk
  6. Finally, you have the APK file on your PC (in the folder where you opened your terminal)

Listing packages (using Wireless ADB)

Note: if you only connected to one device there's no need to keep using -s [IP address]

  1. To list all the packages on the phone type adb -s 192.168.1.10 shell pm list packages
  2. Let's say there's a package you need to extract, type adb -s 192.168.1.10 shell pm path com.test
  3. You'll get something like package:/odm/overlay/test.apk
  4. You delete the package: part and copy the rest, so for example /odm/overlay/test.apk
  5. Now you take the APK from the device by adb -s 192.168.1.10 pull /odm/overlay/test.apk
  6. Finally, you have the APK file on your PC (in the folder where you opened your terminal)

Useful apps

Useful online services