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

Go to file

Xùdōng Yáng 11de748d66 Use repo-relative labels wherever possible (#9187 ) * Use repo-relative labels wherever possible The label `@com_google_protobuf//:foo` within the protobuf repo is often synonymous with just `//:foo`. We should prefer the latter as it allows us to use a shorter name for the module in the Bazel Central Registry (so just "protobuf" instead of "com_google_protobuf"). Note that the semantics can be subtle: in a macro, plain strings are anchored to the calling repo, so if we just use `//:foo` as the default value of a macro argument, it will be resolved to `@myrepo//:foo` if the macro is called from the repo `@myrepo`. In this case, it's necessary to directly call the `Label()` constructor to anchor the string label to the repo where the .bzl file lives. See https://github.com/bazelbuild/bazel-central-registry/pull/28#issuecomment-954741081 for a bit more context. * fix protobuf_deps.bzl		3 years ago
.github	Sync from Piper @395706834	3 years ago
benchmarks	Fix benchmark by making sure we use Python 3 (#9170 ) (#9176 )	3 years ago
cmake	Remove references to HAVE_PTHREAD (#9100 )	3 years ago
conformance	Update JRuby to leverage pure-Ruby DSL.	3 years ago
csharp	Merge pull request #9169 from protocolbuffers/3.19.x	3 years ago
docs	Add pbkit to third_party.md (#9177 )	3 years ago
editors	Emacs: Protobuf mode should be derived from prog-mode (#9076 )	3 years ago
examples	examples: update Go example (#7217 )	3 years ago
java	Merge pull request #9169 from protocolbuffers/3.19.x	3 years ago
js	Update protobuf version (#9167 )	3 years ago
kokoro	Fix benchmark by making sure we use Python 3 (#9170 ) (#9176 )	3 years ago
m4	Updated ax_pthread.m4 to its most recent upstream version	4 years ago
objectivec	Fix comment syntax in any.proto (#8792 )	3 years ago
php	Merge pull request #9169 from protocolbuffers/3.19.x	3 years ago
protoc-artifacts	Update protobuf version (#9167 )	3 years ago
python	Merge pull request #9169 from protocolbuffers/3.19.x	3 years ago
ruby	Merge pull request #9169 from protocolbuffers/3.19.x	3 years ago
src	Implement unambiguous comparisons for RepeatedPtrIterator in C++20 (#9139 )	3 years ago
third_party	Remove references to six (#9096 )	3 years ago
toolchain	Fixing builds	3 years ago
util/python	[bazel] Add fixes for --incompatible_load_{cc,java,proto}_rules_from_bzl (Part 2)	5 years ago
.bazelignore	Sync from Piper @391414001	3 years ago
.gitignore	same directory ignore	3 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	Remove references to HAVE_PTHREAD (#9100 )	3 years ago
CHANGES.txt	Update changelog for 3.19.1	3 years ago
CONTRIBUTING.md	document the kinds of patches the repo is open to (#8900 )	3 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	Fix distcheck test by updating example Go file paths (#9137 )	3 years ago
Protobuf-C++.podspec	Update protobuf version (#9167 )	3 years ago
Protobuf.podspec	Update protobuf version (#9167 )	3 years ago
README.md	Remove build badges, they were consistently out of date and not very useful. (#8634 )	4 years ago
SECURITY.md	Sync from Piper @391414001	3 years ago
WORKSPACE	Align dependency handling with Bazel best practices (#9165 )	3 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	Build updates (#5300 )	4 years ago
build_files_updated_unittest.sh	Fixed sort ordering and updated test to output context information.	4 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 (#9167 )	3 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	Updated version to 3.12.3 and updated CHANGES.txt. (#7580 )	5 years ago
global.json	Improve WriteString perf with SIMD	4 years ago
internal.bzl	Bazel powered Java testing (#8506 )	4 years ago
maven_install.json	Add jsr305 dependency for Bazel	3 years ago
post_process_dist.sh	Removed javanano from post_process_dist.sh	7 years ago
protobuf-lite.pc.in	Remove references to HAVE_PTHREAD (#9100 )	3 years ago
protobuf.bzl	Use repo-relative labels wherever possible (#9187 )	3 years ago
protobuf.pc.in	Remove references to HAVE_PTHREAD (#9100 )	3 years ago
protobuf_deps.bzl	Use repo-relative labels wherever possible (#9187 )	3 years ago
protobuf_version.bzl	Update protobuf version (#9167 )	3 years ago
tests.sh	Add python 3.10 (#9034 )	3 years ago
update_compatibility_version.py	Merge 3.11.0-rc1 changes to master (#6917 )	5 years ago
update_file_lists.sh	Sync from Piper @396393195	3 years ago
update_version.py	Update versions in README files (#9093 )	3 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
C++ (include C++ runtime and protoc)	src
Java	java
Python	python
Objective-C	objectivec
C#	csharp
JavaScript	js
Ruby	ruby
Go	protocolbuffers/protobuf-go
PHP	php
Dart	dart-lang/protobuf

Quick Start

The best way to learn how to use protobuf is to follow the tutorials in our developer guide:

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

If you want to learn from code examples, take a look at the examples in the examples directory.

Documentation

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

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