protobuf
Protocol
Copyright 2023 Google LLC
Protokollpuffer (auch bekannt als Protobuf) sind Googles sprachneutraler, plattformneutraler und erweiterbarer Mechanismus zur Serialisierung strukturierter Daten. Weitere Informationen hierzu finden Sie in der Dokumentation von protobuf.
Diese README-Datei enthält Protobuf-Installationsanweisungen. Um Protobuf zu installieren, müssen Sie den Protokoll-Compiler (der zum Kompilieren von .proto-Dateien verwendet wird) und die Protobuf-Laufzeitumgebung für die von Ihnen gewählte Programmiersprache installieren.
Für die meisten Benutzer ist die Arbeit mit unterstützten Versionen der einfachste Weg.
Wenn Sie sich dafür entscheiden, mit der Hauptrevision des Hauptzweigs zu arbeiten, wird Ihr Build gelegentlich durch mit der Quelle inkompatible Änderungen und unzureichend getestetes (und daher fehlerhaftes) Verhalten beschädigt.
Wenn Sie C++ verwenden oder anderweitig als Teil Ihres Projekts Protobuf aus dem Quellcode erstellen müssen, sollten Sie es an einen Release-Commit in einem Release-Zweig anheften.
Dies liegt daran, dass selbst Release-Branches zwischen Release-Commits eine gewisse Instabilität erfahren können.
Der Protobuf-Compiler ist in C++ geschrieben. Wenn Sie C++ verwenden, befolgen Sie bitte die C++-Installationsanweisungen, um Protokoll zusammen mit der C++-Laufzeit zu installieren.
Für Nicht-C++-Benutzer besteht die einfachste Möglichkeit zur Installation des Protokoll-Compilers darin, eine vorgefertigte Binärdatei von unserer GitHub-Release-Seite herunterzuladen.
Im Download-Bereich jeder Version finden Sie vorgefertigte Binärdateien in Zip-Paketen: protoc-$VERSION-$PLATFORM.zip . Es enthält die Protoc-Binärdatei sowie eine Reihe standardmäßiger .proto Dateien, die zusammen mit Protobuf verteilt werden.
Wenn Sie nach einer alten Version suchen, die auf der Release-Seite nicht verfügbar ist, schauen Sie sich das Maven-Repository an.
Diese vorgefertigten Binärdateien werden nur für veröffentlichte Versionen bereitgestellt. Wenn Sie die Github-Hauptversion bei HEAD verwenden möchten, den Protobuf-Code ändern müssen oder C++ verwenden, wird empfohlen, Ihre eigene Protoc-Binärdatei aus dem Quellcode zu erstellen.
Wenn Sie Protokollbinärdateien aus dem Quellcode erstellen möchten, lesen Sie die C++-Installationsanweisungen.
Protobuf unterstützt mehrere verschiedene Programmiersprachen. Für jede Programmiersprache finden Sie im entsprechenden Quellverzeichnis Anweisungen zur Installation der Protobuf-Laufzeitumgebung für die jeweilige Sprache:
| Sprache | Quelle |
|---|---|
| C++ (einschließlich C++-Laufzeit und -Protokoll) | src |
| Java | Java |
| Python | Python |
| Ziel-C | objektivc |
| C# | csharp |
| Rubin | Rubin |
| Gehen | Protokollpuffer/protobuf-go |
| PHP | php |
| Pfeil | dart-lang/protobuf |
| JavaScript | Protokollpuffer/Protobuf-Javascript |
Der beste Weg, die Verwendung von Protobuf zu erlernen, besteht darin, den Tutorials in unserem Entwicklerhandbuch zu folgen.
Wenn Sie aus Codebeispielen lernen möchten, werfen Sie einen Blick auf die Beispiele im Beispielverzeichnis.
Die vollständige Dokumentation ist auf der Dokumentationsseite von Protocol Buffers verfügbar.
Lesen Sie mehr über unsere Richtlinien zur Versionsunterstützung, um über die Supportzeitrahmen für die Sprachbibliotheken auf dem Laufenden zu bleiben.
Treten Sie der Google-Gruppe bei, um über bevorstehende Änderungen bei Protocol Buffers informiert zu werden und mit Protobuf-Entwicklern und -Nutzern in Kontakt zu treten.
