From c3f0f3e63cec1fdd5d39fcf74aaf6aee9ebbb391 Mon Sep 17 00:00:00 2001 From: Radon Rosborough Date: Fri, 1 Dec 2023 16:28:09 -0800 Subject: [PATCH 1/5] docs: more troubleshooting advice --- docs/3_troubleshooting.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index 3c1fe03be2..1a1393abf8 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -5,14 +5,16 @@ In case you encounter any issues while using ReVanced Manager, please refer to t - 💉 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. + An existing installation of the app you're trying to patch is conflicting with the patched app (i.e., the existing version of the app doesn't allow upgrading to the patched version, or a different copy of the app causes a conflict). 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. + You may be trying to patch a split APK[^1], which is sometimes not supported by ReVanced. Sometimes apps are available in both split and non-split forms. If your existing installation of the app is a split APK, try obtaining a non-split version and see if that can be patched correctly. + + You may also get this error if 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. @@ -25,3 +27,5 @@ In case you encounter any issues while using ReVanced Manager, please refer to t The next page will teach you how to build ReVanced Manager from source. Continue: [🔨 Building from source](4_building.md) + +[^1]: https://old.reddit.com/r/revancedapp/comments/xna2gn/youtube_unsupported_version_and_split_apk/ From e352c4ce5831d9720f2d2a07a92f217f109b04c5 Mon Sep 17 00:00:00 2001 From: oSumAtrIX Date: Fri, 22 Dec 2023 05:48:47 +0100 Subject: [PATCH 2/5] Update docs/3_troubleshooting.md --- docs/3_troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index 1a1393abf8..30a4d3ebfc 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -14,7 +14,7 @@ In case you encounter any issues while using ReVanced Manager, please refer to t You may be trying to patch a split APK[^1], which is sometimes not supported by ReVanced. Sometimes apps are available in both split and non-split forms. If your existing installation of the app is a split APK, try obtaining a non-split version and see if that can be patched correctly. - You may also get this error if your device is not supported. Refer to the [Prerequisites](0_prerequisites.md) page for supported devices. + Your device may otherwise be unsupported. Please look at 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. From 57ce2d452adeab0076d2ba22e1b5870b2a8de22b Mon Sep 17 00:00:00 2001 From: oSumAtrIX Date: Fri, 22 Dec 2023 05:48:56 +0100 Subject: [PATCH 3/5] Update docs/3_troubleshooting.md --- docs/3_troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index 30a4d3ebfc..f4e428ad9a 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -12,7 +12,7 @@ In case you encounter any issues while using ReVanced Manager, please refer to t - ❗️ Error code `135`, `139` or `1` when patching the app - You may be trying to patch a split APK[^1], which is sometimes not supported by ReVanced. Sometimes apps are available in both split and non-split forms. If your existing installation of the app is a split APK, try obtaining a non-split version and see if that can be patched correctly. + You may be trying to patch a split APK[^1]. This may not work under certain circumstances. In such a case, patch a full APK. Your device may otherwise be unsupported. Please look at the [Prerequisites](0_prerequisites.md) page for supported devices. From ddeb8de0803b81d2328779b48d96889e91d4c095 Mon Sep 17 00:00:00 2001 From: oSumAtrIX Date: Fri, 22 Dec 2023 05:49:02 +0100 Subject: [PATCH 4/5] Update docs/3_troubleshooting.md --- docs/3_troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index f4e428ad9a..2268d5c0ad 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -8,7 +8,7 @@ In case you encounter any issues while using ReVanced Manager, please refer to t - 🚫 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 (i.e., the existing version of the app doesn't allow upgrading to the patched version, or a different copy of the app causes a conflict). Uninstall the existing app before installing the patched app. + An existing installation of the app you're trying to patch conflicts with the patched app (i.e., signature mismatch or downgrade). Uninstall the existing app before installing the patched app. - ❗️ Error code `135`, `139` or `1` when patching the app From eea080d4a328b1560a8aa19a30265c4cf25b394d Mon Sep 17 00:00:00 2001 From: oSumAtrIX Date: Fri, 22 Dec 2023 05:49:46 +0100 Subject: [PATCH 5/5] Apply suggestions from code review --- docs/3_troubleshooting.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/3_troubleshooting.md b/docs/3_troubleshooting.md index 2268d5c0ad..1573e50868 100644 --- a/docs/3_troubleshooting.md +++ b/docs/3_troubleshooting.md @@ -28,4 +28,4 @@ The next page will teach you how to build ReVanced Manager from source. Continue: [🔨 Building from source](4_building.md) -[^1]: https://old.reddit.com/r/revancedapp/comments/xna2gn/youtube_unsupported_version_and_split_apk/ +[^1]: https://developer.android.com/guide/app-bundle/app-bundle-format