通过

使用 Azure Static Web Apps 托管和部署独立版的 ASP.NET Core Blazor WebAssembly

注释

此版本不是本文的最新版本。 要查看当前版本，请参阅本文的.NET 9 版本。

警告

此版本的 ASP.NET Core 不再受支持。 有关详细信息，请参阅 .NET 和 .NET Core 支持策略。 要查看当前版本，请参阅本文的.NET 9 版本。

重要

此信息与预发布产品相关，相应产品在商业发布之前可能会进行重大修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。

要查看当前版本，请参阅本文的.NET 9 版本。

本文介绍如何使用 Blazor WebAssembly来托管和部署独立应用。

应用程序配置

若要确保对任何路径的请求返回 index.html，请设置导航回退路由。

使用以下内容在项目的根文件夹中创建一个名为 staticwebapp.config.json 的文件：

{
  "navigationFallback": {
    "rewrite": "/index.html"
  }
}

从 Visual Studio 部署

若要从 Visual Studio 进行部署，请为 Azure Static Web Apps 创建发布配置文件：

  1. 保存项目中所有未保存的工作，因为在此过程中可能需要重启 Visual Studio。

  2. 在 Visual Studio 的“发布”UI 中，选择“目标”“Azure”“特定目标”>“Azure Static Web Apps”创建发布配置文件。

  3. 如果未安装适用于 Visual Studio 的 Azure WebJobs 工具组件，则会提示安装 ASP.NET 和 Web 开发组件。 按照提示使用 Visual Studio 安装程序安装工具。 安装工具时，Visual Studio 会自动关闭并重新打开。 安装这些工具后，从第一步开始创建发布配置文件。

  4. 在发布配置文件配置中，提供“订阅名称”。 选择现有实例，或选择“创建新实例”。 在 Azure 门户的“创建静态 Web 应用”UI 中创建新实例时，请将“部署详细信息”“源”设置为“其他”。 在 Azure 门户中等待部署完成，然后再继续。

  5. 在发布配置文件配置中，从实例的资源组中选择 Azure Static Web Apps 实例。 选择“完成”以创建发布配置文件。 如果 Visual Studio 提示安装 Static Web Apps (SWA) CLI，请按照提示安装 CLI。 SWA CLI 需要 npm/Node.js （Visual Studio 文档）。

创建发布配置文件后，选择“发布”按钮，使用发布配置文件将应用部署到 Azure Static Web Apps 实例。

GitHub 部署方案