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

Go to file

Jan Tattermusch ba61d76e52 simplify serialization to single span		5 years ago
.github	Update mergeable.yml	5 years ago
benchmarks	Set execute bit on files if and only if they begin with (#!). (#7347 )	5 years ago
cmake	Sync from Piper @314226556	5 years ago
conformance	Sync from Piper @314226556	5 years ago
csharp	simplify serialization to single span	5 years ago
docs	Sync from Piper @313142438	5 years ago
editors	Sync from Piper @313142438	5 years ago
examples	Set execute bit on files if and only if they begin with (#!). (#7347 )	5 years ago
java	Merge branch '3.12.x' into merge-312	5 years ago
js	Sync from Piper @314226556	5 years ago
kokoro	Merge branch '3.12.x' into merge-312	5 years ago
m4	Mostly fix Sun Studio configuration using SunCC compiler	6 years ago
objectivec	Sync from Piper @313142438	5 years ago
php	Simplified PHP testing scripts. (#7574 )	5 years ago
protoc-artifacts	Update protobuf version (#7557 )	5 years ago
python	Sync from Piper @314226556	5 years ago
ruby	Update protobuf version (#7557 )	5 years ago
src	fix codegen	5 years ago
third_party	Update six.BUILD	5 years ago
util/python	[bazel] Add fixes for --incompatible_load_{cc,java,proto}_rules_from_bzl (Part 2)	5 years ago
.bazelignore	[bazel] Update gtest and deprecate //external:{gtest,gtest_main} (#7237 )	5 years ago
.gitignore	python: add sphinx docs (#6525 )	5 years ago
.gitmodules	Include googletest as a submodule (#3993 )	7 years ago
.readthedocs.yml	python: publish sphinx docs to read the docs	5 years ago
BUILD	Merge branch '3.12.x' into merge-312	5 years ago
CHANGES.txt	Overcome the `ref struct` limitation for pre-roslyn compilers by introducing GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE for generated code (#7490 )	5 years ago
CONTRIBUTING.md	Update CONTRIBUTING.md	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	Overcome the `ref struct` limitation for pre-roslyn compilers by introducing GOOGLE_PROTOBUF_REFSTRUCT_COMPATIBILITY_MODE for generated code (#7490 )	5 years ago
Protobuf-C++.podspec	Update protobuf version (#7557 )	5 years ago
Protobuf.podspec	Update protobuf version (#7557 )	5 years ago
README.md	Sync from Piper @307316823	5 years ago
WORKSPACE	[bazel] Update gtest and deprecate //external:{gtest,gtest_main} (#7237 )	5 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
build_files_updated_unittest.sh	Copy files to temp-dir for testing	5 years ago
cc_proto_blacklist_test.bzl	[bazel] Fix blacklisted_protos in cc_toolchain and add test (#7075 )	5 years ago
compiler_config_setting.bzl	[bazel] Move Java runtime/toolchains into //java (#7190 )	5 years ago
composer.json	Update PHP descriptors (#3391 )	7 years ago
configure.ac	Update protobuf version (#7557 )	5 years ago
fix_permissions.sh	Set execute bit on files if and only if they begin with (#!). (#7347 )	5 years ago
generate_changelog.py	Replace repo links.	6 years ago
generate_descriptor_proto.sh	Down-integrate from google3.	6 years ago
global.json	C# project cleanup	5 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	Fix depset/list confusion in #7458 .	5 years ago
protobuf.pc.in	Down integrate to GitHub	6 years ago
protobuf_deps.bzl	Update rules_cc	5 years ago
tests.sh	Simplified PHP testing scripts. (#7574 )	5 years ago
update_compatibility_version.py	Marked update_compatibility_version.py as executable (#6916 )	5 years ago
update_file_lists.sh	Add test to verify BUILD- and cmake-files are in sync with src/Makefile.am	5 years ago
update_version.py	Update to 3.10.0-rc0 (#6660 )	5 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