ASP.NET Core Blazor ortamları

Bu makale, bir uygulamasında Blazor nasıl yapılandıracağınızı ve okuyacağınızı açıklar.

Bir uygulamayı yerel olarak çalıştırırken, ortam varsayılan olarak Developmentolarak değiştirilir. Uygulama yayımlandığında ortam varsayılan olarak Productionolarak ayarlanır.

Aşağıdaki kuralları öneririz:

• Yerel geliştirme için her zaman "Development" ortam adını kullanın. Bunun nedeni, ASP.NET Core çerçevesinin uygulamayı yapılandırırken tam olarak bu adı beklemesi ve bir uygulamanın yerel geliştirme çalıştırmaları için araçlara sahip olmasıdır.

• Test, hazırlama ve üretim ortamları için uygulamayı her zaman yayımlayın ve dağıtın. Yayımlanan uygulamalar için istediğiniz ortam adlandırma düzenini kullanabilirsiniz, ancak her zaman ortam adıyla tam olarak eşleşen büyük/küçük harflerle yazılmış ortam bölümü içeren ayar dosya adlarını kullanmalısınız. Hazırlama için ortam adı olarak "Staging" (büyük "S") kullanın ve uygulama ayarları dosyasını eşleşecek şekilde adlandırın (appsettings.Staging.json). Üretim için ortam adı olarak "Production" (büyük "P") kullanın ve uygulama ayarları dosyasını eşleşecek şekilde adlandırın (appsettings.Production.json).

Ortamı ayarlama

Ortam aşağıdaki yaklaşımlardan herhangi biri kullanılarak ayarlanır:

• Blazor Web App veya Blazor Server: Genel ASP.NET Core uygulamaları için ASP.NET Core çalışma zamanı ortamlarında açıklanan yaklaşımlardan herhangi birini kullanın.
• Herhangi bir Blazor uygulama: Blazor yapılandırmayı başlatma
• Tek başına Blazor WebAssembly: <WasmApplicationEnvironmentName> özelliği

İstemci için Blazor Web App, ortam geliştiricilerin etkileşimde bulunmadığı bir HTML yorumu aracılığıyla sunucudan belirlenir.

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

Tek başına Blazor WebAssembly bir uygulama için, uygulamanın proje dosyasında (<WasmApplicationEnvironmentName>) MSBuild özelliğiyle .csproj ortamı ayarlayın. Aşağıdaki örnek Staging ortamını ayarlar:

<WasmApplicationEnvironmentName>Staging</WasmApplicationEnvironmentName>

Varsayılan ortamlar Development derleme ve Production yayımlama içindir.

Derleme/yayımlama işlemleri sırasında tek başına Blazor WebAssembly bir uygulamada ortamı ayarlamak için çeşitli yaklaşımlar ve istemcide başlayan veya çalışan bir uygulama için bir yaklaşım vardır:

• dotnet build veya dotnet publish yürütüldüğünde özellik değerini ayarlayın. Aşağıdaki örnek, bir uygulama yayımlandığında ortamı olarak Staging ayarlar:

  dotnet publish -p:WasmApplicationEnvironmentName=Staging
  

• Visual Studio'da uygulamanın yapılandırmasına göre derleme veya yayımlama sırasında özelliğini ayarlayın. Aşağıdaki özellik grupları, uygulamanın proje dosyasında veya herhangi bir yayımlama yapılandırma dosyasında (.pubxml ) kullanılabilir. Kullanımdaki diğer derleme yapılandırmaları için ek özellik grupları ekleyin.

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

• Ortam, yayımlama profilinin kullanımına göre ayarlanabilir. Aşağıdaki örnekte ilk koşul, yayımlama profili kullanılmadığında ortamı Development olarak ayarlar (profil olmadan hem derleme hem de yayımlama işlemleri için geçerlidir), ikinci koşul ise herhangi bir yayımlama profili kullanıldığında ortamı Production olarak ayarlamayı kapsar:

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

• Özel bir sunucu tarafı web API'si uç noktası oluşturun. Tek başına Blazor WebAssembly uygulama, uygulama başlangıcında veya çalışırken isteğe bağlı olarak kendi ortamını web API'sinden ister. Değer, WebAssemblyStartOptions veya withApplicationEnvironment ile geçirilmelidir.

  Not

  .NET başvuru kaynağına yönelik belge bağlantıları genellikle deponun varsayılan dalını yükler ve bu dal .NET'in sonraki sürümü için geçerli geliştirmeyi temsil eder. Belirli bir sürümün etiketini seçmek için Dallar veya etiketler arasında geçiş yap açılır listesini kullanın. Daha fazla bilgi için ASP.NET Core kaynak kodu için bir sürüm etiketi nasıl seçilir (dotnet/AspNetCore.Docs #26205) bölümüne bakın.

