啟動靜態 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