托管和部署概述

托管和部署 ASP.NET Core Blazor

作者:Luke LathamRainer StropekDaniel Roth

重要

Blazor WebAssembly 为预览版状态

ASP.NET Core 3.0 支持 Blazor Server 。 Blazor WebAssembly 在 ASP.NET Core 3.1 中为预览版。

发布应用

发布应用,用于发布配置中的部署。

创建部署资产前,发布应用将触发项目依赖项的还原生成生成该项目。 在生成过程期间,将删除未使用的方法和程序集,以减少应用下载大小并缩短加载时间。

Blazor WebAssembly 应用发布到 /bin/Release/{TARGET FRAMEWORK}/publish/{ASSEMBLY NAME}/dist 文件夹中 。 Blazor 服务器应用将发布到 /bin/Release/{TARGET FRAMEWORK}/publish 文件夹 。

文件夹中的资产将部署到 Web 服务器。 部署可能是手动或自动化过程,具体取决于使用的开发工具。

应用基路径

应用基路径是应用的根 URL 路径。 请考虑使用下列 ASP.NET Core 应用和 Blazor 子应用:

  • ASP.NET Core 应用名为 MyApp
    • 该应用实际驻留在 d:/MyApp 中 。
    • https://www.contoso.com/{MYAPP RESOURCE} 收到请求。
  • 名为 CoolApp 的 Blazor 应用是 MyApp 的子应用:
    • 子应用实际驻留在 d:/MyApp/CoolApp 中 。
    • https://www.contoso.com/CoolApp/{COOLAPP RESOURCE} 收到请求。

如果不为 CoolApp 指定其他配置,此方案中的子应用将不知道其在服务器上的位置。 例如,不知道它驻留在相对 URL 路径 /CoolApp/ 上,应用就无法构造其资源的正确相对 URL。

要为 Blazor 应用的基路径 https://www.contoso.com/CoolApp/ 提供配置,请将 <base> 标记的 href 属性设置为 Pages/_Host.cshtml 文件(Blazor 服务器)或 wwwroot/index.html 文件 (Blazor WebAssembly) 中的相对根路径 :

<base href="/CoolApp/">

Blazor 服务器应用还会在应用的请求管道 Startup.Configure 中调用 UsePathBase,设置服务器端基路径:

app.UsePathBase("/CoolApp");

提供相对 URL 路径,不再根目录中的元件可以构造相对于应用根路径的 URL。 位于目录结构不同级别的组件可生成指向整个应用其他位置的资源链接。 应用基路径也用于拦截所选超链接,其中链接的 href 目标位于应用基路径 URI 空间中。 Blazor 路由器负责处理内部导航。

在许多托管方案中,应用的相对 URL 路径为应用的根目录。 在这些情况下,应用的相对 URL 基路径为正斜杠 (<base href="/" />),它是 Blazor 应用的默认配置。 在其他托管方案中(例如 GitHub 页和 IIS 子应用),应用基路径必须设置为应用的服务器相对 URL 路径。

要设置应用的基路径,请更新 Pages/_Host.cshtml 文件(Blazor 服务器)或 wwwroot/index.html 文件 (Blazor WebAssembly) 的 <head> 标记元素中的 <base> 标记 。 href 属性值设置为 /{RELATIVE URL PATH}/(需要尾部反斜杠),其中 {RELATIVE URL PATH} 是应用完整相对 URL 路径。

对于具有非根相对 URL 路径的 Blazor WebAssembly 应用(例如 <base href="/CoolApp/">),应用在本地运行时无法查找其资源 。 要在本地开发和测试过程中解决此问题,可提供 path base 参数,用于匹配运行时 <base> 标记的 href 值 。 不要包含尾部反斜杠。 在本地运行应用时,若要传递路径基础参数,请使用 --pathbase 选项从应用的目录执行 dotnet run 命令:

dotnet run --pathbase=/{RELATIVE URL PATH (no trailing slash)}

对于具有相对 URL 路径 /CoolApp/ (<base href="/CoolApp/">) 的 Blazor WebAssembly 应用,命令如下:

dotnet run --pathbase=/CoolApp

Blazor WebAssembly 应用在http://localhost:port/CoolApp 本地响应。

部署

有关部署指南,请参阅以下主题: