[Please read this guide first]: How to troubleshoot Vector?

[JingMatrix]

Is your feature request related to a problem?/你的请求是否与某个问题相关？

Many users frequently encounter similar issues, which can actually be solved by their own, but there isn't an official guide to do so.

Describe the solution you'd like/描述你想要的解决方案

Under current feature request, users are allowed to request common troubleshoot routines and the maintainers should provide pratical instructions and references.

[JingMatrix]

Before we start the troubleshooting

1. Please flash the debug version of the latest CI build in GitHub Actions, which could have fixed the problem for you. Moreover, debug logs are necessary for maintainers to provide their helps. However, make sure that you pick up builds from the master branch instead of some working-in-progress pull-requests.
2. For non-Magisk users, please flash the latest Zygisk module (debug version if possible), such as NeoZygisk, ReZygisk or ZygiskNext.

Status notification for Vector manger is not shown

Update your root manager (Magisk / KernelSU) and use the Action button to open Vector manger

Vector manger cannot be opened

1. Grant root permission to the system Shell(com.android.shell) application.
2. Install Vector manger as a user application using the following command:

adb shell su -c cp /data/adb/modules/zygisk_vector/manager.apk /data/local/tmp && adb pull /data/local/tmp/manager.apk && adb install ./manager.apk

3. Open manager as a normal application from your launcher.
4. If the manager is not functioning, you can alternatively use the cli tool /data/adb/lspd/cli.

How to provide useful logs before asking helps?

1. Please go through the previous instructions to open Vector manager successfully, and upload the generated logs in your issue if it is working.
2. Vector manager will automatically save logs of the previous user session. Taking good advantage of the feature can help maintainers to find out a specific bug introduced in some single commit.
3. Even when Zygisk is crashed for some reason, Vector can still save some logs via its daemon, to pull them, run

adb shell "su -c 'cat /data/adb/lspd/log/verbose_* > /data/local/tmp/lsposed_verbose.log && chown shell:shell /data/local/tmp/lsposed_verbose.log'" && adb pull /data/local/tmp/lsposed_verbose.log

4. Alternatively, you may simply upload the folder /data/adb/lspd/log as logs.