feat(android): ship the Android companion app with an install guide

A thin WebView wrapper that opens a user's own mc-webui instance full
screen, without the browser address bar. It asks once for the server
address and remembers it; all logic stays on the server.

- android/mc-webui-wrapper.apk (1.0, it.wojtaszek.mc.wrapper, minSdk 21)
- docs/android-app.md: download + checksum, "unknown sources" permission,
  the Play Protect notice, first connection, and the limitations that come
  with a WebView (no notifications, no QR camera, no file downloads)
- README, user guide and whatsnew entries, incl. an app-vs-PWA comparison
- *.apk marked binary so the text=auto rule can never touch it

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
MarekWo
2026-07-28 20:55:04 +02:00
parent 0c10640e28
commit f71cac8b2e
7 changed files with 222 additions and 1 deletions
+30
View File
@@ -26,6 +26,7 @@ This guide covers all features and functionality of mc-webui. For installation i
- [Network Commands](#network-commands)
- [PWA Notifications](#pwa-notifications)
- [Notifications Tab](#notifications-tab)
- [Android App](#android-app)
---
@@ -1055,6 +1056,35 @@ To get the full PWA experience with app badge counters:
---
## Android App
Besides installing mc-webui as a PWA, there is a small **Android companion
app** that opens your instance full screen — no address bar, its own icon in
the app drawer. It contains no mesh logic: it asks once for the address of your
server (e.g. `http://192.168.1.100:5000`) and displays it, so everything still
runs on your server and your MeshCore device.
<p align="center">
<img src="../images/android-wrapper-setup.jpg" width="280" alt="mc-webui Android app - server address screen">
</p>
The app is not distributed through Google Play — you download the `.apk` from
the repository and install it yourself, which means going past a couple of
Android warnings. The **[Android App guide](android-app.md)** walks through the
download, the "unknown sources" permission, the Play Protect notice, and the
first connection.
**App or PWA?** They can coexist, and each is better at something:
| | Android app | PWA (Chrome → Add to Home Screen) |
|---|---|---|
| Full screen, own icon | Yes | Yes |
| Setup | Install `.apk`, type the address once | Open in Chrome, add to home screen |
| Notifications | Not available | Available (see above) |
| QR scanning, file downloads | Not available | Available |
---
## Getting Help
- **What's New:** [whatsnew.md](whatsnew.md)