flatbuffers

Плоские буферы

FlatBuffers — это кроссплатформенная библиотека сериализации, разработанная для максимальной эффективности использования памяти. Он позволяет вам напрямую получать доступ к сериализованным данным без предварительного анализа/распаковки, сохраняя при этом отличную прямую/обратную совместимость.

Быстрый старт

1. Создайте компилятор для плоских буферов ( flatc )

   Используйте cmake для создания файлов сборки для вашей платформы, а затем выполните компиляцию (пример Linux).

    cmake -G "Unix Makefiles"
   make -j
   

2. Определите схему плоского буфера ( .fbs ).

   Напишите схему, чтобы определить данные, которые вы хотите сериализовать. См. пример monster.fbs.

3. Сгенерируйте код для вашего языка(ов)

   Используйте компилятор flatc , чтобы взять вашу схему и сгенерировать код для конкретного языка:

    ./flatc --cpp --rust monster.fbs
   

   При этом создаются файлы monster_generated.h и monster_generated.rs .

4. Сериализация данных

   Используйте сгенерированный код, а также FlatBufferBuilder для создания сериализованного буфера. (пример C++ )

5. Передача/сохранение/сохранение буфера

   Используйте сериализованный буфер по своему усмотрению. Отправьте его кому-нибудь, сохраните на потом и т. д.

6. Прочтите данные

   Используйте сгенерированные методы доступа для чтения данных из сериализованного буфера.

   Это не обязательно должна быть одна и та же версия языка/схемы: FlatBuffers обеспечивает читаемость данных на разных языках и версиях схемы. См. пример Rust , читающий данные, написанные на C++ .

Документация

Перейдите на нашу целевую страницу, чтобы просмотреть нашу документацию.

Поддерживаемые операционные системы

• Окна
• macOS
• Линукс
• Андроид
• И любые другие, использующие новейший компилятор C++ (C++ 11 и новее).

Поддерживаемые языки программирования

Библиотеки генерации кода и времени выполнения для многих популярных языков.

1. С
2. С++ — snapcraft.io
3. С# — nuget.org
4. Дарт - pub.dev
5. Перейти - go.dev
6. Ява — Мавен
7. JavaScript – НПМ
8. Котлин
9. Омар
10. Луа
11. PHP
12. Питон — PyPI
13. Ржавчина - crates.io
14. Swift — индекс быстрого пакета
15. TypeScript — НПМ
16. Ним

Управление версиями

FlatBuffers не следует традиционному управлению версиями SemVer (см. обоснование), а скорее использует формат даты выпуска.

Вклад

• FlatBuffers Issues Tracker, чтобы сообщить о проблеме.
• stackoverflow.com с тегом flatbuffers для любых вопросов, касающихся FlatBuffers.

Чтобы внести свой вклад в этот проект, см. ВКЛАД.

Сообщество

• Дискорд-сервер

Безопасность

Чтобы сообщить об уязвимостях, ознакомьтесь с нашей Политикой безопасности.

Лицензирование

Flatbuffers распространяется по лицензии Apache версии 2.0. Полный текст лицензии см. в разделе ЛИЦЕНЗИЯ.