Progressive Web-App mit der Angular CLI erstellen

Sie möchten Ihre Angular-App installierbar machen? Du musst nicht länger warten!

Minko Gechev

In diesem Beitrag erfahren Sie, wie Sie mit der Angular-Befehlszeile (Command Line Interface, CLI) eine progressive Webanwendung (PWA) erstellen.

Das Codebeispiel aus diesem Leitfaden finden Sie auf GitHub.

Installierbare PWA erstellen

Um Ihre Angular-Anwendung zu einer PWA zu machen, müssen Sie nur einen Befehl ausführen:

ng add @angular/pwa

Mit diesem Befehl wird Folgendes ausgeführt:

• Erstellen Sie einen Dienst-Worker mit einer Standard-Caching-Konfiguration.
• Erstellen Sie eine Manifestdatei, die dem Browser mitteilt, wie sich Ihre App verhalten soll, wenn sie auf dem Gerät des Nutzers installiert ist.
• Fügen Sie in index.html einen Link zur Manifestdatei hinzu.
• Fügen Sie das <meta>-Tag theme-color in index.html ein.
• Erstellen Sie App-Symbole im Verzeichnis src/assets.

Ihr Service Worker sollte standardmäßig innerhalb weniger Sekunden nach dem ersten Seitenaufbau registriert sein. Falls nicht, sollten Sie die registrationStrategy anpassen.

PWA anpassen

Im Artikel Assets vorab mit dem Angular-Service-Worker im Cache speichern wird beschrieben, wie Sie den Angular-Service-Worker konfigurieren. Dort können Sie angeben, welche Ressourcen der Service Worker im Cache speichern soll und welche Strategie er hierfür verwenden soll.

In der Manifestdatei Ihrer App können Sie den Namen, den Kurznamen, die Symbole, die Farbgebung des Designs und andere Details Ihrer App angeben. Eine vollständige Liste der Eigenschaften, die Sie festlegen können, finden Sie im Hilfeartikel Manifest für eine Web-App hinzufügen.

Sehen Sie sich die von der Angular-Befehlszeile generierte Manifestdatei an:

{
  "name": "manifest-web-dev",
  "short_name": "manifest-web-dev",
  "theme_color": "#1976d2",
  "background_color": "#fafafa",
  "display": "standalone",
  "scope": "/",
  "start_url": "/",
  "icons": [
    {
      "src": "assets/icons/icon-72x72.png",
      "sizes": "72x72",
      "type": "image/png"
    },
    …
    {
      "src": "assets/icons/icon-512x512.png",
      "sizes": "512x512",
      "type": "image/png"
    }
  ]
}

Sie können diese Eigenschaften anpassen, indem Sie den entsprechenden Wert in manifest.webmanifest ändern.

Eine PWA verweist auf ihre Manifestdatei mit einem link-Element in index.html. Sobald der Browser die Referenz gefunden hat, wird die Aufforderung Zum Startbildschirm hinzufügen angezeigt:

Da die ng-add-Schemata alles enthalten, was für die Installation Ihrer App erforderlich ist, werden einige Verknüpfungssymbole generiert, die angezeigt werden, sobald der Nutzer die App auf seinem Desktop hinzufügt:

Passen Sie die Manifest-Eigenschaften und Symbole an, bevor Sie Ihre PWA in der Produktion bereitstellen.

Fazit

So erstellen Sie eine installierbare Angular-App:

1. Fügen Sie Ihrem Projekt mit der Angular-Befehlszeile @angular/pwa hinzu.
2. Bearbeiten Sie die Optionen in der Datei manifest.webmanifest entsprechend Ihrem Projekt.
3. Aktualisieren Sie die Symbole im Verzeichnis src/assets/icons entsprechend Ihrem Projekt.
4. Optional können Sie die theme-color in index.html bearbeiten.