Migrate Vector to libxposed API 101 (Modern Interceptor Architecture) by JingMatrix · Pull Request #586 · JingMatrix/Vector

JingMatrix · 2026-03-23T09:36:57Z

This PR comprehensively upgrades the Vector framework to support the modern libxposed API 101, replacing the legacy before/after callback model with a robust, OkHttp-style interceptor chain architecture.

Moreover, we add serval minor improvements.

JingMatrix · 2026-03-23T13:57:34Z

@Spontini, @hyplant, @thoitiettxl-cyber, @DarthKnox,
@Fan-Bob, @AbdulrahmanAlamodi, @RinLin-NYA
Please start test the libxposed API 101 implementation of current CI build: ~~https://github.com/JingMatrix/LSPosed/actions/runs/23439889372~~ [buggy]

And attach logs if it is not working on you device with certain API 101 modules.

huynhbaman · 2026-03-23T14:13:53Z

@Spontini, @hyplant, @thoitiettxl-cyber, @DarthKnox,
@Fan-Bob, @AbdulrahmanAlamodi, @RinLin-NYA
Please start test the libxposed API 101 implementation of current CI build: https://github.com/JingMatrix/LSPosed/actions/runs/23439889372

And attach logs if it is not working on you device with certain API 101 modules.

Zygote crash, I remember it had already happened at the past

Dev4Mod · 2026-03-23T14:21:01Z

Here are the logs needed to fix the problem.

Dev4Mod · 2026-03-23T16:08:59Z

Compatibility with the legacy API has been broken. Another thing I noticed is that API 100 is still displayed in the manager, and I see the incompatibility message with API 101 in the modules.

AbdulrahmanAlamodi · 2026-03-23T17:46:04Z

@JingMatrix @huynhbaman

Modules with required 101 not working
Using latest build https://github.com/JingMatrix/LSPosed/actions/runs/23443759490

LSPosed_2026-03-23T20.zip

Things22 · 2026-03-23T18:17:43Z

@JingMatrix
android 16 crdroid 12.8 - oneplus9pro
api changed n homepage
modules not working
pls if there is something personal n logs, lemme know or delete this comment, i'm noob 50%🥲

dedLSPosed_2026-03-23T21_14_14.546616.zip
verboseLSPosed_2026-03-23T21_16_52.387809.zip

JingMatrix · 2026-03-23T18:43:26Z

The latest CI build should work now. I tested with Enable Screenshot v5.0.0.

Please continue to test and tell me if modules are working for you.

JingMatrix · 2026-03-24T09:50:25Z

@AbdulrahmanAlamodi Please test again the module punch-hole-download-progress, I am not sure if it can function for my devices.

If it once worked for you with old versions or LSPosed-it (so that the module itself is good), but not for Vector, please tell us.

Found a bug, fixing...

Dev4Mod · 2026-03-24T11:09:04Z

@Things22 ~~io.github.zensu357.camswap~~(I made a typo) is built with API 100, and API 101 cannot support API 100 modules.
Please avoid pasting AI content, I will use AI if I do need it.

I will investigate more about WppEnhancer error on your device:
[ 2026-03-24T06:29:20.954 10590: 8492: 8492 E/XSharedPreferences ] tryRegisterWatcher: access denied to /data/misc/1cdc73f5-4c90-4458-94cf-6b3c9a393318/prefs/com.wmods.wppenhacer/com.wmods.wppenhacer_preferences.xml
@Dev4Mod Is this log normal for your module ?

This has always appeared but has no impact on the module's operation.

- Split classloader hooking to correctly implement API 101 lifecycle phases and prevent AppComponentFactory <clinit> evasion. - Hook LoadedApk.createAppFactory to dispatch onPackageLoaded immediately before factory instantiation (API 29+). - Hook LoadedApk.createOrUpdateClassLoaderLocked to dispatch onPackageReady after the custom classloader is fully initialized. - Cache reflection targets using lazy delegates to eliminate redundant lookups during classloader updates.

AbdulrahmanAlamodi · 2026-03-24T16:42:33Z

@JingMatrix everything works fine now on the latest build

These are additional logs if needed
working logs.zip

