Protocol Buffers - Google's data interchange format (grpc依赖) https://developers.google.com/protocol-buffers/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Joshua Haberman 9be7dd1c81
Merge pull request #9963 from johnnyshields/ruby-x64-mingw-ucrt-support
3 years ago
.github Add a github action workflow to run CocoaPods validation. (#9800) 3 years ago
benchmarks Add a test for bazel-built dist archives (#9929) 3 years ago
build_defs [Bazel] Move C++ build-related logic into //build_defs (#9921) 3 years ago
cmake Add endian.h to includes list 3 years ago
conformance Add a test for bazel-built dist archives (#9929) 3 years ago
csharp Helper method on Any to allow an any to be unpacked more easily 3 years ago
docs Reserve extension id for Protonium 3 years ago
editors [editors/emacs] Fix protobuf-mode definition (#9572) 3 years ago
examples Rename all BUILD files to BUILD.bazel (#9892) 3 years ago
java Switch C++ test protos to use the normal cc_proto_library rules. (#9950) 3 years ago
kokoro [Bazel] Move Python rules to //python (#9952) 3 years ago
m4 Updated ax_pthread.m4 to its most recent upstream version 4 years ago
objectivec Remove the support for the kokoro cocoapods integration tests. 3 years ago
php Merge pull request #9536 from bshaffer/patch-2 3 years ago
pkg [Bazel] Move Python rules to //python (#9952) 3 years ago
protoc-artifacts Update protobuf version (#9820) 3 years ago
python [Bazel] Move Python rules to //python (#9952) 3 years ago
ruby Ruby: support x64-mingw-ucrt platform, which is the new platform which Windows Ruby Installer uses as of Ruby 3.1 3 years ago
src Various fixups to warnings flags (#9344) 3 years ago
third_party Add a test for bazel-built dist archives (#9929) 3 years ago
toolchain Optimization is now working. 3 years ago
util/python Rename all BUILD files to BUILD.bazel (#9892) 3 years ago
.bazelignore Update CMake configuration to add a dependency on Abseil (#9793) 3 years ago
.gitignore Remove the JavaScript implementation (#9874) 3 years ago
.gitmodules Update CMake configuration to add a dependency on Abseil (#9793) 3 years ago
.readthedocs.yml python: publish sphinx docs to read the docs 5 years ago
BUILD.bazel [Bazel] Move Python rules to //python (#9952) 3 years ago
CHANGES.txt Minor CHANGES.txt fix and pulled one more upb commit. 3 years ago
CMakeLists.txt Factor out MSVC-only `version.rc` logic, and ensure other variables are always initialized (#9880) 3 years ago
CONTRIBUTING.md Replace master with main in URLs & docs 3 years ago
CONTRIBUTORS.txt Match service argument names to abstract interface (#9418) 3 years ago
LICENSE Cleanup LICENSE file. 7 years ago
Makefile.am [Bazel] Move Python rules to //python (#9952) 3 years ago
Protobuf-C++.podspec Update protobuf version (#9820) 3 years ago
Protobuf.podspec Add a github action workflow to run CocoaPods validation. (#9800) 3 years ago
README.md Remove the JavaScript implementation (#9874) 3 years ago
SECURITY.md grammar nit 3 years ago
WORKSPACE Added a Bazel dependency for upb (#9812) 3 years ago
appveyor.bat Update .NET SDKs to LTS versions 3 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
configure.ac Remove the JavaScript implementation (#9874) 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 Remove the JavaScript implementation (#9874) 3 years ago
generate_descriptor_proto.sh Updated version to 3.12.3 and updated CHANGES.txt. (#7580) 5 years ago
global.json Update .NET SDKs to LTS versions 3 years ago
maven_install.json Update Guava to 31.1 (#9707) 3 years ago
post_process_dist.sh Remove the JavaScript implementation (#9874) 3 years ago
protobuf-lite.pc.in Remove references to HAVE_PTHREAD (#9100) 3 years ago
protobuf.bzl [Bazel] Move Python rules to //python (#9952) 3 years ago
protobuf.pc.in Remove references to HAVE_PTHREAD (#9100) 3 years ago
protobuf_deps.bzl Minor CHANGES.txt fix and pulled one more upb commit. 3 years ago
protobuf_release.bzl Update protobuf_version.bzl to separate protoc and per-language java major version (#9900) 3 years ago
protobuf_version.bzl Updated the release notes and the upb version. 3 years ago
tests.sh Run kotlin tests on JDK 8 *and later* (#9949) 3 years ago
update_compatibility_version.py Merge 3.11.0-rc1 changes to master (#6917) 5 years ago
update_file_lists.sh Enable GeneratedDescriptorTest.EnormousDescriptor test for GCC/Clang CMake builds (#9617) 3 years ago
update_version.py Remove the JavaScript implementation (#9874) 3 years ago
version.json Increment python major version in version.json for python upb (#9926) 3 years ago

README.md

Protocol Buffers - Google's data interchange format

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/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 main 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
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/