From f14b697769c42e3b354d0f1b33412ff7e024531f Mon Sep 17 00:00:00 2001 From: validcube Date: Sat, 21 Oct 2023 22:43:40 +0700 Subject: [PATCH] docs: part 7 Co-authored-by: Ushie --- CONTRIBUTING.md | 16 ++++++++-------- README.md | 15 ++++++++------- docs/0_prerequisites.md | 3 +++ docs/1_installation.md | 3 +++ docs/2_1_patching.md | 3 +++ docs/2_2_managing.md | 3 +++ docs/2_3_updating.md | 3 +++ docs/2_4_settings.md | 10 ++++++++++ docs/2_usage.md | 3 +++ docs/3_troubleshooting.md | 6 ++++++ docs/README.md | 5 ++++- docs/developers/0_preparation.md | 8 +++----- docs/developers/1_overview.md | 8 ++++---- docs/developers/README.md | 2 +- 14 files changed, 62 insertions(+), 26 deletions(-) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index cca63330..0f460900 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -48,24 +48,24 @@ This document describes how to contribute to ReVanced Manager. ## ๐Ÿ“– Resources to help you get started * The [documentation](/docs/README.md) provides steps to build ReVanced Manager from source -* [Our backlog](https://github.com/orgs/ReVanced/projects/12) is where we keep track of what we're working on +* Our [backlog](https://github.com/orgs/ReVanced/projects/12) is where we keep track of what we're working on * [Issues](https://github.com/ReVanced/revanced-manager/issues) are where we keep track of bugs and feature requests ## ๐Ÿ™ Submitting a feature request Features can be requested by opening an issue using the -[Feature request issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=feature-request&projects=&template=feature-issue.yml&title=feat%3A+%3Ctitle%3E). +[feature request issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=feature-request&projects=&template=feature-issue.yml&title=feat%3A+%3Ctitle%3E). > [!NOTE] -> We may rejected your request at the discretion of maintainers, -> please provides good motivation for a request to be accepted. +> We may reject your request at the discretion of ReVanced Manager's maintainers, +> please provide good motivation for a request to be accepted. ## ๐Ÿž Submitting a bug report If you encounter a bug while using the ReVanced Manager app, open an issue using the -[Bug report issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=bug&projects=&template=bug-issue.yml&title=bug%3A+%3Ctitle%3E). +[bug report issue template](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=bug&projects=&template=bug-issue.yml&title=bug%3A+%3Ctitle%3E). ## ๐Ÿ“ How to contribute > [!NOTE] -> It's worth noting that we recommended that you discuss your changes with +> It's worth noting that we recommend that you discuss your changes with > the maintainers of ReVanced Manager before contributing. > This will help you determine whether your change is acceptable. @@ -77,7 +77,7 @@ If you encounter a bug while using the ReVanced Manager app, open an issue using Once your pull request is approved and merged, it will be included in the next release of ReVanced Manager ## ๐Ÿคš I want to contribute but don't know how to code -Even if you don't know how to code, you can still help us by -translate the ReVanced Manager application at [Crowdin](https://translate.revanced.app/). +Even if you don't know how to code, you can still contribute by +translating the ReVanced Manager application on our [Crowdin](https://translate.revanced.app/). โค๏ธ Thank you for considering contributing to ReVanced Manager. diff --git a/README.md b/README.md index a73c9914..c2d78f69 100644 --- a/README.md +++ b/README.md @@ -51,15 +51,16 @@ ReVanced Manager is an Android application that uses ReVanced Patcher to add, re ### ๐Ÿ’ช Features We provide the some of the features are: -* ๐Ÿ“ฑ ReVanced Patcher that fit in your pocket! -* ๐Ÿค— Friendly & intuitive UI to help you manage your patched applications! -* ๐Ÿ› ๏ธ Lots of customization to patch using 3rd-party sources and integration! -* โœจ And a lot more! +* ๐Ÿ“ฑ **Portable**: ReVanced Patcher that fit in your pocket! +* ๐Ÿค— **Intuitive UI**: Help you manage your patched applications *intuitively*! +* ๐Ÿ› ๏ธ **Customization**: Patch using 3rd-party sources and integration! +* โœจ And a **lot more!** ### ๐Ÿ”ฝ Download -You can obtain ReVanced Manager by downloading it from either [revanced.app/download](https://revanced.app/download) or [GitHub Releases](https://github.com/ReVanced/revanced-manager/releases) +You can obtain ReVanced Manager by downloading it from either [ReVanced site](https://revanced.app/download) or [GitHub Releases](https://github.com/ReVanced/revanced-manager/releases) ## ๐ŸŒฑ Miscellaneous + ### ๐Ÿ“„ Documentation Step on how to use the application are available [here](/docs/README.md). @@ -67,7 +68,7 @@ Step on how to use the application are available [here](/docs/README.md). Thanks for consider contributing to ReVanced Manager, you can find the contribution guidelines [here](/CONTRIBUTING.md). ### ๐Ÿ”ด Issues -For suggestions and bug reports, open an issue [here](https://github.com/ReVanced/revanced-manager/issues/new?assignees=&labels=bug&projects=&template=bug-issue.yml&title=bug%3A+%3Ctitle%3E). +For suggestions and bug reports, open an issue [here](https://github.com/ReVanced/revanced-manager/issues/choose). -### โš–๏ธ License +## โš–๏ธ License ReVanced Manager adopt the [GNU General Public License 3.0](/LICENSE), [tl;dr](https://www.tldrlegal.com/license/gnu-general-public-license-v3-gpl-3): You may copy, distribute and modify the software as long as you track changes/dates in source files. Any modifications to or software including (via compiler) GPL-licensed code must also be made available under the GPL along with build & install instructions. diff --git a/docs/0_prerequisites.md b/docs/0_prerequisites.md index c33d02a1..a53b46fb 100644 --- a/docs/0_prerequisites.md +++ b/docs/0_prerequisites.md @@ -1,13 +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) diff --git a/docs/1_installation.md b/docs/1_installation.md index f353d46b..bcf1a3f5 100644 --- a/docs/1_installation.md +++ b/docs/1_installation.md @@ -1,11 +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) diff --git a/docs/2_1_patching.md b/docs/2_1_patching.md index e1f1e785..9d84bfbd 100644 --- a/docs/2_1_patching.md +++ b/docs/2_1_patching.md @@ -1,7 +1,9 @@ # ๐Ÿงฉ Patching apps + The following pages will guide you through using ReVanced Manager to patch apps. ## โœ… Steps to patch apps + 1. Navigate to the Apps tab from the top navigation bar 2. Tap the + button in the bottom right corner 3. Choose an app to patch[^1] @@ -17,6 +19,7 @@ The following pages will guide you through using ReVanced Manager to patch apps. [^3]: Mounting the patched app on top of the original app will only work if the installed app version matches the version of the app selected in step 4. above. ## โญ๏ธ What's next + The next page will bring you back to the usage page. Continue: [๐Ÿ› ๏ธ Usage](2_usage.md) diff --git a/docs/2_2_managing.md b/docs/2_2_managing.md index e02a3a47..c72a0cd2 100644 --- a/docs/2_2_managing.md +++ b/docs/2_2_managing.md @@ -1,11 +1,14 @@ # ๐Ÿงฐ 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 + 1. Navigate to the Apps tab from the top navigation bar 2. Select the app you want to manage 3. + ## โญ๏ธ What's next The next page will bring you back to the usage page. diff --git a/docs/2_3_updating.md b/docs/2_3_updating.md index 72305eb9..2b42104c 100644 --- a/docs/2_3_updating.md +++ b/docs/2_3_updating.md @@ -1,10 +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 + > Currently not implemented ## โญ๏ธ What's next + The next page will bring you back to the usage page. Continue: [๐Ÿ› ๏ธ Usage](2_usage.md) diff --git a/docs/2_4_settings.md b/docs/2_4_settings.md index 8803dedf..008cda46 100644 --- a/docs/2_4_settings.md +++ b/docs/2_4_settings.md @@ -1,29 +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) diff --git a/docs/2_usage.md b/docs/2_usage.md index 9267274f..f079782f 100644 --- a/docs/2_usage.md +++ b/docs/2_usage.md @@ -1,13 +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) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index c291a519..c2f9291b 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -1,18 +1,24 @@ # โ” 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. diff --git a/docs/README.md b/docs/README.md index c7dfe9a5..0b327509 100644 --- a/docs/README.md +++ b/docs/README.md @@ -1,7 +1,9 @@ # ๐Ÿ’Š 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) @@ -12,9 +14,10 @@ This documentation explains how to use [ReVanced Manager](https://github.com/ReV 3. [โ” Troubleshooting](3_troubleshooting.md) ## ๐Ÿ‘‹ Developer version -Are you a contributors? Consider checking out developer version of the [documentation](/developers/README.md). +Interested in contributing? Consider checking out developer version of the [documentation](/developers/README.md). ## โญ๏ธ Start here + The next page will tell you about the prerequisites for using ReVanced Manager. Continue: [๐Ÿ’ผ Prerequisites](0_prerequisites.md) diff --git a/docs/developers/0_preparation.md b/docs/developers/0_preparation.md index d56a94ad..7f041cf4 100644 --- a/docs/developers/0_preparation.md +++ b/docs/developers/0_preparation.md @@ -1,19 +1,17 @@ -# ๐Ÿ’ผ Preparing a developer environment +# ๐Ÿ’ผ Preparing a development environment In order to compile ReVanced Manager, certain requirements must be met. ## ๐Ÿ“ Prerequisites * Kotlin IDE such as [Android Studio](https://developer.android.com/studio) -* Understanding of [Android](https://android.com) development, [Kotlin](https://kotlinlang.org/) language and [Jetpack Compose](https://developer.android.com/jetpack/compose). -* At least Java Development Kit version 17 of any vendors +* Knowledge of [Android](https://android.com) App development, [Kotlin](https://kotlinlang.org/) language. +* At least JDK 17 of any vendors ## ๐Ÿƒ Prepare the environment 1. Clone the repository ```sh git clone https://github.com/ReVanced/revanced-manager.git && cd revanced-manager ``` - 2. Build the APK - Release variant: ```sh gradlew assembleRelease -Psign ``` diff --git a/docs/developers/1_overview.md b/docs/developers/1_overview.md index 7f9cab3e..8fd163a3 100644 --- a/docs/developers/1_overview.md +++ b/docs/developers/1_overview.md @@ -7,7 +7,7 @@ build beautiful and performant user interfaces using declarative programming. It provides a unified and efficient way of building UI that is well-integrated with the Android framework. ## ๐Ÿ“‚ Structure -We structure our code to use MVVM (Model-View-ViewModel) architecture for easier maintenance of the code. +We structure our code to use [MVVM architecture](https://developer.android.com/topic/libraries/architecture/viewmodel) for easier maintenance of the code. * **Model**: responsible for retrieving & storing data as well as performing calculations and other operations * **View**: responsible for displaying the UI to the user, and send inputs to **ViewModel** @@ -15,8 +15,8 @@ We structure our code to use MVVM (Model-View-ViewModel) architecture for easier ## ๐Ÿง‘โ€๐Ÿ’ป Code readability In order to maintain readability of the code, It's highly recommend that you follow -https://developer.android.com/jetpack/compose/api-guidelines style guide in order to maintain -consistent readability through out the codebase. +https://developer.android.com/jetpack/compose/api-guidelines style guide to maintain +consistent style through out the codebase. ## ๐ŸŽจ Design language We adopt the [Material Design 3](https://m3.material.io) as our design language to @@ -34,5 +34,5 @@ Example: * `fix`(**settings**): NullPointerException when exporting logs * `refactor`: optimize sub-optimal code * `perf`(**api**): reduces network latency -* `docs`(**developer**): concise wording +* `docs`(**developer**): correct grammatical mistak * `build`: bump version to v1.9.3 diff --git a/docs/developers/README.md b/docs/developers/README.md index fdcf629f..63fe9ef5 100644 --- a/docs/developers/README.md +++ b/docs/developers/README.md @@ -2,7 +2,7 @@ This documentation explains how the [ReVanced Manager](https://github.com/ReVanced/revanced-manager) work. ## ๐Ÿ“– Table of contents -0. [๐Ÿ’ผ Preparing a developer environment](0_preparation.md) +0. [๐Ÿ’ผ Preparing a development environment](0_preparation.md) 1. [๐Ÿ’ Overview](1_overview.md) ## โญ๏ธ Start here