AuroraMiddleware/protobuf
1
0
Fork 0
Code Issues 1 Pull Requests Projects Releases Wiki Activity
5eb1fac983
protobuf/csharp
History
Jon Skeet 5eb1fac983 Generate a directory hierarchy based on namespace (C#) 
This introduces a new C# option, base_namespace.
If the option is not specified, the behaviour is as before: no directories are generated.
If the option *is* specified, all C# namespaces must be relative to the base namespace, and the directories are generated relative to that namespace.

Example:
- Any.proto declares csharp_namespace = "Google.Protobuf.WellKnownTypes"
- We build with --csharp_out=Google.Protobuf --csharp_opt=base_namespace=Google.Protobuf
- The Any.cs file is generated in Google.Protobuf/WellKnownTypes (where it currently lives)

We need a change to descriptor.proto before this will all work (it wasn't in the right C# namespace) but that needs the other descriptors to be regenerated too. See next commit...
2015-09-01 15:05:03 +01:00
..
keys build signed assemblies 2015-08-02 01:20:40 -07:00
protos Remove a redundant layer of directory hierarchy. 2015-08-03 11:29:59 +01:00
src Merge pull request #738 from jtattermusch/include_descriptor_proto 2015-08-26 06:44:26 +01:00
.gitignore First pass at C# conformance tests. 2015-08-05 07:09:39 +01:00
build_packages.bat First pass at the big rename from ProtocolBuffers to Google.Protobuf. 2015-07-17 08:26:04 +01:00
buildall.sh build signed assemblies 2015-08-02 01:20:40 -07:00
CHANGES.txt Updated readme.md and changes.txt, removed old license.txt 2015-04-16 10:23:54 -07:00
generate_protos.sh Generate a directory hierarchy based on namespace (C#) 2015-09-01 15:05:03 +01:00
README.md Update README.md for C# 2015-08-26 15:26:34 -07:00

README.md

This directory contains the C# Protocol Buffers runtime library.

Status: Alpha - ready for early adopters

This code is still under significant churn. Unlike the original port, it only supports proto3 (but not all of proto3 yet) - there are no unknown fields or extensions, for example. protoc will (eventually) deliberately fail if it is asked to generate C# code for proto2 messages other than descriptor.proto, which is still required for reflection. (It's currently exposed publicly, but won't be eventually.)

Also unlike the original port, the new version embraces mutability - there are no builder types.

Usage

The easiest way how to use C# protobufs is via the Google.Protobuf NuGet package. Just add the NuGet package to your VS project.

Besides C# runtime library, the NuGet package also contains precompiled version of protoc.exe and a copy of well known .proto files under the package's tools directory.

To generate C# files from your .proto files, invoke protoc with the --csharp_out option.

Supported platforms

The runtime library is built as a portable class library, supporting:

  • .NET 4.5
  • Windows 8
  • Windows Phone Silverlight 8
  • Windows Phone 8.1
  • .NET Core (dnxcore)

Building

Open the src/Google.Protobuf.sln solution in Visual Studio. Click "Build solution" to build the solution. You should be able to run the NUnit test from Test Explorer (you might need to install NUnit Visual Studio add-in).

Supported Visual Studio versions are VS2013 (update 4) and VS2015. On Linux, you can also use Monodevelop 5.9 (older versions might work fine).

History of C# protobufs

This subtree was originally imported from https://github.com/jskeet/protobuf-csharp-port and represents the latest development version of C# protobufs, that will now be developed and maintained by Google. All the development will be done in open, under this repository (https://github.com/google/protobuf).