Skip to content

Commit

Permalink
Blazor Pre6 text updates (#29797)
Browse files Browse the repository at this point in the history
  • Loading branch information
guardrex authored Jul 13, 2023
1 parent 7bdbddb commit 93228eb
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 7 deletions.
38 changes: 31 additions & 7 deletions aspnetcore/blazor/tooling.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,12 @@ This article describes tools for building Blazor apps on various platforms. Sele

To create a Blazor app on Windows, use the following guidance:

* Install the latest version of [Visual Studio](https://visualstudio.microsoft.com) with the **ASP.NET and web development** workload.
<!-- UPDATE FOR 8.0 Remove Preview VS install from versioning blocks -->

:::moniker range=">= aspnetcore-8.0"

* Install the latest version of [Visual Studio Preview](https://visualstudio.microsoft.com/vs/preview/) with the **ASP.NET and web development** workload.

* Create a new project:
* For a Blazor Web App experience (*recommended*), choose the **Blazor Web App** template. Select **Next**.
* For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template, which includes demonstration code and Bootstrap, or the **Blazor WebAssembly App Empty** template without demonstration code and Bootstrap. Select **Next**.
Expand All @@ -31,6 +33,8 @@ To create a Blazor app on Windows, use the following guidance:

:::moniker range=">= aspnetcore-7.0 < aspnetcore-8.0"

* Install the latest version of [Visual Studio](https://visualstudio.microsoft.com) with the **ASP.NET and web development** workload.

* Create a new project:
* For a Blazor Server experience, choose the **Blazor Server App** template, which includes demonstration code and [Bootstrap](https://getbootstrap.com/), or the **Blazor Server App Empty** template without demonstration code and Bootstrap. Select **Next**.
* For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template, which includes demonstration code and Bootstrap, or the **Blazor WebAssembly App Empty** template without demonstration code and Bootstrap. Select **Next**.
Expand All @@ -39,6 +43,8 @@ To create a Blazor app on Windows, use the following guidance:

:::moniker range="< aspnetcore-7.0"

* Install the latest version of [Visual Studio](https://visualstudio.microsoft.com) with the **ASP.NET and web development** workload.

* Create a new project:
* For a Blazor Server experience, choose the **Blazor Server App** template. Select **Next**.
* For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template. Select **Next**.
Expand Down Expand Up @@ -90,8 +96,18 @@ To create a Blazor app on Linux, use the following guidance:

Use the [.NET command-line interface (CLI)](/dotnet/core/tools/) to execute commands in a Linux command shell.

:::moniker range=">= aspnetcore-8.0"

Install the latest version of the [.NET Core SDK Preview](https://dotnet.microsoft.com/download/dotnet/8.0). If you previously installed the SDK, you can determine your installed version by executing the following command:

:::moniker-end

:::moniker range="< aspnetcore-8.0"

Install the latest version of the [.NET Core SDK](https://dotnet.microsoft.com/download). If you previously installed the SDK, you can determine your installed version by executing the following command:

:::moniker-end

```dotnetcli
dotnet --version
```
Expand Down Expand Up @@ -475,15 +491,15 @@ For more information, see <xref:security/enforcing-ssl#trust-https-certificate-o

To create a Blazor app on macOS, use the following guidance:

* Install [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). When the installer requests the workloads to install, select **.NET**.

* Select **New Project** from the **File** menu or create a **New** project from the **Start Window**.

:::moniker range=">= aspnetcore-8.0"

<!-- UPDATE FOR 8.0 VS4Mac new project guidance -->

* For a Blazor Web Apps experience (*recommended*), Visual Studio for Mac can't create a Blazor Web App in its UI at this time.
* Install [Visual Studio for Mac Preview](https://visualstudio.microsoft.com/vs/mac/preview/). When the installer requests the workloads to install, select **.NET**.

* Select **New Project** from the **File** menu or create a **New** project from the **Start Window**.

* For a Blazor Web Apps experience (*recommended*), Visual Studio for Mac Preview can't create a Blazor Web App in its UI at this time.

Install the [.NET 8.0 Preview SDK](https://dotnet.microsoft.com/download/dotnet/8.0) using the correct macOS installer for your platform architecture (Arm64 or x64). For more information on trusting the ASP.NET Core HTTPS development certificate, see <xref:security/enforcing-ssl#trust-the-aspnet-core-https-development-certificate-on-windows-and-macos>.

Expand All @@ -495,7 +511,7 @@ To create a Blazor app on macOS, use the following guidance:

<!-- UPDATE FOR 8.0 Cross-link SSR -->

To enable interactivity with server-side rendering (SSR), add the `--use-server`option to the command:
To enable interactivity with server-side rendering (SSR), add the `--use-server` option to the command:

```dotnetcli
dotnet new blazor -o BlazorApp --use-server
Expand All @@ -520,6 +536,10 @@ For a Blazor Web App experience (*recommended*), choose the **Blazor Web App** t

:::moniker range=">= aspnetcore-7.0 < aspnetcore-8.0"

* Install [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). When the installer requests the workloads to install, select **.NET**.

* Select **New Project** from the **File** menu or create a **New** project from the **Start Window**.

* In the sidebar, select **Web and Console** > **App**.

* Create the app:
Expand All @@ -530,6 +550,10 @@ For a Blazor Web App experience (*recommended*), choose the **Blazor Web App** t

:::moniker range="< aspnetcore-7.0"

* Install [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/). When the installer requests the workloads to install, select **.NET**.

* Select **New Project** from the **File** menu or create a **New** project from the **Start Window**.

* In the sidebar, select **Web and Console** > **App**.

* Create the app:
Expand Down
4 changes: 4 additions & 0 deletions aspnetcore/blazor/tutorials/build-a-blazor-app.md
Original file line number Diff line number Diff line change
Expand Up @@ -424,6 +424,8 @@ Update the `<h1>` header to show a count of the number of todo items that aren't
<h1>Todo (@todos.Count(todo => !todo.IsDone))</h1>
```

<!-- UPDATE FOR 8.0 Re-enable the completed component display after the 8.0 sample app is created
The completed `Todo` component (`Pages/Todo.razor`):
:::moniker range=">= aspnetcore-8.0"
Expand Down Expand Up @@ -456,6 +458,8 @@ The completed `Todo` component (`Pages/Todo.razor`):
:::moniker-end
-->

Save the `Pages/Todo.razor` file. The app is automatically rebuilt in the command shell, and the page reloads in the browser.

Add items, edit items, and mark todo items done to test the component.
Expand Down

0 comments on commit 93228eb

Please sign in to comment.