Starten des Emulators für die Static Web Apps CLI
Wichtig
Um die Sicherheit von Bereitstellungen aus der Static Web Apps CLI zu verbessern, wurde ein Breaking Change eingeführt, der es erforderlich macht, bis zum 15. Januar 2025 ein Upgrade auf die neueste Version (2.0.2) der Static Web Apps CLI durchzuführen.
Static Web Apps ist eine cloudbasierte Plattform, auf der Ihre Web-Apps gehostet und ausgeführt werden. Wenn Sie Ihre App lokal ausführen, benötigen Sie spezielle Tools, mit denen Sie abschätzen können, wie Ihre App in der Cloud ausgeführt wird.
Die Static Web Apps CLI (SWA CLI) bietet einen Emulator, der nachahmt, wie Ihre App in Azure ausgeführt wird, aber ausschließlich auf Ihrem Computer ausgeführt wird.
Der Befehl swa start startet den Emulator mit Standardeinstellungen. Standardmäßig verwendet der Emulator Port 4280.
Weitere Informationen zu einzelnen Befehlen finden Sie in der CLI-Referenz.
Bereitstellen statischer Dateien aus Ihrem Dateisystem
Die SWA CLI ermöglicht Ihnen, Ihre statischen Inhalte direkt aus Ihrem Dateisystem ohne weitere Tools bereitzustellen. Sie können entweder statische Inhalte aus Ihrem aktuellen Verzeichnis oder einem bestimmten Ordner bereitstellen.
| Bereitstellung aus: | Get-Help | Notizen |
|---|---|---|
| Aktueller Ordner | swa start |
Standardmäßig startet die CLI aus dem aktuellen Arbeitsverzeichnis und stellt auch aus diesem statische Inhalte (HTML-, Image-, Skript- und CSS-Dateien) bereit. |
| Bestimmter Ordner | swa start ./my-dist |
Sie können dieses Verhalten außer Kraft setzen, um den Emulator mit einem anderen Ordner für statische Inhalte zu starten. |
Verwenden eines Entwicklungsservers
Wenn Sie das Front-End Ihrer App entwickeln, möchten Sie wahrscheinlich den Standardentwicklungsserver des Frameworks verwenden. Mit dem Server eines Frameworks können Sie Vorteile wie Echtzeit-Neuladen und HMR (Hot Module Replacement) nutzen.
So verwenden Fachkräfte in der Angular-Entwicklung häufig ng serve oder npm start, um den Entwicklungsserver auszuführen.
Sie können die Static Web Apps CLI (SWA CLI) so einrichten, dass Proxyanforderungen an den Entwicklungsserver gesendet werden. Dadurch nutzen Sie die Vorteile der CLI Ihres Frameworks und können gleichzeitig die Static Web Apps CLI verwenden.
Es sind zwei Schritte erforderlich, um den Entwicklungsservers eines Frameworks zusammen mit der SWA CLI nutzen zu können:
Starten Sie den lokalen Entwicklungsserver Ihres Frameworks wie gewohnt. Notieren Sie sich unbedingt die URL (einschließlich des Ports), die vom Framework verwendet wird.
Starten Sie die SWA CLI in einem neuen Terminal, und übergeben Sie die URL des Entwicklungsservers.
swa start <DEV_SERVER_URL>
Hinweis
Ersetzen Sie unbedingt den Platzhalter <DEV_SERVER_URL> durch Ihren Wert.
Starten des Entwicklungsservers
Sie können Ihren Workflow weiter vereinfachen, indem Sie den Entwicklungsserver durch die SWA CLI starten lassen.
Sie können über den --run-Parameter einen benutzerdefinierten Befehl an den Befehl swa start übergeben.
swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>
Im Folgenden finden Sie einige Beispiele für das Starten des Emulators mit unterschiedlichen Frameworks:
| Framework | Get-Help |
|---|---|
| React | swa start http://localhost:3000 --run "npm start" |
| Blazor | swa start http://localhost:5000 --run "dotnet watch run" |
| Jekyll | swa start http://localhost:4000 --run "jekyll serve" |
Sie können den --run-Parameter auch verwenden, wenn Sie ein benutzerdefiniertes Skript ausführen möchten, während Sie den Entwicklungsserver starten.
swa start http://localhost:4200 --run "./startup.sh"
Mit dem obigen Befehl können Sie auf die Anwendung mit den emulierten Diensten in http://localhost:4280 zugreifen.