Uygulamanın geliştirme aşamasında yerel olarak çalışması için uygulama varsayılan olarak Development ortamına ayarlı olur. Uygulamayı yayımlamak, ortamı varsayılan olarak Productionolarak ayarlıyor.

Blazor başlangıç yapılandırması aracılığıyla istemci tarafı ortamını ayarlama

Aşağıdaki örnek, konak adı Blazoriçeriyorsa, Staging ortamında localhost olarak başlar. Aksi takdirde ortam varsayılan değerine ayarlanır.

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>

Yukarıdaki örnekte, {BLAZOR SCRIPT} yer tutucusu Blazor betik yolu ve dosya adıdır. Betiğin konumu için bkz. ASP.NET Core Blazor proje yapısı.

Not

Blazor Web App yapılandırmasında webAssembly>environment özelliğini ayarlayan Blazor.startiçin, sunucu tarafı ortamını environment özelliğinde ayarlanan ortamla eşleştirmek akıllıca olacaktır. Aksi takdirde, sunucuda önceden oluşturma, istemci üzerindeki oluşturmadan farklı bir ortamda çalışır ve bu da rastgele etkilere neden olur. Genel ortam ayarlama yönergeleri için Blazor Web App bkz. ASP.NET Core çalışma zamanı ortamları.

Bağımsız Blazor WebAssembly:

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

Yukarıdaki örnekte, {BLAZOR SCRIPT} yer tutucusu Blazor betik yolu ve dosya adıdır. Betiğin konumu için bkz. ASP.NET Core Blazor proje yapısı.

Ortamı tek başına Blazor WebAssembly bir uygulamada veya .Client bir Blazor Web App projesinde konsola günlüğe kaydetmek için, ProgramWebAssemblyHost ile oluşturulduktan sonra, aşağıdaki C# kodunu WebAssemblyHostBuilder.CreateDefault dosyasına, projeyi derleyen ve çalıştıran satırdan önce (await builder.Build().RunAsync();), yerleştirin.

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

Blazor başlangıç hakkında daha fazla bilgi için bkz. ASP.NET Core Blazor başlangıç.

Blazor WebAssembly uygulamasında ortamı okuma

IWebAssemblyHostEnvironment ekleyerek ve Environment özelliğini okuyarak uygulamanın ortamını bir bileşende edinin.

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'dan ortamı istemci tarafında oku

Bir bileşen veya uygulama için prerendering'in devre dışı bırakılmadığını varsayarsak, .Client projesindeki bir bileşen sunucuda önceden oluşturulur. Sunucunun kayıtlı bir IWebAssemblyHostEnvironment hizmeti olmadığından, hizmeti eklemek ve sunucu hazırlama sırasında hizmet uygulamasının ana bilgisayar ortamı uzantısı yöntemlerini ve özelliklerini kullanmak mümkün değildir. Hizmeti Etkileşimli WebAssembly veya Etkileşimli Otomatik bileşene eklemek aşağıdaki çalışma zamanı hatasına neden olur:

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

Bu sorunu gidermek için sunucuda IWebAssemblyHostEnvironment için özel bir hizmet uygulaması oluşturun. Daha fazla bilgi edinmek ve örnek bir uygulama için, belgelerde daha sonra görünen Prerendering makalesinin sunucu bölümündeki Özel hizmet uygulaması bölümüne Blazor bakın.

Başlatma sırasında istemci tarafı ortamını oku

Başlatma sırasında WebAssemblyHostBuilder, IWebAssemblyHostEnvironment özelliği aracılığıyla HostEnvironment'i, konak oluşturucu kodunda ortama özgü mantığı etkinleştiren şekilde kullanıma sunar.

Program dosyasında:

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

WebAssemblyHostEnvironmentExtensions aracılığıyla sağlanan aşağıdaki kolaylık uzantısı yöntemleri, Development, Production, Stagingve özel ortam adları için geçerli ortamı denetlemeye izin verir:

• IsDevelopment
• IsProduction
• IsStaging
• IsEnvironment

Program dosyasında:

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

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

IWebAssemblyHostEnvironment.BaseAddress özelliği, NavigationManager hizmeti kullanılamadığında başlatma sırasında kullanılabilir.

Ek kaynaklar

• ASP.NET Core Blazor başlatma
• ASP.NET Core çalışma zamanı ortamları
• Blazor örnekleri GitHub deposu (dotnet/blazor-samples) (nasıl indirileceği)