It is said as we have spent time to improve it. Now it is better to use third party library for module developers

CoelacanthusHex · 2026-03-24T19:29:56Z

Does it no longer support legacy modules? I try to install from CI, all api 101 modules I used work well, but the legacy module https://github.com/RichardLuo0/global-icon-pack-android does not work.

JingMatrix · 2026-03-24T20:04:30Z

@CoelacanthusHex No, legacy APIs will always be supported, please upload your debug logs to help locating the issue.

JingMatrix · 2026-03-24T21:33:40Z

~~Confirm that release build is not working, while debug build works.~~ Fixed now

In general, it will be stealthier to use randomized names.

CoelacanthusHex · 2026-03-25T09:41:59Z

Vector seems will stuck in infinitely recursive,

03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.connect(VectorURLStreamHandler.kt:67)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.getJarFile(VectorURLStreamHandler.kt:75)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.connect(VectorURLStreamHandler.kt:67)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.getJarFile(VectorURLStreamHandler.kt:75)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.connect(VectorURLStreamHandler.kt:67)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.getJarFile(VectorURLStreamHandler.kt:75)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.connect(VectorURLStreamHandler.kt:67)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.getJarFile(VectorURLStreamHandler.kt:75)
03-25 17:07:55.940  6897  6897 E Vector  :  at org.matrix.vector.impl.utils.VectorURLStreamHandler$ClassPathURLConnection.connect(VectorURLStreamHandler.kt:67)

Something function calls ClassPathURLConnection.connect().
In ClassPathURLConnection.connect(), jarFile resolves to this.getJarFile() (the abstract getter from java.net.JarURLConnection, implemented by ClassPathURLConnection)
ClassPathURLConnection.getJarFile() calls connect()
In connect(), connected is still false (not yet set) → calls jarFile -> getJarFile() again
drop into infinite loop

CoelacanthusHex · 2026-03-25T10:08:22Z

xposed/src/main/kotlin/org/matrix/vector/impl/utils/VectorURLStreamHandler.kt

+        override fun connect() {
+            check(!isClosed) { "JarURLConnection has been closed" }
+            if (!connected) {
+                jarEntry =
+                    jarFile.getEntry(entryName)
+                        ?: throw FileNotFoundException("URL=$url, zipfile=${jarFile.name}")
+                connected = true
+            }
+        }
+


Suggested change

override fun connect() {

check(!isClosed) { "JarURLConnection has been closed" }

if (!connected) {

jarEntry =

jarFile.getEntry(entryName)

?: throw FileNotFoundException("URL=$url, zipfile=${jarFile.name}")

connected = true

}

}

override fun connect() {

check(!isClosed) { "JarURLConnection has been closed" }

if (!connected) {

jarEntry =

this@VectorURLStreamHandler.jarFile.getEntry(entryName)

?: throw FileNotFoundException("URL=$url, zipfile=${this@VectorURLStreamHandler.jarFile.name}")

connected = true

}

}

Maybe we can let connect() access VectorURLStreamHandler.jarFile directly, just like the way in getJarFile(), so we can bypass the connect() call when accessing it through getJarFile() to avoid infinite recursion. I tested it on my device, and the issue disappeared.

That is correct, thanks for the suggestion !

Things22 · 2026-03-26T09:36:59Z

hi @JingMatrix
thanox not working
logs:

thanoxLSPosed_2026-03-26T12_34_18.631214.zip

thanks

JingMatrix · 2026-03-26T11:34:33Z

@Things22 Thanox is not written in API 101.

Things22 · 2026-03-26T12:09:33Z

@Things22 Thanox is not written in API 101.

oh, ok, but i didnt see any warining n vector manager
also, i thought both 100&101 are supported idk
thank u for the info

JingMatrix · 2026-03-26T14:43:45Z

@Things22 See my explanation here #587 (comment)

lsfqxd2006 · 2026-03-28T15:16:34Z

XposedSmsCode Release: v3.2.4 api101
Hide My Applist v3.6.1 r462 leagey
上述两个模块不起作用
Uploading LSPosed_2026-03-28T23_15_28.180358.zip…

JingMatrix added 15 commits March 22, 2026 10:22

Implement libxposed 101

