mirror of
https://github.com/MarekWo/mc-webui.git
synced 2026-08-06 08:43:17 +02:00
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:
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user