ASP.NET Core Blazor 환경

이 기사는 앱에서 Blazor을 구성하고 읽는 방법을 설명합니다.

애플리케이션을 로컬에서 실행할 때 환경은 기본적으로 Development로 설정됩니다. 앱이 게시되면 환경은 Production로 기본 설정됩니다.

다음의 관례를 권장합니다:

• 항상 로컬 개발에서는 "Development" 환경 이름을 사용하세요. ASP.NET Core 프레임워크가 애플리케이션의 로컬 개발 실행을 위해 애플리케이션 및 도구를 구성할 때 정확히 그 이름을 기대하기 때문입니다.

• 테스트, 스테이징 및 프로덕션 환경에서는 항상 앱을 게시하고 배포하십시오. 게시된 앱의 경우 원하는 환경 네이밍 체계를 사용할 수 있지만, 환경 이름과 정확히 일치하는 환경 세그먼트의 대소문자가 포함된 앱 설정 파일 이름을 항상 사용하십시오. 스테이징에는 환경 이름으로 "Staging" (대문자 "S")를 사용하고, 이를 맞추기 위해 앱 설정 파일의 이름을 "appsettings.Staging.json"로 지정하십시오. 프로덕션에서는 "Production" (대문자 "P")를 환경 이름으로 사용하고, 앱 설정 파일을 동일하게 이름 지정하십시오 (appsettings.Production.json).

환경을 설정하세요

환경은 다음 접근 방식 중 하나를 사용하여 설정됩니다:

• Blazor Web App 또는 Blazor Server: 일반 ASP.NET Core 앱에 ASP.NET Core 런타임 환경에 설명된 접근 방식을 사용합니다.
• 모든 Blazor 앱: Blazor 구성 시작
• 독립 실행형 Blazor WebAssembly: <WasmApplicationEnvironmentName> 속성

클라이언트 Blazor Web App에서 환경은 개발자가 상호 작용하지 않는 HTML 주석을 통해 서버에서 결정됩니다.

<!--Blazor-WebAssembly:{"environmentName":"Development", ...}-->

독립 실행형 Blazor WebAssembly 앱의 경우 앱의 프로젝트 파일(<WasmApplicationEnvironmentName>)에서 MSBuild 속성을 사용하여 환경을 .csproj 설정합니다. 다음 예제에서는 Staging 환경을 설정합니다.

<WasmApplicationEnvironmentName>Staging</WasmApplicationEnvironmentName>

기본 환경은 Development 빌드 및 Production 게시용입니다.

빌드/게시 작업 중에 독립 실행형 Blazor WebAssembly 앱에서 환경을 설정하는 몇 가지 방법과 클라이언트에서 시작 또는 실행되는 앱에 대한 한 가지 방법이 있습니다.

• dotnet build 또는 dotnet publish이 실행될 때 속성 값을 설정합니다. 앱을 게시할 때 다음 예제에서 Staging 환경을 설정합니다.

  dotnet publish -p:WasmApplicationEnvironmentName=Staging
  

• Visual Studio에서 앱의 구성에 따라 빌드 또는 게시하는 동안 속성을 설정합니다. 앱의 프로젝트 파일 또는 게시 구성 파일(.pubxml)에서 다음 속성 그룹을 사용할 수 있습니다. 사용 중인 다른 빌드 구성에 대한 추가 속성 그룹을 추가합니다.

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
    <WasmApplicationEnvironmentName>Development</WasmApplicationEnvironmentName>
  </PropertyGroup>
  
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
    <WasmApplicationEnvironmentName>Production</WasmApplicationEnvironmentName>
  </PropertyGroup>
  

• 게시 프로필의 사용에 따라 환경을 설정할 수 있습니다. 다음 예제에서 첫 번째 조건은 게시 프로필이 사용되지 않는 경우(프로필 없이 빌드 및 게시 작업에 모두 적용됨) 환경을 Development 설정하는 반면, 두 번째 조건은 게시 프로필이 사용되는 시점으로 환경을 설정하는 방법을 Production 다룹니다.

  <PropertyGroup Condition="'$(PublishProfile)' == ''">
    <WasmApplicationEnvironmentName>Development</WasmApplicationEnvironmentName>
  </PropertyGroup>
  
  <PropertyGroup Condition="'$(PublishProfile)' != ''">
    <WasmApplicationEnvironmentName>Production</WasmApplicationEnvironmentName>
  </PropertyGroup>
  

