Protocol Buffers - Google's data interchange format (grpc依赖) https://developers.google.com/protocol-buffers/

Go to file

Alex Konradi b44a1364ec Add extension number for protoc-gen-validate This project is used by the [Envoy proxy](https://www.envoyproxy.io/) and several others. The existing code is using the extension value [919191](`54b08a686f/validate/validate.proto (L29)`) but since maintaining binary compatibility is not important, it shouldn't be a problem to change once this allocation is approved.		6 years ago
.github	Add Mergeable config	6 years ago
benchmarks	Down integrate to GitHub	6 years ago
cmake	Down integrate to GitHub	6 years ago
conformance	Add a new conformance test for top level JSON null (#5966 )	6 years ago
csharp	Update generated files	6 years ago
docs	Add extension number for protoc-gen-validate	6 years ago
editors	Improve fix for https://github.com/google/protobuf/issues/295	8 years ago
examples	create importable function for defining zlib	6 years ago
java	Down integrate to GitHub	6 years ago
js	Down integrate to GitHub	6 years ago
kokoro	Add -Werror for CI builds	6 years ago
m4	Mostly fix Sun Studio configuration using SunCC compiler	6 years ago
objectivec	Add module for JavaLite and fix builds	6 years ago
php	Update generated files	6 years ago
protoc-artifacts	Update version number to 3.7.1 (#5947 )	6 years ago
python	Down integrate to GitHub	6 years ago
ruby	Revert "Convert Google::Protobuf.deep_copy to pure Ruby"	6 years ago
src	Down integrate to GitHub	6 years ago
third_party	Revert "Add stack overflow protection for text format"	6 years ago
util/python	Remove hack for building Python support with Bazel.	9 years ago
.gitignore	Php 7.3 fix (#5434 )	6 years ago
.gitmodules	Include googletest as a submodule (#3993 )	7 years ago
BUILD	Fixed typo: conformance_test_runner should be a binary, not library.	6 years ago
CHANGES.txt	Fix "the the".	6 years ago
CONTRIBUTING.md	Update CONTRIBUTING.md to recommend applying the appropriate labels	6 years ago
CONTRIBUTORS.txt	Add nano proto authors and update LICENSE file to include Android.mk.	10 years ago
LICENSE	Cleanup LICENSE file.	7 years ago
Makefile.am	C# Proto2 feature : Extensions (#5350 )	6 years ago
Protobuf.podspec	Update version number to 3.7.1 (#5947 )	6 years ago
README.md	Add link to continuous test badges (#5855 )	6 years ago
WORKSPACE	Removed duplicate text from WORKSPACE file	6 years ago
appveyor.bat	use netcoreapp2.1 for testing	6 years ago
appveyor.yml	Merge branch '3.6.x' into merge-3-6-x	7 years ago
autogen.sh	Add cpp tests under release docker image.	6 years ago
compiler_config_setting.bzl	Create compiler_config_setting.bzl	6 years ago
composer.json	Update PHP descriptors (#3391 )	7 years ago
configure.ac	Update version number to 3.7.1 (#5947 )	6 years ago
generate_changelog.py	Replace repo links.	6 years ago
generate_descriptor_proto.sh	Down-integrate from google3.	6 years ago
global.json	Bump target frameworks of C# programs from netcoreapp1.0 to netcoreapp2.1 (#5838 )	6 years ago
post_process_dist.sh	Removed javanano from post_process_dist.sh	7 years ago
protobuf-lite.pc.in	`Libs` should not include `@PTHREAD_CFLAGS@`	6 years ago
protobuf.bzl	Down-integrate internal changes (#5467 )	6 years ago
protobuf.pc.in	Down integrate to GitHub	6 years ago
protobuf_deps.bzl	comply with Bazel recommendations	6 years ago
six.BUILD	Add srcs_version = "PY2AND3" in BUILD files	9 years ago
tests.sh	Merge branch '3.7.x' into merge-3-7-x	6 years ago
update_file_lists.sh	fix duplicate mkdir in update_file_lists.sh	7 years ago
update_version.py	Make sure to return the updated line when modifying .pb.h file	6 years ago

README.md

Protocol Buffers - Google's data interchange format

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/protocolbuffers/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:

https://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	Ubuntu	MacOS	Windows
C++ (include C++ runtime and protoc)	src
Java	java
Python	python
Objective-C	objectivec
C#	csharp
JavaScript	js
Ruby	ruby
Go	golang/protobuf
PHP	php
Dart	dart-lang/protobuf