저작권 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++ 런타임 및 protoc 포함) | 소스 |
자바 | 자바 |
파이썬 | 파이썬 |
오브젝티브-C | 객관적인 |
기음# | csharp |
루비 | 루비 |
가다 | 프로토콜 버퍼/protobuf-go |
PHP | PHP |
다트 | dart-lang/protobuf |
자바스크립트 | 프로토콜 버퍼/protobuf-javascript |
protobuf 사용법을 배우는 가장 좋은 방법은 개발자 가이드의 튜토리얼을 따르는 것입니다.
코드 예제를 통해 배우고 싶다면 예제 디렉터리의 예제를 살펴보세요.
전체 문서는 프로토콜 버퍼 문서 사이트에서 확인할 수 있습니다.
언어 라이브러리에 대한 지원 기간을 최신 상태로 유지하려면 버전 지원 정책을 읽어보세요.
프로토콜 버퍼의 향후 변경사항에 대한 알림을 받고 protobuf 개발자 및 사용자와 소통하려면 Google 그룹에 가입하세요.