Skip to content

Commit 6d607a0

Browse files
authored
VS4Mac 8.6 updates (#18262)
1 parent 8f6b020 commit 6d607a0

9 files changed

Lines changed: 57 additions & 48 deletions

File tree

aspnetcore/blazor/get-started.md

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Get started with Blazor by building a Blazor app with the tooling o
55
monikerRange: '>= aspnetcore-3.1'
66
ms.author: riande
77
ms.custom: mvc
8-
ms.date: 05/02/2020
8+
ms.date: 05/11/2020
99
no-loc: [Blazor, "Identity", "Let's Encrypt", Razor, SignalR]
1010
uid: blazor/get-started
1111
---
@@ -84,51 +84,52 @@ To get started with Blazor, follow the guidance for your choice of tooling:
8484

8585
# [Visual Studio for Mac](#tab/visual-studio-mac)
8686

87-
Blazor Server is supported in Visual Studio for Mac. Blazor WebAssembly isn't supported at this time. To create Blazor WebAssembly apps on macOS, follow the guidance on the **.NET Core CLI** tab. For information on the two Blazor hosting models, *Blazor WebAssembly* and *Blazor Server*, see <xref:blazor/hosting-models>.
87+
> [!NOTE]
88+
> Blazor Server is supported in Visual Studio for Mac 8.4 or later, and Blazor WebAssembly support is included in Visual Studio for Mac 8.6 or later.
8889
8990
1. Install [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/).
9091

91-
1. Select **File** > **New Solution** or create a **New** project from the **Start Window**.
92+
1. In Visual Studio for Mac versions prior to 8.6:
9293

93-
1. In the sidebar, select **.NET Core** > **App**.
94+
* Select **File** > **New Solution** or create a **New** project from the **Start Window**.
9495

95-
1. Select the **Blazor Server App** template. Select **Next**.
96+
* In the sidebar, select **.NET Core** > **App**.
9697

97-
1. Confirm the following configurations:
98+
* Select the **Blazor Server App** template. Select **Next**.
9899

99-
* **Target Framework** set to **.NET Core 3.1**.
100-
* **Authentication** set to **No Authentication**.
100+
* Confirm the following configurations:
101+
102+
* **Target Framework** set to **.NET Core 3.1**.
103+
* **Authentication** set to **No Authentication**.
101104

102-
Select **Next**.
105+
Select **Next**.
103106

104-
1. In the **Project Name** field, name the app `WebApplication1`. Select **Create**.
107+
* In the **Project Name** field, name the app `WebApplication1`. Select **Create**.
105108

106-
1. Select **Run** > **Start Without Debugging** to run the app *without the debugger*. Debugging isn't supported at this time.
109+
* Select **Run** > **Start Without Debugging** to run the app *without the debugger*. Debugging isn't supported at this time.
107110

108-
<!-- HOLD FOR 8.6 GA
111+
In the preview of Visual Studio for Mac version 8.6, which uses the [Preview channel](/visualstudio/mac/update):
109112

110-
1. Select **File** > **New Solution** or create a **New** project from the **Start Window**.
113+
* Select **File** > **New Solution** or create a **New** project from the **Start Window**.
111114

112-
1. In the sidebar, select **Web and Console** > **App**.
115+
* In the sidebar, select **Web and Console** > **App**.
113116

114-
1. For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template. For a Blazor Server experience, choose the **Blazor Server App** template. Select **Next**.
117+
* For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template. For a Blazor Server experience, choose the **Blazor Server App** template. Select **Next**.
115118

116-
For information on the two Blazor hosting models, *Blazor WebAssembly* and *Blazor Server*, see <xref:blazor/hosting-models>.
119+
For information on the two Blazor hosting models, *Blazor WebAssembly* and *Blazor Server*, see <xref:blazor/hosting-models>.
117120

118-
1. Confirm the following configurations:
121+
* Confirm the following configurations:
119122

120-
* **Target Framework** set to **.NET Core 3.1**.
121-
* **Authentication** set to **No Authentication**.
123+
* **Target Framework** set to **.NET Core 3.1**.
124+
* **Authentication** set to **No Authentication**.
122125

123-
Select **Next**.
124-
125-
1. In the **Project Name** field, name the app `WebApplication1`. Select **Create**.
126+
Select **Next**.
126127

127-
1. Select **Run** > **Start Without Debugging** to run the app *without the debugger*. Run the app with **Run** > **Start Debugging** or the Run (&#9654;) button to run the app *with the debugger*.
128+
* In the **Project Name** field, name the app `WebApplication1`. Select **Create**.
128129

129-
-->
130+
* Select **Run** > **Start Without Debugging** to run the app *without the debugger*. Run the app with **Run** > **Start Debugging** or the Run (&#9654;) button to run the app *with the debugger*.
130131

131-
If a prompt appears to trust the development certificate, trust the certificate and continue. The user and keychain passwords are required to trust the certificate.
132+
If a prompt appears to trust the development certificate, trust the certificate and continue. The user and keychain passwords are required to trust the certificate.
132133

133134
# [.NET Core CLI](#tab/netcore-cli/)
134135

aspnetcore/tutorials/first-mongo-app.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ The database is ready. You can start creating the ASP.NET Core web API.
174174

175175
# [Visual Studio for Mac](#tab/visual-studio-mac)
176176

177-
1. Go to **File** > **New Solution** > **.NET Core** > **App**.
177+
1. In Visual Studio for Mac earlier than version 8.6, select **File** > **New Solution** > **.NET Core** > **App** from the sidebar. In version 8.6 or later, select **File** > **New Solution** > **Web and Console** > **App** from the sidebar.
178178
1. Select the **ASP.NET Core Web API** C# project template, and select **Next**.
179179
1. Select **.NET Core 3.0** from the **Target Framework** drop-down list, and select **Next**.
180180
1. Enter *BooksApi* for the **Project Name**, and select **Create**.
@@ -524,7 +524,7 @@ The database is ready. You can start creating the ASP.NET Core web API.
524524

525525
# [Visual Studio for Mac](#tab/visual-studio-mac)
526526

527-
1. Go to **File** > **New Solution** > **.NET Core** > **App**.
527+
1. In Visual Studio for Mac earlier than version 8.6, select **File** > **New Solution** > **.NET Core** > **App** from the sidebar. In version 8.6 or later, select **File** > **New Solution** > **Web and Console** > **App** from the sidebar.
528528
1. Select the **ASP.NET Core Web API** C# project template, and select **Next**.
529529
1. Select **.NET Core 2.2** from the **Target Framework** drop-down list, and select **Next**.
530530
1. Enter *BooksApi* for the **Project Name**, and select **Create**.

aspnetcore/tutorials/first-mvc-app/start-mvc.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -89,9 +89,7 @@ The tutorial assumes familarity with VS Code. See [Getting started with VS Code]
8989

9090
![macOS New solution](./start-mvc/_static/new_project_vsmac.png)
9191

92-
* Select **.NET Core** > **App** > **Web Application (Model-View-Controller)** > **Next**.
93-
94-
![macOS New project dialog](./start-mvc/_static/new_project_mvc_vsmac.png)
92+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **Web Application (Model-View-Controller)** > **Next** from the sidebar. In version 8.6 or later, select **Web and Console** > **App** > **Web Application (Model-View-Controller)** > **Next** from the sidebar.
9593

9694
* In the **Configure your new ASP.NET Core Web API** dialog, set the **Target Framework** of **.NET Core 3.1**.
9795

@@ -237,9 +235,7 @@ The tutorial assumes familarity with VS Code. See [Getting started with VS Code]
237235

238236
![macOS New solution](./start-mvc/_static/new_project_vsmac.png)
239237

240-
* Select **.NET Core** > **App** > **Web Application (Model-View-Controller)** > **Next**.
241-
242-
![macOS New project dialog](./start-mvc/_static/new_project_mvc_vsmac.png)
238+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **Web Application (Model-View-Controller)** > **Next**. In version 8.6 or later, select **Web and Console** > **App** > **Web Application (Model-View-Controller)** > **Next**.
243239

244240
* In the **Configure your new ASP.NET Core Web API** dialog, accept the default **Target Framework** of **.NET Core 2.2**.
245241

Binary file not shown.
-46.1 KB
Binary file not shown.

aspnetcore/tutorials/first-web-api.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,9 +98,7 @@ The following diagram shows the design of the app.
9898

9999
![macOS New solution](first-web-api-mac/_static/sln.png)
100100

101-
* Select **.NET Core** > **App** > **API** > **Next**.
102-
103-
![macOS New project dialog](first-web-api-mac/_static/1.png)
101+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **API** > **Next** from the sidebar. In version 8.6 or later, select **Web and Console** > **App** > **API** > **Next** from the sidebar.
104102

105103
* In the **Configure your new ASP.NET Core Web API** dialog, select **Target Framework** of **.NET Core 3.1*.
106104

@@ -578,9 +576,7 @@ The following diagram shows the design of the app.
578576

579577
![macOS New solution](first-web-api-mac/_static/sln.png)
580578

581-
* Select **.NET Core** > **App** > **API** > **Next**.
582-
583-
![macOS New project dialog](first-web-api-mac/_static/1.png)
579+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **API** > **Next**. In version 8.6 or later, select **Web and Console** > **App** > **API** > **Next**.
584580

585581
* In the **Configure your new ASP.NET Core Web API** dialog, accept the default **Target Framework** of **.NET Core 2.2*.
586582

aspnetcore/tutorials/razor-pages/razor-pages-start.md

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -92,9 +92,7 @@ At the end of this tutorial, you'll have a working Razor Pages web app that you'
9292

9393
![macOS New solution](../first-mvc-app/start-mvc/_static/new_project_vsmac.png)
9494

95-
* Select **.NET Core** > **App** > **Web Application** > **Next**.
96-
97-
![macOS New project dialog](razor-pages-start/_static/webapp.png)
95+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **Web Application** > **Next** from the sidebar. In version 8.6 or later, select **Web and Console** > **App** > **Web Application** > **Next** from the sidebar.
9896

9997
* In the **Configure your new Web Application** dialog, set the **Target Framework** to **.NET Core 3.1**.
10098

@@ -237,9 +235,7 @@ At the end of this tutorial, you'll have a working Razor Pages web app that you'
237235

238236
![macOS New solution](../first-mvc-app/start-mvc/_static/new_project_vsmac.png)
239237

240-
* Select **.NET Core** > **App** > **Web Application** > **Next**.
241-
242-
![macOS New project dialog](razor-pages-start/_static/webapp.png)
238+
* In Visual Studio for Mac earlier than version 8.6, select **.NET Core** > **App** > **Web Application** > **Next**. In version 8.6 or later, select **Web and Console** > **App** > **Web Application** > **Next**.
243239

244240
* In the **Configure your new ASP.NET Core Web API** dialog, set the **Target Framework** to **.NET Core 3.1**.
245241

Binary file not shown.

aspnetcore/tutorials/signalr-blazor-webassembly.md

Lines changed: 23 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Create a chat app that uses ASP.NET Core SignalR with Blazor WebAss
55
monikerRange: '>= aspnetcore-3.1'
66
ms.author: riande
77
ms.custom: mvc
8-
ms.date: 04/30/2020
8+
ms.date: 05/11/2020
99
no-loc: [Blazor, "Identity", "Let's Encrypt", Razor, SignalR]
1010
uid: tutorials/signalr-blazor-webassembly
1111
---
@@ -89,13 +89,33 @@ Follow the guidance for your choice of tooling:
8989

9090
# [Visual Studio for Mac](#tab/visual-studio-mac)
9191

92-
1. In a command shell, execute the following command:
92+
1. If you don't wish to install the preview of Visual Studio for Mac version 8.6, open a command shell and execute the following command:
9393

9494
```dotnetcli
9595
dotnet new blazorwasm --hosted --output BlazorSignalRApp
9696
```
9797

98-
1. In Visual Studio for Mac, open the project by navigating to the project folder and opening the project's solution file (*.sln*).
98+
1. To use the preview of Visual Studio for Mac version 8.6, install [Visual Studio for Mac](https://visualstudio.microsoft.com/vs/mac/), use the [Preview channel](/visualstudio/mac/update), and perform the following steps:
99+
100+
* Select **File** > **New Solution** or create a **New** project from the **Start Window**.
101+
102+
* In the sidebar, select **Web and Console** > **App**.
103+
104+
* For a Blazor WebAssembly experience, choose the **Blazor WebAssembly App** template.
105+
106+
* Confirm the following configurations:
107+
108+
* Select the **ASP.NET Core hosted** check box.
109+
* **Target Framework** set to **.NET Core 3.1**.
110+
* **Authentication** set to **No Authentication**.
111+
112+
Select **Next**.
113+
114+
* In the **Project Name** field, name the app `BlazorSignalRApp`. Select **Create**.
115+
116+
If a prompt appears to trust the development certificate, trust the certificate and continue. The user and keychain passwords are required to trust the certificate.
117+
118+
1. Open the project by navigating to the project folder and opening the project's solution file (*.sln*).
99119

100120
# [.NET Core CLI](#tab/netcore-cli/)
101121

0 commit comments

Comments
 (0)