protobuf
Protocol
Copyright 2023 Google LLC
Les tampons de protocole (alias protobuf) sont le mécanisme extensible de Google, indépendant du langage et de la plate-forme, pour sérialiser les données structurées. Vous pouvez en apprendre davantage dans la documentation de protobuf.
Ce fichier README contient les instructions d'installation de protobuf. Pour installer protobuf, vous devez installer le compilateur de protocole (utilisé pour compiler les fichiers .proto) et le runtime protobuf pour le langage de programmation choisi.
La plupart des utilisateurs trouveront que travailler à partir des versions prises en charge est le chemin le plus simple.
Si vous choisissez de travailler à partir de la révision principale de la branche principale, votre build sera parfois interrompue par des modifications incompatibles avec les sources et un comportement insuffisamment testé (et donc défectueux).
Si vous utilisez C++ ou si vous avez besoin de créer protobuf à partir des sources dans le cadre de votre projet, vous devez épingler une validation de version sur une branche de version.
En effet, même les branches de version peuvent rencontrer une certaine instabilité entre les validations de version.
Le compilateur protobuf est écrit en C++. Si vous utilisez C++, veuillez suivre les instructions d'installation C++ pour installer le protocole avec le runtime C++.
Pour les utilisateurs non C++, le moyen le plus simple d'installer le compilateur de protocole consiste à télécharger un binaire prédéfini à partir de notre page de version GitHub.
Dans la section téléchargements de chaque version, vous pouvez trouver des binaires prédéfinis dans des packages zip : protoc-$VERSION-$PLATFORM.zip . Il contient le binaire du protocole ainsi qu'un ensemble de fichiers .proto standard distribués avec protobuf.
Si vous recherchez une ancienne version qui n'est pas disponible sur la page de publication, consultez le référentiel Maven.
Ces binaires prédéfinis ne sont fournis que pour les versions publiées. Si vous souhaitez utiliser la version principale de github sur HEAD, ou si vous devez modifier le code protobuf, ou si vous utilisez C++, il est recommandé de créer votre propre binaire de protocole à partir des sources.
Si vous souhaitez créer un binaire de protocole à partir des sources, consultez les instructions d'installation C++.
Protobuf prend en charge plusieurs langages de programmation différents. Pour chaque langage de programmation, vous pouvez trouver des instructions dans le répertoire source correspondant sur la façon d'installer le runtime protobuf pour ce langage spécifique :
| Langue | Source |
|---|---|
| C++ (inclure le runtime et le protocole C++) | src |
| Java | Java |
| Python | python |
| Objectif-C | objectif |
| C# | cpointu |
| Rubis | rubis |
| Aller | tampons de protocole/protobuf-go |
| PHP | php |
| Dard | dart-lang/protobuf |
| Javascript | tampons de protocole/protobuf-javascript |
La meilleure façon d'apprendre à utiliser protobuf est de suivre les tutoriels de notre guide du développeur.
Si vous souhaitez apprendre des exemples de code, jetez un œil aux exemples dans le répertoire des exemples.
La documentation complète est disponible sur le site de documentation Protocol Buffers.
Découvrez notre politique de prise en charge des versions pour rester au courant des délais de prise en charge des bibliothèques de langues.
Pour être alerté des changements à venir dans les tampons de protocole et vous connecter avec les développeurs et les utilisateurs de protobuf, rejoignez le groupe Google.