e5d1566

Refactor Java layer implementations into Kotin

18ca366

Delete old java implementations

ba75f92

Fix VectorContext implements

0e46709

Rename classes to compile core module

05f29a7

Adapt changes into zygisk module

e80a908

Fix crashes during testing

675dc5a

Allow multiple chain proceeding

5a2a34a

Avoid depending on dummy class

58812c4

Fix class resolution errors

f7bb788

Fix typo

dbf1f4d

Debug manager

059a0f7

Fix resolveActivity hook

f461953

Add docs in README

83bcda1

Minor fixes

7479987

JingMatrix force-pushed the 101 branch from 8add75c to 7479987 Compare March 23, 2026 09:46

Refactor core module into legacy

bdd7c3b

Moreover, we add serval minor improvements.

JingMatrix marked this pull request as ready for review March 23, 2026 13:52

Fix typos and disable DexParserBridge

6862c5f

JingMatrix added 2 commits March 23, 2026 18:00

Handle exceptions gracefully

2dcf376

Fix comments

7f549c4

First step of updating service to API 101

99f6e95

Adapt constructor changes in API 101

38f6d73

Add debugging logs

377da0b

JingMatrix mentioned this pull request Mar 24, 2026

LSPosed Manager crashes on startup #591

Closed

1 task

JingMatrix added 2 commits March 24, 2026 18:21

Completely remove dexparser

93eabcc

It is said as we have spent time to improve it. Now it is better to use third party library for module developers

Trigger onPackageReady for split APKs

77f8e5b

This was referenced Mar 24, 2026

module not working com.leohearts.alternativeUnlockHook #592

Closed

Odd update notification on 1.11.0 #593

Closed

JingMatrix added 4 commits March 24, 2026 23:12

Fix release build issue

f767241

Reduce detection surface for injected target

630db98

Customize generated class and source names of hooks

06cc4f8

In general, it will be stealthier to use randomized names.

Add missing log utils

d691000

CoelacanthusHex reviewed Mar 25, 2026

View reviewed changes

Fix class loader

5918019

JingMatrix force-pushed the 101 branch from b125fb9 to 5918019 Compare March 25, 2026 11:02

[skip ci] fix docs

492aa66

JingMatrix merged commit a7d97a6 into master Mar 26, 2026

JingMatrix mentioned this pull request Mar 29, 2026

Xposedsmscode app bug #578

Closed

1 task

hxreborn mentioned this pull request Apr 5, 2026

Xposed API migration breaks the module under LSPosed JingMatrix latest version, and there are no forks that have Closed API 101 hxreborn/punch-hole-download-progress#56

Closed

Conversation

JingMatrix commented Mar 23, 2026

Uh oh!

JingMatrix commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

huynhbaman commented Mar 23, 2026

Uh oh!

Dev4Mod commented Mar 23, 2026

Uh oh!

Dev4Mod commented Mar 23, 2026

Uh oh!

AbdulrahmanAlamodi commented Mar 23, 2026

Uh oh!

Things22 commented Mar 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

JingMatrix commented Mar 23, 2026

Uh oh!

JingMatrix commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Dev4Mod commented Mar 24, 2026

Uh oh!

AbdulrahmanAlamodi commented Mar 24, 2026

Uh oh!

CoelacanthusHex commented Mar 24, 2026

Uh oh!

JingMatrix commented Mar 24, 2026

Uh oh!

JingMatrix commented Mar 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

CoelacanthusHex commented Mar 25, 2026

Uh oh!

CoelacanthusHex Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

JingMatrix Mar 25, 2026

Choose a reason for hiding this comment

Uh oh!

Things22 commented Mar 26, 2026

Uh oh!

JingMatrix commented Mar 26, 2026

Uh oh!

Things22 commented Mar 26, 2026

Uh oh!

JingMatrix commented Mar 26, 2026

Uh oh!

lsfqxd2006 commented Mar 28, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

JingMatrix commented Mar 23, 2026 •

edited

Loading

Things22 commented Mar 23, 2026 •

edited

Loading

JingMatrix commented Mar 24, 2026 •

edited

Loading

JingMatrix commented Mar 24, 2026 •

edited

Loading