| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 1 | Protocol Buffers - Google's data interchange format |
| Feng Xiao | 17007a6 | 2014-08-28 14:39:49 -0700 | [diff] [blame] | 2 | =================================================== |
| 3 | |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 4 | Copyright 2008 Google Inc. |
| Feng Xiao | 17007a6 | 2014-08-28 14:39:49 -0700 | [diff] [blame] | 5 | |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 6 | [Protocol Buffers documentation](https://developers.google.com/protocol-buffers/) |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 7 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 8 | Overview |
| 9 | -------- |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 10 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 11 | Protocol Buffers (a.k.a., protobuf) are Google's language-neutral, |
| 12 | platform-neutral, extensible mechanism for serializing structured data. You |
| Sylvain Baubeau | e5ec85e | 2016-01-25 21:41:31 +0100 | [diff] [blame] | 13 | can find [protobuf's documentation on the Google Developers site](https://developers.google.com/protocol-buffers/). |
| Feng Xiao | 64d8652 | 2016-01-06 16:25:35 -0800 | [diff] [blame] | 14 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 15 | This README file contains protobuf installation instructions. To install |
| 16 | protobuf, you need to install the protocol compiler (used to compile .proto |
| 17 | files) and the protobuf runtime for your chosen programming language. |
| Feng Xiao | 64d8652 | 2016-01-06 16:25:35 -0800 | [diff] [blame] | 18 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 19 | Protocol Compiler Installation |
| 20 | ------------------------------ |
| Feng Xiao | 64d8652 | 2016-01-06 16:25:35 -0800 | [diff] [blame] | 21 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 22 | The protocol compiler is written in C++. If you are using C++, please follow |
| 23 | the [C++ Installation Instructions](src/README.md) to install protoc along |
| 24 | with the C++ runtime. |
| Feng Xiao | 64d8652 | 2016-01-06 16:25:35 -0800 | [diff] [blame] | 25 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 26 | For non-C++ users, the simplest way to install the protocol compiler is to |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 27 | download a pre-built binary from our [GitHub release page](https://github.com/protocolbuffers/protobuf/releases). |
| Feng Xiao | de00052 | 2014-08-28 11:18:51 -0700 | [diff] [blame] | 28 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 29 | In the downloads section of each release, you can find pre-built binaries in |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 30 | zip packages: `protoc-$VERSION-$PLATFORM.zip`. It contains the protoc binary |
| 31 | as well as a set of standard `.proto` files distributed along with protobuf. |
| Feng Xiao | de00052 | 2014-08-28 11:18:51 -0700 | [diff] [blame] | 32 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 33 | If you are looking for an old version that is not available in the release |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 34 | page, check out the [Maven repository](https://repo1.maven.org/maven2/com/google/protobuf/protoc/). |
| Feng Xiao | de00052 | 2014-08-28 11:18:51 -0700 | [diff] [blame] | 35 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 36 | These pre-built binaries are only provided for released versions. If you want |
| noahdietz | 5abf802 | 2022-04-12 10:25:08 -0700 | [diff] [blame] | 37 | to use the github main version at HEAD, or you need to modify protobuf code, |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 38 | or you are using C++, it's recommended to build your own protoc binary from |
| 39 | source. |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 40 | |
| Mike Kruskal | ed5c57a | 2022-08-10 22:51:29 -0700 | [diff] [blame] | 41 | If you would like to build protoc binary from source, see the [C++ Installation Instructions](src/README.md). |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 42 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 43 | Protobuf Runtime Installation |
| 44 | ----------------------------- |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 45 | |
| Feng Xiao | d0e0114 | 2016-01-21 17:06:38 -0800 | [diff] [blame] | 46 | Protobuf supports several different programming languages. For each programming |
| 47 | language, you can find instructions in the corresponding source directory about |
| 48 | how to install protobuf runtime for that specific language: |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 49 | |
| Joshua Haberman | 96ccf40 | 2021-05-20 10:06:36 -0700 | [diff] [blame] | 50 | | Language | Source | |
| 51 | |--------------------------------------|-------------------------------------------------------------| |
| 52 | | C++ (include C++ runtime and protoc) | [src](src) | |
| 53 | | Java | [java](java) | |
| 54 | | Python | [python](python) | |
| 55 | | Objective-C | [objectivec](objectivec) | |
| 56 | | C# | [csharp](csharp) | |
| Joshua Haberman | 96ccf40 | 2021-05-20 10:06:36 -0700 | [diff] [blame] | 57 | | Ruby | [ruby](ruby) | |
| 58 | | Go | [protocolbuffers/protobuf-go](https://github.com/protocolbuffers/protobuf-go)| |
| 59 | | PHP | [php](php) | |
| 60 | | Dart | [dart-lang/protobuf](https://github.com/dart-lang/protobuf) | |
| Noel Kim (김민혁) | e58ff98 | 2022-08-31 01:30:54 +0900 | [diff] [blame] | 61 | | Javascript | [protocolbuffers/protobuf-javascript](https://github.com/protocolbuffers/protobuf-javascript)| |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 62 | |
| Feng Xiao | 74bf45f | 2017-09-08 15:44:09 -0700 | [diff] [blame] | 63 | Quick Start |
| 64 | ----------- |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 65 | |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 66 | The best way to learn how to use protobuf is to follow the [tutorials in our |
| 67 | developer guide](https://developers.google.com/protocol-buffers/docs/tutorials). |
| Feng Xiao | 74bf45f | 2017-09-08 15:44:09 -0700 | [diff] [blame] | 68 | |
| 69 | If you want to learn from code examples, take a look at the examples in the |
| 70 | [examples](examples) directory. |
| 71 | |
| 72 | Documentation |
| 73 | ------------- |
| temporal | 40ee551 | 2008-07-10 02:12:20 +0000 | [diff] [blame] | 74 | |
| Protobuf Team Bot | 016ef23 | 2022-11-23 13:53:12 -0800 | [diff] [blame] | 75 | The complete documentation is available via the [Protocol Buffers documentation](https://developers.google.com/protocol-buffers/). |
| Protocol Buffers Docs | 1cb0d64 | 2022-07-17 13:16:59 +0000 | [diff] [blame] | 76 | |
| 77 | Developer Community |
| 78 | ------------------- |
| 79 | |
| 80 | To be alerted to upcoming changes in Protocol Buffers and connect with protobuf developers and users, |
| 81 | [join the Google Group](https://groups.google.com/g/protobuf). |
| 82 | |
