Skip to content

Docs: add general instructions for updating WebView #410

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
proud-nerd wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Docs: add general instructions for updating WebView #410

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
fc972ef
docs: add general instructions for updating WebView
proud-nerd Jun 18, 2025
6749838
docs: remove duplicate step; fix typo;
proud-nerd Jun 29, 2025
89cbabe
docs: add disclaimer and warranty warning
proud-nerd Jul 16, 2025
e6722ec
docs: small changes to improve comprehensibility
proud-nerd Jul 16, 2025
2e922fc
docs: improve comprehensibility
proud-nerd Jul 16, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
81 changes: 76 additions & 5 deletions docs/docs/getting-started/apps.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -108,10 +108,80 @@ 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
Copy link
Collaborator

@3rob3 3rob3 Jun 18, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this header indicate Android 7+ or something?


```
⚠️ 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.

- 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
```
- 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 somewhere else, for example below `/product`
```shell
mount -o rw,remount /system && rm -rf /system/app/webview/oat
```
- 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 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-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/
Expand All @@ -128,7 +198,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
```
Expand Down Expand Up @@ -174,5 +244,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