tree: 1d48ebcd14f9c66c005effbf6b77a3f7cadda79e [path history] [tgz]
  1. build/
  2. Properties/
  3. Common.cs
  4. CommonPlatformDetection.cs
  5. DepFileUtil.cs
  6. GeneratorServices.cs
  7. Grpc.Tools.csproj
  8. implementation_notes.md
  9. ProtoCompile.cs
  10. ProtoCompilerOutputs.cs
  11. ProtoReadDependencies.cs
  12. ProtoToolsPlatform.cs
  13. README.md
  14. SourceLink.csproj.include
src/csharp/Grpc.Tools/README.md

Grpc.Tools - Protocol Buffers/gRPC C# Code Generation Build Integration

This package provides C# tooling support for generating C# code from .proto files in .csproj projects:

  • It contains protocol buffers compiler and gRPC plugin to generate C# code.
  • It can be used in building both grpc-dotnet projects and legacy c-core C# projects.

The package is used to automatically generate the C# code for protocol buffer messages and gRPC service stubs from .proto files. These files:

  • are generated on an as-needed basis each time the project is built.
  • aren't added to the project or checked into source control.
  • are a build artifact usually contained in the obj directory.

This package is optional. You may instead choose to generate the C# source files from .proto files by running the protoc compiler manually or from a script.

Simple example

To add a .proto file to a project edit the project’s .csproj file and add an item group with a <Protobuf> element that refers to the .proto file, e.g.

<ItemGroup>
    <Protobuf Include="Protos\greet.proto" />
</ItemGroup>

For more complex examples and detailed information on how to use this package see: BUILD-INTEGRATION.md