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 |