forked from Coober-Ding/Xpatch
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
64 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,64 @@ | ||
# What is Xpatch | ||
|
||
Xpatch is a jar tool which is used to repackage the apk file. Then, the new apk can load any Xposed modules installed in the android system. | ||
|
||
This is a way to use Xposed modules without root your device. | ||
|
||
It is easy way to modify one app using xposed module. And any apps changed by Xpatch can load every modules downloaded in the [Xposed Module Repository](https://repo.xposed.info/). | ||
# Benefits | ||
1. Use xposed modules without your device; | ||
2. Modify any apps without root your device. | ||
|
||
# How to use | ||
1. Download the latest jar file from the [release page](https://github.com/WindySha/Xpatch/releases); | ||
2. Run this command in the Windows/Mac console: | ||
``` | ||
$ java -jar ../../xpatch.jar ../../source.apk | ||
``` | ||
Then, a new apk named `source-xposed-signed.apk` in the same folder as `source.apk`. | ||
|
||
# More commands | ||
1. You can specify the output apk path by add `-o` parameter, eg: | ||
``` | ||
$ java -jar ../../xpatch.jar ../../source.apk -o ../../dst.apk | ||
``` | ||
2. Show all the building new apk logs, just add `-l`, eg: | ||
``` | ||
$ java -jar ../../xpatch.jar ../../source.apk -l | ||
``` | ||
3. Not delete the build files, just add `-k`, eg: | ||
``` | ||
$ java -jar ../../xpatch.jar ../../source.apk -k | ||
``` | ||
4. After the version 1.2, craching app signature verifying is added, if you won't need the function, just add '-c', eg: | ||
``` | ||
$ java -jar ../../xpatch.jar ../../source.apk -c | ||
``` | ||
5. More command details can be found when no parameter is added, eg: | ||
``` | ||
$ java -jar ../../xpatch.jar | ||
``` | ||
|
||
|
||
# Todo list | ||
1. Support packaging the xposed modules into the source apk; | ||
2. Support loading so library in the xposed modules; | ||
3. Crach apk protections. | ||
|
||
# Issues | ||
1. If the apk dex files are protected, dex2jar can not effect on the dexs, then this tool will not work; | ||
2. The hook framework is using [whale](https://github.com/asLody/whale); this framework is not very stable, some hooks may fail; | ||
3. Do not support Davlik VM; | ||
4. Do not support resource hook; | ||
|
||
|
||
# Thanks | ||
- [Xposed][10] | ||
- [whale][11] | ||
- [dex2jar][12] | ||
- [AXMLPrinter2][13] | ||
|
||
[10]: https://github.com/rovo89/Xposed | ||
[11]: https://github.com/asLody/whale | ||
[12]: https://github.com/pxb1988/dex2jar | ||
[13]: https://code.google.com/archive/p/android4me/downloads |