OLD | NEW |
(Empty) | |
| 1 This directory contains the C# Protocol Buffers runtime library. |
| 2 |
| 3 Warning: experimental! |
| 4 ====================== |
| 5 |
| 6 This code is still under significant churn. Unlike the original port, |
| 7 it only supports proto3 (but not *all* of proto3 yet) - there are no |
| 8 unknown fields or extensions, for example. protoc will (eventually) |
| 9 deliberately fail if it is asked to generate C# code for proto2 |
| 10 messages other than descriptor.proto, which is still required for |
| 11 reflection. (It's currently exposed publicly, but won't be |
| 12 eventually.) |
| 13 |
| 14 Also unlike the original port, the new version embraces mutability - |
| 15 there are no builder types. We plan to add "freezing" operations as |
| 16 well as cloning, however. |
| 17 |
| 18 Usage |
| 19 ===== |
| 20 |
| 21 Use `protoc` with the `--csharp_out` option to generate C# files in the specifie
d directory. |
| 22 Include these in your C# project, and add a reference to the `Google.Protobuf` p
roject. Currently |
| 23 there is no NuGet package for this, but we will be building one as soon as the A
PI is stable. |
| 24 |
| 25 Supported platforms |
| 26 =================== |
| 27 |
| 28 The runtime library is built as a portable class library, supporting: |
| 29 |
| 30 - .NET 4.5 |
| 31 - Windows 8 |
| 32 - Windows Phone Silverlight 8 |
| 33 - Windows Phone 8.1 |
| 34 - .NET Core (dnxcore) |
| 35 |
| 36 Building |
| 37 ======== |
| 38 |
| 39 Open the `src/Google.Protobuf.sln` solution in Visual Studio. Click "Build solut
ion" to build the solution. You should be able to run the NUnit test from Test E
xplorer (you might need to install NUnit Visual Studio add-in). |
| 40 |
| 41 Supported Visual Studio versions are VS2013 (update 4) and VS2015. On Linux, you
can also use Monodevelop 5.9 (older versions might work fine). |
| 42 |
| 43 History of C# protobufs |
| 44 ======================= |
| 45 |
| 46 This subtree was originally imported from https://github.com/jskeet/protobuf-csh
arp-port |
| 47 and represents the latest development version of C# protobufs, that will now be
developed |
| 48 and maintained by Google. All the development will be done in open, under this r
epository |
| 49 (https://github.com/google/protobuf). |
OLD | NEW |