From f236143f9eac5a7ab12e3d2cd04e39877dae6fc4 Mon Sep 17 00:00:00 2001 From: Lauri Ojansivu Date: Sun, 2 Feb 2025 22:12:50 +0200 Subject: [PATCH] Updated PWA (markdown) --- PWA.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 48 insertions(+), 4 deletions(-) diff --git a/PWA.md b/PWA.md index 9874688..40f5e89 100644 --- a/PWA.md +++ b/PWA.md @@ -88,15 +88,59 @@ These are mostly just notes to WeKan maintainer xet7 itself, how xet7 did get of Related, for creating apps to other appstores: https://github.com/wekan/wekan/wiki/Browser-compatibility-matrix 1. https://www.pwabuilder.com to create Android app. Select fullscreen when creating app, also requires correctly installed assetlinks.json with below Caddy config to get fullscreen. When creating app, make your own signing key if you don't have one yet. Releasing Android app is at Play Console https://play.google.com/console/ . - -2. Upgrade to Android 14 targe SDK 34 like this: https://www.youtube.com/watch?v=DbarW15E058 +``` +- id: com.company.someapp.twa +- Web view (Custom Tabs did not work) +- Fullscreen +- Notifications [X] Enable +- Signing key [X] Use mine +- Version: 1.0.0.0 (next I used were 2.0.0.0, 3.0.0.0) +- Version code: 1 (next I used were 2, 3) +``` +2. Upgrade to Android 14 target SDK 34 like this: https://www.youtube.com/watch?v=DbarW15E058 . This was mentioned at https://github.com/pwa-builder/PWABuilder/issues/4766#issuecomment-2229867608 3. PWABuilder has about 100+ downloadable icons etc webmanifest requirements like is at https://github.com/wekan/wekan/tree/main/public . -It was mentioned at https://github.com/pwa-builder/PWABuilder/issues/4766#issuecomment-22 +It was mentioned at https://github.com/pwa-builder/PWABuilder/issues/4766#issuecomment-22 . Minimum site.webmanifest is like this: +``` +{ + "name": "MyApp", + "short_name": "MyApp", + "id": "BixPlat", + "icons": [ { + "src": "https://app.company.com/favicon.svg", + "sizes": "any", + "type": "image/svg" + } , { + "src": "https://app.company.com/favicon.svg", + "sizes": "512x512", + "type": "image/svg" + } + ], + "theme_color": "#000000", + "background_color": "#000000", + "start_url": "sign-in", + "display": "fullscreen", + "orientation": "any", + "categories": [ + "productivity" + ], + "description": "BixPlat", + "dir": "auto", + "scope": "https://app.company.com", + "prefer_related_applications": false, + "launch_handler": { + "client_mode": ["navigate-existing", "auto"] + } , + "display_override": [ + "fullscreen" + ] + } +``` +And max all possible is like this https://github.com/wekan/wekan/blob/main/public/site.webmanifest 4. Clone WeKan repo, add favicons etc from step 2 to wekan/public/ , and build WeKan bundle from source like at https://github.com/wekan/wekan/wiki/Emoji . Note: Currently WeKan does not have feature for custom favicons, it would require a lot of work for 100+ favicons etc customizations. -5. Run bundle at server like https://github.com/wekan/wekan/wiki/Offline or https://github.com/wekan/wekan/wiki/Raspberry-Pi +5. Run bundle at server like https://github.com/wekan/wekan/wiki/Offline or https://github.com/wekan/wekan/wiki/Raspberry-Pi . Or use Docker, Snap, etc. 6. Install Caddy like https://github.com/wekan/wekan/wiki/Caddy-Webserver-Config , with this config for PWA at https://boards.example.com , there add assetlinks.json details you got when you downloaded Android .zip file from https://pwabuilder.com , see assetlinks issue about where at Play Console those 2 SHA256 keys https://github.com/pwa-builder/PWABuilder/issues/3867#issuecomment-1450826565