ASP.NET Core Blazor WebAssembly ferramentas de build e compilação ahead-of-time (AOT) (compilação antecipada)

Este artigo descreve as ferramentas de compilação para aplicativos autônomos Blazor WebAssembly e como compilar um aplicativo antes da implantação com compilação antecipada (AOT).

Ferramentas de compilação do .NET WebAssembly

As ferramentas de compilação do .NET WebAssembly são baseadas no Emscripten, uma cadeia de ferramentas de compilador para a plataforma Web.

Para instalar as ferramentas de compilação como uma carga de trabalho .NET, use uma das seguintes abordagens:

• Para a carga de trabalho de ASP.NET e desenvolvimento da Web no instalador do Visual Studio, selecione a opção Ferramentas de compilação do .NET WebAssembly na lista de componentes opcionais. A opção garante o seguinte:

  • A carga de trabalho está instalada no SDK .NET mais recente.
  • Quando uma nova versão do Visual Studio é lançada e contém um novo SDK do .NET, a opção instala a carga de trabalho para o novo SDK.

• Como alternativa, execute o seguinte comando em um shell de comando administrativo para instalar a carga de trabalho mais recente no SDK .NET mais recente disponível no sistema:

  dotnet workload install wasm-tools
  

Para direcionar um lançamento anterior do .NET com um determinado SDK do .NET, instale o workload wasm-tools-net{MAJOR VERSION}.

• O {MAJOR VERSION} espaço reservado é substituído pelo número da versão principal da versão .NET que você deseja direcionar (por exemplo, wasm-tools-net8 para .NET 8).
• As cargas de trabalho são instaladas por SDK do .NET. A instalação da wasm-tools carga de trabalho para um SDK não a torna disponível para outros SDKs no sistema.
• Você deve instalar a carga de trabalho apropriada para cada versão do SDK do .NET que pretende usar.

A lista a seguir mostra qual carga de trabalho instalar para cada SDK do .NET, dependendo dos aplicativos que você planeja segmentar. Embora várias linhas possam conter o mesmo nome de carga de trabalho, as cargas de trabalho sempre diferem ligeiramente para cada SDK .NET específico.

• Usando o SDK do .NET 10
  • Para direcionar o .NET 10, é necessário wasm-tools.
  • Targeting .NET 9 requer wasm-tools-net9.
  • O direcionamento para o .NET 8 requer wasm-tools-net8.
• Usando o SDK do .NET 9
  • Targeting .NET 9 requer wasm-tools.
  • O direcionamento para o .NET 8 requer wasm-tools-net8.
• Usando o SDK do .NET 8: destinar o .NET 8 requer wasm-tools.

Compilação Antecipada (AOT)

Blazor WebAssembly suporta compilação ahead-of-time (AOT), onde você pode compilar seu código .NET diretamente no WebAssembly. A compilação AOT resulta em melhorias de desempenho em tempo de execução às custas de um tamanho de aplicativo maior.

Para obter orientação sobre como instalar as ferramentas de compilação do .NET WebAssembly, consulte ASP.NET Core Blazor WebAssembly build tools and ahead-of-time (AOT) compilation.

Para habilitar a compilação WebAssembly AOT, adicione a <RunAOTCompilation> propriedade definida para true ao Blazor WebAssembly arquivo de projeto do aplicativo:

<PropertyGroup>
  <RunAOTCompilation>true</RunAOTCompilation>
</PropertyGroup>

Para compilar o aplicativo para WebAssembly, publique o aplicativo. A publicação da Release configuração garante que a vinculação IL (.NET Intermediate Language) também seja executada para reduzir o tamanho do aplicativo publicado:

dotnet publish -c Release

A compilação WebAssembly AOT só é executada quando o projeto é publicado. A compilação AOT não é usada quando o projeto é executado durante o desenvolvimento (Development ambiente) porque a compilação AOT geralmente leva vários minutos em projetos pequenos e potencialmente muito mais tempo para projetos maiores. A redução do tempo de compilação para a compilação AOT está em desenvolvimento para versões futuras do ASP.NET Core.

O tamanho de um aplicativo compilado Blazor WebAssembly pela AOT geralmente é maior do que o tamanho do aplicativo se compilado no .NET IL:

• Embora a diferença de tamanho dependa do aplicativo, a maioria dos aplicativos compilados pela AOT tem cerca de duas vezes o tamanho de suas versões compiladas por IL. Isso significa que o uso da compilação AOT compensa o desempenho em tempo de carregamento pelo desempenho em tempo de execução. Se essa compensação vale a pena usar a compilação AOT depende do seu aplicativo. Blazor WebAssembly os aplicativos que consomem muita CPU geralmente se beneficiam mais da compilação AOT.

• O tamanho maior de um aplicativo compilado pela AOT se deve a duas condições:

  • É necessário mais código para representar instruções de IL .NET de alto nível no WebAssembly nativo.
  • A AOT não corta DLLs gerenciadas quando o aplicativo é publicado. Blazor requer as DLLs para metadados de reflexão e para apoiar certas funcionalidades do runtime .NET. Exigir as DLLs no cliente aumenta o tamanho do download, mas fornece uma experiência .NET mais compatível.

Desempenho

Para obter orientações sobre desempenho, consulte o desempenho do tempo de execução do ASP.NET CoreBlazor WebAssembly.

• Tamanho do heap para alguns navegadores de dispositivos móveis
• Revinculação de tempo de execução
• Instrução única, vários dados (SIMD)
• Cortar IL do .NET após compilação antecipada (AOT) (.NET 8 ou posterior)

Processamento de exceções

<PropertyGroup>
  <WasmEnableExceptionHandling>false</WasmEnableExceptionHandling>
</PropertyGroup>

<PropertyGroup>
  <WasmEnableExceptionHandling>true</WasmEnableExceptionHandling>
</PropertyGroup>

Para obter mais informações, consulte os seguintes recursos:

• Configurando e hospedando aplicativos .NET WebAssembly: EH - Tratamento de exceções
• Tratamento de exceções

Recursos adicionais

• ASP.NET Desempenho de tempo de execução principal Blazor WebAssembly
• ASP.NET Core Blazor WebAssembly dependências nativas
• Formato de empacotamento Webcil para assemblies .NET