Protocol Buffers - Google's data interchange format
C++ Java Objective-C C# Protocol Buffer C Other
Latest commit 7e62773 Aug 29, 2016 @haberman haberman committed on GitHub Merge pull request #1920 from gegles/master
Fix missing import of jspb.Map (#1885)
Permalink
Failed to load latest commit information.
benchmarks Add the missing maintiner-clean entry for benchmarks May 6, 2016
cmake Merge pull request #1842 from udnaan/master Aug 8, 2016
conformance Add note about JSON tests maybe being wrong. (#1992) Aug 23, 2016
csharp Add more JSON tests around underscores (#1963) Aug 16, 2016
docs Add an Erlang project, gpb, to third_party.md Aug 25, 2016
editors [master] Add dependency cl. Fixes google/protobuf#295. Aug 5, 2016
examples Integrate from internal code base. Jul 13, 2016
java Use 64-bit protoc binaries in compatibility tests. Aug 1, 2016
javanano Update version number to 3.0.0-beta-4 Jul 13, 2016
jenkins Keep cpp_distcheck on travis for now. Jul 22, 2016
js Fix missing import of jspb.Map (#1885) Aug 4, 2016
m4 Merge pull request #789 from motahan/solaris64_fix Jan 21, 2016
more_tests Add makefile for extended tests to be run before release. Jan 12, 2010
objectivec Support GenerateAll(). Aug 26, 2016
php Fix spelling in strings and comments Jul 3, 2016
protoc-artifacts Fix the build-zip.sh to add .exe for win packages. Jul 29, 2016
python Typo: beffer -> buffer Aug 3, 2016
ruby Fixing regular expression... Aug 24, 2016
src Support GenerateAll(). Aug 26, 2016
util/python Remove hack for building Python support with Bazel. Feb 25, 2016
.gitignore Add note about JSON tests maybe being wrong. (#1992) Aug 23, 2016
.travis.yml Run Java compatibility tests on Travis. Jul 29, 2016
BUILD Bazel: export LICENSE file. Aug 4, 2016
CHANGES.txt Change log for 3.0 GA release. Jul 27, 2016
CONTRIBUTORS.txt Add nano proto authors and update LICENSE file to include Android.mk. Nov 20, 2014
LICENSE Add support for POWER Linux Nov 3, 2015
Makefile.am Merge pull request #1878 from haberman/rubywkt Aug 2, 2016
Protobuf.podspec Adds watch os deployment target for protobuf Jul 30, 2016
README.md Add a jenkins test status badge. Aug 12, 2016
WORKSPACE add java/util support based on java/util/pom.xml Mar 12, 2016
appveyor.bat Move to dotnet cli for building, and .NET Core (netstandard1.0) as ta… Jul 14, 2016
appveyor.yml Update links in appveyor.yml Aug 25, 2016
autogen.sh Update gmock links. Aug 25, 2016
configure.ac Bump version number for GA Jul 25, 2016
generate_descriptor_proto.sh Merge branch 'master' of github.com:google/protobuf Mar 30, 2016
gmock.BUILD Fix headers for gmock.BUILD Dec 1, 2015
post_process_dist.sh Add js to post_process_dist.sh. Dec 29, 2015
protobuf-lite.pc.in Uncomment conflict fields from pkg-config files. May 12, 2015
protobuf.bzl Bazel build: Keep generated sources and Python runtime in the same di… May 26, 2016
protobuf.pc.in Uncomment conflict fields from pkg-config files. May 12, 2015
six.BUILD Add srcs_version = "PY2AND3" in BUILD files Dec 3, 2015
tests.sh Run Java compatibility tests on Travis. Jul 29, 2016
update_file_lists.sh Fix bugs on windows Aug 26, 2015

README.md

Protocol Buffers - Google's data interchange format

Build Status 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 documentation 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++ Installation 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/