Merge pull request #503 from vicancy/v1.0.9

Releasing 1.0.9 version

.travis.yml

@@ -2,7 +2,7 @@ language: csharp
 branches:
   only:
   - dev
-dist: trusty
+dist: xenial
 mono: none
 dotnet: 2.1.301
 os:

AzureSignalR.sln

@@ -1,7 +1,7 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
-# Visual Studio 15
-VisualStudioVersion = 15.0.27130.2020
+# Visual Studio Version 16
+VisualStudioVersion = 16.0.28714.193
 MinimumVisualStudioVersion = 15.0.26730.03
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{DA69F624-5398-4884-87E4-B816698CDE65}"
 	ProjectSection(SolutionItems) = preProject
@@ -60,6 +60,10 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChatSample.CSharpClient", "
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.Azure.SignalR.Tests.Common", "test\Microsoft.Azure.SignalR.Tests.Common\Microsoft.Azure.SignalR.Tests.Common.csproj", "{981419D7-5199-4829-ABE2-421D05EF7D8C}"
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "ChatSample.CoreApp3", "samples\ChatSample\ChatSample.CoreApp3\ChatSample.CoreApp3.csproj", "{1F6D9B7A-36A0-4B71-825B-77F832B425A5}"
+EndProject
+Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "RazorComponentSample", "samples\RazorComponentSample\RazorComponentSample.csproj", "{44181F77-1BD8-421C-B53E-DA7CEC2F319B}"
+EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution
 		Debug|Any CPU = Debug|Any CPU
@@ -130,6 +134,14 @@ Global
 		{981419D7-5199-4829-ABE2-421D05EF7D8C}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{981419D7-5199-4829-ABE2-421D05EF7D8C}.Release|Any CPU.ActiveCfg = Release|Any CPU
 		{981419D7-5199-4829-ABE2-421D05EF7D8C}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1F6D9B7A-36A0-4B71-825B-77F832B425A5}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1F6D9B7A-36A0-4B71-825B-77F832B425A5}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1F6D9B7A-36A0-4B71-825B-77F832B425A5}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1F6D9B7A-36A0-4B71-825B-77F832B425A5}.Release|Any CPU.Build.0 = Release|Any CPU
+		{44181F77-1BD8-421C-B53E-DA7CEC2F319B}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{44181F77-1BD8-421C-B53E-DA7CEC2F319B}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{44181F77-1BD8-421C-B53E-DA7CEC2F319B}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{44181F77-1BD8-421C-B53E-DA7CEC2F319B}.Release|Any CPU.Build.0 = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(SolutionProperties) = preSolution
 		HideSolutionNode = FALSE
@@ -152,6 +164,8 @@ Global
 		{C965ED06-6A17-4329-B3C6-811830F4F4ED} = {C4BC9889-B49F-41B6-806B-F84941B2549B}
 		{3F9B3FD8-A54F-4AB4-B9D4-D4D55686A0E9} = {C965ED06-6A17-4329-B3C6-811830F4F4ED}
 		{C51AA61E-5210-4545-B49E-61255C136B83} = {C965ED06-6A17-4329-B3C6-811830F4F4ED}
+		{1F6D9B7A-36A0-4B71-825B-77F832B425A5} = {C965ED06-6A17-4329-B3C6-811830F4F4ED}
+		{44181F77-1BD8-421C-B53E-DA7CEC2F319B} = {C4BC9889-B49F-41B6-806B-F84941B2549B}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution
 		SolutionGuid = {7945A4E4-ACDB-4F6E-95CA-6AC6E7C2CD59}

Directory.Build.props

@@ -25,5 +25,8 @@
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
     <LangVersion>latest</LangVersion>
     <MicroBuildCorePackageVersion>0.3.0</MicroBuildCorePackageVersion>
+    <AssemblySigningCertName>Microsoft400</AssemblySigningCertName>
+    <PackageSigningCertName>NuGet</PackageSigningCertName>
+    <IsTargetMultiFramework>true</IsTargetMultiFramework>
   </PropertyGroup>
 </Project>

README.md

@@ -11,11 +11,15 @@ This repository contains the open source subset of the .NET SDK.
 
 ## Nuget Packages
 
-Package Name | Target Framework | NuGet | MyGet
+Azure SignalR Service SDK is supporting ASP.NET Core 3.0 preview from version `1.1.0-preview1-*`. And version `1.0.*` targets .NET Standard 2.0 only. Please find package information below.
+
+Package Name | Target Frameworks | NuGet | MyGet
 ---|---|---|---
