-
-
Notifications
You must be signed in to change notification settings - Fork 748
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
1 parent
6f2ca5b
commit d9ab820
Showing
11 changed files
with
235 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
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,16 @@ | ||
# πΌ Prerequisites | ||
|
||
In order to use ReVanced Manager, certain requirements must be met. | ||
|
||
## π€ Requirements | ||
|
||
- An Android device running Android 8 or higher | ||
- Any device architecture except ARMv7[^1] | ||
|
||
[^1]: This constraint only applies to patches, that require patching APK resources which is why some patches may or may not work on ARMv7 architecture. You can find out, which architectures your device supports here: [βοΈ Configuring ReVanced Manager](2_4_settings.md#%E2%84%B9%EF%B8%8F-about). | ||
|
||
## βοΈ What's next | ||
|
||
The next page will guide you through patching an app. | ||
|
||
Continue: [β¬οΈ Installation](1_installation.md) |
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,14 @@ | ||
# β¬οΈ Installation | ||
|
||
In order to use ReVanced on your Android device, ReVanced Manager must be installed. | ||
|
||
## β Installation steps | ||
|
||
1. Download the latest version of ReVanced Manager from [here](https://github.com/revanced/revanced-manager/releases/latest) | ||
2. Install ReVanced Manager | ||
|
||
## βοΈ What's next | ||
|
||
The next page will guide you through using ReVanced Manager. | ||
|
||
Continue: [π οΈ Usage](2_usage.md) |
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,13 @@ | ||
# 𧩠Patching apps | ||
|
||
The following pages will guide you through using ReVanced Manager to patch apps. | ||
|
||
## β Steps to patch apps | ||
|
||
> TODO | ||
## βοΈ What's next | ||
|
||
The next page will bring you back to the usage page. | ||
|
||
Continue: [π οΈ Usage](2_usage.md) |
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,13 @@ | ||
# π§° Managing patched apps | ||
|
||
After patching an app, you may want to manage it. This page will guide you through managing patched apps. | ||
|
||
## β Steps to manage patched apps | ||
|
||
> TODO | ||
## βοΈ What's next | ||
|
||
The next page will bring you back to the usage page. | ||
|
||
Continue: [π οΈ Usage](2_usage.md) |
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,13 @@ | ||
# π Updating ReVanced Manager | ||
|
||
In order to keep up with the latest features and bug fixes, it is recommended to keep ReVanced Manager up to date. | ||
|
||
## β Updating steps | ||
|
||
> TODO | ||
## βοΈ What's next | ||
|
||
The next page will bring you back to the usage page. | ||
|
||
Continue: [π οΈ Usage](2_usage.md) |
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,39 @@ | ||
# βοΈ Configuring ReVanced Manager | ||
|
||
ReVanced Manager has settings that can be configured to your liking. | ||
|
||
## β Essential settings | ||
|
||
- ### π API URL | ||
|
||
Specify the URL of the API to use. This is used to fetch ReVanced Patches and update ReVanced Manager. | ||
|
||
- ### 𧬠Sources | ||
|
||
Override the API and change the source of ReVanced Patches. | ||
|
||
- ### π§ͺ Experimental ReVanced Patches support | ||
|
||
Lift app version constraints from ReVanced Patches. This allows you to patch any version of an app, even if the patch is not explicitly compatible with it. | ||
|
||
- ### π§βπ¬ Experimental universal support | ||
|
||
This will show or hide ReVanced Patches, which are not meant for any app in particular but rather for all apps but may not work on all apps. | ||
|
||
- ### π Export, import or delete keystore | ||
|
||
Manage the keystore used to sign patched apps. | ||
|
||
- ### π Export, import or reset ReVanced Patches selection | ||
|
||
Manage the ReVanced Patches selection. This is useful if you want to share your ReVanced Patches selection with others or reset it to the default selection. | ||
|
||
- ### βΉοΈ About | ||
|
||
View information about your device and ReVanced Manager. This includes the version of ReVanced Manager and supported architectures of your device. | ||
|
||
## βοΈ What's next | ||
|
||
The next page will bring you back to the usage page. | ||
|
||
Continue: [π οΈ Usage](2_usage.md) |
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,16 @@ | ||
# π οΈ Usage | ||
|
||
The following pages will guide you through using ReVanced Manager to patch apps, manage patched apps, and update ReVanced Manager. | ||
|
||
## π Table of contents | ||
|
||
1. [𧩠Patching apps](2_1_patching.md) | ||
2. [π§° Managing patched apps](2_2_managing.md) | ||
3. [π Updating ReVanced Manager](2_3_updating.md) | ||
4. [βοΈ Configuring ReVanced Manager](2_4_settings.md) | ||
|
||
## βοΈ What's next | ||
|
||
The next page will guide you through troubleshooting ReVanced Manager. | ||
|
||
Continue: [β Troubleshooting](3_troubleshooting.md) |
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,31 @@ | ||
# β Troubleshooting | ||
|
||
In case you encounter any issues while using ReVanced Manager, please refer to this page for possible solutions. | ||
|
||
- π Patching fails with an error | ||
|
||
Make sure ReVanced Manager is up to date by following [π Updating ReVanced Manager](2_3_updating.md) and select the **Default** button when choosing patches. | ||
|
||
- π₯ App not installed as package conflicts with an existing package | ||
|
||
An existing installation of the app you're trying to patch is conflicting with the patched app. Uninstall the existing app before installing the patched app. | ||
|
||
- βοΈ Error code `135`, `139` or `1` when patching the app | ||
|
||
Your device is not supported. Refer to the [Prerequisites](0_prerequisites.md) page for supported devices. | ||
|
||
Alternatively, you can use [ReVanced CLI](https://github.com/revanced/revanced-cli) to patch the app. | ||
|
||
- π« Non-root install is not possible with the current patches selection | ||
|
||
Select the **Default** button when choosing patches. | ||
|
||
- π¨ Patched app crashes on launch | ||
|
||
Select the **Default** button when choosing patches. | ||
|
||
## βοΈ What's next | ||
|
||
The next page will teach you how to build ReVanced Manager from source. | ||
|
||
Continue: [π¨ Building from source](4_building.md) |
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,38 @@ | ||
# π οΈ Building from source | ||
|
||
This page will guide you through building ReVanced Manager from source. | ||
|
||
1. Download Java SDK 17 ([Azul JDK](https://www.azul.com/downloads/?version=java-17-lts&package=jdk#zulu) or [OpenJDK](https://jdk.java.net/java-se-ri/17)) and add it to path | ||
|
||
2. Clone the repository | ||
|
||
```sh | ||
git clone https://github.com/revanced/revanced-manager.git && cd revanced-manager | ||
``` | ||
|
||
3. Create a GitHub personal access token with the `read:packages` scope [here](https://github.com/settings/tokens/new?scopes=read:packages&description=ReVanced) | ||
|
||
4. Add your GitHub username and the token to `~/.gradle/gradle.properties` | ||
|
||
```properties | ||
gpr.user = YourUsername | ||
gpr.key = ghp_longrandomkey | ||
``` | ||
|
||
5. Set the `sdk.dir` property in `local.properties` to your Android SDK location | ||
|
||
```properties | ||
sdk.dir = /path/to/android/sdk | ||
``` | ||
|
||
6. Build the APK | ||
|
||
Debug: | ||
```sh | ||
./gradlew assembleDebug | ||
``` | ||
|
||
Release: | ||
```sh | ||
./gradlew assembleRelease -Psign | ||
``` |
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,21 @@ | ||
# π ReVanced Manager | ||
|
||
This documentation explains how to use [ReVanced Manager](https://github.com/revanced/revanced-manager). | ||
|
||
## π Table of contents | ||
|
||
0. [πΌ Prerequisites](0_prerequisites.md) | ||
1. [β¬οΈ Installation](1_installation.md) | ||
2. [π οΈ Usage](2_usage.md) | ||
1. [𧩠Patching apps](2_1_patching.md) | ||
2. [π§° Managing patched apps](2_2_managing.md) | ||
3. [π Updating ReVanced Manager](2_3_updating.md) | ||
4. [βοΈ Configuring ReVanced Manager](2_4_settings.md) | ||
3. [β Troubleshooting](3_troubleshooting.md) | ||
4. [π¨ Building from source](4_building.md) | ||
|
||
## βοΈ Start here | ||
|
||
The next page will tell you about the prerequisites for using ReVanced Manager. | ||
|
||
Continue: [πΌ Prerequisites](0_prerequisites.md) |