Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / grpc-grpc / 5eb24eeaed12f96e49171a77939e23ff2af8680b / . / src / csharp
tree: fecaed28e4b336f212c4a023f97b9047b7678cf4 [path history] [tgz]
  1. doc/
  2. ext/
  3. Grpc.Auth/
  4. Grpc.Core/
  5. Grpc.Core.Tests/
  6. Grpc.Examples/
  7. Grpc.Examples.MathClient/
  8. Grpc.Examples.MathServer/
  9. Grpc.Examples.Tests/
  10. Grpc.HealthCheck/
  11. Grpc.HealthCheck.Tests/
  12. Grpc.IntegrationTesting/
  13. Grpc.IntegrationTesting.Client/
  14. Grpc.IntegrationTesting.QpsWorker/
  15. Grpc.IntegrationTesting.Server/
  16. Grpc.IntegrationTesting.StressClient/
  17. Grpc.Reflection/
  18. Grpc.Reflection.Tests/
  19. keys/
  20. .gitignore
  21. build_packages_dotnetcli.bat
  22. build_packages_dotnetcli.sh
  23. buildall.bat
  24. generate_proto_csharp.sh
  25. Grpc.Dotnet.sln
  26. Grpc.nuspec
  27. Grpc.sln
  28. Grpc.Tools.nuspec
  29. README.md
  30. Settings.StyleCop
  31. tests.json
src/csharp/README.md

Nuget 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 or 2015
  • 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

  • The grpc_csharp_ext native library needs to be built so you can build the gRPC C# solution. Open the solution vsprojects/grpc_csharp_ext.sln in Visual Studio and build it.

  • Open src\csharp\Grpc.sln (path is relative to gRPC repository root) using Visual Studio

Linux and Mac OS X

  • The grpc_csharp_ext native library needs to be built so you can build the gRPC C# solution:

    # from the gRPC repository root
$ tools/run_tests/run_tests.py -c dbg -l csharp --build_only

  • Use MonoDevelop / Xamarin Studio to open the solution Grpc.sln

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.

Under Monodevelop or Xamarin Studio, make sure you installed "NUnit support" in Add-in manager. Then you should be able to run all the test from the Test View.

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.