啟動靜態 Web Apps CLI 模擬器
重要
為了改善靜態 Web Apps CLI 部署的安全性,引進了重大變更,要求您在 2025 年 1 月 15 日之前升級至最新版的靜態 Web Apps CLI。
Static Web Apps 是雲端式平臺,可裝載和執行您的 Web 應用程式。 當您在本機執行應用程式時,您需要特殊的工具來協助您大致瞭解應用程式在雲端中執行的方式。
Static Web Apps CLI (SWA CLI) 包含模擬器,其會模擬您的應用程式在 Azure 上執行的方式,但改為只在您的電腦上執行。
命令 swa start
會啟動具有預設設定的模擬器。 根據預設,模擬器會使用連接埠 4280
。
如需個別命令的詳細資訊,請參閱 CLI 參考。
從檔案系統提供靜態檔案
SWA CLI 可讓您直接從文件系統提供靜態內容,而不需要其他必要工具。 您可以從目前目錄或特定資料夾提供靜態內容。
從... | Command | 注意 |
---|---|---|
目前資料夾 | swa start |
根據預設,CLI 會從目前的工作目錄啟動並提供靜態內容(HTML、影像、腳本和 CSS 檔案)。 |
特定資料夾 | swa start ./my-dist |
您可以覆寫行為,以使用不同的靜態資產資料夾啟動模擬器。 |
使用開發伺服器
當您開發應用程式的前端時,您可能想要使用架構的預設開發伺服器。 使用架構的伺服器可讓您利用即時重載和熱模組取代 (HMR) 等優點。
例如,Angular 開發人員通常會使用 ng serve
或 npm start
來執行開發伺服器。
您可以將 Static Web Apps SWA CLI 設定為對開發伺服器的 Proxy 要求,這可讓您在同時使用靜態 Web Apps CLI 的同時,同時使用架構的 CLI 的優點。
使用架構的開發伺服器以及 SWA CLI 有兩個步驟:
像往常一樣啟動架構的本機開發伺服器。 請務必記下架構所使用的 URL(包括埠)。
在新的終端機中啟動SWA CLI,並傳入開發伺服器URL。
swa start <DEV_SERVER_URL>
注意
請務必將 <DEV_SERVER_URL>
佔位元取代為您自己的值。
啟動開發伺服器
您可以讓SWA CLI為您啟動開發伺服器,進一步簡化工作流程。
您可以將自訂命令傳遞至 --run
參數至 swa start
命令。
swa start <DEV_SERVER_URL> --run <DEV_SERVER_LAUNCH_COMMAND>
以下是使用幾個不同架構啟動模擬器的一些範例:
架構 | Command |
---|---|
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" |
如果您想要在啟動開發伺服器時執行自定義腳本,也可以使用 --run
參數。
swa start http://localhost:4200 --run "./startup.sh"
使用上述命令,您可以使用模擬服務從 存取應用程式 http://localhost:4280