• 사용자 지정 서버 쪽 웹 API 엔드포인트를 만듭니다. 독립 실행형 Blazor WebAssembly 앱은 실행되는 동안 앱 시작 시 또는 주문형 웹 API에서 해당 환경을 요청합니다. 값은 WebAssemblyStartOptions에 전달되거나 withApplicationEnvironment와 함께 전달되어야 합니다.

  비고

  문서 링크는 .NET 참조 소스를 가리키며, 일반적으로 저장소의 기본 브랜치를 로드합니다. 이는 .NET의 다음 릴리스를 위한 현재 개발 상태를 나타냅니다. 특정 릴리스를 위한 태그를 선택하려면 Switch branches or tags 드롭다운 목록을 사용하세요. 자세한 내용은 ASP.NET Core 소스 코드(dotnet/AspNetCore.Docs #26205)의 버전 태그를 선택하는 방법을 참조하세요.

로컬에서 개발 중 실행되는 앱의 경우, 앱은 Development 환경을 기본값으로 합니다. 앱을 게시하면 환경은 기본적으로 Production로 설정됩니다.

클라이언트 측 환경을 Blazor 시작 구성으로 설정하세요.

호스트 이름에 Blazor가 포함되어 있으면 다음 예제는 Staging 환경에서 localhost을 시작합니다. 그렇지 않으면 환경이 기본값으로 설정됩니다.

Blazor Web App:

<script src="{BLAZOR SCRIPT}" autostart="false"></script>
<script>
  if (window.location.hostname.includes("localhost")) {
    Blazor.start({
      webAssembly: {
        environment: "Staging"
      }
    });
  } else {
    Blazor.start();
  }
</script>

앞의 예제 {BLAZOR SCRIPT} 에서 자리 표시자는 스크립트 경로 및 파일 이름입니다 Blazor . 스크립트의 위치는 ASP.NET Core Blazor 프로젝트 구조를 참조하세요.

비고

Blazor Web App 설정에서 webAssembly>environment 속성을 설정하는 Blazor.start의 경우, 서버 측 환경을 environment 속성에 설정한 환경과 일치시키는 것이 좋습니다. 그렇지 않으면 서버의 미리 렌더링은 클라이언트에서 렌더링하는 것과 다른 환경에서 작동하므로 임의 효과가 발생합니다. 환경 설정에 대한 Blazor Web App일반적인 지침은 ASP.NET Core 런타임 환경을 참조하세요.

독립형 Blazor WebAssembly:

<script src="{BLAZOR SCRIPT}" autostart="false"></script>
<script>
  if (window.location.hostname.includes("localhost")) {
    Blazor.start({
      environment: "Staging"
    });
  } else {
    Blazor.start();
  }
</script>

앞의 예제 {BLAZOR SCRIPT} 에서 자리 표시자는 스크립트 경로 및 파일 이름입니다 Blazor . 스크립트의 위치는 ASP.NET Core Blazor 프로젝트 구조를 참조하세요.

독립 실행형 Blazor WebAssembly 앱 또는 .Client의 Blazor Web App 프로젝트에서 환경을 콘솔에 기록하려면, Program를 WebAssemblyHost로 생성한 후 프로젝트를 빌드하고 실행하는 줄 (WebAssemblyHostBuilder.CreateDefault) 이전에 다음 C# 코드를 await builder.Build().RunAsync(); 파일에 배치하십시오.

Console.WriteLine(
    $"Client Hosting Environment: {builder.HostEnvironment.Environment}");

Blazor 시작에 대한 자세한 내용은 ASP.NET Core Blazor 시작을 참조하세요.

Blazor WebAssembly 앱의 환경 읽기

속성을 삽입 IWebAssemblyHostEnvironment 하고 읽어 구성 요소에서 앱의 환경을 가져옵니다 Environment .

ReadEnvironment.razor:

@page "/read-environment"
@using Microsoft.AspNetCore.Components.WebAssembly.Hosting
@inject IWebAssemblyHostEnvironment Env

<h1>Environment example</h1>

<p>Environment: @Env.Environment</p>

환경을 클라이언트 측에서 읽습니다 Blazor Web App

컴포넌트나 앱에 대해 사전 렌더링이 비활성화되지 않은 경우, .Client 프로젝트의 컴포넌트는 서버에서 사전 렌더링됩니다. 서버에 등록된 IWebAssemblyHostEnvironment 서비스가 없기 때문에, 서버 사전 렌더링 동안 서비스 구현의 호스트 환경 확장 메서드 및 속성을 주입하고 사용할 수 없습니다. 서비스를 인터랙티브 웹어셈블리 또는 인터랙티브 자동 구성 요소에 주입하면 다음 실행 오류가 발생합니다.

There is no registered service of type 'Microsoft.AspNetCore.Components.WebAssembly.Hosting.IWebAssemblyHostEnvironment'.

이를 해결하기 위해 서버에서 IWebAssemblyHostEnvironment에 대한 사용자 정의 서비스 구현을 생성하십시오. 자세한 내용 및 예제 구현은 설명서의 뒷부분에 나오는 미리 렌더링 문서의 서버 섹션에서 사용자 지정 서비스 구현을 Blazor 참조하세요.

시작 시 클라이언트 측 환경을 읽기

시작할 때 WebAssemblyHostBuilder는 IWebAssemblyHostEnvironment 속성을 통해 HostEnvironment을 공개하여 호스트 빌더 코드에서 환경별 로직을 사용할 수 있게 합니다.

Program 파일에서:

if (builder.HostEnvironment.Environment == "Custom")
{
    ...
};

다음의 편리한 확장 메서드는 WebAssemblyHostEnvironmentExtensions를 통해 제공되며, 현재 환경에서 Development, Production, Staging, 그리고 사용자 지정 환경 이름을 확인할 수 있습니다.

• IsDevelopment
• IsProduction
• IsStaging
• IsEnvironment

Program 파일에서:

if (builder.HostEnvironment.IsStaging())
{
    ...
};

if (builder.HostEnvironment.IsEnvironment("Custom"))
{
    ...
};

IWebAssemblyHostEnvironment.BaseAddress 속성은 NavigationManager 서비스가 사용할 수 없을 때 시작 시 사용할 수 있습니다.

추가 리소스

• ASP.NET Core Blazor 시작
• ASP.NET Core 런타임 환경
• Blazor 샘플 GitHub 리포지토리 (dotnet/blazor-samples) (다운로드 방법)