create readme English version
This commit is contained in:
parent
2d49f3899f
commit
6ec0f3c161
|
|
@ -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
|
||||
Loading…
Reference in New Issue