Updated PWA (markdown)

Lauri Ojansivu 2025-02-02 22:12:50 +02:00
parent 9d0b25ecd8
commit f236143f9e

52
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