著作権 2023 Google LLC
プロトコル バッファー (別名 protobuf) は、構造化データをシリアル化するための Google の言語中立、プラットフォーム中立の拡張可能なメカニズムです。詳細については、protobuf のドキュメントを参照してください。
この README ファイルには、protobuf のインストール手順が含まれています。 protobuf をインストールするには、プロトコル コンパイラー (.proto ファイルのコンパイルに使用) と、選択したプログラミング言語の protobuf ランタイムをインストールする必要があります。
ほとんどのユーザーは、サポートされているリリースから作業するのが最も簡単な方法であると考えます。
メイン ブランチのヘッド リビジョンから作業することを選択した場合、ソースに互換性のない変更や、テストが不十分な (したがって壊れた) 動作によってビルドが壊れることがあります。
C++ を使用している場合、またはプロジェクトの一部としてソースから protobuf をビルドする必要がある場合は、リリース ブランチのリリース コミットに固定する必要があります。
これは、リリース ブランチでもリリース コミット間で不安定性が発生する可能性があるためです。
protobuf コンパイラは C++ で書かれています。 C++ を使用している場合は、「C++ インストール手順」に従って、C++ ランタイムとともに protoc をインストールしてください。
C++ 以外のユーザーの場合、プロトコル コンパイラーをインストールする最も簡単な方法は、GitHub リリース ページからビルド済みバイナリをダウンロードすることです。
各リリースのダウンロード セクションでは、zip パッケージで事前に構築されたバイナリが見つかります: protoc-$VERSION-$PLATFORM.zip
。これには、protoc バイナリと、protobuf とともに配布される標準.proto
ファイルのセットが含まれています。
リリース ページで入手できない古いバージョンを探している場合は、Maven リポジトリをチェックしてください。
これらの事前構築バイナリは、リリースされたバージョンに対してのみ提供されます。 HEAD で github のメイン バージョンを使用する場合、protobuf コードを変更する必要がある場合、または C++ を使用している場合は、ソースから独自の protoc バイナリをビルドすることをお勧めします。
ソースから protoc バイナリをビルドしたい場合は、「C++ インストール手順」を参照してください。
Protobuf は、いくつかの異なるプログラミング言語をサポートしています。プログラミング言語ごとに、その特定の言語の protobuf ランタイムをインストールする方法に関する説明が、対応するソース ディレクトリにあります。
言語 | ソース |
---|---|
C++ (C++ ランタイムとプロトコルを含む) | 送信元 |
ジャワ | ジャワ |
パイソン | パイソン |
目的-C | 客観的な |
C# | シャープ |
ルビー | ルビー |
行く | プロトコルバッファ/protobuf-go |
PHP | php |
ダーツ | dart-lang/protobuf |
JavaScript | プロトコルバッファー/protobuf-javascript |
protobuf の使用方法を学ぶ最良の方法は、開発者ガイドのチュートリアルに従うことです。
コード例から学びたい場合は、examples ディレクトリ内の例を参照してください。
完全なドキュメントは、Protocol Buffers ドキュメント サイトで入手できます。
言語ライブラリのサポート期間を最新の状態に保つために、バージョン サポート ポリシーをお読みください。
プロトコル バッファーの今後の変更に関するアラートを受け取り、protobuf 開発者やユーザーとつながるには、Google グループに参加してください。