Vector README

The project's README from github.com/JingMatrix/Vector. As one markdown file: README.md.

Vector Framework

A high-performance ART hooking framework for modern Android

Build Crowdin Download Total


Introduction

Vector is a Zygisk module providing an ART hooking framework that maintains API consistency with the original Xposed. It is engineered on top of LSPlant to deliver a stable, native-level instrumentation environment.

The framework allows modules to modify system and application behavior in-memory. Because no APK files are modified, changes are non-destructive, easily reversible via reboot, and compatible across various ROMs and Android versions.


Compatibility

Vector supports devices running Android 8.1 through Android 17 Beta.

[!TIP] This framework requires a recent installation of Magisk or KernelSU with Zygisk enabled.


Installation

  1. Download the latest release as a system module.
  2. Install the module via your root manager (Magisk/KernelSU).
  3. Ensure a Zygisk environment (e.g., NeoZygisk).
  4. Reboot the device.
  5. Access management settings via the system notification.

Downloads

Channel Source
Stable Releases GitHub Releases
Canary (CI) Builds GitHub Actions

[!NOTE] Debug builds are recommended for users encountering issues or performing troubleshooting. We encourage users to test CI builds to help us identify bugs and accelerate development.

[!CAUTION] GitHub requires users to be logged in to download CI artifacts.

The link above is filtered to show only master branch builds. Please note that builds from Pull Requests (PRs) are often unstable and potentially unsafe (depending on the authors); we recommend staying on the master branch for verified builds, unless you are asked to help our debugging sessions.


Support and Contribution

If you encounter issues or wish to help improve the project, please refer to the resources below.

[!IMPORTANT] Bug reports are only accepted if they are based on the latest debug build.

Notice for Chinese speakers:

为了提高沟通效率,本项目仅接受英文 Issue。请使用 DeepL 或其他翻译工具提交您的反馈。


Developer Resources

Vector supports both legacy and modern hooking standards to ensure broad module compatibility.

[!NOTE] Vector supports the libxposed API via two git submodules: the module API and the service API.

A successful GitHub Actions build of the master branch indicates that Vector fully supports these APIs at those specific commits. Developers are suggested to check out the same commits as Vector.


Credits

This project is made possible by the following open-source contributions:

Legacy and Historical Dependencies

License

Vector is licensed under the GNU General Public License v3.

Vector (JingMatrix/Vector)

Searching Database…

12.8K ·GitHub
这是什么东西?Vector 是一个面向现代 Android 的高性能 ART hook 框架。它以 Zygisk 模块的形式发布,并保持与原版 Xposed 相同的 API,因此 Xposed 风格的模块在现在的设备上依然可以正常使用。
所以它不是普通应用——我到底要安装什么?安装的是一个系统模块:你下载一个 release zip 包,然后通过 Magisk 或 KernelSU 这类 root 管理器刷入。重启之后,它就充当一个框架,在设备上运行 Xposed 风格的模块。
怎么在我手机上把它跑起来?用你的 root 管理器安装下载好的模块,确保设备上有 Zygisk 环境(比如 NeoZygisk),然后重启,之后你会通过一条系统通知找到它的管理设置入口。
我的手机必须 root 吗?是的。Vector 需要较新版本的 Magisk 或 KernelSU,并且启用 Zygisk——没有 root 的话,它就没有可以 hook 的对象。
如果某个模块把系统搞坏了,我能撤销吗?可以——没有任何改动是永久性的。模块只在内存中修改运行行为,不会碰任何 APK 文件,重启一次就全部恢复原样,而且框架在各种 ROM 和 Android 版本上都能保持兼容。
它支持哪些 Android 版本?从 Android 8.1 一直到 Android 17 Beta——覆盖范围很广,老设备和新出的测试版都能用。
我现有的 Xposed 模块还能用吗?这正是它的目标:Vector 同时支持旧版 Xposed API 和现代的 libxposed API(以 git 子模块的形式接入),力求兼容整个 Xposed 生态中的大量模块。
运行在 Vector 上的模块究竟能做什么?它们会 hook 进 Android 运行时(ART),在内存中修改系统和应用的行为。具体改成什么样取决于每个模块本身;Vector 提供的是构建在 LSPlant 之上的稳定、原生层面的 hook 层。
Vector 和 LSPosed 是什么关系?LSPosed——以及更早的 EdXposed——都被列为上游来源,而且 hook 功能由 LSPlant 驱动,正是同一个核心 ART hook 引擎。Vector 本质上是这一脉络的现代延续,以独立 Zygisk 模块的形式存在。
稳定版还是 CI canary——我该下载哪个构建?先用 GitHub Releases 上的稳定版。CI canary 构建是供测试用的,下载需要登录 GitHub;Pull Request 构建往往不稳定,甚至可能有风险,所以请留在 master 分支上。排查问题时请使用 debug 构建——bug 反馈只接受针对最新 debug 构建的报告。
Creator
JingMatrix
Size
24.9 MB
Stars
12.8K
Age
3y
Commits · 90 Days