+Microsoft.Azure.SignalR | .NET Standard 2.0, .NET Core App 3.0 | [![Nuget (with prereleases)](https://img.shields.io/nuget/vpre/Microsoft.Azure.SignalR.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR/1.1.0-preview1-10384) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR)
 Microsoft.Azure.SignalR | .NET Standard 2.0 | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.SignalR.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR)
-Microsoft.Azure.SignalR.Protocols | .NET Standard 2.0 | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.SignalR.Protocols.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Protocols) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.Protocols.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR.Protocols)
+Microsoft.Azure.SignalR.Protocols | .NET Standard 2.0 | [![NuGet](https://img.shields.io/nuget/vpre/Microsoft.Azure.SignalR.Protocols.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Protocols/1.1.0-preview1-10384) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.Protocols.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR.Protocols)
 Microsoft.Azure.SignalR.AspNet | .NET Standard 2.0 | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.SignalR.AspNet.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR.AspNet) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.AspNet.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR.AspNet)
+Microsoft.Azure.SignalR.Management | .NET Standard 2.0, .NET Core App 3.0 | [![NuGet](https://img.shields.io/nuget/v/Microsoft.Azure.SignalR.Management.svg)](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Management) | [![MyGet](https://img.shields.io/myget/azure-signalr-dev/vpre/Microsoft.Azure.SignalR.Management.svg)](https://www.myget.org/feed/azure-signalr-dev/package/nuget/Microsoft.Azure.SignalR.Management)
 
 ## Getting Started
 
@@ -37,6 +41,13 @@ Package [Microsoft.Azure.SignalR.AspNet](https://www.nuget.org/packages/Microsof
 
 Samples on how to use Azure SignalR Service can be found [here](https://github.com/aspnet/AzureSignalR-samples/tree/master/aspnet-samples/ChatRoom)
 
+### Management
+Package [Microsoft.Azure.SignalR.Management](https://www.nuget.org/packages/Microsoft.Azure.SignalR.Management) is the one to use when you want to manage SignalR clients through Azure SignalR Service directly such as broadcast messages. This SDK can be but not limited to be used in [serverless](https://azure.microsoft.com/zh-cn/solutions/serverless/) environments. You can use this SDK to manage SignalR clients connected to your Azure SignalR Service in any environment, such as in a console app, in an Azure function or in an App Server.
+
+More details can be found [here](./docs/management-sdk-guide.md).
+
+The sample on how to use Management SDK to redirect SignalR clients to Azure SignalR Service can be found [here](https://github.com/aspnet/AzureSignalR-samples/tree/master/samples/Management).
+
 ## Next Steps
 
 The following documents describe more details about Azure SignalR Service.
@@ -51,8 +62,7 @@ Contributions are highly welcome. Keep reading if you want to contribute to our
 
 ### Building from source
 
-Run `build.cmd` or `build.sh` without arguments for a complete build including tests.
-See [Building documents](https://github.com/aspnet/Home/wiki/Building-from-source) for more details.
+See [Building Documents](./docs/build-source.md) for more details.
 
 ### Contributing
 

build/dependencies.props

@@ -28,7 +28,8 @@
     <MicrosoftConfigurationUserSecretVersion>2.2.0</MicrosoftConfigurationUserSecretVersion>
     <MicrosoftConfigurationEnvironmentVariablesVersion>2.2.0</MicrosoftConfigurationEnvironmentVariablesVersion>
     <MicrosoftExtensionHttpVersion>2.2.0</MicrosoftExtensionHttpVersion>
-
+    <MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>1.0.0</MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>
+
     <!-- Signing -->
     <MicroBuildCorePackageVersion>0.3.0</MicroBuildCorePackageVersion>
 
@@ -40,7 +41,8 @@
     <OwinPackageVersion>1.0.0</OwinPackageVersion>
 
     <!--Testing -->
-    <MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>1.0.0</MicrosoftAspNetCoreSignalRProtocolsMessagePackPackageVersion>
+    <MicrosoftAspNetCoreSignalRProtocolsMessagePackTestPackageVersion>3.0.0-preview3-19153-02</MicrosoftAspNetCoreSignalRProtocolsMessagePackTestPackageVersion>
+    <MicrosoftAspNetCoreSignalRClientTest>3.0.0-preview3-19153-02</MicrosoftAspNetCoreSignalRClientTest>
     <MicrosoftNETTestSdkPackageVersion>15.6.1</MicrosoftNETTestSdkPackageVersion>
     <MoqPackageVersion>4.7.49</MoqPackageVersion>
     <XunitPackageVersion>2.4.0</XunitPackageVersion>

build/package-test.3.proj

@@ -0,0 +1,11 @@
+<Project Sdk="Microsoft.NET.Sdk">
+  <PropertyGroup>
+    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <PackageVersion Condition=" '$(PackageVersion)' == '' ">$(VersionPrefix)-$(VersionSuffix)</PackageVersion>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Azure.SignalR.Protocols" Version="$(PackageVersion)" />
+    <PackageReference Include="Microsoft.Azure.SignalR" Version="$(PackageVersion)" />
+  </ItemGroup>
+</Project>

build/package-test.proj

@@ -1,6 +1,6 @@
 <Project Sdk="Microsoft.NET.Sdk">
   <PropertyGroup>
-    <TargetFramework>netcoreapp2.1</TargetFramework>
+    <TargetFramework>netcoreapp2.2</TargetFramework>
     <PackageVersion Condition=" '$(PackageVersion)' == '' ">$(VersionPrefix)-$(VersionSuffix)</PackageVersion>
   </PropertyGroup>
 

build/repo.props

@@ -5,4 +5,18 @@
     <DotNetCoreRuntime Include="$(MicrosoftNETCoreApp20PackageVersion)" />
     <DotNetCoreRuntime Include="$(MicrosoftNETCoreApp21PackageVersion)" />
   </ItemGroup>
+
+  <ItemGroup>
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR\bin\$(Configuration)\netstandard2.0\Microsoft.Azure.SignalR.dll" Certificate="$(AssemblySigningCertName)" />
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR.AspNet\bin\$(Configuration)\net461\Microsoft.Azure.SignalR.AspNet.dll" Certificate="$(AssemblySigningCertName)" />
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR.Common\bin\$(Configuration)\netstandard2.0\Microsoft.Azure.SignalR.Common.dll" Certificate="$(AssemblySigningCertName)" />
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR.Management\bin\$(Configuration)\netstandard2.0\Microsoft.Azure.SignalR.Management.dll" Certificate="$(AssemblySigningCertName)" />
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR.Protocols\bin\$(Configuration)\netstandard2.0\Microsoft.Azure.SignalR.Protocols.dll" Certificate="$(AssemblySigningCertName)" />
+  </ItemGroup>
+
+  <ItemGroup Condition ="'$(IsTargetMultiFramework)' != 'false'">
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR.Management\bin\$(Configuration)\netcoreapp3.0\Microsoft.Azure.SignalR.Management.dll" Certificate="$(AssemblySigningCertName)" />
+    <FilesToSign Include="$(RepositoryRoot)src\Microsoft.Azure.SignalR\bin\$(Configuration)\netcoreapp3.0\Microsoft.Azure.SignalR.dll" Certificate="$(AssemblySigningCertName)" />
+  </ItemGroup>
+
 </Project>

docs/build-source.md

@@ -0,0 +1,59 @@
+Build Azure SignalR Service SDK from Source
+==============================
+
+Building Azure SignalR Service SDK from source allows you tweak and customize the SDK, and to contribute your improvements back to the project.
+
+## Install pre-requistes
+
+Building Azure SignalR Service SDK requires:
+
+* Visual Studio **2019 Preview**. <https://visualstudio.com>
+    * To install the exact required components, run [eng/scripts/InstallVisualStudio.ps1](/eng/scripts/InstallVisualStudio.ps1).
+        ```ps1
+        PS> ./eng/scripts/InstallVisualStudio.ps1
+        ```
+* Git. <https://git-scm.org>
+* AspNetCore 3.0 Preview Runtime (Version >= 3.0.0-preview3-27503-5) <https://dotnet.microsoft.com/download/dotnet-core/3.0>
+* AspNetCore 3.0 SDK (Version >= 3.0.100-preview4-011136). Install from AspNetCore code repo before release <https://github.com/dotnet/core-sdk#installers-and-binaries>.
+
+## Clone the source code
+
+For a new copy of the project, run:
+```
+git clone https://github.com/Azure/azure-signalr
+```
+
+## Building on command-line
+
+You can build the entire project on command line with the `build.cmd`/`.sh` scripts.
+
+On Windows:
+```
+.\build.cmd
+```
+
+On macOS/Linux:
+```
+./build.sh
+```
+
+## Building in Visual Studio
+
+Before opening our .sln files in Visual Studio or VS Code, it is suggested to run `.\build.cmd` to make sure all the dependencies are restored correctly.
+
+The solution file is **AzureSignalR.sln** in the root.
+
+## Build properties
+
+Additional properties can be added as an argument in the form `/property:$name=$value`, or `/p:$name=$value` for short. For example:
+```
+.\build.cmd /p:Configuration=Release
+```
+
+Common properties include:
+
+Property                 | Description
+-------------------------|-------------------------------------------------------------------------------------------------------------
+BuildNumber              | (string). A specific build number, typically from a CI counter, which is appended to the preview1 label.
+Configuration            | `Debug` or `Release`. Default = `Debug`.
+IsTargetMultiFramework   | `true` or `false`. Default = `true`. Configure whether to build projects targeting ASP.NET Core 3.0.

docs/faq.md

@@ -12,10 +12,7 @@
 <a name="production-use"></a>
 ## Is Azure SignalR Service ready for production use?
 
-Yes if you are using [ASP.NET Core SignalR](https://github.com/aspnet/SignalR) with Azure SignalR Service.
-The generally-available announcement is at [here](https://azure.microsoft.com/en-us/blog/azure-signalr-service-now-generally-available/).
-
-The support of [ASP.NET SignalR](https://github.com/SignalR/SignalR) is still in *public preview*.
+Yes, both the support for [ASP.NET Core SignalR](https://github.com/aspnet/SignalR) and [ASP.NET SignalR](https://github.com/SignalR/SignalR) are all generally available.
 
 <a name="no-server-available"></a>
 ## Client connection is closed with error message "No server available". What does that mean?