From fc972ef55d2acd451f4323c438f46cde92f7b6e9 Mon Sep 17 00:00:00 2001 From: ProudNerd <64123611+proud-nerd@users.noreply.github.com> Date: Wed, 18 Jun 2025 17:00:57 +0200 Subject: [PATCH 1/5] docs: add general instructions for updating WebView --- docs/docs/getting-started/apps.md | 76 +++++++++++++++++++++++++++++-- 1 file changed, 71 insertions(+), 5 deletions(-) diff --git a/docs/docs/getting-started/apps.md b/docs/docs/getting-started/apps.md index 4c2885c6..0cfbec5b 100644 --- a/docs/docs/getting-started/apps.md +++ b/docs/docs/getting-started/apps.md @@ -108,10 +108,73 @@ ADB is often enabled on these devices by default, if it is not go to Frameo Sett adb uninstall com.immichframe.immichframe ``` -### Frameo WebView Update -Follow instructions below to update WebView to 106. This has been tested and working on Android 6.01 10.1" Frameo devices: +### Frameo WebView Update + +The basic procedure of updating the WebView installation consists of a few steps. Read through and understand them first, before you attempt any changes. + +To make it easier to follow, there are tested and working examples for Android 6.01 10.1" Frameo devices provided at the end. If you have one of those, you might as well skip directly to them. + +- Download WebView to PC from [APKMirror (WebView by Lineage)][webview-lineage] + - You most likely must use an APK with com.android.webview as the package name, that's why LineageOS version is recommended instead of the Google version (which is com.google.android.webview) + - You must use a version that is compatible with your Android version + - You must use a version that is compatible with your device's architecture +- Find the current WebView APK on your device + ```shell + adb shell pm path com.android.webview + ``` + might return something like `/system/app/webview/webview.apk` or `/product/app/webview/webview.apk` +- Rename downloaded APK to match the original one (compare with output of the command above) + ``` + mv downloaded-webview.apk webview.apk + ``` +- Push new apk to sdcard + ```shell + adb push /path/to/your/new/webview.apk /sdcard/ + ``` +- Enter root shell + ```shell + adb shell su + ``` +- Mount the correct partition as read-write. Replace `/partition` with the first path of the original WebView APK on your device + ```shell + adb shell mount -o rw,remount /partition + ``` +- Backup original WebView APK + ```shell + mount -o rw,remount /partition && cp /path/to/original/webview.apk /path/to/original/webview.apk.bak + ``` +- Override original WebView APK with the downloaded one + ```shell + mount -o rw,remount /system && cp /sdcard/webview.apk /system/app/webview/webview.apk + ``` +- Delete the oat folder recursively + - needed for Android 6.1 and most likely for all devices, where WebView is installed as a system app below `/system` + - might not be needed/possible if original WebView is installed for example below `/product` + ```shell + mount -o rw,remount /system && rm -rf /system/app/webview/oat + ``` +- Copy new WebView to system + ```shell + mount -o rw,remount /partition && cp /sdcard/webview.apk /path/to/original/webview.apk + ``` +- exit root + ```shell + exit + ``` +- Reboot device + ```shell + adb reboot + ``` + This should reset the mounted /partition to read-only automatically +- You may or may not need to also follow up with an adb install of the APK +- Verify WebView version (optional) + + In Android developer settings, you can view the "WebView implementation". Check that this reflects the new version you pushed. + +#### Complete step-by-step instructions for Android 6.01 +Follow instructions below to update WebView to 106. This has been tested and working on Android 6.01 10.1" Frameo devices: - Download WebView 106 to PC: - [Lineage OS WebView 106-0-5249-126-12][webview-update] + [Lineage OS WebView 106-0-5249-126-12][webview-lineage-106] - Push new apk to sdcard ```shell adb push /path/to/your/new/webview.apk /sdcard/ @@ -128,7 +191,7 @@ Follow instructions below to update WebView to 106. This has been tested and wor ```shell mount -o rw,remount /system && rm -rf /system/app/webview/oat ``` -- Copy new WebView to system +- Copy new WebView to system ```shell mount -o rw,remount /system && cp /sdcard/webview.apk /system/app/webview/webview.apk ``` @@ -140,6 +203,8 @@ Follow instructions below to update WebView to 106. This has been tested and wor ```shell adb reboot ``` + + ### Desktop (Windows, MacOS, Linux) Get the latest Desktop-App from the [GitHub Releases][releases-url]-Page. @@ -174,5 +239,6 @@ The screen is configured in a 3x3 gird. You can touch or click: [app-store-link]: https://apps.apple.com/us/app/immichframe/id6742748077 [releases-url]: https://github.com/3rob3/ImmichFrame/releases/latest [ADB-link]: https://www.xda-developers.com/install-adb-windows-macos-linux/ -[webview-update]: https://www.apkmirror.com/apk/lineageos/android-system-webview-2/android-system-webview-2-106-0-5249-126-release/android-system-webview-106-0-5249-126-12-android-apk-download/ +[webview-lineage]: https://www.apkmirror.com/apk/lineageos/android-system-webview-2/ +[webview-lineage-106]: https://www.apkmirror.com/apk/lineageos/android-system-webview-2/android-system-webview-2-106-0-5249-126-release/android-system-webview-106-0-5249-126-12-android-apk-download/ [setting-androidtv-screensaver]: https://youtu.be/m3Arh-hrWks From 674983828140830979a23c33e56ef3fb92016969 Mon Sep 17 00:00:00 2001 From: ProudNerd <64123611+proud-nerd@users.noreply.github.com> Date: Sun, 29 Jun 2025 13:57:16 +0200 Subject: [PATCH 2/5] docs: remove duplicate step; fix typo; --- docs/docs/getting-started/apps.md | 18 ++++++------------ 1 file changed, 6 insertions(+), 12 deletions(-) diff --git a/docs/docs/getting-started/apps.md b/docs/docs/getting-started/apps.md index 0cfbec5b..08205f50 100644 --- a/docs/docs/getting-started/apps.md +++ b/docs/docs/getting-started/apps.md @@ -112,7 +112,7 @@ ADB is often enabled on these devices by default, if it is not go to Frameo Sett The basic procedure of updating the WebView installation consists of a few steps. Read through and understand them first, before you attempt any changes. -To make it easier to follow, there are tested and working examples for Android 6.01 10.1" Frameo devices provided at the end. If you have one of those, you might as well skip directly to them. +There are tested and working examples for Android 6.01 10.1" Frameo devices provided at the end. If you have one of those, you might as well skip directly to them. - Download WebView to PC from [APKMirror (WebView by Lineage)][webview-lineage] - You most likely must use an APK with com.android.webview as the package name, that's why LineageOS version is recommended instead of the Google version (which is com.google.android.webview) @@ -143,20 +143,16 @@ To make it easier to follow, there are tested and working examples for Android 6 ```shell mount -o rw,remount /partition && cp /path/to/original/webview.apk /path/to/original/webview.apk.bak ``` -- Override original WebView APK with the downloaded one - ```shell - mount -o rw,remount /system && cp /sdcard/webview.apk /system/app/webview/webview.apk - ``` +- Overwrite original WebView APK with the downloaded one +```shell + mount -o rw,remount /partition && cp /sdcard/webview.apk /path/to/original/webview.apk + ``` - Delete the oat folder recursively - needed for Android 6.1 and most likely for all devices, where WebView is installed as a system app below `/system` - - might not be needed/possible if original WebView is installed for example below `/product` + - might not be needed/possible if original WebView is installed somewhere else, for example below `/product` ```shell mount -o rw,remount /system && rm -rf /system/app/webview/oat ``` -- Copy new WebView to system - ```shell - mount -o rw,remount /partition && cp /sdcard/webview.apk /path/to/original/webview.apk - ``` - exit root ```shell exit @@ -203,8 +199,6 @@ Follow instructions below to update WebView to 106. This has been tested and wor ```shell adb reboot ``` - - ### Desktop (Windows, MacOS, Linux) Get the latest Desktop-App from the [GitHub Releases][releases-url]-Page. From 89cbabe2c5f6ac89f92d04b3626ffdbfbe2ef131 Mon Sep 17 00:00:00 2001 From: ProudNerd <64123611+proud-nerd@users.noreply.github.com> Date: Wed, 16 Jul 2025 11:32:57 +0200 Subject: [PATCH 3/5] docs: add disclaimer and warranty warning --- docs/docs/getting-started/apps.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/docs/getting-started/apps.md b/docs/docs/getting-started/apps.md index 08205f50..93aa81e9 100644 --- a/docs/docs/getting-started/apps.md +++ b/docs/docs/getting-started/apps.md @@ -110,6 +110,19 @@ ADB is often enabled on these devices by default, if it is not go to Frameo Sett ### Frameo WebView Update +``` +⚠️ Disclaimer: + +This might not work for you or require extra steps that are not covered here. Since there are a myriad of devices and Android versions, consider this procedure as not tested. Especially when talking about repurposed digital frames, vendor lockdowns vastly differ. + +If this worked for you, consider opening a 'Show and tell'-Discussion. +``` + +``` +❗️ Warning: +This might break your warranty +``` + The basic procedure of updating the WebView installation consists of a few steps. Read through and understand them first, before you attempt any changes. There are tested and working examples for Android 6.01 10.1" Frameo devices provided at the end. If you have one of those, you might as well skip directly to them. From e6722ecada830fe0562b65f02e76cfaf10b53c69 Mon Sep 17 00:00:00 2001 From: ProudNerd <64123611+proud-nerd@users.noreply.github.com> Date: Wed, 16 Jul 2025 11:37:38 +0200 Subject: [PATCH 4/5] docs: small changes to improve comprehensibility --- docs/docs/getting-started/apps.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/getting-started/apps.md b/docs/docs/getting-started/apps.md index 93aa81e9..809217a0 100644 --- a/docs/docs/getting-started/apps.md +++ b/docs/docs/getting-started/apps.md @@ -120,7 +120,7 @@ If this worked for you, consider opening a 'Show and tell'-Discussion. ``` ❗️ Warning: -This might break your warranty +This might break your warranty. ``` The basic procedure of updating the WebView installation consists of a few steps. Read through and understand them first, before you attempt any changes. From 2e922fcbabae1e3b85c590df5bd3428630e732ca Mon Sep 17 00:00:00 2001 From: ProudNerd <64123611+proud-nerd@users.noreply.github.com> Date: Wed, 16 Jul 2025 11:42:25 +0200 Subject: [PATCH 5/5] docs: improve comprehensibility --- docs/docs/getting-started/apps.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/docs/docs/getting-started/apps.md b/docs/docs/getting-started/apps.md index 809217a0..87c05875 100644 --- a/docs/docs/getting-started/apps.md +++ b/docs/docs/getting-started/apps.md @@ -125,8 +125,6 @@ This might break your warranty. The basic procedure of updating the WebView installation consists of a few steps. Read through and understand them first, before you attempt any changes. -There are tested and working examples for Android 6.01 10.1" Frameo devices provided at the end. If you have one of those, you might as well skip directly to them. - - Download WebView to PC from [APKMirror (WebView by Lineage)][webview-lineage] - You most likely must use an APK with com.android.webview as the package name, that's why LineageOS version is recommended instead of the Google version (which is com.google.android.webview) - You must use a version that is compatible with your Android version @@ -157,7 +155,7 @@ There are tested and working examples for Android 6.01 10.1" Frameo devices prov mount -o rw,remount /partition && cp /path/to/original/webview.apk /path/to/original/webview.apk.bak ``` - Overwrite original WebView APK with the downloaded one -```shell + ```shell mount -o rw,remount /partition && cp /sdcard/webview.apk /path/to/original/webview.apk ``` - Delete the oat folder recursively @@ -180,7 +178,7 @@ There are tested and working examples for Android 6.01 10.1" Frameo devices prov In Android developer settings, you can view the "WebView implementation". Check that this reflects the new version you pushed. -#### Complete step-by-step instructions for Android 6.01 +#### Complete step-by-step instructions for Android 6.01 10.1" Frameo devices Follow instructions below to update WebView to 106. This has been tested and working on Android 6.01 10.1" Frameo devices: - Download WebView 106 to PC: [Lineage OS WebView 106-0-5249-126-12][webview-lineage-106]