Skip to content

P
protobuf
Switch branch/tag
History Find file
Name
Last commit
 Last update
benchmarks Add the missing maintiner-clean entry for benchmarks
cmake Update file lists.
conformance Properly express all outputs for the conformance build
csharp Merge pull request #1542 from google/beta-3
docs Add initial design document for Swift protocol buffers. (#1442)
editors down-integrate internal changes
examples Merge pull request #1144 from dongjoon-hyun/remove_redundant_the
java Merge pull request #1542 from google/beta-3
javanano Update version numbers for other languages
jenkins Rearranged and commented files for running under Jenkins.
js Merge pull request #1542 from google/beta-3
m4 Merge pull request #789 from motahan/solaris64_fix
more_tests Add makefile for extended tests to be run before release.
objectivec Declare an init and avoid passing NULL to initWithValue:count:
php Down integrate from Google internal.
protoc-artifacts Remove the instructions for pbconfig.h
python JSON format for Any message must print @type first, use OrderedDict instead of {}
ruby Update version numbers for other languages
src Integrate interanl changes
util/python Remove hack for building Python support with Bazel.
.gitignore Add two missing ignores for conformance directory.
.travis.yml Merge branch 'master' into docker
BUILD Update file lists.
CHANGES.txt Update changes for lite
CONTRIBUTORS.txt Add nano proto authors and update LICENSE file to include Android.mk.
LICENSE Add support for POWER Linux
Makefile.am Added framework for generating/consuming benchmarking data sets.
Protobuf.podspec Shrink ObjC overhead (generated size and some runtime sizes)
README.md Fix typos in README.md
WORKSPACE add java/util support based on java/util/pom.xml
appveyor.bat Improved SHARED build from CMake project
appveyor.yml Down-integrate from internal code base.
autogen.sh Add support for arguments.
configure.ac Update version numbers for beta3
generate_descriptor_proto.sh Merge branch 'master' of github.com:google/protobuf
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 pass correct args to protoc for java wellknown protos when used as an external repository
protobuf.pc.in Uncomment conflict fields from pkg-config files.
six.BUILD Add srcs_version = "PY2AND3" in BUILD files
tests.sh Read files directly from filesystem since xxd isn't always available.
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 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/