Skip to content

Příkazy ​

PříkazKdy
pwa:installjednou po composer require
pwa:iconspři změně loga
pwa:build / pwa:clearpři každém nasazení (nebo optimize / optimize:clear)
pwa:doctorpo instalaci, v CI a deploy skriptu
pwa:downúdržba
pwa:disable / pwa:enablenouzové vypnutí SW
pwa:push:vapidjednou, před zapnutím push notifikací

pwa:install ​

bash
php artisan pwa:install [--no-interaction]

Publikuje config/pwa.php (tag pwa::config) a vypíše další kroky. Při chybě publikování vrací 1.

pwa:icons ​

bash
php artisan pwa:icons {source?} {--background=} {--splash}
Argument / volbaPopis
sourcePNG (gd nebo imagick) nebo SVG (jen imagick); bez něj icons.source
--backgroundbarva pozadí maskable a iOS ikony; výchozí theme.background
--splashvytvoří i úvodní obrazovky iOS pro každý iPhone a iPad (icons.splash)

Vytvoří v public/{icons.path}: icon-{size}.png pro icons.sizes, maskable-512.png, monochrome-512.png, apple-touch-icon.png (180 px), favicon-32.png, ze SVG i icon.svg. Přepisuje existující.

S --splash vytvoří i splash/apple-splash-{šířka}x{výška}.png pro každou obrazovku z AppleDevices::SCREENS na výšku i na šířku a varianty -dark, když je nastavené icons.splash.dark_background. Starší úvodní obrazovky nejdřív smaže, takže značky <link> vždy odpovídají aktuální sadě. Všech 22 velikostí v obou orientacích zabere s GD pár sekund.

pwa:build ​

bash
php artisan pwa:build

Sestaví service worker do {sw.compiled_path}/sw.js z configu a Vite manifestu. Spouštějte po npm run build. Je napojený na php artisan optimize.

  INFO  Service worker 1a2b3c4d5e6f built (14 files precached) → bootstrap/cache/pwa/sw.js.

Bez Vite manifestu varuje (precache pak obsahuje jen offline stránku). Neplatný Vite manifest = 1.

pwa:clear ​

Smaže sestavený SW; /sw.js se pak sestavuje za běhu. Napojený na optimize:clear.

pwa:doctor ​

bash
php artisan pwa:doctor [--ci]
KontrolaÚroveň při selhání
HTTPS v APP_URL (mimo local)chyba
pwa.enabledvarování
nouzové vypnutí neaktivníchyba
manifest: namechyba
ikony 192 a 512chyba
maskable ikona, apple-touch-icon, úvodní obrazovky iOSvarování
screenshoty: wide a narrowvarování
screenshoty: soubor existuje, sizes a type mu odpovídajíchyba
start_url uvnitř scopechyba
public/sw.js neexistujechyba
Vite manifestvarování
SW sestavenývarování
sestavený SW odpovídá configu a builduchyba
soubory ze sw.import existujíchyba (cizí doména = varování)
výjimky z údržbyvarování
session driver není arraychyba
pwa.remember na nějaké routěvarování
pwa.cache na nějaké routěvarování
sdílené úložiště nouzového vypnutívarování
s push.enabled: minishlink/web-push, klíče VAPID a subject, tabulka odběrůchyba
s push.enabled: push.endpoints = null, žádný worker nezobrazuje notifikacevarování

Bez --ci vrací vždy 0; s --ci vrací 1 při jakékoli chybě (varování ne).

pwa:down ​

bash
php artisan pwa:down {--message=} {--until=} {--retry=} {--refresh=} {--secret=} {--with-secret}

Viz Údržba. Neplatné --until = 1, jinak návratový kód artisan down.

pwa:disable / pwa:enable ​

bash
php artisan pwa:disable [--force]
php artisan pwa:enable

Viz Nouzové vypnutí. Bez --force se ptá; zamítnutí = 1.

pwa:push:vapid ​

bash
php artisan pwa:push:vapid [--show] [--force]

Vygeneruje pár klíčů P-256 (OpenSSL, bez dalšího balíčku) a zapíše PWA_VAPID_PUBLIC_KEY a PWA_VAPID_PRIVATE_KEY do .env. Existující klíče ponechá a vrátí 1; --force je nahradí (všechny odběry přestanou fungovat, dokud se prohlížeč nepřihlásí znovu). --show klíče vypíše pro správce tajemství a nic nezapíše. Viz Push notifikace.

php artisan about ​

Sekce Laravel PWA: verze, Enabled, Kill switch, Service worker (compiled / not built), Display.

Released under the MIT License.