protobuf
Protocol
Direitos autorais 2023 Google LLC
Buffers de protocolo (também conhecidos como protobuf) são o mecanismo extensível, neutro em termos de linguagem e de plataforma do Google para serializar dados estruturados. Você pode aprender mais sobre isso na documentação do protobuf.
Este arquivo README contém instruções de instalação do protobuf. Para instalar o protobuf, você precisa instalar o compilador de protocolo (usado para compilar arquivos .proto) e o tempo de execução do protobuf para a linguagem de programação escolhida.
A maioria dos usuários achará que trabalhar com versões suportadas é o caminho mais fácil.
Se você optar por trabalhar a partir da revisão principal do branch principal, sua compilação será ocasionalmente interrompida por alterações incompatíveis com a fonte e comportamento insuficientemente testado (e, portanto, quebrado).
Se você estiver usando C++ ou precisar construir o protobuf a partir do código-fonte como parte do seu projeto, você deve fixar um commit de lançamento em um branch de lançamento.
Isso ocorre porque mesmo as ramificações de lançamento podem sofrer alguma instabilidade entre os commits de lançamento.
O compilador protobuf é escrito em C++. Se você estiver usando C++, siga as instruções de instalação do C++ para instalar o protoc junto com o tempo de execução do C++.
Para usuários que não usam C++, a maneira mais simples de instalar o compilador de protocolo é baixar um binário pré-construído em nossa página de lançamento do GitHub.
Na seção de downloads de cada versão, você pode encontrar binários pré-construídos em pacotes zip: protoc-$VERSION-$PLATFORM.zip . Ele contém o binário protoc, bem como um conjunto de arquivos .proto padrão distribuídos junto com o protobuf.
Se você está procurando uma versão antiga que não está disponível na página de lançamento, verifique o repositório Maven.
Esses binários pré-construídos são fornecidos apenas para versões lançadas. Se você quiser usar a versão principal do github em HEAD, ou precisar modificar o código protobuf, ou estiver usando C++, é recomendado construir seu próprio binário protoc a partir do código-fonte.
Se você quiser construir o binário protoc a partir do código-fonte, consulte as Instruções de instalação do C++.
Protobuf oferece suporte a várias linguagens de programação diferentes. Para cada linguagem de programação, você pode encontrar instruções no diretório de origem correspondente sobre como instalar o tempo de execução do protobuf para essa linguagem específica:
| Linguagem | Fonte |
|---|---|
| C++ (inclui tempo de execução e protoc C++) | fonte |
| Java | Java |
| Pitão | píton |
| Objetivo-C | objetivo |
| C# | csharp |
| Rubi | rubi |
| Ir | protocolobuffers/protobuf-go |
| PHP | php |
| Dardo | dart-lang/protobuf |
| JavaScript | protocolobuffers/protobuf-javascript |
A melhor maneira de aprender como usar o protobuf é seguir os tutoriais em nosso guia do desenvolvedor.
Se você quiser aprender com exemplos de código, dê uma olhada nos exemplos no diretório de exemplos.
A documentação completa está disponível no site de documentação do Protocol Buffers.
Leia sobre nossa política de suporte de versão para se manter atualizado sobre os prazos de suporte para as bibliotecas de idiomas.
Para ser alertado sobre as próximas mudanças nos buffers de protocolo e conectar-se com desenvolvedores e usuários do protobuf, junte-se ao Grupo do Google.
