протобуф
Protocol
Авторские права принадлежат Google LLC, 2023 г.
Протокольные буферы (также известные как protobuf) — это независимый от языка и платформы расширяемый механизм Google для сериализации структурированных данных. Вы можете узнать больше об этом в документации protobuf.
Этот файл README содержит инструкции по установке protobuf. Чтобы установить protobuf, вам необходимо установить компилятор протокола (используемый для компиляции файлов .proto) и среду выполнения protobuf для выбранного вами языка программирования.
Большинству пользователей проще всего будет работать с поддерживаемыми выпусками.
Если вы решите работать с головной ревизией основной ветки, ваша сборка иногда будет нарушаться из-за несовместимых с исходным кодом изменений и недостаточно протестированного (и, следовательно, сломанного) поведения.
Если вы используете C++ или вам по какой-либо другой причине необходимо собрать protobuf из исходного кода как часть вашего проекта, вам следует закрепить коммит выпуска в ветке выпуска.
Это связано с тем, что даже ветки релизов могут испытывать некоторую нестабильность между коммитами релизов.
Компилятор protobuf написан на C++. Если вы используете C++, следуйте инструкциям по установке C++, чтобы установить protoc вместе со средой выполнения C++.
Для пользователей, не владеющих C++, самый простой способ установить компилятор протокола — загрузить предварительно созданный двоичный файл с нашей страницы выпуска GitHub.
В разделе загрузок каждого выпуска вы можете найти готовые двоичные файлы в zip-пакетах: protoc-$VERSION-$PLATFORM.zip . Он содержит двоичный файл protoc, а также набор стандартных файлов .proto распространяемых вместе с protobuf.
Если вы ищете старую версию, которой нет на странице выпуска, посетите репозиторий Maven.
Эти предварительно созданные двоичные файлы предоставляются только для выпущенных версий. Если вы хотите использовать основную версию github в HEAD, или вам нужно изменить код protobuf, или вы используете C++, рекомендуется создать собственный двоичный файл protoc из исходного кода.
Если вы хотите собрать двоичный файл protoc из исходного кода, см. Инструкции по установке C++.
Protobuf поддерживает несколько разных языков программирования. Для каждого языка программирования в соответствующем каталоге исходного кода вы можете найти инструкции по установке среды выполнения protobuf для этого конкретного языка:
| Язык | Источник |
|---|---|
| C++ (включая среду выполнения и протокол C++) | источник |
| Ява | Ява |
| Питон | питон |
| Цель-C | объективныйc |
| С# | csharp |
| Руби | рубин |
| Идти | протоколбуферы/protobuf-go |
| PHP | php |
| Дарт | дарт-ланг/протобуф |
| JavaScript | протоколбуферы/protobuf-javascript |
Лучший способ научиться использовать protobuf — следовать инструкциям в нашем руководстве для разработчиков.
Если вы хотите учиться на примерах кода, взгляните на примеры в каталоге примеров.
Полная документация доступна на сайте документации Protocol Buffers.
Прочтите о нашей политике поддержки версий, чтобы быть в курсе сроков поддержки языковых библиотек.
Чтобы получать уведомления о предстоящих изменениях в протокольных буферах и общаться с разработчиками и пользователями protobuf, присоединитесь к группе Google.
