Skip to content
Protocol Buffers - Google's data interchange format https://developers.google.com/protocol-buffers/
C++ Java Objective-C C# Python Protocol Buffer Other
Latest commit bc21508 @haberman haberman Merge pull request #1214 from haberman/binarygem
Added support for binary gems.
Failed to load latest commit information.
benchmarks More cleanup, based around searches for "Google.ProtocolBuffers"
cmake Integrate from google internal.
conformance Merge pull request #1145 from jskeet/conformance
csharp Generated code changes from previous commit
editors down-integrate internal changes
examples Merge pull request #1052 from tswast/master
java Restore the license for Internal.java
javanano Update version number and fix javadoc errors.
js Enable JavaScript tests for binary parse/serialize.
m4 Merge pull request #789 from motahan/solaris64_fix
more_tests Add makefile for extended tests to be run before release.
objectivec Integrate from google internal.
protoc-artifacts Fix typos in README.md/CHANGES.txt
python Manually down-integrate python JSON struct support from internal code…
ruby Actually enabling cross compilation.
src Rename Preconditions to ProtoPreconditions
util/python Added util/python/BUILD to provide //util/python:python_headers depen…
.gitignore Manually down-integrate python JSON struct support from internal code…
.travis.yml Added README and enabled JavaScript tests on Node.js
BUILD Fix bazel BUILD for Java.
CHANGES.txt Fix typos in README.md/CHANGES.txt
CONTRIBUTORS.txt Add nano proto authors and update LICENSE file to include Android.mk.
LICENSE Add support for POWER Linux
Makefile.am Rename Preconditions to ProtoPreconditions
Protobuf.podspec Update podspec version to 3.0.0-beta-2
README.md Refactor README.md.
WORKSPACE fix six package path.
appveyor.bat Improved SHARED build from CMake project
appveyor.yml Down-integrate from internal code base.
autogen.sh Add support for arguments.
configure.ac Add missing files to EXTRA_DIST.
generate_descriptor_proto.sh Integrate from google internal.
gmock.BUILD Fix headers for gmock.BUILD
post_process_dist.sh Add js to post_process_dist.sh.
protobuf-lite.pc.in Uncomment conflict fields from pkg-config files.
protobuf.bzl Make protobuf Skylark extension appends the workspace root
protobuf.pc.in Uncomment conflict fields from pkg-config files.
six.BUILD Add srcs_version = "PY2AND3" in BUILD files
travis.sh Allow conformance test runner to tolerate crashes, and re-enable conf…
update_file_lists.sh Fix bugs on windows

README.md

Protocol Buffers - Google's data interchange format

Build Status Build status

Copyright 2008 Google Inc.

https://developers.google.com/protocol-buffers/

Overview

Protocol Buffers (a.k.a., protobuf) are Google's language-neutral, platform-neutral, extensible mechanism for serializing structured data. You can find protobuf's documentaion on the Google Developers site.

This README file contains protobuf installation instructions. To install protobuf, you need to install the protocol compiler (used to compile .proto files) and the protobuf runtime for your chosen programming language.

Protocol Compiler Installation

The protocol compiler is written in C++. If you are using C++, please follow the C++ Installation Instructions to install protoc along with the C++ runtime.

For non-C++ users, the simplest way to install the protocol compiler is to download a pre-built binary from our release page:

https://github.com/google/protobuf/releases

In the downloads section of each release, you can find pre-built binaries in zip packages: protoc-$VERSION-$PLATFORM.zip. It contains the protoc binary as well as a set of standard .proto files distributed along with protobuf.

If you are looking for an old version that is not available in the release page, check out the maven repo here:

http://repo1.maven.org/maven2/com/google/protobuf/protoc/

These pre-built binaries are only provided for released versions. If you want to use the github master version at HEAD, or you need to modify protobuf code, or you are using C++, it's recommended to build your own protoc binary from source.

If you would like to build protoc binary from source, see the C++ Installaton Instructions.

Protobuf Runtime Installation

Protobuf supports several different programming languages. For each programming language, you can find instructions in the corresponding source directory about how to install protobuf runtime for that specific language:

Language Source
C++ (include C++ runtime and protoc) src
Java java
Python python
Objective-C objectivec
C# csharp
JavaNano javanano
JavaScript js
Ruby ruby
Go golang/protobuf
PHP TBD

Usage

The complete documentation for Protocol Buffers is available via the web at:

https://developers.google.com/protocol-buffers/
Something went wrong with that request. Please try again.