/protobuf

Protocol Buffers - Google's data interchange format
  1. C++ 38.2%
  2. Java 16.6%
  3. Objective-C 12.5%
  4. C# 9.3%
  5. Protocol Buffer 7.2%
  6. C 5.5%
  7. Other 10.7%
C++ Java Objective-C C# Protocol Buffer C Other
Find file
Latest commit a83ac86 Jan 27, 2017 @michaelpengcn michaelpengcn committed with TeBoring fix compile error on centos in metadata.h for constructors. (#2599)
Permalink
Failed to load latest commit information.
benchmarks Added C++ benchmark. (#1525) Sep 23, 2016
cmake Fixed "make check" for cmake build Dec 19, 2016
conformance A few more cases for binary conformance tests. (#2500) Jan 7, 2017
csharp Support custom options in C# Jan 19, 2017
docs Add link to Elm proto plugin Dec 28, 2016
editors [master] Add dependency cl. Fixes google/protobuf#295. Aug 5, 2016
examples Integrate from internal code base. Jul 13, 2016
java Merge pull request #2394 from cwelton/formatting Dec 8, 2016
javanano Class is final but declares protected field Nov 14, 2016
jenkins Update commit id in Dockerfile to trigger update. (#2467) Dec 8, 2016
js Fix generation of extending nested messages in JavaScript (#2439) Jan 7, 2017
m4 Fixed cross compilations with the Autotools build Jan 3, 2017
more_tests Add makefile for extended tests to be run before release. Jan 12, 2010
objectivec Adds nullability modifiers to resolve Xcode 8.3 warnings Jan 25, 2017
php Oneof accessor should return the field name that is actually set. (#2631 Jan 27, 2017
protoc-artifacts Update version number. Oct 10, 2016
python Add python compatibility tests against v2.5.0 amd run on Travis. Jan 26, 2017
ruby Ruby: removed redundant RepeatedField#slice. (#2449) Dec 7, 2016
src fix compile error on centos in metadata.h for constructors. (#2599) Jan 28, 2017
third_party Added C++ benchmark. (#1525) Sep 23, 2016
util/python Remove hack for building Python support with Bazel. Feb 25, 2016
.gitignore Auto-generate well_known_types_embed.cc Dec 19, 2016
.gitmodules Added C++ benchmark. (#1525) Sep 23, 2016
.travis.yml Add python compatibility tests against v2.5.0 amd run on Travis. Jan 26, 2017
BUILD Add a proto_lang_toolchain for Java Jan 12, 2017
CHANGES.txt Update change log for 3.1.0 (#2173) Oct 10, 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 Support custom options in C# Jan 19, 2017
Protobuf.podspec Update version number. Oct 10, 2016
README.md Add a badge for bazel build status. Dec 12, 2016
WORKSPACE Fix gson dependency. Sep 21, 2016
appveyor.bat Rename UNICODE to protobuf_UNICODE Sep 2, 2016
appveyor.yml Use "appveyor DownloadFile" Oct 10, 2016
autogen.sh Update gmock links. Aug 26, 2016
composer.json Fixed issue with autoloading - Invalid paths (#2538) Dec 28, 2016
configure.ac Fixed cross compilations with the Autotools build Jan 3, 2017
generate_changelog.py generate_changelog.py: flush output so piping works correctly. Dec 10, 2016
generate_descriptor_proto.sh Fix #2071 replacing /bin/sh with bash Sep 7, 2016
gmock.BUILD Update repo to use google test Sep 9, 2016
post_process_dist.sh Add php files for make dist. Oct 10, 2016
protobuf-lite.pc.in Uncomment conflict fields from pkg-config files. May 12, 2015
protobuf.bzl Merge pull request #2403 from google/down-integrate-with-msvc-fix Nov 23, 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 Add python compatibility tests against v2.5.0 amd run on Travis. Jan 26, 2017
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 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 php

Usage

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

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