Stanley Cheung da6f23bf96 Bump to version 1.4.7		vor 8 Jahren
..
Grpc.Auth	be8522974d include symbols and source in nugets	vor 8 Jahren
Grpc.Core	da6f23bf96 Bump to version 1.4.7	vor 8 Jahren
Grpc.Core.Testing	be8522974d include symbols and source in nugets	vor 8 Jahren
Grpc.Core.Tests	67206428a4 add StartThrowsWithUnboundPortTest	vor 8 Jahren
Grpc.Examples	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.Examples.MathClient	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.Examples.MathServer	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.Examples.Tests	09d2f55c34 eliminate crosstalk between C# tests	vor 8 Jahren
Grpc.HealthCheck	be8522974d include symbols and source in nugets	vor 8 Jahren
Grpc.HealthCheck.Tests	09d2f55c34 eliminate crosstalk between C# tests	vor 8 Jahren
Grpc.IntegrationTesting	19e3d3ba9f get rid of Histogram lock contention in qps worker	vor 8 Jahren
Grpc.IntegrationTesting.Client	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.IntegrationTesting.QpsWorker	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.IntegrationTesting.Server	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.IntegrationTesting.StressClient	7727c7649c Initial migration to new .csproj files	vor 8 Jahren
Grpc.Microbenchmarks	7c206f4c15 override in benchmark	vor 8 Jahren
Grpc.Reflection	be8522974d include symbols and source in nugets	vor 8 Jahren
Grpc.Reflection.Tests	09d2f55c34 eliminate crosstalk between C# tests	vor 8 Jahren
doc	431756b15a Include new namespaces in the generated docs as well	vor 8 Jahren
ext	06eb057eb7 add grpc_slice_unref to fix leaks	vor 8 Jahren
keys	ecb02be1ea include assembly signing key in the repo	vor 9 Jahren
.editorconfig	c7c2bf1714 add editorconfig for C#	vor 8 Jahren
.gitignore	ec4359ddc1 add support for CoreCLR	vor 9 Jahren
Grpc.Tools.nuspec	3294474d15 adjust package build scripts to new paths	vor 8 Jahren
Grpc.nuspec	48f7ed4442 pick up nuget package version from cmdline param and fix nuget build	vor 10 Jahren
Grpc.sln	c91bc02d97 Add Grpc.Microbenchmarks project	vor 8 Jahren
README.md	3ddc5da0c2 update docs	vor 8 Jahren
Settings.StyleCop	3de9f49e3c Setting up stylecop to ignore generated files and fixing style	vor 10 Jahren
build_packages_dotnetcli.bat	da6f23bf96 Bump to version 1.4.7	vor 8 Jahren
build_packages_dotnetcli.sh	da6f23bf96 Bump to version 1.4.7	vor 8 Jahren
generate_proto_csharp.sh	091057a4e5 fix proto import paths for C# where possible	vor 8 Jahren
tests.json	93c8951695 NUnitVersion tests no longer needed	vor 8 Jahren

gRPC C#

A C# implementation of gRPC.

SUPPORTED PLATFORMS

.NET Core on Linux, Windows and Mac OS X
.NET Framework 4.5+ (Windows)
Mono 4+ on Linux, Windows and Mac OS X

PREREQUISITES

When using gRPC C# under .NET Core you only need to install .NET Core.

Windows: .NET Framework 4.5+, Visual Studio 2013, 2015, 2017
Linux: Mono 4+, MonoDevelop 5.9+ (with NuGet add-in installed)
Mac OS X: Xamarin Studio 5.9+

HOW TO USE

Windows, Linux, Mac OS X

Open Visual Studio / MonoDevelop / Xamarin Studio and start a new project/solution.
Add the Grpc NuGet package as a dependency (Project options -> Manage NuGet Packages).
To be able to generate code from Protocol Buffer (.proto) file definitions, add the Grpc.Tools NuGet package that contains Protocol Buffers compiler (protoc) and the gRPC protoc plugin.

BUILD FROM SOURCE

You only need to go through these steps if you are planning to develop gRPC C#. If you are a user of gRPC C#, go to Usage section above.

Windows, Linux or Mac OS X

The easiest way to build is using the run_tests.py script that will take care of building the grpc_csharp_ext native library:
```
# from the gRPC repository root
$ python tools/run_tests/run_tests.py -c dbg -l csharp --build_only
```
Use Visual Studio 2017 (on Windows) to open the solution Grpc.sln or use Visual Studio Code with C# extension (on Linux and Mac). gRPC C# code has been migrated to dotnet SDK .csproj projects that are much simpler to maintain, but are not yet supported by Xamarin Studio or Monodevelop (the NuGet packages still support both net45 and netstandard and can be used in all IDEs).

RUNNING TESTS

gRPC C# is using NUnit as the testing framework.

Under Visual Studio, make sure NUnit test adapter is installed (under "Extensions and Updates"). Then you should be able to run all the tests using Test Explorer.

gRPC team uses a Python script to simplify facilitate running tests for different languages.

tools/run_tests/run_tests.py -l csharp

DOCUMENTATION

PERFORMANCE

For best gRPC C# performance, use .NET Core and the Server GC mode "System.GC.Server": true for your applications.

THE NATIVE DEPENDENCY

Internally, gRPC C# uses a native library written in C (gRPC C core) and invokes its functionality via P/Invoke. The fact that a native library is used should be fully transparent to the users and just installing the Grpc.Core NuGet package is the only step needed to use gRPC C# on all supported platforms.

README.md